返回文章
指南2026-11-07•7 分钟阅读•CSR.plus 团队

Let's Encrypt 需要 CSR 吗?什么情况下必须自己生成

Let's Encrypt 需要 CSR 吗?什么情况下必须自己生成

简短回答:通常不需要,但也有例外

Let's Encrypt 从不要求你在网页表单里上传 CSR。ACME 协议里确实有一个 finalize 步骤需要提交 CSR,但那份 CSR 是客户端自己生成的——私钥在你本机产生,被签进 CSR 后只有 CSR 会发给 CA。

所以常见情况下:你不需要手工生成 CSR。执行 certbot --nginx -d example.com,certbot 会自己创建 privkey.pem 和 CSR、完成验证、写回证书。

但有四类场景,你确实得自己产出 CSR。

什么时候必须手工 CSR

场景为什么客户端做不到
私钥存放在 HSM 或云 KMS私钥不可导出,只能在边界内签好 CSR 再导出
企业 CA 或托管商代签对方只接收 CSR 文件,永远不接触你的私钥
复用已有私钥客户端会新生成密钥,把你固定的公钥冲掉
排查 finalize 失败需要精确查看 CSR 里到底带了哪些域名

用 OpenSSL 生成私钥与 CSR

一条命令同时产出两个文件。-addext 负责把 SAN 写进 CSR——这才是 Let's Encrypt 真正读取的字段:

openssl req -new -newkey rsa:2048 -nodes \
  -keyout privkey.pem -out request.csr \
  -subj "/CN=example.com" \
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

换成 ECDSA(体积更小、握手更快,Let's Encrypt 同样接受):

openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes \
  -keyout privkey.pem -out request.csr \
  -subj "/CN=example.com" \
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

两条命令生成的 privkey.pem 都是未加密的(-nodes)。这是 Web 服务器需要的形态,也正因如此该文件必须只有 root 可读。

提交前先检查 CSR

openssl req -in request.csr -noout -text

输出里重点看三项:

  1. Subject Alternative Name 是否列全所有域名。CN 只是装饰——Let's Encrypt 只校验 SAN。
  2. Public Key Algorithm 与位数是否符合预期(2048 位 RSA 或 P-256)。
  3. Signature Algorithm 是否存在且与密钥类型匹配。没有签名块的就不是合法 CSR。

如果不想把文件丢进 shell,可以本站的 CSR 解析器 在浏览器里解析同样的字段。

CA 拿到 CSR 后做了什么

ACME 流程大概是这样:

  1. 客户端下单,声明一组标识(域名)。
  2. CA 下发挑战(HTTP-01、DNS-01、TLS-ALPN-01)。
  3. 客户端逐项证明控制权。
  4. 客户端把 CSR POST 到 finalize 端点。
  5. CA 校验 CSR 里的域名与已通过的标识完全一致,然后签发。

第 5 步是手工 CSR 最常翻车的地方。订单覆盖 example.com 和 www.example.com,而 CSR 只写了 example.com,finalize 就会报标识不匹配。CSR 无法在验证之后再追加域名,两份清单必须事先对齐。

四个常见错误

  • 漏写 SAN:只有 CN=example.com 的 CSR 在现在的浏览器验证里等于什么都没声明。
  • CN 与 SAN 不一致:有的工具会把 CN 复制进 SAN,有的不会,务必实际查看文件。
  • 通配符配了 HTTP-01:*.example.com 必须用 DNS TXT 验证,HTTP-01 无法证明通配符。
  • 密钥和 CSR 不是同一次生成的:先生成 CSR 又重生成密钥,最终证书和服务器密钥就对不上。部署前可用 密钥匹配工具 比对模数或公钥点。

续期时复用私钥

CSR 与证书有效期无关。你可以多年沿用同一把私钥,每次只重新生成 CSR——有些团队这么做,因为密钥被配置管理系统固定,或者密钥轮换与证书续期走两套节奏。

代价是:密钥一旦泄漏,在轮换之前一直危险,证书续多少次都没用。如果没有运维上的硬性理由,让客户端每次续期都生成新密钥——默认如此是有原因的。

直接在浏览器里做

如果 CSR 只是为了交给某个面板,CSR 生成器 会在本地生成私钥与 CSR,全程不上传。导出私钥离线保存,只在需要的地方粘贴 CSR。

常见问题

可以把自己的 CSR 直接交给 Let’s Encrypt 吗?

在 ACME 层面可以。客户端的 finalize 请求提交的就是 DER 编码的 CSR,允许粘贴 CSR 的工具只是跳过了本地生成密钥这一步。证书签发给 CSR 中的域名,因此必须与已通过验证的标识完全一致。

certbot 会覆盖我的 CSR 或私钥吗?

certbot 会为每个域名在 /etc/letsencrypt/live/<域名>/ 下生成独立的密钥对。如果你手工替换了私钥,续期时会继续使用该路径的文件——所以要在原位置替换,或用 --key-path 指向你自己的密钥。

通配符证书需要 CSR 吗?

CSR 中必须包含 DNS:*.example.com,且验证方式必须是 DNS-01。通配符不允许用 HTTP-01,因此 CSR 与验证类型要一起规划。

为什么 CSR 在商业 CA 能用,在 Let’s Encrypt 却失败?

多数是域名不匹配:商业 CA 常接受 CN,而 Let’s Encrypt 只读 SAN;或者 CSR 里包含无法公网验证的内网域名。

免费 SSL/TLS 工具

数秒内验证并检查你的证书。

相关证书信息

进一步了解如何选择和购买 SSL 证书。

相关文章