OpenSSL 验证证书链实战:从 Nginx 报错到 openssl verify 与 s_client 逐段排查
openssl 验证证书链的核心命令是 openssl verify -CAfile root.pem -untrusted intermediate.pem server.pem,返回 server.pem: OK 且退出码为 0 才表示链完整;OpenSSL 3.0.x 会按 RFC 5280 校验证书有效期、Basic Constraints、Key Usage 与签名。 线上握手用 openssl s_client -connect example.com:443 -servername example.com -showcerts -verify_return_error,看到 Verify return code: 0 (ok) 才说明服务端发送链完整;只发叶子证书常见报错 unable to verify the first certificate。 信任库路径:Debian/Ubuntu 24.04 为 /etc/ssl/certs/ca-certificates.crt,RHEL 9 为 /etc/pki/tls/certs/ca-bundle.crt;openssl verify 未指定 -CAfile/-CApath 时不会自动使用系统库,需显式给出信任锚。 选型上,离线拆链校验用 openssl verify,线上 SNI 与 OCSP 用 s_client,应用侧回归用 curl --cacert,公开站点可用 SSL Labs 做旁证;三者应统一同一份根证书清单。 自动化巡检把 openssl verify 的退出码写入监控,0 为通过、2 为验证失败;配合 openssl x509 -checkend 2592000 -noout -in server.pem 在到期前 30 天告警。
为什么浏览器能打开,openssl 验证证书链却报 unable to get local issuer certificate?
先给结论:这不是证书本身有问题,而是”浏览器会自动补链,openssl 不会”。真实场景是:Nginx 1.24 的 ssl_certificate 只写了 server.crt,中间证书没有拼进去。Chrome 122 打开正常,因为桌面版 Chrome 会读取叶子证书 AIA 扩展里的 caIssuers URL,自动下载中间证书补齐链条;而同一台机器上:
# 复现:-servername 不能省,否则拿到的是默认虚拟主机证书
$ openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>&1 | grep -E "verify error|Verify return code"
depth=1 CN = R3
verify error:num=20:unable to get local issuer certificate
Verify return code: 20 (unable to get local issuer certificate)
# 直接验文件,同样失败
$ openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt server.crt
error 20 at 0 depth lookup: unable to get local issuer certificate
error server.crt: verification failed
把 openssl 验证证书链 失败拆开看,通常是下面五个原因之一,顺序也建议按这个顺序排查。
- verify 只认你显式给出的信任锚。据 OpenSSL 文档,
openssl verify的信任锚来自-CAfile或-CApath;两者都不给时才回落到编译期默认路径(用openssl version -d查看,Debian/Ubuntu 通常是/usr/lib/ssl)。openssl verify不会自动去读/etc/ssl/certs下的散列目录,除非你显式写成-CApath /etc/ssl/certs。Alpine、distroless 等精简镜像经常连ca-certificates包都没装,于是任何站点都报 error 20。 - 服务端没有发送中间证书。RFC 8446 第 4.4.2 节要求服务端发送叶子证书及全部中间证书,根证书不必也不应发送。只发叶子时,客户端无法构建到根的链,典型报错是
unable to verify the first certificate(error 21);出现 error 20 则说明连第一段中间证书都缺。用下面一条命令数清服务端到底发了几张证书:
# 正常应输出 2~3;输出 1 表示只发了叶子证书
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
# 修复:叶子证书必须在前,中间证书在后
cat server.crt intermediate.crt > fullchain.crt
# nginx.conf(Nginx 1.24 验证通过)
# ssl_certificate /etc/nginx/ssl/fullchain.crt;
# ssl_certificate_key /etc/nginx/ssl/server.key;
第三个原因最容易误判:客户端信任库根本不同。同一个站点,在不同信任库下执行 openssl 验证证书链,结论可以完全相反,所以排障前先确认命令用的是哪份 CA。
| 客户端 | 默认信任库 | 验证方式 |
|---|---|---|
| Chrome 122 | 系统根库 + 内置根,并支持 AIA 补链 | 地址栏锁图标 → 证书 → 证书路径 |
| curl 8.x(Debian 系) | /etc/ssl/certs/ca-certificates.crt |
curl -v https://www.example.com |
| openssl verify / s_client | 仅 -CAfile/-CApath,或编译期默认路径 |
openssl verify -CAfile ... |
| Java 17 | $JAVA_HOME/lib/security/cacerts(默认口令 changeit) |
keytool -list -cacerts |
第四个原因:SNI 与默认站点。多站点 Nginx 上执行 openssl s_client -connect 203.0.113.10:443 且不带 -servername 时,返回的是 default_server 的证书,链和域名都不匹配。加上 -servername www.example.com 后对比两次输出的 subject= 与 issuer= 行,差异一目了然;-servername 在 OpenSSL 1.1.1 及以后版本默认不开启 SNI,必须手动指定。
第五个原因:时间与安全级别。先用 date -u 和 openssl version -a 排除环境因素。系统时间超出证书 notBefore/notAfter 会报 certificate has expired / not yet valid;而 Ubuntu 22.04、RHEL 9 等发行版在 /etc/ssl/openssl.cnf 中设置 CipherString = DEFAULT@SECLEVEL=2(OpenSSL 3.0 默认安全级别为 1,发行版普遍上调到 2),SECLEVEL=2 要求 112 位安全强度,1024 位 RSA 与 SHA1 签名链会被直接拒绝,报 ee key too small 或 ca md too weak。临时降级可用 openssl verify -auth_level 1 ... 验证判断,但生产环境应更换为 2048 位 RSA 或 ECDSA P-256 证书。
做 openssl 验证证书链前要准备哪些文件与信任库?
问:动手跑 openssl 验证证书链之前,最少要准备哪些文件和信任库?
答:三张 PEM 证书(叶子 / 中间 / 根)+ 一份与运行环境匹配的系统信任库,再加一次版本确认。少任何一样,后面的 openssl verify 结果都不可信。
第一步:先确认 openssl 版本,别在 1.0.2 上找 -show_chain
据 OpenSSL 官方 verify(1ssl) 手册,-show_chain 自 1.1.0 起引入;CentOS 7 的 1.0.2k 会直接报 verify: Unknown option or option requires an argument: -show_chain。所以排查脚本必须按版本分支。
# 打印版本、编译日期、OPENSSLDIR(默认信任库目录)与引擎路径
openssl version -a
# 示例输出(Ubuntu 24.04):
# OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
# OPENSSLDIR: "/usr/lib/ssl"
# 判断是否支持 -show_chain,供脚本分支使用
openssl verify -help 2>&1 | grep -q show_chain && CHAIN="-show_chain" || CHAIN=""
| 系统 | 默认 openssl version | -show_chain |
排查策略 |
|---|---|---|---|
| Ubuntu 24.04 | OpenSSL 3.0.13 | 支持 | 直接 openssl verify -show_chain |
| RHEL 9 | OpenSSL 3.0.7 | 支持 | 同上 |
| CentOS 7 | OpenSSL 1.0.2k-fips | 不支持 | 改用 -CAfile 逐段验证,并注意 x509 -ext 同样缺失 |
| macOS 自带 | LibreSSL 3.3.x | 不支持 | 用 brew install openssl@3 后调 /opt/homebrew/opt/openssl@3/bin/openssl |
第二步:把 CA 下发的包拆成单张证书
从 CA 下载的 ca-bundle.crt 通常含多张中间证书,直接喂给 -untrusted 会因为顺序或冗余干扰判断。先列出主题再拆分:
# 只列主题与签发者,不输出正文
openssl crl2pkcs7 -nocrl -certfile ca-bundle.crt | openssl pkcs7 -print_certs -noout
# 转成纯 PEM 后按 BEGIN 行切分成 inter-00.pem / inter-01.pem ...
openssl pkcs7 -in ca-bundle.crt -print_certs -out chain.pem
csplit -z -f inter- -b '%02d.pem' chain.pem '/-----BEGIN CERTIFICATE-----/' '{*}'
第三步:确认信任库路径,别把宿主机路径套进容器
# Debian / Ubuntu:生成 /etc/ssl/certs/ca-certificates.crt
sudo update-ca-certificates
# RHEL / CentOS / Fedora:生成 /etc/pki/tls/certs/ca-bundle.crt
sudo update-ca-trust extract
# macOS 常见 /etc/ssl/cert.pem,或直接用 Keychain:
security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain > root.pem
容器里若没跑过上述命令,/etc/ssl/certs 可能是空的,此时 openssl verify 会报 unable to get local issuer certificate——这是信任库缺失,不是链断了。
第四步:逐项核对证书文本
openssl x509 -in server.pem -noout -subject -issuer -dates
-ext basicConstraints -ext keyUsage -ext extendedKeyUsage -ext subjectAltName
# 叶子证书应看到:CA:FALSE、TLS Web Server Authentication、SAN 含实际访问域名
# 若出现 CA:TRUE 说明拿错文件(很可能拿成了中间证书)
第五步:用 AKI/SKI 指纹先判链是否接得上
# 叶子证书的 Authority Key Identifier 应等于中间证书的 Subject Key Identifier
openssl x509 -in server.pem -noout -ext authorityKeyIdentifier
openssl x509 -in intermediate.pem -noout -ext subjectKeyIdentifier
openssl x509 -in intermediate.pem -noout -ext authorityKeyIdentifier
openssl x509 -in root.pem -noout -ext subjectKeyIdentifier
两段指纹对不上时,先怀疑「下错了中间证书」(同一 CA 常同时签发 RSA 与 ECDSA 两套中间证书,如 Let’s Encrypt 的 R3 与 E1),而不是继续调 openssl verify 的参数。
第六步:格式不对,一切免谈
# 快速判断:PEM 必须以 -----BEGIN CERTIFICATE----- 开头
head -1 server.pem
# DER 转 PEM
openssl x509 -inform DER -in server.der -out server.pem
# PKCS#7(.p7b)转 PEM
openssl pkcs7 -in chain.p7b -print_certs -out chain.pem
文件格式错误时,openssl 会直接抛 unable to load certificate(x509)或 Could not read any certificates(pkcs7),与链验证逻辑无关,必须先修格式。Mozilla 的 CA 证书存储文档也建议以 PEM 作为跨平台交换格式,可减少此类问题。
openssl 验证证书链的完整实操步骤怎么走?
问:手上有 server.pem、intermediate.pem、root.pem 三个文件,怎么一步步确认这条链到底通不通?按下面六步走,每一步都有明确的成功标志和失败含义,别跳步。
- 先证明根证书是自签且完整的。如果根证书本身有问题,后面所有验证都是在错误的信任锚上做无用功。
# 适用 OpenSSL 1.0.2+;root.pem 必须是完整 PEM(含 -----BEGIN/END CERTIFICATE-----)
openssl verify -CAfile root.pem root.pem
# 期望输出:root.pem: OK
# 若失败,先确认 subject 与 issuer 相同、且带 CA:TRUE
openssl x509 -in root.pem -noout -subject -issuer -text | grep -A1 "Basic Constraints"
若报 error 18 at 0 depth lookup: self-signed certificate,说明该文件没有被当作信任锚——最常见原因是把中间证书当成了根,或者 PEM 被截断。注意 -CAfile 里的证书才会被视为信任锚,这一点在 OpenSSL 的 verify(1) 手册里有明确说明。
- 用根 + 中间验证叶子。这一步才真正复现浏览器/客户端的构建路径。
# -show_chain 需要 OpenSSL 1.1.0+,先 openssl version 确认
openssl verify -verbose -show_chain
-CAfile root.pem -untrusted intermediate.pem server.pem
# 期望:server.pem: OK,且 Chain: 下依次出现 0 server.pem / 1 intermediate.pem / 2 root.pem
只看到 0、1 两层,说明服务器没发中间证书,或你漏传了 -untrusted;此时线上通常报 verify error:num=21:unable to verify the first certificate。
- 用系统信任库验证线上链。本地文件通过不代表线上部署正确。
# -servername 显式发送 SNI;-verify_return_error 让验证失败时中止握手
# (默认 s_client 验证失败仍会继续,只打印 Verify return code,容易误判)
openssl s_client -connect www.example.com:443 -servername www.example.com
-showcerts -verify_return_error
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 重点看 Verify return code: 0 (ok),并数一下服务器实际发了几张证书
把 -showcerts 的输出用 grep -c "BEGIN CERTIFICATE" 数一下:正常应为 2(叶子 + 中间),只有 1 说明链不完整。
- 校验链深与用途。
-purpose sslserver会按 RFC 5280 检查 EKU(须含 serverAuth 或缺失)与 KeyUsage,Web 证书必须过这一关。
# -verify_depth 默认 -1(不限制),Web 场景 2~3 层足够
openssl verify -verify_depth 3 -purpose sslserver
-CAfile root.pem -untrusted intermediate.pem server.pem
- 校验主机名。前面几步只验签名链,不验域名,会漏掉 SAN 缺失和通配符只匹配一级标签(RFC 6125)的问题。
# -verify_hostname 需要 OpenSSL 1.1.0+
openssl verify -verify_hostname www.example.com
-CAfile root.pem -untrusted intermediate.pem server.pem
- 用 curl 做端到端旁证。curl 走的是真实 HTTP 栈,能暴露 s_client 看不到的 SNI、代理和后端指向问题。
curl -v --cacert root.pem --resolve www.example.com:443:203.0.113.10
https://www.example.com/ -o /dev/null
# 期望出现:SSL certificate verify ok.
| 命令 | 验证对象 | 默认行为差异(易踩坑) |
|---|---|---|
openssl verify |
本地 PEM 文件的静态链 | 不校验主机名;-verify_depth 默认 -1 不限制;不带 -purpose 时不做 EKU 专项检查 |
openssl s_client |
线上实际发送的链 | 默认不发 SNI(须 -servername);默认验证失败不中止握手 |
curl |
端到端 HTTPS 请求 | 默认用系统信任库,--cacert 可覆盖;受代理与 DNS 影响 |
据 Let’s Encrypt 文档,绝大多数“链不完整”报错都源于服务器只发了叶子证书而漏发中间证书——第 2 步和第 3 步正是分别从文件侧和传输侧确认这件事。若 curl 通过而 s_client 失败,优先查 SNI 是否带对、是否被中间设备代理,以及 --resolve 是否把你指向了另一台后端。
openssl verify 与 s_client 的命令示例和参数怎么写?
离线验证整条链,一条命令就能判断问题出在叶子、中间证书还是根。关键点:-untrusted 只提供“候选中间证书”,本身不构成信任锚,信任锚只由 -CAfile / -CApath 指定——这正是很多人把 fullchain 一股脑塞给 -CAfile 却仍报错的根因。OpenSSL 3.0.13 实测:
# root.pem 只放根证书;intermediate.pem 放中间证书;server.pem 是叶子证书
# -show_chain 打印链上每级 subject 与是否被信任,-verbose 保留详细原因
openssl verify -CAfile root.pem
-untrusted intermediate.pem
-show_chain -verbose server.pem
# 成功输出(片段):
# server.pem: OK
# Chain:
# depth=0: CN = www.example.com (untrusted)
# depth=1: CN = R3, O = Let's Encrypt (untrusted)
# 失败输出(最典型):
# error 20 at 0 depth lookup: unable to get local issuer certificate
# 退出码:成功 0,验证失败 2 —— 可直接写进 CI 的 if 判断
error 20 at 0 depth 表示 depth 0 的叶子证书找不到签发者,九成是服务端漏发中间证书;若报 error 2 at 1 depth lookup: unable to get issuer certificate,则说明中间证书本身链不上根。
| 参数 | 作用 | 默认值与取值范围 |
|---|---|---|
-CAfile |
PEM 信任锚文件,可含多张 | 无默认,必须显式指定 |
-CApath |
哈希命名的信任目录 | 无默认;文件名须为 hash.N |
-untrusted |
提供候选中间证书,可重复 | 不参与信任判定 |
-partial_chain |
允许把非自签名中间证书当信任锚 | OpenSSL 1.0.2+,默认关闭 |
-show_chain |
打印构造出的链 | OpenSSL 1.1.0+ |
线上排查用 s_client,OpenSSL 1.1.1w 与 3.0.x 行为一致:
# -servername 触发 SNI(缺失会拿到默认虚拟主机的证书,RFC 6066 有明确要求)
# -showcerts 打印服务端实际发送的全部证书,而非只打印叶子
# -verify_return_error:默认验证失败仍继续握手,加上后立即中断并返回非零
# -status 请求 OCSP stapling;</dev/null 避免交互式等待
openssl s_client -connect www.example.com:443 -servername www.example.com
-showcerts -verify_return_error -status </dev/null
# 关注两行:Verify return code: 0 (ok) 与 OCSP response: no response sent
# 后者说明 Nginx 未开启 stapling 或未被正确缓存
把服务端发的链单独抠出来清点:
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null
| sed -n '/BEGIN CERTIFICATE/,/END CERTIFICATE/p' > chain.pem
# OpenSSL 1.1.1+ 的 storeutl 可直接解析 PEM 包,每张证书以 Certificate: 开头
openssl storeutl -noout -text -certs chain.pem | grep -c 'Certificate:'
用系统信任目录而不是单文件时,目录里的证书必须按哈希命名,否则会被静默忽略:openssl rehash /etc/ssl/certs(OpenSSL 1.1.0+ 内置;Ubuntu 长期提供的 perl 脚本 c_rehash 已由它取代)。之后执行 openssl verify -CApath /etc/ssl/certs -untrusted intermediate.pem server.pem。内部 CA 分权场景——根离线、只下发中间证书——用 openssl verify -partial_chain -CAfile private-root.pem -untrusted private-intermediate.pem server.pem,让校验在中间证书处合法终止。
Nginx 侧与上述排查一一对应:
server {
# fullchain.pem = 叶子在前 + 中间证书在后,顺序错了 s_client 立刻能看出来
# 根证书不要放进去:据 Mozilla Server Side TLS 指南,服务端只需发送叶子+中间
ssl_certificate /etc/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/server.key;
# 仅用于 stapling 校验的链文件,可与 fullchain 相同
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
ssl_stapling on;
ssl_stapling_verify on; # 默认 off,不显式打开等于没校验
}
改完配置 nginx -t && nginx -s reload,再用上面的 s_client 复测一次,Verify return code 从非 0 变 0 即闭环。这也是 openssl 验证证书链最实用的工作流:离线 verify 定位、在线 s_client 复核、配置层修正。
openssl 验证证书链用哪种方案?verify、s_client、curl 与在线工具对比表
线上 Nginx 或 curl 报 unable to get local issuer certificate 时,第一反应常常是“证书是不是过期了”,但真正要确认的是链上哪一段断了、比对的是哪一份信任库。不同工具看到的“链”根本不是同一份数据:openssl verify 看你手工拼出来的 PEM,s_client 看服务端实际发送的链,curl 看应用运行时加载的信任库。先用下表定位,再决定跑哪条命令。
| 方案 | 是否离线 | 是否验证完整链 | 是否检查主机名 | 是否看 OCSP | 适用场景 |
|---|---|---|---|---|---|
openssl verify |
离线 | 是(需 -CAfile + -untrusted 拼链) |
默认否,需 -verify_hostname(OpenSSL 1.1.0+) |
否 | 拆链排障、CI 中做证书链检查 |
openssl s_client |
在线 | 验证服务端实际发送的链 | 默认否,需 -verify_hostname |
是,-status 打印 stapling 响应 |
线上握手、SNI 与中间证书缺失定位 |
curl --cacert |
在线 | 是,按应用视角 | 是(默认开启) | 否(--cert-status 才查) |
确认应用运行时的信任库与主机名校验 |
| 在线工具(SSL Labs 等) | 在线 | 是,但不依赖本机信任库 | 是 | 部分支持 | 交叉验证、看评分与链完整性 |
| 编程库(Python/Go/Java) | 取决于实现 | 是 | 是(ssl/x509 默认校主机名) |
否 | 把校验写进发布流水线 |
离线拆链首选 openssl verify。据 OpenSSL 官方 openssl-verify(1) 文档,根证书用 -CAfile 指定,中间证书必须用 -untrusted 逐级补上——很多人只给了 -CAfile 就以为在验完整链,结果服务端证书仍报 error 20。退出码 0 表示链路(以及加了 -verify_hostname 时的主机名)全部通过,可直接写进 CI。
# OpenSSL 1.1.0+ 支持 -verify_hostname;1.0.2 无此选项
# -CAfile: 根证书;-untrusted: 中间证书,可重复传多个文件
openssl verify -CAfile root_ca.pem -untrusted intermediate.pem
-verify_hostname www.example.com server.pem
# 成功: server.pem: OK
# 失败: error 20 at 0 depth lookup: unable to get local issuer certificate
echo $? # 非 0 即失败,适合 CI 断言
线上握手用 s_client。它默认打印 verify 错误但不会因此失败,必须加 -verify_return_error 才以非 0 退出;-brief 从 OpenSSL 1.1.1 起可用,1.1.0 及更早没有。需要看 OCSP stapling 时加 -status,输出中会出现 OCSP Response Status: successful。
# -servername 显式传 SNI,避免命中默认站点拿到错误的证书链
openssl s_client -connect www.example.com:443 -servername www.example.com
-showcerts -verify_return_error -verify_hostname www.example.com
-status -brief
# -showcerts 打印服务端发送的全部证书,可用于核对是否漏发中间证书
应用侧回归用 curl。Ubuntu 22.04 自带 curl 7.81.0,默认信任库是 /etc/ssl/certs/ca-certificates.crt,由 ca-certificates 包提供——容器镜像里没装这个包,就会出现“本机 openssl 验证证书链通过、容器里失败”的经典偏差。
# --cacert 覆盖默认信任库,按应用视角校验链与主机名
curl -v --cacert ./root_ca.pem https://www.example.com/ 2>&1
| grep -E "SSL certificate verify|subject:|issuer:"
# 成功: SSL certificate verify ok.
# 失败: curl: (60) SSL certificate problem: unable to get local issuer certificate
怎么选?日常巡检和 CI 用 openssl verify 加退出码;线上故障用 s_client -showcerts -verify_return_error 看服务端到底发了什么;应用回归用 curl --cacert。关键是把三者的信任库统一到同一份根证书清单(例如 Let’s Encrypt 的 ISRG Root X1,据 Let’s Encrypt 文档其有效期至 2035 年),否则“本机通过、容器失败”会反复出现。在线工具只作交叉验证:它能发现中间证书漏发,但受网络与扫描队列影响,生产结论仍以本地命令为准。
openssl 验证证书链常见报错有哪些,怎么逐条排查?
先给结论:error N at M depth lookup 里,N 是 OpenSSL 的 X509_V_ERR 错误码,M 是验证链中的深度——0 是叶子证书(服务端证书本身),1 是签发它的中间证书,2 及以上是更上层。据 OpenSSL verify(1) 手册,深度指向的是“链上这一层”的问题,而不是你喂进去的文件顺序;看到 at 1 depth 就该先怀疑中间证书,而不是叶子。下面是六类高频报错的对照表,命令均以 OpenSSL 1.1.1 / 3.x 为准。
| 错误码与原文 | 典型根因 | 一条命令定位 |
|---|---|---|
| 20 unable to get local issuer certificate | 缺中间证书,或根不在 -CAfile |
openssl verify -CAfile ca.pem -untrusted int.pem server.pem |
| 21 unable to verify the first certificate | 服务端只发叶子证书 | s_client -showcerts | grep -c 'BEGIN CERT' |
| 18 self-signed certificate | 自签根未受信,或根被误发到链里 | openssl x509 -in c1.pem -noout -subject -issuer |
| 10 certificate has expired | 叶子或根过期 | openssl x509 -in server.pem -noout -dates |
| 7 certificate signature failure | 中间与叶子不匹配、文件截断、SHA1 被拒 | openssl verify -show_chain ... |
| 62 hostname mismatch | SAN 不含访问域名,通配符层级不符 | openssl x509 -in server.pem -noout -ext subjectAltName |
error 20 怎么查?先用 -noout -issuer 读出叶子声明的签发者,再确认这个 issuer 的证书是否作为 -untrusted 传入。-untrusted 可一次传多个中间证书(拼接在同一文件),OpenSSL 会自行组链:
# 1) 看叶子声明的 issuer 是谁
openssl x509 -in server.pem -noout -issuer -subject
# 2) 指定信任根 + 中间证书重新验证;-show_chain 打印实际组出的链(OpenSSL 1.1.0+)
openssl verify -show_chain
-CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted intermediates.pem server.pem
# 3) 不指定 -CAfile 时用的是编译期默认信任库,路径由此查看
openssl version -d # 输出 OPENSSLDIR,如 "/usr/lib/ssl"
error 21 怎么查?这几乎是 Nginx 的“经典错误”:ssl_certificate 只配了 server.crt,没有拼接中间证书。据 Let’s Encrypt 文档,fullchain.pem 就是叶子加中间证书的拼接文件,应作为 ssl_certificate 的值。改完 nginx -s reload 后验证发送的证书数量必须 ≥ 2:
# 统计服务端实际发送的证书条数,正常公网站点应为 2(叶子+中间)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| grep -c 'BEGIN CERTIFICATE'
error 18 与 error 10 怎么区分?前者是“链里出现了自签证书但没被信任”,私有 CA 场景把根加进 -CAfile 即可;公网场景则往往是运维误把根证书拼进了发送链——根证书不应由服务端发送,客户端本地已有。后者是时间问题:-dates 会同时给出 notBefore/notAfter,注意根证书过期同样会让整条链失败。Let’s Encrypt 的 ISRG Root X1 有效期到 2035 年 6 月,而旧的交叉签名链(DST Root CA X3)已于 2021 年 9 月 30 日到期,这也是大量 Android 老设备报 error 10 的历史原因。
error 7 与 num=62 怎么查?error 7 表示“这一层证书的签名验不过”,先看 -show_chain 打印的主题是否与预期 issuer 一致,再核对 AKI/SKI 是否配对;OpenSSL 3.x 在 Debian/Ubuntu 的默认配置为 DEFAULT@SECLEVEL=2,SHA1 签名的中间证书会被直接拒绝,需要换用 SHA256 链。num=62 来自 s_client 的校验输出,链本身是通的,只是 SAN 不匹配;注意通配符只匹配一级,*.example.com 不匹配 a.b.example.com(RFC 6125 的匹配规则)。另外 openssl verify 默认不校验主机名,必须显式加参数才会触发 62:
openssl x509 -in server.pem -noout -ext subjectAltName # OpenSSL 1.1.1+
openssl verify -verify_hostname example.com
-CAfile ca.pem -untrusted intermediates.pem server.pem # 主动触发主机名校验
怎么确认 openssl 验证证书链已经生效?
先把一句话结论说清楚:openssl 验证证书链是否生效,唯一可信的信号是进程退出码,不是日志里那一行 “OK”。因为 openssl verify 默认会把每个证书的校验结果打印成 server.pem: OK,但只要你传了多个文件,或者中途有 stderr 警告,人眼很容易误读。据 OpenSSL 官方文档 verify(1),命令成功返回 0,证书校验失败返回 2,其他内部错误返回 1 —— 所以脚本里必须显式捕获 $?。
第一步:用退出码做布尔判断。下面的写法在 CentOS 7 的 OpenSSL 1.0.2k、Ubuntu 22.04 的 OpenSSL 3.0.x 上行为一致:
# -CAfile 指定受信任根;-untrusted 指定中间证书(可多个文件/可重复传参)
openssl verify -CAfile root.pem -untrusted intermediate.pem server.pem >/tmp/verify.log 2>&1
rc=$?
echo "exit=$rc" # 0=通过,2=校验失败,1=参数/IO 错误
[ "$rc" -eq 0 ] || cat /tmp/verify.log
如果你在日志里看到 error 20 at 0 depth lookup: unable to get local issuer certificate,退出码必然是 2,说明中间证书没进链,而不是根证书有问题。
第二步:用 -show_chain 确认链的层数。该选项从 OpenSSL 1.1.0 起提供:
openssl verify -show_chain -CAfile root.pem -untrusted intermediate.pem server.pem
# 期望输出:
# server.pem: OK
# Chain:
# depth=0: CN = www.example.com (untrusted)
# depth=1: CN = R3 (untrusted)
# depth=2: CN = ISRG Root X1 (untrusted)
只出现 depth=0 一层,基本可以断定 intermediate.pem 是空文件或主题不匹配——用 openssl x509 -in intermediate.pem -noout -subject -issuer 核对 subject 是否等于叶子证书的 issuer。
第三步:验证线上真实握手,而不是本地文件。据 OpenSSL 文档,-brief 自 1.1.0 引入,1.1.1 及以上输出最完整:
openssl s_client -connect www.example.com:443 -servername www.example.com
-verify_return_error -brief </dev/null
# 期望包含:Verification: OK
# 以及 Protocol version: TLSv1.3 / Cipher: TLS_AES_256_GCM_SHA384
# -servername 必加,否则 CDN 多域名场景会取到默认证书
第四步:换应用视角交叉验证。客户端信任库和 OpenSSL 默认路径常常不是同一份文件:
curl -v --cacert root.pem https://www.example.com/ -o /dev/null
# 期望 stderr 出现:SSL certificate verify ok.
# 容器内复跑同一命令,并对比信任库:
docker run --rm -it myimage sha256sum /etc/ssl/certs/ca-certificates.crt
sha256sum /etc/ssl/certs/ca-certificates.crt # 两值不一致即为“容器内报错、宿主机正常”的根因
第五步:OCSP stapling 是独立开关,不能由 verify 通过推出。
openssl s_client -connect www.example.com:443 -servername www.example.com -status </dev/null
| grep -A2 'OCSP response'
# 生效:OCSP Response Status: successful (0x0)
# 未生效:OCSP response: no response sent
# 排查方向:Nginx 需同时开启 ssl_stapling on; ssl_stapling_verify on;
# 且 resolver 必须指向可达 DNS,否则 1.19.x 上会静默失败
各检查手段的定位差异如下,建议按顺序组合使用而不是任选其一:
| 检查手段 | 验证对象 | 通过判据 | 典型误判 |
|---|---|---|---|
openssl verify |
本地 PEM 文件链 | 退出码 0 | 只看 “OK” 忽略 error 20 |
verify -show_chain |
链层数与顺序 | depth 0/1/2 齐全 | 中间证书为空文件 |
s_client -brief |
线上握手 + 服务端下发链 | Verification: OK |
漏 -servername |
curl --cacert |
应用侧信任库 | SSL certificate verify ok |
宿主机与镜像信任库不同 |
s_client -status |
OCSP stapling | successful (0x0) |
缺 resolver 静默失效 |
第六步:把上面几步固化成巡检。cron 每 5 分钟跑一次,非 0 退出即告警;到期提醒用 -checkend(单位秒,2592000 = 30 天):
#!/bin/sh
# /etc/cron.d/certcheck 内:*/5 * * * * root /usr/local/bin/certcheck.sh
openssl verify -CAfile /etc/ssl/root.pem -untrusted /etc/ssl/intermediate.pem
/etc/nginx/ssl/server.pem >/dev/null 2>&1 || echo "CHAIN FAIL" | mail -s cert alert@example.com
openssl s_client -connect www.example.com:443 -servername www.example.com
-verify_return_error -brief </dev/null 2>&1 | grep -q 'Verification: OK'
|| echo "HANDSHAKE FAIL" | mail -s cert alert@example.com
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/server.pem
|| echo "EXPIRING <30d" | mail -s cert alert@example.com
把这一节的检查链和前面 Nginx 报错、s_client 逐段排查的内容串起来看,你会发现 openssl 验证证书链的失败几乎都落在三类:中间证书缺失、SNI 未指定、信任库不一致。自动化巡检的价值在于把这三类从”上线后偶发”变成”5 分钟内可见”。
进阶:交叉签名、私有 CA 与容器环境下的 openssl 验证证书链
交叉签名链为什么会让 openssl verify 选错根?
交叉签名(cross-signing)指同一张中间证书(同一公钥、同一 Subject)被两个不同的根分别签发,Let’s Encrypt 从 DST Root CA X3 过渡到 ISRG Root X1 期间就是典型场景。服务端通常只下发一张中间证书,而不同客户端的本地信任库里锚点不同,构出的链自然不同。据 OpenSSL 文档,-trusted_first 从 1.1.0 起默认开启(对应 RFC 4158 的信任锚优先构建策略),会优先用信任库里的根拼出最短链;1.0.2 及更早需要手动加上这个开关。
# -show_chain 打印实际构建出的链(OpenSSL 1.1.0+ 才有)
openssl verify -show_chain -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.pem
# 报错 unable to get local issuer certificate(错误码 20)时,
# 先看 chain 有几层、每层签发者是谁,再判断服务端是否漏发中间证书
私有 CA 怎么签出能通过 openssl verify 的链?
根证书自签,中间证书的 basicConstraints 必须是 critical,CA:TRUE,pathlen:0,叶子证书必须 CA:FALSE,否则会直接报 invalid CA certificate(错误码 79)。
# 1) 生成根(-addext 需要 OpenSSL 1.1.1+;1.0.2 请改用 -extensions 配合配置文件)
openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes
-keyout ca.key -out ca.crt -subj '/CN=Internal Root CA'
-addext 'basicConstraints=critical,CA:TRUE'
# 2) 核对中间证书扩展是否合规
openssl x509 -in mid.crt -noout -text | grep -A1 'Basic Constraints'
# 期望输出: CA:TRUE, pathlen:0
容器里没有 update-ca-certificates 怎么办?
Alpine 的信任库落在 /etc/ssl/certs/ca-certificates.crt,执行 apk add --no-cache ca-certificates && update-ca-certificates 即可刷新。Distroless / scratch 镜像既无包管理器也无 update-ca-certificates,只能在构建阶段从 builder 阶段复制该文件,运行时用 -CAfile 显式指定,不要指望环境变量 SSL_CERT_FILE 在非 OpenSSL 调用链里生效。
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted intermediate.pem leaf.pem
握手成功但 verify 失败,怎么用 s_client 定位?
# OpenSSL 3.0 默认启用 TLS 1.3;-servername 触发 SNI,避免拿到默认站点的链
openssl s_client -tls1_3 -connect www.example.com:443
-servername www.example.com -showcerts -CAfile /etc/ssl/certs/ca-certificates.crt
若 -showcerts 只吐出一张叶子证书,说明服务端没配 ssl_certificate 拼接的 fullchain,旧客户端(不缓存中间证书)会失败,而新浏览器靠 AIA 补链仍能成功——这正是“浏览器正常、命令行报错”的常见成因。
证书透明度与 OCSP 能替代链验证吗?
不能。openssl s_client -ct 展示 SCT(RFC 6962)、-status 发起 OCSP 查询(RFC 6960),它们只解释浏览器与命令行行为差异,链的构建仍由 openssl verify 负责,两者需分别排查。
| 能力 | OpenSSL 1.0.2k(CentOS 7) | OpenSSL 3.0.13(Debian 12 / RHEL 9) |
|---|---|---|
verify -show_chain |
不支持 | 支持 |
verify -verify_hostname |
不支持 | 支持 |
| 主机名校验替代方案 | x509 -checkhost |
x509 -checkhost / -verify_hostname |
verify -trusted_first |
存在但需显式指定 | 默认开启(1.1.0 起) |
| 默认协商版本 | TLS 1.2 | TLS 1.3 |
req -addext |
不支持 | 支持 |
实操建议:把 openssl version -a 的输出写进排障脚本开头,升级到 3.0.13 后再统一 -show_chain 与 -verify_hostname 参数,避免同一份脚本在 CentOS 7 上直接报 unknown option。
浏览器用系统或内置根库,并会通过 AIA 补中间证书;openssl verify 只信 -CAfile/-CApath 指定的信任锚,且不会自动下载中间证书。用 openssl s_client -showcerts 对比服务器实际发送链,再决定是补中间证书还是补信任库。
先看叶子证书 issuer,确认 -untrusted 传入了对应中间证书,且 -CAfile 含签发它的根证书。常见修复是把中间证书拼进 fullchain.pem,再用 openssl verify -show_chain 确认 0/1/2 三层齐全。
openssl verify 是离线文件校验,适合拆链、CI 和排查中间证书缺失;s_client 走真实 TLS 握手,能看 SNI、服务器实际发送链和 OCSP stapling。排障顺序建议先 s_client -showcerts 取链,再 openssl verify 分段验证。
不需要。按 TLS 实践,服务端发送叶子证书和中间证书即可,根证书由客户端信任库提供;把根证书放进发送链会增加握手字节,并可能触发 self-signed certificate in certificate chain。Nginx 的 ssl_certificate 用叶子加中间,ssl_trusted_certificate 才放根或链。
可以,OpenSSL 1.1.0+ 用 openssl verify -verify_hostname www.example.com -CAfile root.pem -untrusted intermediate.pem server.pem;OpenSSL 1.0.2 用 openssl x509 -checkhost www.example.com -noout -in server.pem。只跑不带主机名参数的 openssl verify 只验证签名链,不验证 SAN。
先确认 curl 使用的信任库,curl -v 会显示 CAfile 路径;容器内常见 CA 包缺失或 –cacert 指向旧根。再用 openssl s_client -connect 看是否 SNI 返回了另一张证书,必要时加 –resolve 固定 IP。
把私有根证书作为 -CAfile,中间证书用 -untrusted,执行 openssl verify -CAfile private-root.pem -untrusted private-intermediate.pem server.pem。若中间证书本身就是信任锚,可加 -partial_chain(OpenSSL 1.0.2+),并确保中间证书 basicConstraints=CA:TRUE。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。