跳到主要内容
基础知识

openssl 生成csr命令:-subj 与 SAN 扩展怎么写?8 个参数、3 类报错与指纹校验(OpenSSL 3.0/1.1.1)

openssl 生成csr命令 — 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。这两点决定了后面所有命令是否有效,而不只是操作习惯问题。

  1. 确认版本与配置路径。先运行 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。

  2. 先收紧权限,再生成私钥。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,跨版本脚本要留意这个差异。

  3. 准备主题字段。C 用 ISO 3166-1 两位码(如 CN),ST/L 用拼音或英文,O 用组织全称,OU 可省略,CN 填主域名。据 RFC 5280 的 ub-common-name 约束,CN 上限 64 字符;值里若出现 / 必须转义成 /。中文值需加 -utf8,但多数公共 CA 会拒绝非 ASCII 字段,跨境签发建议全用 ASCII,国际化域名按 A-label(xn--)填写。
  4. 生成 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 列表。

  5. 本地自检。两条命令分别验证「签名有效且私钥匹配」和「字段逐项正确」:
    # 校验 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。

  6. 交付与留痕。只把 .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 才引入的:

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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。