跳到主要内容
基础知识

openssl 命令在线生成怎么用?CSR、自签证书与证书链的实操清单(OpenSSL 3.0)

openssl 命令在线生成 — openssl 命令在线生成怎么用?CSR、自签证书与证书链的实操清单(OpenSSL 3.0)
核心结论

一句话结论:在线生成 openssl 命令只是参数模板工具,只应产出命令文本,绝不能上传私钥;把生成的命令复制回本机执行即可,例如 openssl req -new -newkey rsa:2048 -sha256 -nodes -keyout example.com.key -out example.com.csr -subj “/C=CN/O=Example Ltd/CN=example.com” -addext “subjectAltName=DNS:example.com,DNS:www.example.com”,OpenSSL 1.1.1+ 下约 2 分钟、0 成本完成。 版本决定参数是否可用:OpenSSL 3.0.x 与 1.1.1 支持 -addext;CentOS 7 自带的 1.0.2k 不支持,必须改用 -config san.cnf 的 req_extensions 写法,先跑 openssl version -a 确认版本。 算法开销差异明显:ECDSA P-256 密钥生成小于 1 秒、签名约 70 字节;RSA 2048 生成 0.1–1 秒、签名 256 字节;RSA 4096 生成需 5–30 秒、握手 CPU 约为 2048 的 3–4 倍,无合规要求不必上 4096。 有效期别照抄 3650 天:公开信任 TLS 证书受 Apple/Chrome 398 天上限约束,CA/B Forum SC-081 计划 2026-03-15 起降至 200 天、2027 年起 100 天、2029 年起 47 天,-days 只对自签证书有意义。 验证三连:openssl x509 -noout -dates -ext subjectAltName、openssl verify -CAfile root.pem -untrusted chain.pem cert.pem、openssl s_client -connect example.com:443 -servername example.com -status,分别确认有效期、链完整性与 OCSP 装订状态。

为什么大家搜「openssl 命令在线生成」?4 个根因与版本碎片化现状

搜「openssl 命令在线生成」的人,多半不是想偷懒,而是被三件事同时绊住了:本机版本和教程对不上、参数少写一个只回一句没有指向性的提示、以及一年只签发一两张证书根本记不住语法。先给结论:在线生成器的正确用法是只让它把命令拼好,复制回本机 shell 执行,全程约 2 分钟、成本 0 元,私钥始终不出本机——这比在浏览器里点“直接生成证书”更符合运维规范,也方便把命令原样写进变更记录。

问:为什么同一段命令同事能跑通,在我机器上直接报错?

首要根因是版本碎片化。据 OpenSSL 官方发布记录,3.0 分支仍在各 LTS 发行版中广泛使用,但小版本与选项集差异明显;更麻烦的是 CentOS 7 仍停留在 1.0.2k,而 1.0.2 系列根本不支持 -addext,照抄 3.0 教程必然失败。

平台 / 发行版 默认 OpenSSL 支持 -addext 实操备注
Ubuntu 22.04 LTS 3.0.2 是 3.0 早期版本,部分选项行为与 3.0.13 有细微差异
Ubuntu 24.04 LTS 3.0.13 是 当前主流教学环境
Debian 12 (bookworm) 3.0.11 是 随安全更新滚动至 3.0.1x
RHEL 9 / Rocky 9 3.0.7 是 受红帽 ABI 策略约束,长期停在 3.0.x
CentOS 7 1.0.2k 否 已 EOL,连 -help 都没有,只能靠 -config 写 SAN
macOS 自带 /usr/bin/openssl LibreSSL 3.3.6 不完全一致 需 brew install openssl@3 并用绝对路径调用
# 1) 先确认版本,再决定用哪套语法(3.0 与 1.0.2 的命令不通用)
openssl version -a
# 典型输出:OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
#          built on: ... platform: debian-amd64

# 2) 统计 req 子命令的选项数量(3.0.13 实测 70 项上下)
openssl req -help 2>&1 | grep -c '^-'
# 注意:1.0.2k 执行这行只会得到 "unknown option -help",它没有统一 -help

# 3) OpenSSL 3.0:一条命令生成私钥 + 带 SAN 的 CSR
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/O=Example Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com" 
  -addext "extendedKeyUsage=serverAuth"
# -nodes(3.0 等价写法 -noenc)表示私钥不加密;省略则交互式索要口令
# -newkey rsa 省略位数时默认 2048;-addext 自 1.1.1 起提供

问:少写一个参数,为什么只回一句 “req: Use -help for summary”?

这是表层原因却最折磨人:openssl req 的选项有 60 余个,-newkey、-keyout、-nodes、-subj、-addext 任意漏一项,OpenSSL 都不会告诉你缺的是哪一项,只给一句摘要提示。这也是「openssl 命令在线生成」这类工具真正的价值所在——把算法、SAN、有效期变成可勾选参数,省去翻 man 手册的十来分钟。

问:报错文本能直接看出该补什么参数吗?

基本不能,三条高频报错字面与根因几乎无关:

报错文本(3.0 风格) 真实原因 定位命令
error:...:key values mismatch 私钥与证书不是一对 openssl pkey -pubout -in a.key | openssl md5 与证书侧对比
error:...:PEM routines::no start line PEM 头缺失,或文件里混进了网页文本 head -1 server.crt 应为 -----BEGIN CERTIFICATE-----
verify error:num=20:unable to get local issuer certificate 证书链缺中间证书 openssl verify -CAfile chain.pem server.crt

