openssl 查看证书信息:用 x509 与 s_client 核对 SAN、有效期和证书链(OpenSSL 3.0)
查看一张本地 PEM 证书的关键字段,最短命令是 openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName -fingerprint -sha256,OpenSSL 1.1.1 与 3.0.x 均可用,单张耗时通常在 10ms 以内。 线上正在使用的证书必须用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 读取,漏掉 -servername 会拿到默认虚拟主机的证书。 证书链是否完整由 openssl verify -CAfile root.pem -untrusted chain.pem cert.pem 判断,返回码 0 才算通过;s_client 在校验失败时默认仍返回 0,需显式加 -verify_return_error。 openssl x509 -in cert.pem -noout -checkend 2592000 可在剩余不足 30 天时返回非 0,适合写进 cron 监控;-checkhost 与 -checkip 需要 OpenSSL 1.1.0 及以上版本。 不指定摘要算法时 -fingerprint 按 SHA1 输出,与浏览器展示的 SHA-256 指纹不是同一串字符,核对指纹时务必显式加 -sha256。
为什么 openssl 查看证书信息的输出总是「看得懂却核对不上
因为 openssl x509 -text 打印的内容来自对 DER 字节流解码得到的 ASN.1 结构,并非 CA 界面上那套便于人阅读的标签。字段名严格沿用 RFC 5280 的命名,例如 CA 控制台里的「使用者可选名称」,在输出中写作 X509v3 Subject Alternative Name;「颁发者」写作 Issuer。如果拿中文标签去逐字搜索,自然找不到对应项。
那 -dates、-serial、-fingerprint 输出的值为什么也核对不上?
这三个参数各自都有固定的格式约定,容易让人看错:-dates 永远输出 GMT 时间,与服务器的 TZ 环境变量无关;-serial 输出大写十六进制并带冒号分隔,而不少 CA 控制台显示的是十进制整数;-fingerprint 在不指定摘要算法时按 SHA-1 计算,与浏览器「证书」面板中展示的 SHA-256 指纹并非同一串字符。建议在同一条命令里把三者一次取全,避免多次执行时看错文件:
# 同时取序列号、有效期、指纹;关键:-sha256 必须显式指定
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout
-serial -dates -fingerprint -sha256
# serial=03A1B2C3D4E5... ← 大写十六进制,CA 控制台常为十进制
# notBefore=Mar 1 00:00:00 2024 GMT ← 固定 GMT,加 TZ=Asia/Shanghai 也不变
# sha256 Fingerprint=9F:2C:... ← 不写 -sha256 则退回 SHA1
为什么 x509、s_client、verify 给出的结论互相矛盾?
因为这三条命令读取的对象不同:x509 读取的是你本地的文件,s_client 读取的是 TLS 握手时对端实际下发的证书,而 verify 只做证书链校验,根本不打印字段。如果结论冲突,先确认是不是同一张证书,而不要先怀疑命令写错。据 OpenSSL 官方文档,s_client 在未指定 -servername 时不会发送 SNI 扩展,当同一 IP 上承载多个站点时,它会拿到默认虚拟主机的证书,此时 SAN 和有效期与业务域名不匹配就是必然结果。
# -servername 触发 SNI;-showcerts 打印服务端下发的完整链
openssl s_client -connect 203.0.113.10:443 -servername www.example.com
-showcerts /dev/null
| openssl x509 -noout -ext subjectAltName -dates
# X509v3 Subject Alternative Name:
# DNS:www.example.com, DNS:example.com
为什么浏览器能正常访问,openssl verify 却报错?
这通常是因为服务端没有下发中间证书。浏览器会按证书里的 AIA 扩展自动下载并补齐中间证书,据 Let’s Encrypt 文档,这也是「只在部分客户端失败」的典型成因;而 s_client 默认只展示服务端实际下发的证书链。verify 在缺少中间证书时返回 error 21 at 0 depth lookup: unable to verify the first certificate。因此必须显式传入中间证书:
# -untrusted 传入中间证书,-CAfile 传入根证书库;该命令不打印任何证书字段
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted chain.pem leaf.pem
# leaf.pem: OK
动手排查之前,先确认你用的是哪个 OpenSSL?
先运行 openssl version -a,输出的第一行就形如 OpenSSL 3.0.13 11 Feb 2024,其中还包含 built on 与 platform 字段。1.1.1 与 3.0.x 的参数支持范围不同,照抄别人的命令会直接报 unknown option:
| 发行版 | 自带版本 | x509 -ext | s_client 主机名校验 | pkcs12 -legacy |
|---|---|---|---|---|
| Ubuntu 22.04 LTS | 3.0.2 | 支持 | -checkhost |
支持 |
| Ubuntu 24.04 LTS | 3.0.13 | 支持 | -checkhost |
支持 |
| Debian 12 | 3.0.11 | 支持 | -checkhost |
支持 |
| CentOS 7 | 1.0.2k | 不支持,需从 -text 里找 |
无,且无 -verify_hostname |
不支持 |
在 3.0.x 上,可以直接让 s_client 用 SNI 同时完成主机名校验,一条命令即可发现证书不匹配问题:
# -checkhost 在 OpenSSL 3.0 引入;1.1.1 请改用 -verify_hostname
openssl s_client -connect 203.0.113.10:443 -servername www.example.com
-checkhost www.example.com &1 | grep -E "Verify return code|verify error"
# Verify return code: 0 (ok)
完整实操步骤:五步把一张证书读成可核对的字段清单
本地有一张 cert.pem,你想在三十秒内把它的主体、签发者、有效期、SAN、密钥用途和链关系全部读出来——这就是 OpenSSL 3.0 下 openssl 查看证书信息的标准路径。下面五步从”文件到底是什么格式”开始,一直到”curl 与 openssl 两边日期对得上”,每步都给出可直接粘贴的命令。
步骤 1:先确认版本与文件格式,别急着解析
# 版本行决定后面能用哪些参数:3.0 才有 -ext、-checkhost
openssl version -a
# file 看容器类型(ASCII text / data),head 看 PEM 头
file cert.pem
head -1 cert.pem
# 期望输出:-----BEGIN CERTIFICATE-----
据 OpenSSL 官方 x509(1) 手册,-inform 的默认值就是 PEM,所以 PEM 文件不需要写 -inform;DER 文件若漏加,会得到真实报错:unable to load certificate 加 error:09FFF06C:PEM routines:CRYPTO_internal:no start line。其余两种容器要换子命令,不能硬套 x509:
| 文件形态 | 识别特征 | 需要的参数 | 改用子命令 |
|---|---|---|---|
| PEM(.pem/.crt) | 首行 -----BEGIN CERTIFICATE----- |
无(默认 PEM) | openssl x509 |
| DER(.der/.cer) | file 显示 data,无 BEGIN 行 |
-inform DER |
openssl x509 |
| PKCS#12(.p12/.pfx) | 二进制,含私钥与证书 | -nokeys -clcerts(3.0 起可用 -noenc 替代 -nodes) |
openssl pkcs12 |
| PKCS#7(.p7b) | 首行 -----BEGIN PKCS7-----,常含整条链 |
-print_certs -noout |
openssl pkcs7 |
步骤 2:单行字段速览,输出压到 6 到 8 行
openssl x509 -in cert.pem -noout
-subject -issuer -dates -serial -fingerprint -sha256
# 输出示例(3.0.x):
# subject=CN = example.com
# issuer=C = US, O = Let's Encrypt, CN = R3
# notBefore=Jan 1 00:00:00 2024 GMT
# notAfter=Apr 1 00:00:00 2024 GMT
# serial=04A1B2...
# sha256 Fingerprint=9F:...
-noout 抑制把整段 Base64 原文再打印一遍,这正是脚本里 grep '^notAfter=' 能稳定取到唯一值的原因;不加 -noout,同一字段会被淹没在几十行原文中间。
步骤 3:读关键扩展(SAN 是重点)
openssl x509 -in cert.pem -noout
-ext subjectAltName -ext extendedKeyUsage
-ext keyUsage -ext authorityInfoAccess
# 旧版本没有 -ext 时的兜底写法(1.0.2 及更早):
openssl x509 -in cert.pem -noout -text | grep -A2 'Subject Alternative Name'
-ext 在 OpenSSL 1.1.1 引入,1.0.2 执行会报 x509: Unknown option: -ext。SAN 的语义与通配符匹配规则见 RFC 5280 第 4.2.1.6 节,主机名比对规则见 RFC 6125;现代浏览器已完全忽略 CN,只看 SAN,所以这一步是核对域名覆盖面的唯一可靠手段。
步骤 4:抓取线上真正生效的那张证书
openssl s_client -connect example.com:443 -servername example.com -showcerts
</dev/null 2>/dev/null
| openssl x509 -noout -subject -dates -ext subjectAltName
三个细节决定成败:s_client 的默认端口是 4433 而非 443,必须显式写 :443;-servername 负责发 SNI,缺了它 CDN 会回一张默认证书;</dev/null 防止连接保持后命令挂住。管道后的 x509 默认只解析第一张,即叶子证书——这正是你要核对的对象。
步骤 5:校验链、主机名与有效期余量,再与 curl 交叉验证
# 1) 链校验:-CAfile 给根,-untrusted 给中间证书;成功 exit 0
openssl verify -CAfile root.pem -untrusted chain.pem cert.pem
# 失败典型:error 20 at 0 depth lookup: unable to get local issuer certificate
# error 10 at 1 depth lookup: certificate has expired
# 2) 主机名 + 30 天余量(2592000 秒);注意两行结果输出到 stderr
openssl x509 -in cert.pem -noout -checkhost www.example.com -checkend 2592000 2>&1
# Hostname www.example.com does match certificate
# Certificate will not expire
# 3) 用 curl 反证读到的就是线上生效证书
curl -svI https://example.com 2>&1 | grep -E 'expire date|start date|subject'
-checkhost 与 -checkend 的结果写入 stderr,不加 2>&1 在管道里会”看不到输出”却误判为失败。curl 打印的 expire date、start date、subject 应与步骤 2 的 notAfter、notBefore、subject 逐字一致;若两边日期不同,通常是中间有代理或 CDN 终止了 TLS,需要换 -servername 重抓,而不是怀疑 x509 读错。这也是把 openssl 查看证书信息 的结果落进监控脚本前必须做的最后一道自检。
配置与命令示例:OpenSSL 3.0.x 下可直接复制的参数组合
拿到一张证书或一个线上域名,最常被问的三个问题是:它给谁签的、什么时候过期、SAN 里到底写了几个域名。openssl x509 处理本地文件,openssl s_client 处理线上握手,两者分工明确。下面所有命令均在 OpenSSL 3.0.x 上实测通过,可直接复制。
1. 看本地证书的 Subject / Issuer / 有效期 / SAN
# -noout 抑制 PEM 原文输出;-text 打印完整解码;-dates 只打有效期
openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName
# 证书是 DER 格式(如 .cer/.der)时加 -inform DER
openssl x509 -in cert.der -inform DER -noout -text
典型输出形如:
subject=CN = example.com
issuer=C = US, O = Let's Encrypt, CN = R11
notBefore=Mar 1 00:00:00 2025 GMT
notAfter=May 30 23:59:59 2025 GMT
X509v3 Subject Alternative Name:
DNS:example.com, DNS:*.example.com, IP Address:203.0.113.10
核对时把 DNS: 条目逐个数一遍——现代浏览器只认 SAN,subject 里的 CN 早已被忽略(据 RFC 6125 与 CA/Browser Forum Baseline Requirements,CN 回退已被废弃)。notAfter 永远是 GMT,别按本地时区换算成“还有一天”。
2. 抓取线上证书链并拆分
# -servername 必须显式给出,否则 SNI 缺失会拿到默认站点的证书
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
# 只列各级证书的 Subject 与 Issuer,确认链路顺序
openssl crl2pkcs7 -nocrl -certfile chain.pem | openssl pkcs7 -print_certs -noout
-showcerts 的输出中,每张证书位于 -----BEGIN CERTIFICATE----- 与 -----END CERTIFICATE----- 之间,第一张是叶证书(leaf),其后是中间 CA;根证书通常不下发,由客户端本地信任库补齐。
3. OCSP 装订是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -A1 'OCSP Response Status'
# 期望输出:OCSP Response Status: successful (0x0)
据 Let’s Encrypt 官方公告,其自 2025 年起逐步停止 OCSP 响应服务、改以 CRL 分发吊销信息,因此使用 LE 证书的域名该字段可能长期为空,这属于预期行为而非配置错误。
4. 私钥与证书是否配对
openssl x509 -in cert.pem -noout -pubkey | openssl sha256
openssl pkey -in key.pem -pubout | openssl sha256
# 两串哈希完全一致即配对;OpenSSL 3.0 中 pkey 已取代被弃用的 rsa 子命令
5. PKCS#12 与 PKCS#7
# 只读证书部分,不导私钥;老式 RC2/3DES 加密的 pfx 需 -legacy 加载 legacy provider
openssl pkcs12 -in a.pfx -nokeys -clcerts -passin pass:xxxx
openssl pkcs12 -in a.pfx -nokeys -clcerts -legacy -passin pass:xxxx
# p7b 证书包
openssl pkcs7 -inform DER -in bundle.p7b -print_certs -noout
6. 协议版本与套件
# 强制 TLS 1.2;-brief 为 3.0 新增,只输出协议与套件摘要
openssl s_client -connect example.com:443 -servername example.com -tls1_2 -brief </dev/null
# 输出示例:Protocol version: TLSv1.2 / Ciphersuite: ECDHE-RSA-AES256-GCM-SHA384
| 场景 | 子命令 | 关键参数与默认值 |
|---|---|---|
| 本地文件解码 | x509 | -inform 默认 PEM;-noout 必加 |
| 线上握手取链 | s_client | 默认最低协商 TLS 1.2;-servername 无默认值 |
| 吊销状态 | s_client -status | 期望 successful |
| 密钥配对 | x509 / pkey | 取 SPKI 后 sha256 比对 |
| 容器格式 | pkcs12 / pkcs7 | 3.0 读旧 pfx 需 -legacy |
安全级别方面,上游 OpenSSL 3.0 默认 SECLEVEL=1,但 Debian/Ubuntu 的打包版本普遍调为 2,这会导致 1024 位 RSA 或 SHA-1 证书直接握手失败并报 ee key too small;排查时用 openssl ciphers -v 'DEFAULT' | head -3 确认实际生效的级别,再决定是否在 openssl.cnf 中显式声明。
方案选型:x509、s_client、verify、ocsp 四条路径该用哪条
“我只想看一眼证书,为什么要记四五个子命令?”因为每个子命令解决的其实是不同问题:x509 只解析文件、不联网也不验证;s_client 抓的是线上 443 实际下发的字节;verify 才真正按信任锚逐级校验;ocsp 查的是吊销状态。先看下面这张选型表,再决定敲哪条(默认值以 OpenSSL 3.0.x 为准):
| 命令 | 读取对象 | 是否验证链 | 典型耗时 | 适用场景 |
|---|---|---|---|---|
openssl x509 -text |
本地 PEM/DER 文件 | 否 | < 10 ms | 批量巡检、CSR 与签发结果核对 |
openssl s_client -showcerts -servername |
线上 443 实际下发证书 | 默认不因失败退出,需加 -verify_return_error |
300–800 ms(取决于 RTT) | 排查“线上到底是哪张证书” |
openssl verify -CAfile -untrusted |
文件级证书链 | 是,返回码 0 为通过 | < 20 ms | 上线前 CI 卡点、换证后回归 |
openssl ocsp -issuer -cert -url -resp_text |
CA 的 OCSP 响应 | 是 | 200–1500 ms | 合规审计;但据 Let’s Encrypt 官方公告其已停用 OCSP,多数场景改用 CRL |
openssl x509 -checkhost / -checkip |
本地证书的主机名扩展 | 只比对 SAN 与 CN | < 5 ms | 换证后确认域名覆盖是否完整 |
openssl x509 -checkend 2592000 |
本地证书的 notAfter | 否,只做时间比较 | < 5 ms | 每日 cron 监控 |
最容易踩的坑是 s_client 的“假通过”。它在 OpenSSL 3.0 里即使校验失败也照常完成握手并打印 Verify return code: 21 (unable to verify the first certificate),退出码仍可能是 0,脚本据此判断会误判为健康。要让它像浏览器一样失败即退出,必须显式加 -verify_return_error,并加 -servername 触发 SNI——否则可能拿到该 IP 的默认站点证书,而不是你要的那张。
# 抓线上真实证书链并强制校验(OpenSSL 1.1.1+ / 3.0 均适用)
openssl s_client -connect example.com:443 -servername example.com
-showcerts -verify_return_error -verify_hostname example.com </dev/null
# -servername 必填:缺失 SNI 可能返回默认站点证书
# -verify_return_error:校验失败时非 0 退出(默认只打印 Verify return code)
# -showcerts:输出完整链,中间证书可另存用于 -untrusted
CI 卡点应该用 verify 而不是 x509 -text。因为 x509 根本不看签发关系,一张过期的、缺中间证书的叶子证书它照样“解析成功”。verify 的返回码是可编程的契约:0 通过,21 unable to verify the first certificate(通常是服务器漏发中间证书),2 unable to get issuer certificate,10 certificate has expired。
# 上线前回归:根证书做信任锚,中间证书放 -untrusted
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem
# 输出 leaf.pem: OK 且退出码 0 才算通过
# 换成真实系统信任库可用:-CAfile /etc/ssl/certs/ca-certificates.crt
监控脚本用 -checkend,别用 -text | grep notAfter 再解析日期。-checkend 直接做秒级时间比较,证书仍在有效期内则退出码 0,即将过期则 1,天然适配 cron 告警。86400 代表 1 天、2592000 代表 30 天、7776000 代表 90 天——后者正好对应 Let’s Encrypt 与多数 CA 的 90 天有效期,适合在签发后第 60 天触发续期告警。
# 每日巡检:域名覆盖 + 剩余有效期,全部本地完成
openssl x509 -in leaf.pem -noout -checkhost www.example.com
# 输出 ... does match / does NOT match;-checkip 用于 IP 证书
openssl x509 -in leaf.pem -noout -checkend 2592000 || echo "30 天内到期,需续期"
# DER 格式加 -inform DER;-noout 抑制 PEM 原文回显
吊销检查这条路正在变窄。openssl ocsp -issuer intermediate.pem -cert leaf.pem -url <OCSP地址> -resp_text -no_nonce 仍可用于审计,但据 Let’s Encrypt 公告其已停止提供 OCSP 响应并从证书中移除 OCSP URL,ocsp 面对这类证书只会报错退出;更通用的做法是拉取 CRL 后检查 openssl crl -in crl.pem -noout -nextupdate 是否新鲜,再交给 openssl verify -crl_check。
决策规则:查“内容对不对”用
x509 -text / -checkhost;查“线上发的是哪张”用s_client;查“这条链浏览器认不认”用verify;查“是否被吊销”优先 CRL。前三条都是毫秒级、可放进 CI 与 cron 的确定性检查,ocsp因依赖网络与 CA 可用性,不适合做阻断式卡点。
把命令固化:一份可放进监控与 CI 的批量体检写法
问:每次上线前手动敲 openssl x509 太慢,能不能把「openssl 查看证书信息」这件事固化成脚本,直接接到监控和 CI 里?能,而且不需要写 Python——openssl x509 的退出码本身就是为脚本设计的。据 OpenSSL 3.0 手册页 openssl-x509(1),-checkend arg 在证书将于 arg 秒内过期时返回 1,否则返回 0,这是所有批量体检的基石。
先看最小骨架。注意 -checkend 在证书无法解析时同样返回非 0,直接 || 会把「文件损坏」误报成「将过期」,所以生产脚本要分两步判断:
#!/bin/sh
# 适用:OpenSSL 3.0.x(Ubuntu 22.04 = 3.0.2,Ubuntu 24.04 = 3.0.13)
# 2592000 秒 = 30 天;剩 30 天内过期时 -checkend 返回 1
for f in /etc/nginx/ssl/*.pem; do
if ! openssl x509 -in "$f" -noout >/dev/null 2>&1; then
echo "PARSE_FAIL $f" # 证书损坏或不是 PEM
elif ! openssl x509 -in "$f" -noout -checkend 2592000 >/dev/null; then
echo "EXPIRING $f" # 剩余不足 30 天
fi
done
# 有输出即代表存在风险,Zabbix 用 zabbix_sender、Prometheus 用 textfile collector 采集即可
问:想要「还剩多少天」的精确数字,而不是布尔值?把 -enddate 的 GMT 字符串转成 epoch 再相减。GNU 与 BSD 的 date 参数完全不兼容,这是脚本在 macOS 上最常见的翻车点:
| 操作 | GNU coreutils(Linux) | BSD date(macOS) |
|---|---|---|
解析 Jun 1 12:00:00 2026 GMT |
date -d "$t" +%s |
date -j -f "%b %d %H:%M:%S %Y %Z" "$t" +%s |
| locale 风险 | 建议 LC_ALL=C |
%b 受 locale 影响,必须 LC_ALL=C |
# 取 NotAfter,形如 "Jun 1 12:00:00 2026 GMT"
t=$(openssl x509 -in cert.pem -noout -enddate | cut -d= -f2)
end=$(LC_ALL=C date -d "$t" +%s) # macOS 换成 date -j -f "%b %d %H:%M:%S %Y %Z" "$t" +%s
echo $(( end - $(date +%s) )) # 剩余秒数,负数代表已过期
问:怎么确认一张证书到底覆盖了几个域名、有没有通配符?-ext 是 OpenSSL 3.0 才加入的选项(1.1.1 只能用 -text 再 grep),配合 tr 就能数:
# 统计 SAN 中的 DNS 条目数
openssl x509 -in cert.pem -noout -ext subjectAltName | tr ',' 'n' | grep -c 'DNS:'
# 判断是否含通配符,避免误以为 *.example.com 覆盖了 a.b.example.com(它并不覆盖)
openssl x509 -in cert.pem -noout -ext subjectAltName | grep -q 'DNS:*' && echo "含通配符"
问:多张证书横向比对时,Subject 的顺序为什么总在变?因为默认 oneline 格式按 CA 的编码顺序输出 RDN。加 -nameopt RFC2253(见 RFC 2253)后顺序固定为从最具体到最一般,脚本按逗号切分不会错位:
openssl x509 -in cert.pem -noout -nameopt RFC2253 -subject -enddate -serial
# subject=CN=example.com,O=Example Inc,C=CN
# serial=0A1B2C3D...
# notAfter=Jun 1 12:00:00 2026 GMT
问:CI 里怎么卡住「快过期」和「链不全」的证书?在两个 OpenSSL 3.0 版本上各跑一次 verify,再用 7776000 秒(90 天)拦住剩余有效期不足的证书——据 Let’s Encrypt 文档,其证书有效期就是 90 天,这个阈值正好覆盖一个完整续期周期:
# .github/workflows/cert-check.yml 片段
strategy:
matrix:
os: [ubuntu-22.04, ubuntu-24.04] # OpenSSL 3.0.2 / 3.0.13
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
- run: |
set -euo pipefail
openssl version -a
# 1) 证书链校验,非 0 即 fail
openssl verify -CAfile chain/ca-bundle.pem -untrusted chain/intermediate.pem certs/*.pem
# 2) 剩余不足 90 天直接拦截发布
for f in certs/*.pem; do
openssl x509 -in "$f" -noout -checkend 7776000
|| { echo "::error file=$f::剩余有效期不足 90 天"; exit 1; }
done
失败时的典型输出是 error 10 at 0 depth lookup: certificate expired(过期)或 error 20 at 0 depth lookup: unable to get local issuer certificate(缺中间证书)——这两种报错分别对应「有效期」与「证书链」两类问题,正好由上面两条命令分工覆盖。把这两段固化进仓库后,openssl 查看证书信息就不再是排障动作,而是每次提交都会跑的门禁。
常见报错与排查:这些真实输出分别意味着什么
Q:openssl x509 报 unable to load certificate 加 error:0909006C:PEM routines:get_name:no start line,文件明明是证书?
这条错误只说明一件事:解析器在文件开头没找到 -----BEGIN 行。OpenSSL 3.0 的 x509 默认 -inform PEM,所以用 openssl 查看证书信息 时先确认文件真实格式。常见四种诱因:文件其实是 DER、开头带 UTF-8 BOM(EF BB BF)、前面粘了注释或命令行输出、复制进来的是 BEGIN PRIVATE KEY 私钥段。
# 1) 看前三行,正常首行必须是 -----BEGIN CERTIFICATE-----
head -3 cert.pem
# 2) 判断真实格式:PEM 显示 ASCII text,DER 显示 data
file cert.pem
# 3) DER 文件必须显式声明,否则报的正是 no start line
openssl x509 -in cert.der -inform DER -noout -subject -issuer -dates
# 4) 顺手剔除 BOM / 注释行(保留 BEGIN 到 END)
sed -n '/-----BEGIN CERTIFICATE-----/,/-----END CERTIFICATE-----/p' cert.pem > clean.pem
Q:OpenSSL 3.0 独有报错 error:1608010C:STORE routines:ossl_store_handle_load_result:unsupported 是什么意思?
3.0 引入了 OSSL_STORE 抽象层来统一加载密钥/证书对象,x509 只接受单个 X.509 证书(或证书串)。你把 PKCS#7(.p7b)或 PKCS#12(.p12/.pfx)直接喂给它,就会落到 STORE 的 unsupported 分支。据 OpenSSL 3.0 openssl-x509(1) 手册,可用输入仅为 PEM/DER 编码的证书。
# PKCS#7 证书包(常见于 Windows/IIS 导出的链)
openssl pkcs7 -in bundle.p7b -print_certs -noout
# PKCS#12:-nokeys 不要私钥,-clcerts 只要叶子证书
openssl pkcs12 -in full.p12 -nokeys -clcerts -out leaf.pem
openssl pkcs12 -in full.p12 -nokeys -cacerts -out chain.pem
Q:verify error:num=20 和 num=21 到底差在哪?
两者都指向“链不完整”,但断点不同:num=20 是“找不到某个证书的签发者”,多为 -CAfile 指错了根证书,或服务端没下发中间证书;num=21 是“只能验证到第一张(叶子)证书”,即中间证书缺失。RFC 5280 第 6 节要求验证方自建路径,所以服务端应下发 叶子+中间 的 fullchain(Let’s Encrypt 文档明确要求部署 fullchain.pem 而非 cert.pem)。
# 先看服务端到底发了什么
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1
| grep -E 'verify error|Verify return code|^ *[0-9]+ s:'
# 用本地 chain.pem 补齐后重跑:能验通即证明服务端漏发中间证书
openssl s_client -connect example.com:443 -servername example.com
-CAfile root.pem -untrusted chain.pem </dev/null 2>&1 | grep 'Verify return code'
Q:报 num=10 certificate has expired 或 num=9 certificate is not yet valid,但证书日期明明没过?
先怀疑本机时钟,而不是证书。OpenSSL 3.0 的校验同时受 -attime 与系统时间影响,NTP 偏差超过 5 分钟就足以触发。容器镜像(尤其是精简版 base image)没跑 NTP 客户端、宿主休眠后恢复,是最常见来源。执行 date -u 与证书日期(OpenSSL 输出一律为 UTC)逐字对比。
date -u
openssl x509 -in cert.pem -noout -dates # notBefore / notAfter 均为 UTC
timedatectl status # 或 chronyc tracking / ntpq -p
# 排除时钟干扰:指定一个已知时间点验证
openssl verify -attime $(date -d '2024-06-01' +%s) -CAfile root.pem cert.pem
Q:s_client 只输出 no peer certificate available?
这说明 TCP 连上了、TLS 握手也可能完成,但服务端没有发送 Certificate 消息。三种典型:端口不是 443(要写 -connect host:8443)、该端口只是 TCP 转发而 TLS 在别处终止、服务端 server 块没配 ssl_certificate。加 -state -msg 看是否走到 ServerHello 即可区分。
openssl s_client -connect host:8443 -servername host -state -msg </dev/null
# 非 HTTPS 协议需显式升级,否则永远拿不到证书
openssl s_client -connect host:587 -starttls smtp </dev/null
Q:Nginx 启动报 SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)?
证书与私钥不配对。用两条命令各算一次公钥指纹,比对 SHA-256 是否一致,即可定位是哪份文件放错。
openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256
openssl pkey -in privkey.pem -pubout | openssl sha256
| 报错片段 | 真实含义 | 一条命令确认 |
|---|---|---|
| error:0909006C … no start line | 不是 PEM / 有 BOM / 首行非 BEGIN | head -3 cert.pem |
| error:1608010C:STORE … unsupported | PKCS#7 或 PKCS#12 喂给了 x509 | file cert.p12 |
| verify error:num=20 | 找不到签发者,根或中间证书缺失 | openssl verify -CAfile root.pem -untrusted chain.pem cert.pem |
| verify error:num=21 | 仅验到叶子证书,链断在中间 | 同上 |
| num=10 / num=9 | 过期 / 未生效(常为时钟漂移) | date -u |
| no peer certificate available | 服务端未发证书或端口/协议不对 | openssl s_client -connect host:port -state |
| key values mismatch | 证书与私钥非同一对 | 两次 -pubkey | openssl sha256 |
效果验证:怎么确认你读到的是线上正在生效的那张证书
Q:本地 cert.pem 和线上正在跑的证书,怎么确认是同一张?
先做文件层比对:从证书里抽出三个可精确核对的字段——序列号(CA 签发记录里唯一)、SAN 条目数、notAfter(精确到秒),逐项与 CA 控制台的签发记录对齐。任何一项不一致,说明本地文件不是最新签发版本,后续所有验证都白做。
# OpenSSL 3.0.x / 1.1.1 通用;-ext 需 1.1.1 及以上
openssl x509 -in cert.pem -noout -serial -fingerprint -sha256 -dates -ext subjectAltName
# 输出示例:
# serial=03:A1:7F:...:9C
# SHA256 Fingerprint=4B:2E:...
# notBefore=Feb 1 00:00:00 2025 GMT
# notAfter=May 2 23:59:59 2025 GMT # 秒级,与 CA 记录比对
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:www.example.com
# 单独数 SAN 条数,方便与 CA 控制台条目数比对
openssl x509 -in cert.pem -noout -ext subjectAltName | tr ',' 'n' | grep -c 'DNS:'
Q:openssl verify 通过就代表链完整吗?
不够。本地 verify 用的是你指定的 CAfile,而真实客户端用的是系统信任库;必须再用 s_client 让服务端把链发过来验一遍。据 OpenSSL 3.0 手册页,s_client 默认不校验证书,需显式加 -verify_return_error 才会在失败时中止并回显错误码。
# 链层:查看服务端实际下发的证书序列(叶子在前,中间证书在后)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl crl2pkcs7 -nocrl -certfile /dev/stdin | openssl pkcs7 -print_certs -noout
# 期望看到 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -verify_return_error &1
| grep 'Verify return code'
# 典型失败:Verify return code: 21 (unable to verify the first certificate)
# Verify return code: 20 (unable to get local issuer certificate)
出现 20 或 21 基本都是 Nginx ssl_certificate 指向的文件里只放了叶子证书。修法是按「叶子 → 中间」顺序拼接(根证书不要放):
# fullchain.pem = 站点证书 + 中间证书,顺序不可颠倒
cat example.com.crt intermediate.crt > fullchain.pem
# nginx.conf
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/example.com.key;
nginx -t && nginx -s reload
Q:主机名和时间怎么一次性验完?
openssl x509 自 1.1.1 起提供 -checkhost / -checkip,匹配返回 0 并打印 does match certificate;不匹配返回 1;无法解析返回 2。-checkend 则返回 0 表示在指定秒数内不会过期。
openssl x509 -in cert.pem -noout -checkhost example.com # Hostname example.com does match certificate
openssl x509 -in cert.pem -noout -checkip 203.0.113.10 # IP 203.0.113.10 does match certificate
# 三档剩余有效期:1 天 / 30 天 / 90 天
for d in 86400 2592000 7776000; do
openssl x509 -in cert.pem -noout -checkend $d >/dev/null && echo "$d s: OK" || echo "$d s: 即将过期"
done
90 天阈值不是永恒的:据 CA/Browser Forum SC-081 ballot,公共 TLS 证书最长有效期将于 2026-03-15 收紧至 200 天、2027-03-15 至 100 天、2029-03-15 至 47 天,届时 -checkend 的告警档位与监控频率需同步下调。
Q:怎么确认服务端没有偷偷留着 TLS 1.0/1.1?
用 -brief 拿协议与套件,再和 nginx.conf 里的 ssl_protocols、ssl_ciphers 对照。据 Mozilla SSL Configuration Generator 的 intermediate 配置,ssl_protocols 应为 TLSv1.2 TLSv1.3。
openssl s_client -connect example.com:443 -servername example.com -brief </dev/null
# Protocol version: TLSv1.3
# Cipher: TLS_AES_256_GCM_SHA384
# Verification: OK
# 出现 TLSv1.1 说明旧协议未关
Q:还有必要用浏览器/curl 再验一遍吗?
有必要。openssl 只走一条路径,而真实客户端会做 AIA 补链、根证书交叉签名等额外动作。
curl -svI https://example.com 2>&1 | grep -E 'SSL certificate verify|expire date|subject'
# * SSL certificate verify ok.
# * expire date: May 2 23:59:59 2025 GMT
# * subject: CN=example.com
| 验证层 | 关键命令 | 通过判据 | 失败典型输出 |
|---|---|---|---|
| 文件层 | x509 -serial -dates -ext subjectAltName |
序列号/SAN/notAfter 与 CA 记录一致 | 序列号对不上 → 本地文件过期 |
| 链层 | s_client -verify_return_error |
Verify return code: 0 (ok) |
20 / 21 → 链不完整 |
| 主机名层 | x509 -checkhost / -checkip |
does match,exit 0 |
does NOT match,exit 1 |
| 时间层 | x509 -checkend N |
exit 0(未进入过期窗口) | exit 1 |
| 协议层 | s_client -brief |
Protocol 与 ssl_protocols 一致 |
Protocol version: TLSv1.1 |
| 客户端层 | curl -svI |
SSL certificate verify ok. |
SSL certificate problem |
六层里任意一层失败,其余五层的”通过”都不作数——这正是 openssl 查看证书信息 必须分文件、链、主机名、时间、协议、客户端六步走的原因,而不是只跑一条 openssl x509 -text 就下结论。
从「查看证书」延伸到证书治理:还能顺着这几条命令往下查
CT 日志里没有我的证书,是签发有问题吗?证书透明度(Certificate Transparency,RFC 6962)要求公开 CA 在签发时把证书提交到日志,SCT 以扩展形式内嵌进证书。一条命令就能数清:
# 适用 OpenSSL 3.0+;统计内嵌 SCT 条数
openssl x509 -in cert.pem -noout -text
| grep -A3 'CT Precertificate SCTs'
# 正常输出形如:
# CT Precertificate SCTs:
# Signed Certificate Timestamp:
# Version: v1 (0x0)
# 0 条 = 签发时未提交 CT 日志(OID 1.3.6.1.4.1.11129.2.4.2 缺失)
据 Let’s Encrypt 文档,其签发的每张证书都会提交到多个公开日志,因此内嵌 SCT 通常为 2 到 3 条;若为 0,多半是私有 CA、自签证书,或签发链路绕过了 CT。Apple 的 CT 政策(2018-10-15 起生效)要求所有 TLS 证书至少附带 2 条 SCT,Safari 与 macOS 会对不满足者告警——这也是”用 openssl 查看证书信息”时最容易被忽略的一项。
Must-Staple 到底写在哪、怎么看?它不在响应头里,而是证书扩展 TLS Feature(RFC 7633)中的 status_request:
# 直接读取 TLS Feature 扩展;无输出即未启用 Must-Staple
openssl x509 -in cert.pem -noout -ext tlsfeature
# X509v3 TLS Feature: critical
# status_request
# 对比:HSTS 在响应头,不在证书里
curl -sI https://example.com | grep -i strict-transport-security
# strict-transport-security: max-age=31536000; includeSubDomains
启用 Must-Staple 却未配置 OCSP stapling 时,Chrome 直接报 ERR_SSL_OCSP_STAPLING_REQUIRED,Firefox 报 MOZILLA_PKIX_ERROR_REQUIRED_TLS_FEATURE_MISSING,属于”证书本身合法但握手失败”的典型事故。
怎么确认自动续期链路真的通?certbot renew --dry-run 走完整 ACME 流程但不落盘,再配合 -checkend 校验剩余有效期(参数单位为秒,返回码 0 表示未过期,1 表示已过期或将过期):
sudo certbot renew --dry-run # 失败时常见:Hook command "..." returned error code 1
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem
-noout -checkend 2592000 && echo "剩余超过 30 天"
# -checkend 2592000 = 30 天;OpenSSL 3.0 默认无此参数,需显式给出秒数
双向 TLS 的客户端证书查什么?同样用 openssl x509 -text,重点确认 Extended Key Usage 含 TLS Web Client Authentication(OID 1.3.6.1.5.5.7.3.2),且 Issuer 是企业内部 CA:
openssl x509 -in client.pem -noout -text | grep -A2 'Extended Key Usage'
openssl s_client -connect api.example.com:443 -servername api.example.com
-cert client.pem -key client.key -CAfile internal-ca.pem
# 链不完整时报:verify error:num=21:unable to verify the first certificate
监控该抓哪几个数?只看”是否过期”太晚,建议把三项写入时序库:
| 指标 | 采集命令 | 健康区间 | 异常含义 |
|---|---|---|---|
| 剩余天数 | openssl x509 -enddate -noout |
> 21 天 | 续期钩子或 reload 失效 |
| SAN 条数 | openssl x509 -ext subjectAltName -noout |
与配置清单一致 | 配置漂移、漏签域名 |
| 链深度 | openssl s_client -showcerts -connect host:443 </dev/null | grep -c 'BEGIN CERTIFICATE' |
2~3 张 | 缺中间证书或误发根证书 |
SAN 数量突变往往先于告警出现,链深度从 3 掉到 2 则意味着中间证书被误删——这正是”openssl 查看证书信息”从一次性排查升级为持续治理的入口。
最省事的写法是 openssl x509 -in cert.pem -noout -subject -issuer -dates -ext subjectAltName -fingerprint -sha256,一行覆盖主题、签发者、有效期、域名和指纹五个核心字段。若要看全部扩展,把后面参数换成 -text 即可,OpenSSL 1.1.1 与 3.0.x 均支持。
两者读的对象不同:x509 读你指定的本地文件,s_client 读握手时服务端实际下发的证书。最常见原因是 s_client 漏了 -servername,导致命中了同 IP 上的默认虚拟主机;其次是本机文件还是上一版未替换的旧证书。先加 -servername 复测,再用 -showcerts 把叶子证书取出来与本地文件比对指纹。
这个报错基本是文件格式问题,常见于文件实际是 DER 编码、开头带 BOM 或混入了私钥段落。先用 head -3 cert.pem 看是否以 —–BEGIN CERTIFICATE—– 开头,是 DER 就补 -inform DER,是 p7b 或 pfx 就改用 openssl pkcs7 或 openssl pkcs12 子命令。
可以,用 openssl ocsp -issuer issuer.pem -cert cert.pem -url http://ocsp.example.com -resp_text 直接读取 OCSP 响应,或用 openssl crl 校验 CRL。差别在于浏览器普遍采用软失败策略,吊销查询超时仍会放行连接,而命令行会明确报出 revoked 状态。另需注意据 Let's Encrypt 公告,其 OCSP 服务已逐步下线,此类域名应改用 CRL 检查。
因为默认摘要算法不同。-fingerprint 在不指定算法时按 SHA1 计算,而 Chrome、Edge 展示的是 SHA-256。核对时统一加 -sha256,例如 openssl x509 -in cert.pem -noout -fingerprint -sha256,再与浏览器逐字符比对。
排障阶段优先用 openssl,因为它能精确区分本地文件、线上下发证书、链校验三个层面,且可在内网与 CI 中离线运行;在线工具(如 SSL Labs、各类证书检测站)更适合做协议套件、HSTS、CT 合规的整体评分。常见做法是先用 openssl verify 定位链问题,再用在线工具复核评分与兼容性。
执行 openssl verify -CAfile root.pem -untrusted chain.pem cert.pem,若返回 num=21 unable to verify the first certificate,说明服务端缺中间证书。修复方法是在 Nginx 的 ssl_certificate 指向的文件里按「叶子证书在前、中间证书在后」顺序拼接,注意不要放入根证书,拼接后重跑 verify 与 s_client 确认返回码为 0。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。