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输出里重点看三项:
- Subject Alternative Name 是否列全所有域名。CN 只是装饰——Let's Encrypt 只校验 SAN。
- Public Key Algorithm 与位数是否符合预期(2048 位 RSA 或 P-256)。
- Signature Algorithm 是否存在且与密钥类型匹配。没有签名块的就不是合法 CSR。
如果不想把文件丢进 shell,可以本站的 CSR 解析器 在浏览器里解析同样的字段。
CA 拿到 CSR 后做了什么
ACME 流程大概是这样:
- 客户端下单,声明一组标识(域名)。
- CA 下发挑战(HTTP-01、DNS-01、TLS-ALPN-01)。
- 客户端逐项证明控制权。
- 客户端把 CSR POST 到 finalize 端点。
- 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 证书。