至于频次问题:多数中小站点一年只签发 1–3 张证书,语法留不住是必然的,指望背下来并不现实。

安全边界必须先划清。据 Let’s Encrypt 文档与 CA/Browser Forum TLS 基线要求,密钥对必须由订阅者在自己受控的环境中生成,CA 与任何第三方都不应接触私钥。因此在线工具只应输出命令文本:私钥 PEM、PFX 导出口令、含内网主机名的 SAN 一旦粘贴进网页表单,即应视为已泄露并立即轮换。想再降低风险,可用 openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:P-256 生成 ECDSA 密钥,体积更小、握手更快,且同样能交给在线工具帮你把参数拼对。

实操:在线生成命令到本机执行的 6 个步骤(约 2 分钟)

这一节把「在线生成器」当成一个只负责拼命令的助手:它不接触你的私钥,真正的密钥与 CSR 都在本机由 OpenSSL 生成。下面 6 步按顺序执行,全程约 2 分钟。据 OpenSSL 官方文档,3.0 系列为长期支持版本(LTS,支持至 2026-09-07),命令语法与 1.1.1 基本兼容,但 -addext 是 1.1.1 起才提供的选项。

步骤 1:确认版本与配置目录。先跑一条命令,决定在线生成器里该选哪套语法:

# 记录版本号与 OPENSSLDIR,决定用 -addext 还是 -extfile
openssl version -a
# 典型输出(Ubuntu 22.04)
# OpenSSL 3.0.2 15 Mar 2022 (Library: OpenSSL 3.0.2 15 Mar 2022)
# OPENSSLDIR: "/usr/lib/ssl"          <-- Debian/Ubuntu
# RHEL/Rocky 9 则为 OPENSSLDIR: "/etc/pki/tls"

Debian/Ubuntu 的默认配置在 /usr/lib/ssl/openssl.cnf,RHEL 系在 /etc/pki/tls/openssl.cnf;两者都通过 OPENSSLDIR 定位,改配置前先确认路径,否则会改了不生效。若输出为 1.0.2 系列,在线生成器要切到「1.0.2 兼容模式」:用 -extfile san.cnf 代替 -addext "subjectAltName=...",因为 1.0.2 不认识 -addext,直接报 unknown option -addext。

步骤 2:先收紧权限再建目录。顺序很关键——umask 077 要在 mkdir 之前执行,让私钥从落盘那一刻就是 600,而不是先 644 再补 chmod:

# 同一 shell 内执行;umask 077 使新建文件默认 600、目录 700
umask 077 && mkdir -p ~/certs/example.com && cd ~/certs/example.com
umask   # 确认输出 0077

步骤 3:生成器里只填非敏感项。域名列表填 example.com、www.example.com(多域名用逗号或换行分隔,生成器会转成 SAN);密钥算法选 RSA 2048 或 ECDSA P-256;自签有效期建议 397 天(Apple 对 TLS 服务器证书的上限是 398 天,留 1 天余量,据 Apple Support 公告《About upcoming limits on trusted certificates》);私钥是否加密按需勾选。任何已有私钥内容、口令、CA 账户密码都不要粘进网页表单——生成器只需要域名和算法就能拼出完整命令。

步骤 4:复制命令回本机执行。耗时差异明显,可据此判断是否卡死:RSA 2048 约 0.1–1 秒,RSA 4096 约 5–30 秒(老 CPU 更久),ECDSA P-256 通常小于 1 秒。下面是生成器最常输出的一段等价命令(OpenSSL 3.0,未加密私钥 + SAN):

# -newkey 生成新私钥;-nodes 表示私钥不加密(CI/自动化场景常用)
# -addext 仅 OpenSSL ≥1.1.1 支持;1.0.2 请改用 -extfile san.cnf
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 完成后检查权限与产物
ls -l    # 期望:example.com.key 为 -rw-------(600),example.com.csr 为 -rw-r--r--(644)

步骤 5:自检 CSR。提交给 CA 前一定先验签并核对 SAN,避免被 CA 退回重签:

openssl req -in example.com.csr -noout -verify -text | head -40
# 第一行应为:Certificate request self-signature verify OK
# 再确认 X509v3 Subject Alternative Name 段落含全部域名:
#   DNS:example.com, DNS:www.example.com

如果第一行是 verify failure 或 unable to load X509 request,通常是 CSR 被复制时换行/编码损坏,重新生成即可。

步骤 6:交付 CSR,或自签后拼链。把 CSR 交给 CA;自签场景直接产出 crt。拿到证书后拼 fullchain,顺序必须是「站点证书 → 中间证书」,根证书不要放进去(根已在客户端信任库中,重复携带会增大握手包并可能触发校验告警):

# 自签示例:397 天,SAN 与 CSR 保持一致(-copy_extensions 需 OpenSSL ≥3.0)
openssl x509 -req -in example.com.csr -signkey example.com.key 
  -days 397 -copy_extensions copy -out example.com.crt
# 拼链:站点证书在前,中间证书在后
cat example.com.crt chain.pem > fullchain.pem
# 验证链顺序与完整性
openssl verify -untrusted chain.pem fullchain.pem   # 期望:fullchain.pem: OK
算法/参数 典型耗时 适用场景 OpenSSL 3.0 默认值说明
RSA 2048 0.1–1 秒 兼容性优先、老旧客户端 非默认,需显式 rsa:2048
RSA 4096 5–30 秒 长期自签、内部服务 握手开销约为 2048 的 3–4 倍
ECDSA P-256 <1 秒 现代浏览器、移动端 可用 -newkey ec -pkeyopt ec_paramgen_curve:P-256
有效期 — 自签建议 397 天 -days 无内置默认,必须显式指定

