OpenSSL 生成 CSR 命令:RSA、ECDSA、SAN 与常见报错

大多数人只需要这一条
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"拆开读就是:新建请求(-new)、同时生成新密钥(-newkey)、不加密私钥输出(-nodes)、私钥写到 privkey.pem、请求写到 request.csr、subject 设为 CN=example.com,并追加一条覆盖根域与 www 的 SAN 扩展。
两个最容易踩的坑:
-nodes("no DES")表示私钥明文写出。去掉它会要求输入口令,而多数服务器启动时无法交互输入。-addext需要 OpenSSL 1.1.1+。老版本上这条参数不存在,命令不会报错但也就没有 SAN。
RSA 4096
把位数换掉即可:
openssl req -new -newkey rsa:4096 -nodes \
-keyout privkey.pem -out request.csr \
-subj "/CN=example.com" \
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"4096 位 RSA 每次握手明显更耗 CPU,安全收益有限。真想加强,选 ECDSA 更划算。
ECDSA P-256 与 P-384
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"如果 CA 要求 384 位,把 prime256v1 换成 secp384r1。注意部分老 Android 与 Windows 对 ECDSA 证书链兼容性不佳,切换前先看访问日志。
SAN 很多或要带 IP
SAN 一多,-addext 就很难读。用配置文件:
# csr.cnf
[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
req_extensions = v3_req
[dn]
CN = example.com
[v3_req]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
IP.1 = 192.0.2.10openssl req -new -newkey rsa:2048 -nodes \
-keyout privkey.pem -out request.csr -config csr.cnf关键在 req_extensions = v3_req 这一行。漏掉它,你会得到一份完全合法但没有任何 SAN 的 CSR——然后 CA 告诉你域名不匹配。
提交前先看内容
openssl req -in request.csr -noout -text重点:
- Subject Alternative Name 是否包含全部域名
- Public-Key 是否为 2048 bit(或 id-ecPublicKey 加正确曲线)
- Signature Algorithm 例如 sha256WithRSAEncryption
再校验签名自洽:
openssl req -in request.csr -noout -verify正常会打印 verify OK。报 "unable to load" 通常是文件被终端折行截断。
报错对照表
| 报错 | 真实原因 | 处理 |
|---|---|---|
Error unpacking CSR | 文件是 DER 不是 PEM,或混入多余文本 | openssl req -inform DER -in request.der -out request.csr |
no start line | 缺少 PEM 头或换行被破坏 | 确认以 -----BEGIN CERTIFICATE REQUEST----- 开头 |
error adding extension | 在 OpenSSL 1.0.2 上用了 -addext | 改用配置文件 |
unable to load private key | 私钥带口令 | 加 -passin pass:... 或重新生成 |
| CSR 通过但域名被拒 | 没写 SAN 或只写了 CN | 用 -addext 重新生成 |
确认证书与私钥配对
签发回来后,部署前再确认一次:
openssl req -in request.csr -noout -pubkey
openssl pkey -in privkey.pem -pubout两段输出必须完全一致。不一致就意味着你即将装上一张与密钥不匹配的证书——nginx 的 "key values mismatch" 就是这么来的。
不想在命令行里比对,可以用 密钥匹配工具 在浏览器本地完成,私钥不出本机。
为什么还要用命令行
因为可复现。靠点击表单在笔记本上生成的 CSR 很难审计;写进 runbook 的命令可以被 review、被重跑、被版本化。把命令放在部署脚本旁边,但不要把 privkey.pem 提交进仓库——只有 CSR 可以入库。
常见问题
哪个 OpenSSL 版本支持 -addext?
1.1.1 及以上。CentOS 7 或较老的 macOS 自带版本可能是 1.0.2,没有 -addext,需要改用带 [v3_req] 的配置文件。
为什么传了 -subj,CSR 里还是没有 SAN?
-subj 只设置 subject(CN)。SAN 来自 -addext 或配置文件。只用 -subj 生成的 CSR 会被所有现代 CA 拒绝,因为浏览器不再看 CN。
怎么确认 CSR 与私钥是配对的?
分别导出公钥比对:openssl req -in request.csr -noout -pubkey 与 openssl pkey -in privkey.pem -pubout,两块内容必须完全一致。
CSR 里能放 IP 地址吗?
可以,写成 IP:192.0.2.10。公共 CA 很少给公网 IP 签发,但内部 CA 与测试环境支持。
免费 SSL/TLS 工具
数秒内验证并检查你的证书。
相关证书信息
进一步了解如何选择和购买 SSL 证书。