openssl 生成csr命令:-subj 与 SAN 扩展怎么写?8 个参数、3 类报错与指纹校验(OpenSSL 3.0/1.1.1)
最短可用命令是 openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com' -sha256,其中 -addext 需要 OpenSSL 1.1.1 及以上。 自 Chrome 58 起 CN 不再参与域名匹配,据 CA/Browser Forum Baseline Requirements,所有域名必须写入 SAN 扩展,CN 仅作展示且长度不超过 64 字符。 OpenSSL 1.0.2 与 1.1.0 没有 -addext,只能通过 -config 文件里的 req_extensions 段写 SAN,这是同一命令在两台机器上结果不同的主要原因。 CSR 与私钥是否配对,用 openssl req -in example.com.csr -noout -verify -key example.com.key 检查,输出 verify OK 才算通过;再对 DER 编码做 sha256 得到指纹与 CA 控制台比对。 密钥选型上,RSA 2048 生成通常不到 1 秒,RSA 4096 在低配 vCPU 上可能 1 至 10 秒;ECDSA P-256 为毫秒级且握手更轻,但需确认目标 CA 与旧客户端兼容性。
为什么 openssl 生成 CSR 时总卡在 -subj 和 SAN 上?
因为 CSR 本身就是一个“只管编码、不管合规”的容器。CSR 是 PKCS#10 结构(RFC 2986),由三部分组成:公钥、主题 DN(Subject Distinguished Name)、一组属性扩展(attributes/extensions),最后再用对应私钥做一次自签名。据 OpenSSL 官方 man req 文档,openssl req 的职责只是把这三部分编码成 PEM 或 DER 并输出——它不会替你检查 SAN 是否覆盖了所有要签的域名,更不会检查私钥存在哪、权限是不是 600。所以“openssl 生成csr命令跑通了”和“这份 CSR 能过 CA 审核”是两个独立问题,实际卡点几乎全落在 -subj 与 SAN 上。
问:为什么只写 CN 不写 SAN,公共 CA 直接拒签?
据 CA/Browser Forum Baseline Requirements 与 Chrome 58 之后的策略,证书里的 subjectAltName 是域名匹配的唯一依据,CN 字段只作为展示信息保留,且长度上限为 64 个字符。也就是说哪怕你 -subj "/CN=www.example.com" 写得完全正确,只要 CSR 里没有 SAN,Let’s Encrypt 等公共 CA 都会直接拒签。这是“命令不报错、CA 却不收”的第一大原因。
问:-addext 在我机器上为什么用不了?
OpenSSL 1.1.1 起 req 子命令才新增 -addext 选项,可以在命令行直接追加扩展;1.0.2 与 1.1.0 没有这个选项,只能依赖 -config 文件里的 req_extensions 段。这正是同一条 openssl 生成csr命令在 CentOS 7(默认 1.0.2k)与 Ubuntu 22.04(默认 3.0.x)上表现不一致的根本原因。
| 版本 / 发行版 | req -addext | 默认 openssl.cnf | 追加 SAN 的写法 |
|---|---|---|---|
| OpenSSL 3.0.x(Ubuntu 22.04、Debian 12) | 支持 | /etc/ssl/openssl.cnf | -addext 或 -config |
| OpenSSL 1.1.1(Ubuntu 20.04、Debian 11) | 支持 | /etc/ssl/openssl.cnf | -addext 或 -config |
| OpenSSL 1.0.2k(CentOS 7 默认) | 不支持 | /etc/pki/tls/openssl.cnf | 只能 -config + req_extensions |
| OpenSSL 1.0.2 / 1.1.0(旧容器镜像) | 不支持 | /etc/ssl/openssl.cnf | 只能 -config + req_extensions |
新版本一条命令搞定私钥 + CSR + SAN(-nodes 表示私钥不加密,便于 Nginx 免交互加载):
# 适用 OpenSSL 1.1.1 / 3.0.x;-addext 可重复出现,每行一个扩展
openssl req -new
-newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/OU=Ops/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,IP:192.0.2.10"
-addext "keyUsage=critical,digitalSignature,keyEncipherment"
-addext "extendedKeyUsage=serverAuth"
1.0.2 上同样的意图只能落到配置文件里,注意 [req] 段的 req_extensions 必须指向扩展段名,否则扩展会被静默丢弃:
# 适用 OpenSSL 1.0.2 / 1.1.0;文件名 san.cnf
[req]
distinguished_name = dn
req_extensions = v3_req
prompt = no
[v3_req]
subjectAltName = DNS:example.com,DNS:www.example.com
keyUsage = critical,digitalSignature,keyEncipherment
extendedKeyUsage = serverAuth
# 命令:openssl req -new -newkey rsa:2048 -nodes
# -keyout example.com.key -out example.com.csr
# -config san.cnf -subj "/C=CN/O=Example Ltd/CN=example.com"
# 若在 1.0.2k 上误加了 -addext,真实输出是:
# req: Use -help for summary.
问:-subj 里的斜杠、等号、逗号怎么转义?
-subj 采用 /Type=Value 的斜杠分隔语法,/、+、=、, 都是保留字符;值里出现这些字符必须转义,外层还要处理 shell 引号。所以“命令没报错但字段错位”(典型是 OU 跑进 O、CN 被截断)几乎都是转义层级没算对。
# 外层双引号交给 shell,内层 / 交给 OpenSSL 解析
openssl req -new -key example.com.key -out x.csr
-subj "/C=CN/O=A/B Testing Ltd/CN=example.com"
问:-newkey 和 -key 能一起用吗?
不能。私钥与 CSR 必须成对产生:-newkey 会现场生成密钥并顺带产出 CSR,再给 -key 指定已有私钥属于语义冲突,OpenSSL 3.x 会直接报 Cannot use both -key and -newkey 并终止。批量脚本里这种写法最容易留下“CSR 与私钥对不上、事后无法复现”的残局。另外,交互式执行 openssl req -new 时会读取 OPENSSLDIR 下的 openssl.cnf,其中 [req_distinguished_name] 的默认值会被悄悄带进 CSR,导致 CN 与预期不一致;用 openssl version -d 可直接打印该目录(Debian/Ubuntu 常见 /etc/ssl,RHEL/CentOS 为 /etc/pki/tls)。
问:怎么确认 SAN 真写进去了、私钥真的配对?
两条命令就够,别等 CA 打回来才发现:
# 1) 自签名校验 + 查看 SAN 是否落地
openssl req -in example.com.csr -noout -text -verify
# 期望输出包含:
# verify OK
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com, IP Address:192.0.2.10
# 2) 公钥指纹对拍:CSR 与私钥的 SHA256 必须完全一致
openssl req -in example.com.csr -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
# 常见真实报错:把 DER 当 PEM 读
# ...:error:0909006C:PEM routines:get_name:no start line:../crypto/pem/pem_lib.c:745:
# Expecting: CERTIFICATE REQUEST
这条指纹校验流程同样适用于后续把 CSR 提交给 ACME 客户端、或手工比对证书链中的公钥——只要两行 SHA256 不一致,说明私钥与 CSR 从一开始就不是一对,此时重跑 openssl 生成csr命令比继续排查 CA 端配置要快得多。
openssl 生成csr命令的完整实操步骤是怎样的?
下面 6 步是一条可复现的完整链路。顺序不能颠倒:先确认版本,才能判断能不能用 -addext;先收紧 umask,才能保证私钥写入磁盘那一刻就是 600。这两点决定了后面所有命令是否有效,而不只是操作习惯问题。
- 确认版本与配置路径。先运行
openssl version -a看版本号和编译参数,再运行openssl version -d拿到OPENSSLDIR:# 版本号、编译日期、编译参数(确认是否 enable-fips 等定制) openssl version -a # 只输出默认配置目录,openssl.cnf 一般就在其下 openssl version -d典型输出为
OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)和OPENSSLDIR: "/usr/lib/ssl"。建议使用 1.1.1w 或 3.0.13 及以上版本。1.0.2 系列已于 2019 年 12 月 31 日停止公共支持,见 OpenSSL 官方公告;该系列没有-addext,写 SAN 只能退回-config配合req_extensions。 - 先收紧权限,再生成私钥。
umask 077只影响当前 shell 会话,必须和生成私钥的命令放在同一个会话里:umask 077 # 关键行:此后新建文件默认 600 # RSA 2048(PKCS#8 输出,OpenSSL 3.0 起 genpkey 默认即 PKCS#8) openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key # 或 ECDSA P-256 openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out example.com.key ls -l example.com.key # 期望 -rw------- 1 user user 1704 ...RSA 2048 的 PKCS#8 文件约 1704 字节,P-256 约 241 字节。据 OpenSSL 3.0 文档,
genpkey默认输出BEGIN PRIVATE KEY;而openssl genrsa在 1.1.1 输出的是传统BEGIN RSA PRIVATE KEY,3.0 起才改为 PKCS#8,跨版本脚本要留意这个差异。 - 准备主题字段。
C用 ISO 3166-1 两位码(如CN),ST/L用拼音或英文,O用组织全称,OU可省略,CN填主域名。据 RFC 5280 的ub-common-name约束,CN 上限 64 字符;值里若出现/必须转义成/。中文值需加-utf8,但多数公共 CA 会拒绝非 ASCII 字段,跨境签发建议全用 ASCII,国际化域名按 A-label(xn--)填写。 - 生成 CSR。这是最核心的一条 openssl 生成csr命令,
-addext自 1.1.1 起可用:openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/OU=Ops/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com' -sha256-sha256在 1.1.1/3.0 的默认openssl.cnf中已是default_md = sha256,仍建议显式写出,便于审计和代码评审。注意-addext只影响 CSR 的请求扩展;CA 是否原样复制进证书由 CA 决定,据 Let’s Encrypt 文档,其签发的证书只包含 CSR 中提交的 SAN 列表。 - 本地自检。两条命令分别验证「签名有效且私钥匹配」和「字段逐项正确」:
# 校验 CSR 自签名,并确认与私钥配对 openssl req -in example.com.csr -noout -verify -key example.com.key # 逐行核对 Subject、Public Key Algorithm、X509v3 Subject Alternative Name openssl req -in example.com.csr -noout -text若私钥与 CSR 不匹配,会直接报
error:...:key values mismatch;若 CSR 文件被截断,则报error:...:ASN1_CHECK_TLEN:wrong tag。 - 交付与留痕。只把
.csr交给 CA,私钥留在本机或 HSM。记录 CSR 的 SHA-256 摘要:# DER 编码后做摘要,输出形如 SHA2-256(stdin)= 3f2a... openssl req -in example.com.csr -outform DER | openssl dgst -sha256更严格的核对方式是比对公钥指纹:
openssl req -in example.com.csr -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256,与 CA 回显值或签发后证书的公钥指纹一致,即可确认文件未被中间环节替换。
| 对比项 | RSA 2048 | ECDSA P-256 |
|---|---|---|
| 生成命令关键参数 | -algorithm RSA -pkeyopt rsa_keygen_bits:2048 |
-algorithm EC -pkeyopt ec_paramgen_curve:P-256 |
| 私钥文件大小(PKCS#8) | 约 1704 字节 | 约 241 字节 |
| 安全强度 | 约 112 位 | 约 128 位 |
| 握手与签名开销 | 较高 | 明显更低 |
| 兼容性风险 | 几乎无 | 极老客户端(如 Windows XP、Android 4.x 之前)不支持 |
| CSR 生成后续步骤 | 第 4~6 步命令完全相同,仅 -key 指向的文件不同 |
|
一个高频误区:
openssl req -new -newkey rsa:2048 -nodes -keyout ...能把「生成私钥 + 生成 CSR」一步完成,但-nodes意味着私钥明文写入磁盘,且该命令同样受当前umask影响。生产环境仍建议拆成第 2 步和第 4 步,便于在两步之间插入权限检查与密钥托管流程。
openssl 生成csr命令有哪些可直接抄的配置与命令示例?
示例 A:单域名 + SAN,一条命令跑完(RSA 2048,OpenSSL 1.1.1 / 3.0 通用)
这是最常见的 openssl 生成csr命令写法。据 OpenSSL 官方 req(1) 手册,-addext 从 1.1.1 起才支持,用于在命令行直接追加 X.509v3 扩展,省去写配置文件;-nodes 表示私钥不加密(3.0 起官方推荐改用 -noenc,两者等价),这样 Nginx、HAProxy 启动时不需要交互输入口令,但代价是私钥以明文落盘,必须配合 chmod 600。
# -newkey rsa:2048 生成新私钥;-nodes 私钥不加密;-sha256 为默认摘要,可省略
# -addext 追加 SAN,多个 DNS 用逗号分隔,不加空格
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/O=Example/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
-sha256
chmod 600 example.com.key # 明文私钥务必收紧权限
注意:-subj 里的 CN 现代浏览器早已不看,只作展示;据 RFC 5280 与 CA/Browser Forum 基线要求,主机名校验一律以 SAN 为准,因此 CN=example.com 必须同时出现在 SAN 里,否则 Let’s Encrypt 等 CA 会直接拒绝签发。
示例 B:已有 ECDSA 私钥,补签 CSR(含通配符)
# 私钥已存在时不要加 -newkey,否则会覆盖;P-256 私钥由 CA 侧校验曲线
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/O=Example/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:*.example.com,DNS:api.example.com'
通配符只覆盖一级标签:*.example.com 匹配 a.example.com,不匹配 a.b.example.com,也不能写成 *.*.example.com——这条规则出自 RFC 6125 第 6.4.3 节,各家 CA 与浏览器实现一致。
示例 C:用 -config 模板,兼容 OpenSSL 1.0.2
1.0.2 没有 -addext,只能靠配置文件注入扩展。据 OpenSSL 文档,default_bits 默认 2048、default_md 在 1.0.2 中默认为 sha1(1.1.1 起改为 sha256),所以老版本必须显式写 default_md=sha256。
# san.cnf
[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
req_extensions = req_ext # 关键:把扩展带进 CSR
[dn]
C = CN
ST = Zhejiang
L = Hangzhou
O = Example
CN = example.com
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
IP.1 = 203.0.113.10 # 需覆盖 IP 访问时加这一行
openssl req -new -key example.com.key -config ./san.cnf -out example.com.csr
示例 D:只校验、不生成
# 输出 RFC2253 顺序(C 在最前),便于和 CA 控制台逐字段核对
openssl req -in example.com.csr -noout -subject -nameopt RFC2253
# 输出:subject=CN=example.com,O=Example,C=CN
# 直接抓 SAN 列表;-A1 带出下一行
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
若 SAN 缺失,这里会什么都抓不到——这是”CSR 提交后证书没有 www 域名”最常见的原因。
示例 E:CSR 指纹比对(与 CA 控制台核对)
# 先转 DER 再取 SHA-256,得到 64 位十六进制,与 CA 页面显示的指纹逐字符比对
openssl req -in example.com.csr -outform DER | openssl dgst -sha256
# 输出示例:SHA2-256(stdin)= 3f2a9c...(64 hex)
示例 F:私钥与 CSR 公钥比对(比 verify OK 更直观)
# 两侧公钥 DER 的 SHA-256 必须完全一致,说明 CSR 确实由这把私钥生成
openssl req -in example.com.csr -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
| 写法 | 最低版本 | 适用场景 | 局限 / 真实报错 |
|---|---|---|---|
-subj |
0.9.5+ | 脚本化,免交互 | 不支持多值 RDN |
-addext |
1.1.1+ | 单条命令带 SAN | 1.0.2 上报 unknown option -addext |
-config + req_extensions |
0.9.8+ | 多域名、IP、老系统 | 漏写 req_extensions 则 SAN 不进 CSR |
-nodes / -noenc |
1.0.0 / 3.0+ | 服务自动加载私钥 | 私钥明文,需 600 权限 |
生成方式与密钥算法怎么选?参数对比表
问:openssl 生成csr命令到底有几种写法,为什么同样的域名,不同教程给出的命令差别那么大?答:差别主要来自两处——DN 与 SAN 的传入方式,以及私钥算法。先把选型讲清楚,再谈参数细节。
一、生成方式选型(谁适合用哪种)
| 场景 | 命令片段 | 版本要求 | 可重复性 | 常见坑 |
|---|---|---|---|---|
| 单条命令快速签发 | -subj ... -addext ... |
1.1.1+ | 中(需处理转义) | / 与 = 未转义导致字段错位,CN 被截断 |
| 模板化批量 | -config san.cnf |
1.0.2+ | 高 | req_extensions 段名拼错,CSR 里静默没有 SAN |
| 交互式 | 仅 openssl req -new |
全版本 | 低 | 括号里的默认值被直接回车写入 DN,事后无法改 |
| 旧版补 SAN | -extfile 文件 |
1.0.2+ | 高 | 只给 -extfile 不给 -config,DN 变空 |
最快的一条路是单条命令,OpenSSL 1.1.1 起才支持 -addext:
# OpenSSL 1.1.1 / 3.0 通用;-nodes 表示私钥不加密(便于自动化)
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/O=Example Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,IP:203.0.113.10"
需要固定模板时改用配置文件,可重复性最高:
# san.cnf —— req_extensions 的段名必须与下面 [v3_req] 完全一致
[req]
default_md = sha256
prompt = no
distinguished_name = dn
req_extensions = v3_req # 拼错此行,CSR 将不含 SAN
[dn]
CN = example.com
[v3_req]
subjectAltName = @alt
basicConstraints = critical,CA:FALSE
[alt]
DNS.1 = example.com
DNS.2 = www.example.com
IP.1 = 203.0.113.10
openssl req -new -key example.com.key -out example.com.csr -config san.cnf
openssl req -in example.com.csr -noout -text | grep -A1 "Alternative Name" # 自检
二、密钥算法怎么选
| 算法 | 生成耗时量级 | CSR 体积(PEM) | 握手开销 | CA 与客户端兼容性 |
|---|---|---|---|---|
| RSA 2048 | 0.1–1 秒 | 约 1.7 KB | 中 | 兼容面最广,默认首选 |
| RSA 3072 | 0.5–3 秒 | 约 2.1 KB | 略高 | 主流 CA 均支持 |
| RSA 4096 | 1–10 秒 | 约 2.7 KB | 明显更高 | 支持,但握手与签名更慢 |
| ECDSA P-256 | 毫秒级 | 约 0.6 KB | 低 | 现代 CA 普遍支持;需留意老旧 Android 与 Windows 客户端 |
耗时取决于机器熵与 CPU,可用 openssl speed rsa2048 自测。摘要算法上,OpenSSL 1.1.1 起 openssl.cnf 中 default_md 显式为 sha256,CSR 签名即 sha256WithRSAEncryption 或 ecdsa-with-SHA256;SHA-1 已被主流浏览器与 CA 拒绝,不应出现在新 CSR 中,可用 openssl req -in x.csr -noout -text 查看 “Signature Algorithm” 行核对。
两个易错点:其一,-addext 可重复出现多次,每个扩展写一条,例如再追加 -addext "basicConstraints=critical,CA:FALSE";不要在一个字符串里用逗号拼接两个扩展,OpenSSL 会当成同一扩展的值解析。其二,若计划部署 OCSP Must-Staple,可在 CSR 阶段用 -addext "tlsfeature=status_request"(OID 1.3.6.1.5.5.7.1.24)提出请求,但据 RFC 7633,是否写入证书由 CA 决定,签发后必须用 openssl x509 -in cert.pem -noout -text 确认 TLS Feature 扩展存在。
顺带说明:据 Let’s Encrypt 文档,其 ACME 客户端 certbot 会自动生成私钥与 CSR,90 天有效期场景下手写 openssl 生成csr命令并非必需;手写方式更适合商业 OV/EV 证书、内网 CA 或需要固定模板的批量场景。另外,据 RFC 5280,现代校验逻辑以 SAN 为准、CN 仅作兜底,所以无论选哪种生成方式,都别省掉 SAN 扩展。
openssl 生成csr命令常见报错有哪些,怎么排查?
用 openssl 生成csr命令 时,失败输出基本集中在四类:版本不支持、-subj 转义、扩展段解析、文件类型用错。排查第一步永远是确认版本——据 OpenSSL 1.1.1 的 CHANGES 记录,-addext 选项正是从 1.1.1 才引入的:
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
openssl version -a
# 输出示例:OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
# 1.1.1w / 3.0.13 / 3.2.x 支持 -addext;1.1.0 及更早不支持
| 报错关键行 | 根因 | 定位命令 |
|---|---|---|
Unknown option or ciphersuite: -addext |
OpenSSL 低于 1.1.1 | openssl version |
ASN1_mbstring_ncopy:masked tag out of range |
-subj 中的 /、, 未转义 |
回显 -subj 字符串逐字段核对 |
verify failure |
CSR 与 -key 私钥不配对 |
openssl req -in x.csr -noout -verify -key x.key |
string too long / maxsize=64 |
CN 超过 64 字符 | 数 CN 字符数(RFC 5280 附录 A 规定上限 64) |
Error adding extensions from section req_ext |
段名拼写不一致,或值里混入中文逗号 | -config 试运行 |
unable to load certificate |
把 .csr 交给了 openssl x509 |
改用 openssl req -text |
报 Unknown option or ciphersuite: -addext 怎么办?说明你的 OpenSSL 太老。要么升级到 3.0.13 以上重跑,要么退回 -config 模板,把 SAN 写进 req_extensions:
# san.cnf —— 老版本 OpenSSL 的 SAN 写法
[req]
distinguished_name = dn
req_extensions = req_ext # 关键行:必须与下方段名逐字符一致
prompt = no
[dn]
C = CN
O = Example Inc
CN = example.com
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
openssl req -new -key example.key -out example.csr -config ./san.cnf
报 problems making Certificate Request 后跟 ASN1_mbstring_ncopy:masked tag out of range?几乎都是 -subj 里的分隔符没转义,O=Example/Inc 会被解析成两个字段。把值里的斜杠写成 /,逗号写成 ,:
# 错误:O=Example/Inc 被当成两个 RDN
-subj "/C=CN/O=Example/Inc/CN=example.com"
# 正确:值内分隔符反斜杠转义
-subj "/C=CN/O=Example/Inc/CN=example.com"
报 verify failure?CSR 与 -key 指定的私钥不匹配,最常见于覆盖生成了新私钥却复用旧 CSR。用公钥 SHA-256 指纹交叉比对,两者一致才算配对:
openssl req -in example.csr -noout -verify -key example.key # 配对输出 verify OK
openssl req -in example.csr -noout -pubkey | openssl sha256 # CSR 内公钥指纹
openssl pkey -in example.key -pubout | openssl sha256 # 私钥导出公钥指纹
# 两个指纹不同 => 只能重新生成一对密钥和 CSR
报 Error adding extensions from section req_ext?是 [req_ext] 段名与 req_extensions 的值不一致,或 DNS.1 = example.com,DNS.2 = ... 用了中文逗号导致整串被当成一个域名。先不带 -out 试运行,报错即止,不会留下半成品文件:
openssl req -new -key example.key -config ./san.cnf -noout -text
# 解析通过会直接打印待签发的 subject 与 SAN 列表
CN 报 string too long 或 maxsize=64?X.509 的 commonName 上限就是 64 字符,把整串域名或带部门前缀的字符串塞进 CN 必然溢出。据 CA/Browser Forum 基线要求,2017 年 3 月起证书必须含 SAN,CN 已非必需,长域名一律移到 SAN,CN 只留主域名。
报 unable to load certificate / Could not read certificate?这是把 CSR 当成证书交给 x509 子命令了,典型输出 error:0909006C:PEM routines:get_name:no start line。CSR 只能用 req 子命令查看:
openssl x509 -in example.csr -noout -text # 错:CSR 不是证书
openssl req -in example.csr -noout -text # 对:查看 subject / SAN / 公钥
另有一类 Error opening Private Key ... No such file or directory,与 OpenSSL 无关:ls -l example.key 检查路径与属主,确认当前执行用户有读权限即可。
怎么验证 openssl 生成的 CSR 真的正确、且与最终证书一致?
第一层:先验签名,再验配对。据 OpenSSL 官方 openssl-req(1) 文档,-verify 只校验 PKCS#10(RFC 2986)里的自签名,不能证明私钥与 CSR 是一对;必须追加 -key 才会做公私钥匹配检查。
# 只验自签名:OpenSSL 1.1.1 输出 "verify OK",3.0 输出 "Certificate request self-signature verify OK"
openssl req -in example.com.csr -noout -verify
# 加 -key 才校验配对:私钥不匹配时报 "key values mismatch" 并返回非 0
openssl req -in example.com.csr -noout -verify -key example.com.key
第二层:验内容三项。-text 的输出里只需盯三处:Signature Algorithm 应为 sha256WithRSAEncryption 或 ecdsa-with-SHA256(SHA-1 已被 CA/Browser Forum 基线要求淘汰);Public-Key 位数与曲线符合预期;X509v3 Subject Alternative Name 一个不多一个不少。
openssl req -in example.com.csr -noout -text | grep -E -A1 'Signature Algorithm|Public-Key|NIST CURVE|Subject Alternative Name'
# 期望片段:DNS:example.com, DNS:www.example.com(通配符写作 DNS:*.example.com)
第三层:指纹比对。CSR 的指纹是对 DER 编码算的,PEM 的换行差异不影响结果,但被工具重新编码(例如追加属性)就会变。据 openssl-dgst(1),1.1.0 起 dgst 默认摘要已是 SHA-256,仍建议显式写算法便于审计;MD5/SHA-1 只作辅助,不可作为主校验。
openssl req -in example.com.csr -outform DER | openssl dgst -sha256
# 与 CA 控制台回显逐字符比对;辅助校验(仅排错用):
openssl req -in example.com.csr -outform DER | openssl dgst -md5
第四层:签发结果与私钥同源。证书下来后先核 SAN,再验链,最后比对公钥指纹——这一步才能抓住「换了证书但忘了换私钥」。
openssl x509 -in example.com.crt -noout -text | grep -A1 'Subject Alternative Name'
openssl verify -CAfile chain.pem example.com.crt
# 通过:example.com.crt: OK
# 失败:error 20 at 0 depth lookup: unable to get local issuer certificate(chain.pem 缺中间证书)
# 公钥同源比对:两行输出必须完全一致
openssl req -in example.com.csr -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256
openssl x509 -in example.com.crt -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256
第五层:线上验证。-servername 默认不发送,多域名/多证书站点不写就会命中默认证书。
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -dates -ext subjectAltName
# -ext 需 OpenSSL 1.1.1 及以上;输出日期应为新证书的 Not After
第六层:归档。把 CSR 指纹、证书序列号与有效期写入工单或 CMDB,续期时直接比对:openssl x509 -in example.com.crt -noout -serial -dates -fingerprint -sha256。
| 层 | 检查对象 | 通过标志 | 典型失败输出 |
|---|---|---|---|
| 1 | 自签名 + 私钥配对 | verify OK | key values mismatch |
| 2 | 算法 / 位数 / SAN | sha256 系 + 域名齐全 | SAN 缺 www 或多余项 |
| 3 | DER SHA-256 指纹 | 与 CA 回显一致 | 指纹不符(文件被改) |
| 4 | 证书 SAN、链、公钥 | example.com.crt: OK | error 20 unable to get local issuer certificate |
| 5 | 线上实际返回 | Not After 为新日期 | 返回旧证书/默认证书 |
| 6 | 序列号与有效期归档 | 可追溯、可对比 | 无记录,续期无法核对 |
几十个域名要批量生成 CSR,脚本怎么写才不出错?
批量生成 CSR 时,真正导致失败的原因通常不在 openssl 生成csr命令 本身,而在循环中未对变量做校验,也未按错误类型分类处理:一个空行会生成一个 CN 为空的 CSR,一个带空格或下划线的域名会让 CA 在验证阶段直接拒绝,而把“版本不支持”当作“临时故障”重试,则会让脚本无休止地反复执行。下面的骨架假设输入文件 domains.txt 每行一个 FQDN,兼容 OpenSSL 1.1.1 与 3.0。
#!/usr/bin/env bash
# batch-csr.sh —— 适用 OpenSSL 1.1.1 / 3.0.x
set -euo pipefail # 任一命令失败、变量未定义、管道中间失败都立刻退出
umask 077 # 新建私钥权限 0600,同机其他用户不可读
OUT="${1:-./out}"; mkdir -p "$OUT"
printf 'domain,fingerprint,key_path,csr_path,created_atn' > "$OUT/manifest.csv"
while IFS= read -r d || [[ -n "$d" ]]; do # 末行无换行也能读到
d="${d%%#*}"; d="$(printf '%s' "$d" | tr -d '[:space:]')" # 去注释、去空白
[[ -z "$d" ]] && continue # 空行直接跳过,杜绝空 CN
if [[ ! "$d" =~ ^([a-z0-9]([a-z0-9-]*[a-z0-9])?.)+[a-z]{2,}$ ]]; then
echo "[SKIP] 非法域名: $d" >&2; continue # 拦截空格、下划线、大写、通配符
fi
key="$OUT/$d.key"; csr="$OUT/$d.csr"
# 每个域名独立私钥:genpkey 的 rsa_keygen_bits 默认 2048
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out "$key"
# -addext 需 OpenSSL ≥ 1.1.1;-sha256 在 1.1.1/3.0 已是默认摘要,显式写出防 openssl.cnf 覆盖
openssl req -new -key "$key" -out "$csr" -sha256
-subj "/C=CN/O=Example/CN=$d"
-addext "subjectAltName=DNS:$d,DNS:www.$d"
# 对 CSR 的 DER 编码求 SHA-256,用于和 CA 回执核对(注意这不是证书指纹)
fp=$(openssl req -in "$csr" -outform DER | openssl dgst -sha256 | awk '{print $2}')
printf '%s,%s,%s,%s,%sn' "$d" "$fp" "$key" "$csr" "$(date -u +%FT%TZ)" >> "$OUT/manifest.csv"
done < "${2:-domains.txt}"
关于 -subj 与 SAN 的关系:据 CA/Browser Forum Baseline Requirements(v1.4.1 起),自 2017 年起 CN 已是可选字段,浏览器只认 SAN 中的 DNS 条目,因此 -addext "subjectAltName=DNS:..." 才是关键,CN 只是给人工核对用的冗余。若目标 CA 是 Let’s Encrypt,据其官方文档,通配符证书必须用 DNS:*.example.com 且只能走 DNS-01 验证,此时脚本里的正则要额外放行 *. 前缀。
私钥绝不能跨域名复用。一把 key 对应 N 张证书,等于一次泄露就要吊销 N 张。代价是生成时间:RSA 2048 在 2 vCPU 云主机上约 0.1–1 秒/个,RSA 4096 约 1–10 秒/个,50 个域名串行用 4096 位可能超过 3 分钟。可改用 xargs -P 4 并发,但要先确认熵源:cat /proc/sys/kernel/random/entropy_avail 持续高于 1000 才算充裕,容器或克隆镜像中熵不足会让所有进程一起卡在 genpkey。并发时不要共写一个 CSV,多进程 >> 可能交错成半行,改成每个任务写 $d.row 再 cat 合并:
# 4 路并发;-I{} 逐行替换占位符,-r 空输入不执行
grep -vE '^[[:space:]]*(#|$)' domains.txt | xargs -r -P4 -I{} bash -c '
d="$1"
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:4096 -out "$d.key" &&
openssl req -new -key "$d.key" -out "$d.csr" -sha256
-subj "/C=CN/O=Example/CN=$d" -addext "subjectAltName=DNS:$d,DNS:www.$d" &&
openssl req -in "$d.csr" -outform DER | openssl dgst -sha256 | awk -v n="$d" "{print n","$2}" > "$d.row"
' _ {}
失败要按错误类型分流,而不是无差别重试。把 stderr 关键字映射到处理策略,比 for i in 1 2 3 可靠得多:
| 典型报错(stderr 关键字) | 根因 | 正确处理 |
|---|---|---|
req: Unknown option "addext" |
OpenSSL < 1.1.1,无 -addext |
版本问题,重试无意义;升级,或改用 -config 配合 -extensions |
verify failure / key values mismatch |
key 与 csr 不配对(覆盖、拷贝错文件) | 文件配对问题,必须删掉重生成 |
unable to load Private Key |
路径错、权限 0600 但属主不对、文件被截断 | 修正路径/属主,不重试 |
error:…:digital envelope routines::unsupported |
OpenSSL 3.0 下旧配置引用了 legacy provider | 加载 -provider legacy 或更换算法 |
| ACME/HTTP 类网络错误(提交阶段) | 传输层抖动、限流 | 指数退避重试,且只重试这一段 |
最后一步校验建议独立于生成脚本运行:openssl req -in "$d.csr" -noout -subject -ext subjectAltName 应打印出与 domains.txt 完全一致的 CN 和 SAN 列表,OpenSSL 3.0 下输出形如 X509v3 Subject Alternative Name: DNS:a.example.com, DNS:www.a.example.com;若看到 Requested Extensions 为空,说明 -addext 没生效——通常是被 openssl.cnf 中的 req_extensions 覆盖,需要加 -config /dev/null 或显式指定配置文件。
CSR 交给 CA 之后,还有哪些合规与有效期问题要注意?
CSR 只是“申请表”,不是合同。CA 收到后完全可以重排 DN 的 RDN 顺序、删掉它不认可的 SAN、用自家模板覆盖 keyUsage / extendedKeyUsage,甚至在 DV 场景下追加未在 CSR 里出现的域名。判断合规性必须以签发的证书为准,而不是 CSR。据 CA/Browser Forum Baseline Requirements 与 RFC 5280,证书的 Subject 只保证“语义等价”,不保证字节级一致,所以任何下游系统(如按字符串匹配 DN 的准入网关)都可能被 CA 的规范化动作打断。
| 项目 | CSR 里的写法 | CA 实际签发 | 风险点 |
|---|---|---|---|
| DN 顺序 | /C=CN/ST=Zhejiang/O=.../CN=example.com |
常被重排或补 serialNumber |
按字符串比对 DN 会失配,应按 OID 解析 |
| SAN | DNS:example.com,DNS:www.example.com |
DV 仅保留已验证项 | 多写的域名会被静默删除 |
| 有效期 | CSR 不含此字段 | 由 CA 与 CABF 上限决定 | 无法在申请阶段锁定 |
| CT 日志 | 无法指定 | CA 用预证书提交(RFC 6962) | SCT 数量与日志由 CA 决定 |
| OCSP Must-Staple | tlsfeature=status_request |
支持则保留,不支持则丢弃 | 必须签发后复查 |
有效期正在快速缩短。据 CA/Browser Forum 2025 年通过的 Ballot SC-081 决议,公共 TLS 证书最长有效期将从 398 天分三步压缩到 200 天(2026-03-15 起)、100 天(2027-03-15 起)、47 天(2029-03-15 起),同时域名/IP 验证数据复用期也会同步收紧。这意味着手工填 DN 的频率会成倍上升,把 openssl 生成csr命令 固化成带变量的模板脚本,比每次复制粘贴更可靠。免费 DV 场景下 Let’s Encrypt 证书固定 90 天,certbot 会自动完成密钥与 CSR 生成,手写 openssl req 更多用于商业 OV/EV、内网私有 CA,或需要固定主题字段的合规环境。
# 模板化生成 CSR:OpenSSL 1.1.1 与 3.x 均适用(-addext 自 1.1.1 起提供)
# 关键行:tlsfeature=status_request 即 OCSP Must-Staple,需 CA 支持才会写进证书
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Co., Ltd./CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
-addext "tlsfeature=status_request"
# 核对 CSR 实际请求的扩展(应看到 TLS Feature: status_request)
openssl req -in example.com.csr -noout -text | sed -n '/Requested Extensions/,/Signature Algorithm/p'
# 签发后核对:扩展是否被保留、真实到期时间
openssl x509 -in fullchain.pem -noout -text | grep -A1 -E "TLS Feature|Not After"
openssl x509 -in fullchain.pem -noout -enddate
私钥在哪里生成,决定安全等级。高安全场景应在 HSM 或支持 PKCS#11 的设备内生成密钥,私钥永不出设备,CSR 只带走公钥。OpenSSL 3.x 通过 provider 加载(pkcs11-provider),1.1.1 走 libp11 的 engine 接口:
# OpenSSL 3.x + pkcs11-provider:私钥驻留 HSM,-key 直接引用 PKCS#11 URI
openssl req -new -key "pkcs11:object=tls-key;type=private"
-out hsm.csr -subj "/CN=example.com"
-addext "subjectAltName=DNS:example.com"
主题字段必须与资质一致。OV/EV 证书的 O、C、ST、L 会与工商登记信息逐字比对,填简称、拼音缩写或英文译名常导致审核退回,整体延长 1 至 3 个工作日;企业名称中的括号、& 等字符也应与执照保持原样。
Must-Staple 要在部署侧闭环。CT 日志与 OCSP 响应由 CA 写入,不在 CSR 阶段决定;但 Must-Staple 一旦生效而服务器未装订 OCSP 响应,客户端会直接握手失败。Nginx 需开启 ssl_stapling on(默认 off)与 ssl_stapling_verify on,并配置 resolver,随后用 openssl s_client -connect example.com:443 -status 确认返回 OCSP Response Status: successful (0x0) 且 OCSP response: no response sent 不再出现。HAProxy 则对应 ocsp-update on(2.8 起支持自动更新)。
最少是 openssl req -new -key 私钥路径 -out 输出.csr -subj 主题串,但这样不会带 SAN,公共 CA 会拒签。实际使用建议再加 -addext 'subjectAltName=DNS:域名' 与 -sha256,且 -addext 需要 OpenSSL 1.1.1 及以上版本。
说明当前 OpenSSL 低于 1.1.1,用 openssl version 可以确认。两条路:升级到 3.0.13 以上,或改用 -config 文件,在 [req] 段写 req_extensions=req_ext,在 [req_ext] 段写 subjectAltName=@alt_names,再在 [alt_names] 段逐条列 DNS.1、DNS.2。
对公共信任证书不行。据 CA/Browser Forum Baseline Requirements 与 Chrome 58 之后的策略,域名匹配只看 SAN,CN 仅作展示且不超过 64 字符。内网自签证书若客户端明确只校验 CN 才可例外,但主流浏览器与 Java 客户端同样会检查 SAN。
OpenSSL 跨平台、可脚本化、能直接控制 SAN 与扩展,适合 Linux 批量场景;keytool 面向 JKS/PKCS12 密钥库,CSR 与私钥绑定在 keystore 内,适合 Tomcat 等 Java 应用;IIS certreq 与 Windows 证书存储集成,适合纯 Windows 环境。三者生成的 CSR 都是 PKCS#10,CA 端可通用,差别在私钥存放位置与后续导出格式。
运行 openssl req -in example.com.csr -noout -verify -key example.com.key,输出 verify OK 表示配对且签名有效。更直观的做法是分别导出公钥做 sha256:openssl req -in example.com.csr -noout -pubkey | openssl sha256 与 openssl pkey -in example.com.key -pubout | openssl sha256,两条哈希完全一致才算匹配。
CA 会对主题与扩展做规范化,例如去掉内网域名、把大写转小写、按策略补充 CT 相关扩展,部分 CA 还会把 CN 同步写入 SAN。收到证书后用 openssl x509 -in example.com.crt -noout -text 核对 SAN 列表,若缺少必要域名应在上线前联系 CA 重签,而不是直接部署。
技术上可以,因为 CSR 只包含公钥与主题信息,CA 每次签发都会生成新的序列号与有效期。但私钥复用会扩大泄露影响面,且不同 CA、不同有效期的证书混用会增加续期与吊销管理成本,生产环境建议一个域名一份私钥一份 CSR。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。