补充一点常被忽略的细节:openssl req 在 3.0 中若未指定 -config,会读取 OPENSSLDIR/openssl.cnf 里的 req_distinguished_name 默认值,所以同一台机器上不同人执行同样命令,-subj 之外的字段可能不同——把 -subj 写全才能保证结果可复现。这与后续要讲的 CSR 字段规范、证书链校验顺序是同一套逻辑。

可直接复制的命令与配置片段(OpenSSL 1.1.1 / 3.0.x 通用)

问:手边只有一台装了 OpenSSL 的机器,从私钥到证书链要敲哪几条命令?

下面清单在 OpenSSL 1.1.1 与 3.0.x 上均可直接运行(两者差异用注释标出)。先记一条底线:-addext 是 OpenSSL 1.1.1 才引入的选项,1.0.2 上没有;而 1.0.2 已于 2019-12-31 结束支持(EOL),新项目不应再使用。

RSA 2048 + SAN,一条命令出 key 和 CSR:

# 适用 OpenSSL 1.1.1 / 3.0.x;-sha256 为 CSR 签名摘要,默认值即 sha256
# -nodes 表示私钥不加密落盘(OpenSSL 3.0 起该写法已标记 deprecated,推荐 -noenc)
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 Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

# 自检:确认 SAN 真的写进了 CSR,否则签发出来依旧报名称不匹配
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 输出示例:X509v3 Subject Alternative Name:
#             DNS:example.com, DNS:www.example.com

注意 -addext 只作用于你生成的 CSR,最终证书里是否带 SAN 取决于 CA 是否复制扩展——据 Let’s Encrypt 文档,其签发流程会保留 CSR 中的 subjectAltName,因此提交前务必自检。私钥以明文落盘时请立刻 chmod 600 example.com.key。

OpenSSL 1.0.2 没有 -addext 怎么办?改用配置文件,新建 san.cnf:

# san.cnf
[req]
distinguished_name = dn
req_extensions     = ext
prompt             = no
[dn]
CN = example.com
[ext]
subjectAltName = DNS:example.com,DNS:www.example.com

# 命令:-config 指向该文件,-subj 只用于兜底覆盖 CN
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key 
  -out example.com.csr -subj "/CN=example.com" -config san.cnf
能力 / 选项 OpenSSL 1.0.2(2019-12-31 EOL) OpenSSL 1.1.1(2023-09-11 EOL) OpenSSL 3.0.x
命令行直接加 SAN(-addext) 不支持,必须 -config 支持 支持
私钥不加密 -nodes -nodes -nodes(deprecated)/ -noenc
req -x509 默认有效期 30 天(-days 覆盖) 30 天 30 天
PKCS#12 默认加密算法 RC2-40 + 3DES RC2-40 + 3DES AES-256-CBC + PBKDF2

问:内网服务要一张 397 天的 ECDSA 自签证书,怎么写?

# -x509 直接自签;P-256 曲线,-days 397 是给 Apple/Chrome 的 398 天上限留余量
openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:P-256 
  -keyout self.key -out self.crt -days 397 -nodes 
  -subj "/CN=internal.example.com" 
  -addext "subjectAltName=DNS:internal.example.com,IP:10.0.0.10"

关键坑:IP 型 SAN 必须写 IP:10.0.0.10,写成 DNS:10.0.0.10 浏览器仍会报 NET::ERR_CERT_COMMON_NAME_INVALID,因为 RFC 5280 规定 IP 只能放在 iPAddress 类型的 GeneralName 里。

问:导出 PKCS#12 给 IIS / Java 用,旧 Windows 导不进去?

# OpenSSL 3.0 默认 AES-256-CBC + PBKDF2,需配合 -certfile 带上中间证书
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -certfile chain.pem -name example.com -out example.com.p12 
  -passout pass:ChangeMe123

# Windows Server 2012 R2 及更早系统不认新算法,追加 -legacy 回退 RC2-40/3DES
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -certfile chain.pem -name example.com -out example.com.p12 
  -passout pass:ChangeMe123 -legacy

# 导入前先验证 p12 内容与口令
openssl pkcs12 -in example.com.p12 -info -noout -passin pass:ChangeMe123

问:怎么确认私钥和证书是一对?两条命令的输出必须逐字符一致:

openssl pkey -in example.com.key -pubout -outform pem | sha256sum
openssl x509 -in example.com.crt -pubkey -noout -outform pem | sha256sum

其他两条高频生成命令:

openssl rand -hex 32        # 32 字节随机数 → 64 个十六进制字符,常用于 session ticket key、HMAC 密钥
openssl dhparam -out dhparam.pem 2048   # 2 vCPU VPS 约 30 秒–2 分钟;若只启用 ECDHE 套件则无需配置

说到”openssl 命令在线生成”,很多网页生成器其实就是在后端跑上面这些命令——但私钥会经过第三方服务器,凡涉及生产证书,优先在本机执行;需要可视化时也务必核对页面是否声明纯前端(WebCrypto)生成。参数细节以 OpenSSL 官方 man 页 req(1)、pkcs12(1)、x509(1) 为准。

选型对比:RSA 2048/4096、ECDSA P-256 与三种命令来源怎么选

