跳到主要内容
基础知识

openssl 查看证书信息:用 x509 与 s_client 核对 SAN、有效期和证书链(OpenSSL 3.0)

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

内容审核

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