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,肉眼不可见但会让解析器认不出首行:
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。