RSA 2048 还是 ECDSA P-256?在 2 vCPU 测试机上,差异不只在速度,还在握手 CPU 与兼容性。据 OpenSSL 3.0 req(1) 手册,下表参数可直接用于选型:

算法/参数 密钥生成耗时 签名长度 握手 CPU/兼容性
RSA 2048 0.1–1 秒 256 字节 基线;兼容性最好
RSA 4096 5–30 秒 512 字节 握手 CPU 约为 2048 的 3–4 倍;无强制合规要求不必上
ECDSA P-256 <1 秒 约 70–72 字节(DER) 握手更快;Windows Server 2008 R2 及更早通常不支持,需实测确认

默认建议:对外站点用 ECDSA P-256 + RSA 2048 双证书,Nginx 1.11.0+ 可写两行 ssl_certificate 分别指向 ECDSA 与 RSA 证书链;内部系统、老客户端、代码签名继续 RSA 2048,无合规要求不必上 4096。摘要算法别回退:OpenSSL 1.1.1/3.0 的 req 默认已是 SHA-256,显式写 -sha256 更稳;OpenSSL 1.0.2 默认 SHA-1,必须补。SHA-1 签名证书会被 Chrome 拒绝并报 NET::ERR_CERT_WEAK_SIGNATURE_ALGORITHM(Chrome 自 2017 年起),不要为兼容老设备回退。

# OpenSSL 3.0;按需三选一
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out rsa2048.key
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:4096 -out rsa4096.key
openssl genpkey -algorithm EC  -pkeyopt ec_paramgen_curve:prime256v1 -out ecdsa-p256.key  # prime256v1 即 P-256

# 生成 CSR:-sha256 显式指定;SAN 必须写,CN 不再是唯一依据
openssl req -new -key ecdsa-p256.key -sha256 
  -subj "/C=CN/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com" 
  -out example.csr

# 自检:典型输出含 ecdsa-with-SHA256、Public-Key: (256 bit)、DNS
openssl req -in example.csr -noout -text | grep -E 'Signature Algorithm|Public-Key|DNS:'
# Signature Algorithm: ecdsa-with-SHA256
# Public-Key: (256 bit)
# DNS:example.com, DNS:www.example.com
# Nginx 1.11.0+:同一 server 配置 ECDSA 与 RSA 双证书
ssl_certificate     /etc/nginx/ssl/example.ecdsa.fullchain.pem; # ECDSA P-256 证书链
ssl_certificate_key /etc/nginx/ssl/example.ecdsa.key;
ssl_certificate     /etc/nginx/ssl/example.rsa.fullchain.pem;  # RSA 2048 证书链
ssl_certificate_key /etc/nginx/ssl/example.rsa.key;
ssl_protocols TLSv1.2 TLSv1.3;

命令从哪来?所谓 openssl 命令在线生成,本质是网页替你跑等价 openssl req;方便,但生产私钥不要上传。三种来源对比:

来源 出结果速度 版本感知 可重复/审计 适用场景
openssl 命令在线生成(网页生成器) 约 30 秒 无,不知道你本机 OpenSSL/后端版本 弱,难进 Git 一次性任务、临时测试;生产私钥勿上传
本机 man req + openssl version 即时 强,手册与命令版本匹配 手工重复,易漏参数 排错、单次手工签发
Ansible community.crypto.openssl_privatekey(collection 2.x 起)或 Makefile 模板 首次配置后快 可锁定 collection/OpenSSL 版本 强,可重复、可进 Git 多域名团队、批量签发

与 ACME 的边界:公开 DV 证书优先 certbot 3.x 或 acme.sh 3.0 自动化;据 Let’s Encrypt 文档,DV 证书有效期 90 天,应自动续期。OV/EV、内网系统、需要固定 CSR 归档时,才走手工 CSR + openssl 命令在线生成或本机命令。成本参考:Let’s Encrypt DV 0 元;商业 DV 单域名约 100–400 元/年,DV 通配符约 600–2000 元/年,OV 约 500–2000 元/年,EV 约 2000–8000 元/年;自签 0 元,仅限内网与测试。

常见错误与排查:6 条真实报错信息对照

问:跑 openssl req -addext "subjectAltName=DNS:example.com" 直接报 req: Use -help for summary. 或 unknown option -addext,怎么回事?

这两个提示都指向同一件事:你手上的 OpenSSL 低于 1.1.1。-addext 是 1.1.1 才加入 req 子命令的选项,OpenSSL 3.0 手册 openssl-req(1) 明确列出其用法;CentOS 7 自带的 1.0.2k 一定不认。先确认版本,再二选一:

# 确认版本与编译参数,1.1.1 以下不支持 -addext
openssl version -a

# 方案 A:不升级,用配置文件挂 req_extensions
cat > san.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions     = v3_req   # 关键行:把扩展注入 CSR
prompt             = no
[dn]
CN = example.com
[v3_req]
subjectAltName = DNS:example.com, DNS:www.example.com
EOF
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key 
  -out example.com.csr -config san.cnf
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

# 方案 B:升级(Debian/Ubuntu → 3.0.x;RHEL 9 → 3.0.x)
sudo apt install --only-upgrade openssl   # Ubuntu 22.04 默认即 3.0.2
sudo dnf update openssl                   # RHEL 9 默认 3.0.x

注意:用 -config 生成的 CSR 里 SAN 只是”申请”,最终是否进证书由签发端(CA 或自签时的 -extfile)决定——据 RFC 5280 §4.2.1.6,CN 已不再作为主机名回退依据。

问:SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch 或 Nginx 的 SSL_CTX_use_PrivateKey_file() failed 怎么修?

根因只有一个:证书与私钥不是一对(常见于续签后只换了证书、或从两个目录各拷一半)。OpenSSL 在加载时会做 X509_check_private_key 比对,失败即拒绝启动。按下面顺序验证:

# 1) 私钥本身是否完好,正常输出 "RSA key ok"
openssl rsa -in example.com.key -check -noout

# 2) 两条 sha256 比对:模数摘要必须完全一致(RSA 用 -modulus)
openssl x509 -noout -modulus -in example.com.crt | openssl sha256
openssl rsa  -noout -modulus -in example.com.key | openssl sha256
# ECDSA 证书改用公钥摘要:openssl x509 -in crt -noout -pubkey | openssl sha256

问:unable to load certificate ... PEM routines::no start line 是什么问题?

文件根本不是 PEM,或首行前面混了内容。head -1 必须精确等于 -----BEGIN CERTIFICATE-----。Windows 记事本另存为 UTF-8 会写 BOM,肉眼不可见但会让解析器认不出首行:

head -1 example.com.crt                 # 期望:-----BEGIN CERTIFICATE-----
dos2unix example.com.crt                # 顺手处理 CRLF
sed -i '1s/^xEFxBBxBF//' example.com.crt   # GNU sed 去 BOM

问:verify error:num=20:unable to get local issuer certificate 与 num=21 有何区别?

20 表示链断在中间——服务器没发中间证书或本地缺根;21 表示只部署了站点证书,一个中间证书都没带。检查链里到底有什么:

openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout
# 应看到站点证书 + 至少一张中间证书;缺了就按 Let's Encrypt 文档把 intermediate 拼进 fullchain.pem

问:导出 p12 报 error:0308010C:digital envelope routines::unsupported?

OpenSSL 3.0 改变了 pkcs12 -export 的默认值:-certpbe/-keypbe 默认 AES-256-CBC、-macalg 默认 sha256(1.1.1 时代是 RC2-40/3DES)。Windows Server 2012、旧版 Java 8 不认 AES,于是解包失败。两种解法:

# 兼容旧目标系统:回退到 3DES/RC2,需加载 legacy provider
openssl pkcs12 -export -legacy -inkey example.com.key -in fullchain.pem 
  -out example.com.p12

# 或显式指定算法,便于审计
openssl pkcs12 -export -certpbe AES-256-CBC -keypbe AES-256-CBC -macalg sha256 
  -inkey example.com.key -in fullchain.pem -out example.com.p12

长期看应升级消费端而非永久 -legacy;据 OpenSSL 3.0 迁移指南,legacy provider 只是过渡手段。

问:wrong number of fields in /etc/ssl/openssl.cnf 或 Unable to load config info from ...?

命令本身没错,是配置被改坏或 OPENSSL_CONF 指错文件。用两步隔离:

echo $OPENSSL_CONF                      # 空表示用编译默认路径
OPENSSL_CONF=/dev/null openssl req -new -newkey rsa:2048 -nodes 
  -keyout t.key -out t.csr -subj "/CN=test.local"
# 加上 /dev/null 后成功 → 配置问题;仍失败 → 命令或版本问题
报错关键词 根因 一行定位
unknown option -addext OpenSSL < 1.1.1 openssl version
key values mismatch 证书/私钥不配对 openssl rsa -in k -check -noout
PEM routines::no start line 非 PEM 或带 BOM head -1 crt
num=20 / num=21 缺中间证书 / 缺整条链 crl2pkcs7 | pkcs7 -print_certs
digital envelope routines::unsupported 3.0 默认 AES 不被旧端支持 加 -legacy
wrong number of fields OPENSSL_CONF 指向坏配置 echo $OPENSSL_CONF

效果验证:5 条命令确认证书、证书链与 TLS 握手都正常

证书签发完不等于能用。最常见的翻车是「浏览器打得开、Java/curl 报 PKIX path building failed」,根因往往是链没发全。下面 5 条命令按「证书本体 → 链 → 握手 → 协议/OCSP → 服务端配置」的顺序逐层排除,全部在 OpenSSL 3.0.x 下验证过(3.0 与 1.1.1 输出基本一致)。

第 1 条:先看证书自己说了什么。重点不是 subject,而是 notAfter(据 Let’s Encrypt 文档,其证书有效期 90 天,2025 年起已推进更短周期)和 SAN 列表——CN 早在 RFC 6125 之后就不再被浏览器用于匹配域名,只看 CN 会漏掉漏签的子域。

# -ext 需要 OpenSSL 1.1.1 及以上;1.1.0 及更早会报 "unknown option -ext"
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

# 期望输出示例
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R3
# notBefore=Feb  1 00:00:00 2025 GMT
# notAfter=May  2 23:59:59 2025 GMT
# X509v3 Subject Alternative Name:
#     DNS:example.com, DNS:www.example.com

第 2 条:单独校验证书链能否构建。-CAfile 放根证书,-untrusted 放中间证书(可重复传多个文件),顺序不影响结果。输出 example.com.crt: OK 才算链闭合。

# 本地文件方式
openssl verify -CAfile root.pem -untrusted chain.pem example.com.crt
# example.com.crt: OK

# 直接对系统信任库验证(Debian/Ubuntu 系)
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem example.com.crt
# RHEL/CentOS/Rocky/AlmaLinux 系
openssl verify -CAfile /etc/pki/tls/certs/ca-bundle.crt -untrusted chain.pem example.com.crt

# 失败时的真实报错:
# error 20 at 0 depth lookup: unable to get local issuer certificate  → 缺中间证书
# error 21 at 0 depth lookup: unable to verify the first certificate  → 根不在信任库

第 3 条:模拟一次真实握手。-servername 不能省,否则 SNI 站点会返回默认站点的证书;</dev/null 让命令读完即退出,不会挂在交互模式。

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

# 关注末尾两行:
# Verify return code: 0 (ok)
# 若为 21 (unable to verify the first certificate),
# 说明服务端只发了叶子证书,Nginx 的 ssl_certificate 必须指向 fullchain.pem 而非单张 cert.pem

第 4 条:OCSP 装订与协议版本一起看。OCSP 状态定义见 RFC 6960,successful (0x0) 才代表装订生效;若输出 no response sent,通常是服务端没开 ssl_stapling 或没配 ssl_trusted_certificate。协议版本按 RFC 8446 应为 TLSv1.3。

openssl s_client -connect example.com:443 -status -servername example.com </dev/null 
  | grep -E "OCSP Response Status|Protocol"
# OCSP Response Status: successful (0x0)
# Protocol  : TLSv1.3

# 分别探测:能握手说明启用,handshake failure 说明已禁用
openssl s_client -connect example.com:443 -tls1_2 -servername example.com </dev/null | head -1
openssl s_client -connect example.com:443 -tls1_3 -servername example.com </dev/null | head -1
检查项 命令要点 通过信号 失败信号
证书内容 x509 -noout -dates -ext subjectAltName notAfter 在未来、SAN 覆盖全部域名 缺 www 子域、已过期
链构建 verify -CAfile root.pem -untrusted chain.pem OK error 20 / 21
线上握手 s_client -showcerts Verify return code: 0 (ok) 21
OCSP 装订 s_client -status successful (0x0) no response sent
协议版本 s_client -tls1_2 / -tls1_3 按预期握手或拒绝 意外握手成功

第 5 条:回到服务端复核配置与文件权限。私钥必须 600 且属主为 root(Nginx 由 master 进程以 root 读取,worker 无需读权限)。配置项命名可参考 Mozilla SSL Configuration Generator 的 intermediate 配置。

# Nginx 1.25.1+ 使用独立的 http2 指令;更早版本写 listen 443 ssl http2;
server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate         /etc/nginx/ssl/fullchain.pem;  # 叶子+中间,顺序不能反
    ssl_certificate_key     /etc/nginx/ssl/privkey.pem;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;      # 供 OCSP 装订校验
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_protocols TLSv1.2 TLSv1.3;
}

nginx -t && systemctl reload nginx
ls -l /etc/nginx/ssl/privkey.pem      # 期望 -rw------- 1 root root

# Apache 2.4(Debian 系 reload apache2,RHEL 系 reload httpd)
apachectl configtest && systemctl reload apache2

第三方复核。SSL Labs API 首次分析约 60–180 秒,all=done 会等分析完成后一次性返回;本地可用 testssl.sh 3.2 做离线扫描,--severity MEDIUM 过滤掉 INFO 噪音。

curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done"
./testssl.sh --severity MEDIUM example.com

安全边界:哪些内容能贴进在线工具,哪些一贴就要重签

问:哪些信息贴进在线工具是安全的?

域名列表、算法偏好(RSA 还是 ECDSA)、密钥位数、有效期天数、是否需要 SAN —— 这几类信息本来就在公开渠道可查:证书透明度(CT)日志会记录每张公开证书的全部 SAN,用一条命令就能反查出来,所以把它们贴进在线生成器不构成新的信息泄露。据 RFC 6962(Certificate Transparency)与 CA/Browser Forum Baseline Requirements,公开信任的 TLS 证书必须提交 CT 日志,这意味着「example.com 有哪些子域在用什么算法」是公开事实。

# 反查某域名在 CT 日志中的历史 SAN,证明域名/算法信息本就公开
curl -s "https://crt.sh/?q=example.com&output=json" | jq -r '.[].name_value' | sort -u
信息类别 举例 能否贴进在线工具 原因
域名与 SAN 列表 DNS:example.com 可以 CT 日志公开可查
算法与位数 RSA 3072 / ECDSA P-256 可以 证书公钥本身公开
有效期 90 天 可以 证书 notAfter 公开
私钥 PEM 全文 -----BEGIN PRIVATE KEY----- 禁止 持有即可完整冒充站点
PFX 导出与口令 .pfx + export password 禁止 口令与私钥同时泄露,等价于私钥明文
CSR 里夹带的私钥段 把 key 与 csr cat 成一个文件再上传 禁止 这是最常被忽略的一类
内网 IP / 员工姓名 SAN IP:10.0.0.5、DNS:zhangsan-laptop 禁止 泄露网络拓扑与个人信息
CA 账户凭据 ACME EAB、注册商 API Key 禁止 可被用于签发任意域名证书

问:已经贴出去了怎么办?

不要试图「删掉帖子就没事」—— 视为私钥已泄露,走重签 + 吊销流程。OpenSSL 3.0 下完整序列如下(注意 genpkey 已取代 genrsa 作为推荐入口,输出默认是 PKCS#8 格式):

# 1) 生成新密钥对:RSA 3072;genpkey 默认不加密私钥,所以必须手动收紧权限
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:3072 -out example.com.key
chmod 600 example.com.key

# 2) 生成新 CSR:-addext 需要 OpenSSL 1.1.1+,3.0 可用
openssl req -new -key example.com.key -sha256 
  -subj "/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com" 
  -out example.com.csr

# 3) 校验证书与私钥是否配对(两条 SHA-256 必须一致)
openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout      | openssl sha256

# 4) 吊销旧证书:自建 CA 用 openssl ca -revoke,公有 CA 走其 ACME/API 吊销接口
openssl ca -config openssl.cnf -revoke old.crt

问:从博客抄来的命令模板,最常在哪三处出错?

审计项 常见模板写法 OpenSSL 3.0 的默认行为 后果与修正
是否含 -nodes openssl req -newkey rsa:2048 -nodes req -newkey 默认会提示输入 PEM 口令;加 -nodes 则不加密 私钥明文落盘,必须 chmod 600 或 umask 077
私钥写到哪里 -keyout /tmp/k.pem 默认 umask 022 → 文件权限 644 /tmp 全局可读;改用项目私有目录并设 600
是否写 -sha256 老模板里的 -sha1 3.0 起 SHA-1 移入 legacy provider,默认摘要为 SHA-256 显式写 -sha256 防模板漂移;照抄 -sha1 会直接报错

真实报错(OpenSSL 3.0 默认 provider 下使用 SHA-1 签名):
Error setting digest
...:error:0308010C:digital envelope routines:inner_evp_generic_fetch:unsupported:...:Algorithm (SHA1 : 0)

问:团队怎么把这些约束固化下来,而不是靠人记?

把参数封进 Makefile 目标,让 make csr DOMAIN=... SAN=... 成为唯一入口,比让每个人记住「别忘了 -sha256」可靠得多:

# Makefile:openssl 命令在线生成只用来产出参数,私钥环节永远在本机执行
DOMAIN ?= example.com
SAN    ?= DNS:$(DOMAIN),DNS:www.$(DOMAIN)
KEYDIR := pki/private
CSRDIR := pki/csr

csr: $(KEYDIR)/$(DOMAIN).key
	umask 077 && mkdir -p $(CSRDIR) && openssl req -new -sha256 
	  -key $< -subj "/CN=$(DOMAIN)" 
	  -addext "subjectAltName=$(SAN)" -out $(CSRDIR)/$(DOMAIN).csr

$(KEYDIR)/$(DOMAIN).key:
	umask 077 && mkdir -p $(KEYDIR) && openssl genpkey 
	  -algorithm RSA -pkeyopt rsa_keygen_bits:3072 -out $@

跨机器批量签发时,用 Ansible community.crypto 2.x(要求 ansible-core ≥ 2.11)的 openssl_privatekey 与 openssl_csr 模块,把版本差异封在 collection 里:

- name: 私钥只在本机生成,权限 0600
  community.crypto.openssl_privatekey:
    path: /etc/pki/example.com.key
    type: RSA
    size: 3072
    mode: '0600'
- name: 生成 CSR,摘要固定 sha256
  community.crypto.openssl_csr:
    path: /etc/pki/example.com.csr
    privatekey_path: /etc/pki/example.com.key
    common_name: example.com
    subject_alt_name: ['DNS:example.com', 'DNS:www.example.com']
    digest: sha256

问:有 HSM 或云 KMS 的场景还要不要走「在线生成」?

要,但只让它参与前半程:在线工具负责算出参数(密钥类型、位数、SAN、有效期),密钥对的生成与 CSR 签名留在设备内完成,私钥永不导出。据 CA/Browser Forum Baseline Requirements 对密钥保护的基线要求,CA 侧密钥须在符合 FIPS 140-2/140-3 或同等标准的加密模块中生成与保存;订阅方若同样具备 HSM/KMS,把 CSR 生成搬进设备是最省事的对齐方式。本地验证可用 SoftHSM 2 搭一个 PKCS#11 软令牌:

# 初始化软令牌(仅用于验证流程,不用于生产)
softhsm2-util --init-token --free --label pki --pin 1234 --so-pin 123456

# OpenSSL 3.0 用 provider 取代旧的 engine,通过 pkcs11-provider 访问令牌中的私钥
# 配置好 /etc/ssl/pkcs11.cnf 后:
openssl req -new -sha256 -provider default -provider pkcs11 
  -key "pkcs11:token=pki;object=example.com;type=private" 
  -subj "/CN=example.com" -addext "subjectAltName=DNS:example.com" 
  -out example.com.csr

结论落到一句话:openssl 命令在线生成能替你算参数、生成可复制的命令模板,但私钥 PEM、PFX 口令、夹带私钥的 CSR 永远不进浏览器表单;每次使用前按 -nodes、私钥路径、-sha256 三条做一次审计,剩下的交给 Makefile 或 Ansible 固化。

延伸:手工 CSR 与 ACME 自动化的分工,以及下一步该看什么

公开证书该交给 ACME 还是继续手工签 CSR?判断标准只有一条:证书的验证方式能否被自动化。DV(域名验证)证书的签发全程无需人工介入,交给 ACME 客户端最划算;OV/EV 需要提交营业执照等材料做组织核验,内网系统没有公网可达的 HTTP-01 端点,mTLS 客户端证书则由自己的私有 CA 签发,这三类场景都应该走前面演示过的手工 CSR 流程。据 Let’s Encrypt 官方文档,ACME 证书有效期固定为 90 天,官方建议在剩余 30 天时续期,certbot 3.x 与 acme.sh 3.0 默认都以这个节奏执行。

# certbot 3.x:webroot 验证,续期成功后自动重载 Nginx
# --webroot 要求 /.well-known/acme-challenge/ 可被公网访问
sudo certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com 
  --deploy-hook "systemctl reload nginx"

# acme.sh 3.0.x:默认 CA 为 ZeroSSL,可切回 Let's Encrypt
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --set-default-ca --server letsencrypt
~/.acme.sh/acme.sh --issue -w /var/www/html -d example.com -d www.example.com
~/.acme.sh/acme.sh --install-cert -d example.com 
  --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.crt 
  --reloadcmd "systemctl reload nginx"

怎么确认线上证书还剩几天?不要只看本地文件,要连接真实端点取回证书。下面这条命令同时覆盖 SNI 与证书解析,适合放进脚本:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -enddate
# 输出示例:notAfter=Jun  3 12:00:00 2026 GMT

把它包装成每日巡检(GNU date 语法,Debian/RHEL 通用),剩余不足 15 天即告警:

#!/bin/sh
# /usr/local/bin/cert-check.sh,cron 中每日 03:00 执行一次
end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
      | openssl x509 -noout -enddate | cut -d= -f2)
left=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ "$left" -lt 15 ] && echo "example.com 证书剩余 ${left} 天" 
  | mail -s "[证书告警]" ops@example.com
# crontab:0 3 * * * /usr/local/bin/cert-check.sh

还在用 1.1.1 会怎样?1.1.1 已于 2023-09-11 结束公开支持,此后出现的漏洞不再免费修复,升级到 LTS 分支是唯一稳妥选择。OpenSSL 官方博客给出的时间线如下:

分支 状态 支持截止 建议
1.0.2 已 EOL(2019-12-31) 无 立即迁移
1.1.1 已 EOL(2023-09-11) 付费延长至 2025-09-11 尽快升级
3.0 LTS 维护中 2026-09 过渡选择
3.5 LTS 2025-04 发布 2030-04 新部署首选

一个常被忽略的坑:-days 397 只对自签证书生效,公开 CA 签发的有效期由 CA 决定,你在 CSR 里写多少天都无效。CA/Browser Forum 的 SC-081 提案计划自 2026-03-15 起把公开证书上限压到 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天——届时一年多次续期靠人肉完成已不现实,ACME 自动化会从”可选”变成”必需”。这也是为什么本清单强调先用 openssl 命令在线生成把 CSR、私钥与证书链的结构彻底搞懂,再交给自动化工具;否则 certbot 报 fullchain.pem 缺失或链序错误时,你无法判断问题出在哪一层。

下一步该看什么?按依赖顺序推荐:证书链补全与顺序(中间证书必须紧跟在服务器证书之后);OCSP stapling 配置,Nginx 侧 ssl_stapling on; 需配合 ssl_trusted_certificate 指向根+中间证书,否则会静默失效;HSTS preload 的提交条件;TLS 1.3 0-RTT 的重放风险(ssl_early_data on 只应用于幂等请求);以及 mTLS 双向认证中 -verify 与 -verify_return_error 的区别——前者只在验证失败时打印错误,后者才会真正中断握手。

取决于你填了什么。只填域名、算法、有效期这类公开参数,生成器拿不到任何密钥材料;一旦把私钥 PEM 或 p12 口令粘贴进去,就应按泄露处理,立即用新命令重新生成密钥对并重签证书。判断标准很简单:命令文本里出现 -keyout 是正常的,出现真实密钥内容就不正常。

CentOS 7 自带 OpenSSL 1.0.2k,不支持 -addext(1.1.1 才引入)。把 SAN 写进独立的 san.cnf,用 -config san.cnf 配合 req_extensions=ext;也可以 yum install openssl11 后用 openssl11 命令执行,参数与 1.1.1 一致。

多数是 -addext 没生效,或 -config 里没写 req_extensions。用 openssl req -in example.com.csr -noout -text | grep -A2 “Subject Alternative Name” 确认;若为空,说明生成时扩展没带上,只能重新生成 CSR——CSR 不能事后补扩展。

在线生成器产出的是命令模板,最终仍由你本机执行,适合 OV/EV、内网系统、需要固定 CSR 归档的场景;certbot 是 ACME 客户端,自动完成域名验证、签发与续期,适合公开 DV 证书。公开站点优先 certbot,手工 CSR 留给自动化覆盖不到的部分。

不是。自签证书不在系统或浏览器信任库里,必然报这个错。内网使用需要把 self.crt 导入客户端受信任根(Windows 用 certlm.msc 进入“受信任的根证书颁发机构”),或者自建内部 CA 用 openssl ca 签发,再由域策略下发根证书。

严格说需要两条命令比对输出:openssl pkey -in example.com.key -pubout | sha256sum 与 openssl x509 -in example.com.crt -pubkey -noout | sha256sum,哈希一致即匹配。也可以先跑 openssl rsa -in example.com.key -check -noout,输出 RSA key ok 说明私钥本身没损坏。

3.0 默认用 AES-256-CBC + PBKDF2,Windows Server 2012 R2 及更早系统不支持。加 -legacy 重新导出(回退 RC2-40/3DES),或显式指定 -certpbe PBE-SHA1-3DES -keypbe PBE-SHA1-3DES -macalg sha1;长期方案是升级目标系统而不是长期降级加密。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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