openssl s_client 检查证书实战:SNI、证书链与 OCSP 逐项判读
openssl s_client 检查证书的核心命令是 openssl s_client -connect 域名:443 -servername 域名 -showcerts -status -verify_return_error,输出中 Verify return code 为 0 (ok) 且 Certificate chain 至少 2 张才算链验证通过。 OpenSSL 3.0.13 下加 -verify_return_error 后验证失败返回非 0;不加时即使出现 verify error:num=20 连接仍可能返回 0,脚本巡检必须显式加上。 共享 IP 必须带 -servername,否则 SNI 缺失会拿到默认站点证书,常见报错为 verify error:num=62:hostname mismatch。 OCSP stapling 用 -status 查看,成功时显示 OCSP Response Status: successful (0x0);显示 no response sent 说明服务器未启用 stapling。 Let's Encrypt 证书默认 90 天有效期,建议用 openssl x509 -checkend 2592000 在剩余 30 天时告警,避免过期后才排查。
为什么 openssl s_client 检查证书会出现 verify error:问题背景与根本原因
结论先行:用 openssl s_client 检查证书时看到 Verify return code: 20 (unable to get local issuer certificate),绝大多数情况是服务器未发送中间证书,或者本地 CA 信任库不完整,证书文件损坏只占少数。关键点是:s_client 默认采用“宽松”策略,验证失败只打印错误码,仍会完成 TLS 握手,因此连接“看起来成功”,但验证码不是 0。据 OpenSSL 官方文档,只有加上 -verify_return_error 才会让验证失败中断连接。
# 复现最常见的报错(OpenSSL 1.1.1w / 3.0.x 行为一致)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1
| grep -E "verify error|Verify return code"
# 典型输出:
# verify error:num=20:unable to get local issuer certificate
# Verify return code: 20 (unable to get local issuer certificate)
| 根因 | 典型 verify 错误 | 一条命令定位 |
|---|---|---|
| 服务器只发叶证书,未发 intermediate | num=20 / code 20 | s_client -showcerts 数 BEGIN CERTIFICATE 条数 |
| 未显式指定 SNI | num=62 hostname mismatch | 对比加/不加 -servername 的 subject= |
| 证书链顺序错乱 | num=20 或 path length constraint | 看 depth=0/1/2 的 s: 与 i: |
| 系统时间偏差 | num=9 not yet valid / num=10 expired | date -u 对比 notBefore/notAfter |
| OpenSSL 版本不支持 TLS 1.3 | 握手阶段直接失败 | openssl version -a |
根因一:没发中间证书。RFC 5280 要求客户端从叶证书逐级构建到信任根,根证书由本地信任库提供,服务器只需发叶证书加中间证书。Nginx 的 ssl_certificate 必须指向 leaf+intermediate 拼接的 fullchain.pem,Apache 的 SSLCertificateFile 同理;只写 leaf.crt 就会得到 code 20。
# 服务器实际发了几张证书?1 = 只发了叶证书(缺中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
# 正确配置示例(Nginx)
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # leaf + intermediate
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
根因二:漏了 -servername。RFC 6066 定义 SNI 扩展,而 s_client 不会从 -connect 的域名自动推导 SNI。共享 IP、CDN 回源或多站点虚拟主机场景下,服务端会回默认站点证书,于是出现 num=62:hostname mismatch。排查时固定写成 -connect IP:443 -servername 域名。
根因三:链顺序错误。s_client 输出里 depth=0 必须是叶证书、depth=1 是中间证书,依次递增;把根证书也塞进 fullchain 不会修复问题,反而让部分客户端触发 path length constraint 报错。
根因四:时间偏差。证书有效期按 UTC 判定,偏差超过约 5 分钟就可能出现 num=9 或 num=10,NTP 未同步是最常见原因。
date -u # 本地 UTC 时间
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -dates # notBefore / notAfter
根因五:版本与协议不匹配。OpenSSL 1.0.2 不支持 TLS 1.3,只开 TLS 1.3 的站点会握手失败;1.1.1w(2018 年起的 1.1.1 系列)与 3.0.13 均支持 TLS 1.3。用 openssl version -a 确认后,旧版本可先以 -tls1_2 验证证书本身是否正常,再决定升级。
openssl version -a
# OpenSSL 1.0.2k-fips → 无 TLS 1.3
# OpenSSL 1.1.1w → 支持 TLS 1.3
# OpenSSL 3.0.13 → 支持 TLS 1.3
# 旧版本降级验证证书链是否 OK
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>&1
| grep "Verify return code"
openssl s_client 检查证书的完整实操步骤(6 步编号)
本节按“先固定变量、再逐项判读”的顺序给出 6 个可直接复制的步骤。整套流程在 OpenSSL 3.0.13(Ubuntu 24.04 默认)与 OpenSSL 1.1.1w(RHEL 8/CentOS 8 系)上验证过;命令输出格式在两代版本间略有差异,差异点会在对应步骤标注。
步骤 1:确认版本与 DNS 解析。版本决定 -status、-tlsextdebug 等选项的行为与输出格式,DNS 决定你实际连到哪个节点——如果站点位于 CDN 之后,不同 A 记录会返回不同证书(尤其是边缘证书与源站证书不同的场景)。先执行:
# 记录 OpenSSL 版本与编译参数,便于复现问题(3.x 与 1.1.1 输出格式不同)
openssl version -a
# 只取 A/AAAA 记录,确认本次检查的目标 IP;多记录时建议后续用 -connect 指定 IP 复测
dig +short example.com A
dig +short example.com AAAA
据 OpenSSL 官方文档,openssl version -a 会额外打印 OPENSSLDIR 与编译日期,排查“同一域名在两台机器结果不同”时这是第一手证据。
步骤 2:建立连接并抓取完整输出。把 stderr 与 stdout 分开保存,否则 -tlsextdebug 的扩展信息和 -showcerts 的 PEM 会混在一起难以解析。</dev/null 让 s_client 在握手后立即关闭,避免挂起等待标准输入:
# -servername 发送 SNI(共享 IP 托管多站点时必需)
# -showcerts 输出完整 PEM 链;-status 请求 OCSP stapling;-tlsextdebug 打印扩展
openssl s_client -connect example.com:443 -servername example.com
-showcerts -status -tlsextdebug /tmp/sclient.err | tee /tmp/sclient.out
注意:不写 -servername 时,服务器可能返回默认虚拟主机的证书,这是“浏览器正常但命令行报错”的最常见原因。
步骤 3:提取叶证书关键字段。-showcerts 输出中第一个 PEM 块是叶证书(服务器证书),后续是中间证书。用 awk 截取第一段再交给 x509:
# 取第一个证书块,只看主题、签发者、有效期与 SAN
awk '/BEGIN CERTIFICATE/,/END CERTIFICATE/' /tmp/sclient.out
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
判读重点:notAfter 是否临近(Let’s Encrypt 证书有效期 90 天,续期失败常在到期前 30 天内暴露);SAN 是否包含你实际访问的域名,通配符 *.example.com 不覆盖 example.com 本身,也不覆盖 a.b.example.com。
步骤 4:检查验证码与链深度。这是判断“证书本身没问题但链没配全”的关键:
# 提取验证结果、链结构与每级深度
grep -E 'Verify return code|Certificate chain|depth=' /tmp/sclient.out
常见取值对照(依据 OpenSSL 的 X509_V_ERR 定义与 RFC 5280 路径校验规则):
| 返回码 | 含义 | 典型原因 |
|---|---|---|
| 0 (ok) | 校验通过 | 链完整、主机名匹配、未过期 |
| 10 | certificate has expired | 叶证书或中间证书过期 |
| 20 | unable to get local issuer certificate | 服务器未发送中间证书(漏配 chain) |
| 21 | unable to verify the first certificate | 本地缺根证书或链断裂 |
| 62 | hostname mismatch | SNI 缺失或 SAN 不含该域名 |
若返回 20/21,可用 -CAfile /etc/ssl/certs/ca-certificates.crt 指定系统信任库复测,以区分“服务端漏发中间证书”与“本地信任库过旧”。
步骤 5:检查协议与套件。确认没有回落到 TLS 1.0/1.1(RFC 8996 已将其弃用):
# 查看协商协议、密码套件与临时密钥(前向保密证据)
grep -E 'Protocol|Cipher|Server Temp Key' /tmp/sclient.out
TLS 1.3 通常显示 TLS_AES_256_GCM_SHA384 与 X25519;TLS 1.2 显示 ECDHE-RSA-AES256-GCM-SHA384。出现 TLSv1 或 TLSv1.1 即需在服务端禁用,可用 -tls1_2 强制下限验证配置是否生效。
步骤 6:检查 OCSP stapling。stapling 让服务器代替客户端去查吊销状态,减少一次外连与隐私泄露:
# 查看 OCSP 响应状态;-status 已在步骤 2 中开启
grep -A2 'OCSP response' /tmp/sclient.out
出现 OCSP Response Status: successful (0x0) 说明 stapling 生效;出现 no response sent 说明服务器未启用、未缓存到有效响应,或证书链中缺少 OCSP responder 所需的中间证书。据 Let’s Encrypt 文档,其证书自 2025 年起逐步以短期证书与 CRL 为主,OCSP 的可用性会随 CA 策略变化,判读时需结合签发者确认。
openssl s_client 检查证书命令示例:SNI、证书链、OCSP 与协议参数
为什么一条命令就能同时验链、验名和验协议?因为 s_client 默认会做完整握手并打印对端证书链,但有两个容易被忽略的默认行为:验证失败不中断(仅打印 verify error,退出码仍为 0),以及不带 -servername 就不发 SNI,于是 CDN 会返回默认站点证书,导致你以为证书配错了。所以生产排查一律显式加 -servername 和 -verify_return_error(后者 OpenSSL 1.1.1 起可用,3.x 行为一致)。
基础检查(Debian/Ubuntu 的 CA bundle 路径;-verify_depth 默认值为 -1,即不额外限制深度):
# -servername 发 SNI;-showcerts 打印整条链;-verify_return_error 让验证失败时退出码非 0
# </dev/null 提供 EOF,避免 s_client 停在交互式 stdin
openssl s_client -connect sslgood.com:443 -servername sslgood.com
-showcerts -verify_return_error -verify_depth 5
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# 成功时末尾输出:Verify return code: 0 (ok)
# 缺中间证书时:verify error:num=21:unable to verify the first certificate
| 发行版 | CA bundle 路径 | 说明 |
|---|---|---|
| Debian / Ubuntu | /etc/ssl/certs/ca-certificates.crt | 由 ca-certificates 包生成,含 Mozilla 根列表 |
| RHEL / CentOS / Rocky | /etc/pki/tls/certs/ca-bundle.crt | 指向 /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem,可用 update-ca-trust 重建 |
| Alpine | /etc/ssl/cert.pem | 需先装 ca-certificates 包 |
脚本里怎么只取关键几行?OpenSSL 1.1.1 起支持 -brief,3.x 下输出稳定为协议版本、密码套件、对端证书、Verification: OK 几行,配合 -verify_return_error 即可用退出码做健康检查:
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error -brief </dev/null 2>&1
| grep -E 'Verification|Protocol|Ciphersuite'
# 输出示例:
# Protocol version: TLSv1.3
# Ciphersuite: TLS_AES_256_GCM_SHA384
# Verification: OK
只想看还有几天过期?把 s_client 的输出管道给 x509,注意 2>/dev/null 丢掉握手噪声:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate -subject -issuer
# notAfter=Jun 12 03:14:07 2026 GMT
OCSP stapling 怎么判读?-status 会请求 stapled 响应,-tlsextdebug 打印扩展协商细节:
openssl s_client -connect example.com:443 -servername example.com
-status -tlsextdebug </dev/null 2>/dev/null
| grep -E 'OCSP Response Status|This Update|Next Update|no response sent'
# OCSP Response Status: successful (0x0)
# This Update: Jun 1 00:00:00 2026 GMT
# Next Update: Jun 8 00:00:00 2026 GMT
# 若出现 "OCSP response: no response sent",说明服务器未启用 stapling
据 Let’s Encrypt 文档,OCSP 响应通常有效期数天,Next Update 已过期意味着服务端缓存刷新失败(常见于 nginx ssl_stapling on 但未配 resolver),此时浏览器会回退到自行查询 CA。
如何确认某协议版本被禁用?用 -tls1_2 / -tls1_3 强制指定;OpenSSL 3.0.13 与 1.1.1w 均支持 -tls1_3。测试已废弃的老协议需降安全级别,仅用于兼容性排查:
openssl s_client -connect example.com:443 -servername example.com -tls1_2
# 强制旧协议(OpenSSL 3.x 默认 SECLEVEL=2 会直接拒绝 TLS1.0)
openssl s_client -connect example.com:443 -servername example.com
-tls1 -cipher 'DEFAULT@SECLEVEL=0'
非 HTTP 服务也适用吗?适用,证书链与主机名校验逻辑完全相同,只是握手前要走 STARTTLS:SMTP 用 -starttls smtp、IMAP 用 -starttls imap、POP3 用 -starttls pop3,例如:
openssl s_client -connect smtp.example.com:25 -starttls smtp
-servername smtp.example.com -showcerts </dev/null
openssl s_client 检查证书与 curl、浏览器、在线工具的选型对比
排障时最常被问到的问题是:”浏览器打开正常,为什么脚本巡检却报证书错误?”答案往往在于不同工具对证书链、SNI 与退出码的处理方式完全不同。先看选型对比表(OpenSSL 3.0.x / curl 8.x 环境实测):
| 方案 | 链信息 | 退出码 | SNI | OCSP | 适用场景 |
|---|---|---|---|---|---|
openssl s_client |
完整链 + depth + Verify return code | 需 -verify_return_error 才非 0 |
需显式 -servername |
-status 可看 stapling |
脚本巡检、定位链缺失 |
curl -vI |
仅叶证书 subject/issuer/expire | 证书错误返回 60 | 自动从 URL 提取 | --cert-status(7.79+) |
快速看过期、简单健康检查 |
| 浏览器 | UI 展示链,无法导出验证码 | 不暴露 | 自动 | 隐藏 | 人工排障 |
| SSL Labs | 评分 + 完整链 | 在线,不适用 | 自动 | 显示 | 第三方复现、合规取证 |
输出差异是关键。据 OpenSSL 官方手册,s_client 会打印 Certificate chain、每一级的 depth=、末尾的 Verify return code,加 -status 还会输出 OCSP Response Status 与 Next Update;而 curl -vI 只回显叶证书的 subject、issuer、expire date,看不到链深度——链里少发中间证书时,curl 往往”看起来正常”,s_client 则直接暴露 depth=0 之后无 depth=1。
退出码差异最容易埋坑。s_client 默认即使验证失败也返回 0,脚本会误判为健康;必须加 -verify_return_error 才拿到非 0。curl 在证书验证失败时稳定返回 60(SSL certificate problem),所以简单健康检查用 curl 更省事。生产巡检推荐组合(OpenSSL 1.1.1w / 3.0.13 均适用):
# -servername 必须显式写,否则共享 IP 会拿到默认站点证书
# -verify_return_error 让验证失败返回非 0,脚本才能判断
# -status 请求 OCSP stapling;timeout 10 防止挂死
timeout 10 openssl s_client -connect example.com:443
-servername example.com
-verify_return_error
-status
-brief </dev/null
echo "exit=$?"
# 快速看过期时间(curl 7.79+ 可用 --cert-status 校验 stapling)
curl -vI https://example.com 2>&1 | grep -E "expire date|SSL certificate"
curl --cert-status -sI https://example.com -o /dev/null; echo "curl_exit=$?"
SNI 是最隐蔽的差异点。openssl s_client 不会自动发送 SNI,必须写 -servername example.com,否则在共享 IP 上会返回默认站点证书——这正是”浏览器正常、脚本报错”的典型成因。curl 与浏览器都会自动从 URL/地址栏提取 SNI,所以人工验证通过不代表裸 s_client 也通过。据 Let’s Encrypt 文档,SNI 是签发与部署多域名证书的前提,排查时应始终显式指定。
OCSP stapling 的可观测性也不同。s_client -status 直接打印 OCSP Response Status: successful (0x0) 与 Next Update,一眼看出服务端是否真的做了 stapling;curl 7.79+ 的 --cert-status 只能告诉你验证通过与否(失败退出码 91),细节不如 s_client;浏览器基本不展示 stapling 状态。版本层面,OpenSSL 3.0.13 支持 -brief 精简输出,1.1.1w 起支持 TLS 1.3,巡检脚本建议固定版本并在 CI 中锁定。第三方评分与链完整性复现交给 SSL Labs,人工快速看过期用 curl -vI,脚本化定位链缺失与 stapling 问题则用 openssl s_client 检查证书,三者互补而非替代。
openssl s_client 检查证书常见报错:verify error 20/21/62 排查
为什么浏览器正常,openssl s_client 检查证书却报 verify error 20?先分清 20 和 21:20 是“找不到本地签发者”,常见于服务器发了中间证书但客户端信任库缺对应根/中间;21 是“第一张证书就验不过”,高频原因是服务器只配了叶证书。用 -showcerts 数服务器实际下发的证书数量:
# 正常应 ≥2:叶证书 + 中间证书;输出 1 说明只发了 leaf
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c 'BEGIN CERTIFICATE'
# 输出示例:1
据 RFC 8446 §4.4.2,服务器应发送足够中间证书让对端构建到信任锚的链,根证书可省略。Nginx 修复时把中间证书拼在叶证书后面,顺序不能反:
cat example.com.crt intermediate.crt > fullchain.pem
# nginx.conf
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 必须指向 fullchain,不是单张 crt
ssl_certificate_key /etc/nginx/ssl/example.com.key;
nginx -t && nginx -s reload
若服务器链完整、只是本地库缺中间,用 -CAfile 指定包含中间证书的信任库,而不是单张叶证书:
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
# Verify return code: 0 (ok)
| 报错 | 含义 | 高频根因 | 一条命令定位 |
|---|---|---|---|
| num=20 | unable to get local issuer certificate | 缺中间证书或本地信任库不全 | -showcerts 数证书张数 |
| num=21 | unable to verify the first certificate | 服务器只配 leaf 证书 | grep -c 'BEGIN CERTIFICATE' |
| num=62 | hostname mismatch | SAN 不含该域名,或漏了 SNI | -ext subjectAltName |
| num=10 / 9 | 证书过期 / 尚未生效 | 本机时钟偏差或证书确实过期 | date -u 对比 -dates |
num=62 hostname mismatch 怎么查?用 OpenSSL 1.1.1+ 的 -ext subjectAltName 看 SAN;通配符 *.example.com 只匹配一级子域,不匹配 a.b.example.com。同时确认命令带了 -servername example.com,否则 SNI 缺省可能返回默认站点证书。
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -ext subjectAltName
# X509v3 Subject Alternative Name:
# DNS:example.com, DNS:*.example.com
num=10/9 时间报错先排除时钟:
date -u
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -dates
# notBefore=Mar 1 00:00:00 2025 GMT
# notAfter=May 30 00:00:00 2025 GMT
偏差超过 5 分钟先同步 NTP;证书确实过期则续期。据 Let’s Encrypt 文档,其证书默认 90 天有效期,官方建议剩余 30 天时续期。
sslv3 alert handshake failure 或 no protocols available时,分别锁定协议版本,再查套件安全级别:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null
openssl ciphers -v 'DEFAULT@SECLEVEL=2' | head
OpenSSL 3.0 默认 SECLEVEL=2,会拒绝 1024 位 RSA 与 SHA1 签名证书(见 OpenSSL 文档 ciphers(1));服务器若只开 TLS 1.2 且禁用旧套件,-tls1_3 就会报 no protocols available。最后,命令卡住无输出是因为 s_client 握手后仍等待 stdin,用 </dev/null 或 echo | 关闭输入,再加 timeout 10 防防火墙丢包挂起。
timeout 10 openssl s_client -connect example.com:443 -servername example.com </dev/null
echo | openssl s_client -connect example.com:443 -servername example.com
openssl s_client 检查证书后如何确认配置生效:6 个验收指标
改完 Nginx 或 OpenSSL 配置以后,最危险的动作是“重启没报错就以为生效了”。真正可靠的验收方式,是用 openssl s_client 做一次完整握手并留存输出,再对同一份输出逐项判读。下面 6 个指标构成一条最小可用的验收流水线:前 4 项看内容,后 2 项看协议与退出码。
先一次性采集原始输出,后续所有 grep 都基于它:
# -servername 显式发送 SNI(OpenSSL 不会自动发送,缺省时多域名/双证书站点会拿到错证书)
# -showcerts 打印完整证书链;-status 请求 OCSP stapling;</dev/null 防止阻塞在 stdin
openssl s_client -connect example.com:443
-servername example.com
-showcerts -status -tlsextdebug
/tmp/sclient.out 2>&1
echo "exit=$?"
指标 1:Verify return code 必须为 0 (ok)。据 OpenSSL verify(1) 手册,该字段是整条链校验的最终结论,非 0 即代表客户端视角的信任失败:
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error &1 | grep 'Verify return code'
# 通过:Verify return code: 0 (ok)
| 返回码 | 含义 | 常见根因 |
|---|---|---|
| 0 | ok | — |
| 20 | unable to get local issuer certificate | 本地缺根证书或服务端漏发中间证书 |
| 21 | unable to verify the first certificate | 服务端只发了叶证书,未带中间证书 |
| 62 | hostname mismatch | SNI 写错,或证书 SAN 不含该域名 |
指标 2:Certificate chain 至少 2 张且顺序正确。Let’s Encrypt 文档明确指出,服务端必须下发“叶证书 + 中间证书”,客户端一般不预置中间证书。检查张数与顺序:
grep -c 'BEGIN CERTIFICATE' /tmp/sclient.out # 输出 2 或 3 为正常
grep -E '^ *[0-9]+ s:|^ *i:' /tmp/sclient.out # 看链顺序
grep -E 'depth=[0-9]' /tmp/sclient.out # depth=0 叶证书必须出现在最前
指标 3:叶证书剩余天数 > 30 天。-checkend 的参数是秒数,2592000 = 30 天,返回 not expired 表示窗口内不会过期:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 2592000 -enddate
指标 4:OCSP stapling 为 successful (0x0)。OCSP 装订遵循 RFC 6066 的 status_request 扩展与 RFC 6960:
grep -E 'OCSP Response Status|Next Update|OCSP response:' /tmp/sclient.out
# 通过:OCSP Response Status: successful (0x0)
若输出 no response sent,说明 stapling 静默失败,按下面三行排查(Nginx 1.3.7+ 起支持,默认 ssl_stapling off):
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/fullchain.pem; # 必须含中间证书,否则 stapling 不生效
resolver 223.5.5.5 valid=300s;
resolver_timeout 5s;
指标 5:TLS 版本符合基线。分别强制协商,Protocol 行应命中预期版本;TLS 1.0/1.1 应握手失败(OpenSSL 3.x 默认已在安全级别 1 下禁用):
openssl s_client -connect example.com:443 -servername example.com -tls1_2 &1 | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1_3 &1 | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1_1 &1 | grep -i 'alert|Protocol'
指标 6:脚本退出码为 0。这是把 openssl s_client 检查证书接入 Zabbix、Prometheus textfile collector 或定时巡检的唯一可靠信号:
openssl s_client -connect example.com:443 -servername example.com
-verify_return_error /dev/null 2>&1; echo $?
# 输出 0 才可接入监控;非 0 时用指标 1~5 定位具体环节
验收顺序建议:先跑指标 6 拿到“是否通过”的布尔值,再回到
/tmp/sclient.out用指标 1~5 定位失败环节。Mozilla SSL Configuration Generator 生成的配置可作为协议基线与密码套件的对照参考。
openssl s_client 检查证书输出逐段解读:从 CONNECTED 到 Verify return code
很多人执行完 openssl s_client 检查证书后,只要看到第一行 CONNECTED(00000003) 就以为“证书没问题”——这是最常见的一次误判。据 OpenSSL 官方文档,CONNECTED 后面的数字是 BIO 文件描述符编号,它只证明 TCP 三次握手完成(TLS 1.3 下甚至只是 TCP 层完成,握手结果要看后面几行),跟证书是否受信、域名是否匹配、是否被吊销毫无关系。下面这条命令可以把所有关键判读项一次打印出来,适用于 OpenSSL 1.1.1 与 3.x(-showcerts、-status、-verify_hostname 均为可选开关,默认均不开启):
openssl s_client -connect example.com:443
-servername example.com # SNI,不写则可能拿到 CDN 的默认证书
-showcerts # 默认只打印叶证书,加此项才输出完整 PEM 链
-status # 发送 status_request,请求 OCSP stapling
-CAfile /etc/ssl/certs/ca-certificates.crt # 显式指定信任库,避免用错系统默认
-verify_hostname example.com # 1.1.0+ 支持,校验 SAN 是否匹配
</dev/null 2>&1 | tee s_client.log # 防止 stdin 挂起,同时留档
1. depth 行:看清楚服务器到底发了几张证书。
depth=2 C = US, O = Internet Security Research Group, CN = ISRG Root X1
verify error:num=20:unable to get local issuer certificate
verify return:1
depth=1 C = US, O = Let's Encrypt, CN = R3
verify return:1
depth=0 CN = example.com
verify return:1
| depth | 角色 | 典型 CN | 是否应由服务器发送 |
|---|---|---|---|
| depth=0 | 叶证书 | example.com | 是 |
| depth=1 | 中间证书 | R3 / R10 / E1 | 是 |
| depth=2 | 根证书 | ISRG Root X1 | 否,应由客户端信任库提供 |
出现 depth=2 且伴随 verify error:num=20,通常说明服务器把根证书也塞进了 Certificate 消息,而本地信任库没有它——这会白白增加约 1 KB 握手体积。据 RFC 8446 §4.4.2,certificate_list 只需按“叶证书 → 逐级中间证书”顺序排列,根证书可省略,因为客户端必须预先信任它。
2. verify error 行不等于失败。OpenSSL 默认行为是“打印错误但继续握手”(-verify_return_error 才会中断),所以你会看到错误行之后照样输出证书。排查时把 verify error:num=xx 与结尾的 Verify return code 对照看:前者告诉你哪一层断了,后者才是汇总结论。常见码:10 证书过期、20 缺少本地颁发者、21 无法验证第一张证书(中间证书缺失)、62 主机名不匹配。
3. Certificate chain 与 Server certificate 的区别。Certificate chain 段用 s:(subject)/ i:(issuer)列出链上每一环,但 PEM 正文只有加了 -showcerts 才完整;不加时只有叶证书,很容易误判“服务器只发了一张证书”。
4. Protocol 与 Cipher 行。
| 协议 | 典型输出 | 判读 |
|---|---|---|
| TLS 1.3 | TLS_AES_256_GCM_SHA384 |
密码套件名不含密钥交换/签名算法(RFC 8446 已解耦) |
| TLS 1.2 | ECDHE-RSA-AES256-GCM-SHA384 |
前缀 ECDHE 表示前向保密,RSA 是签名算法 |
| TLS 1.0/1.1 | ECDHE-RSA-AES256-SHA |
已被 RFC 8996 正式弃用,需调整协议基线 |
5. 最后一关:OCSP 与 Verify return code 必须同时满足。
OCSP response:
======================================
OCSP Response Data:
OCSP Response Status: successful (0x0) # stapling 成功;no response sent 表示服务器未启用
Verify return code: 0 (ok) # 链验证通过;非 0 即为失败
OCSP Response Status: successful (0x0) 只证明“服务器附带了一张有效的 OCSP 响应”,不证明“证书未被吊销”;Verify return code: 0 (ok) 只证明“链能建到受信根且域名匹配”,也不检查吊销。两者都出现且都为 0/ok,才算链完整性与吊销状态双双过关——这也是把 openssl s_client 检查证书 从“看一眼 CONNECTED”升级为可复核流程的关键。
用 openssl s_client 检查证书做生产巡检:脚本、阈值与告警
把 openssl s_client 从手工排查工具变成生产巡检任务,要解决三个问题:单域名挂起、阈值分级、结果可被监控系统消费。下面给出一套可直接运行的最小实现,适用 OpenSSL 3.0.13(Debian 12 / Ubuntu 22.04 默认)与 OpenSSL 1.1.1w(Ubuntu 20.04)。
巡检脚本怎么写,才不会因为一个域名卡死整轮?
#!/usr/bin/env bash
# cert_check.sh <domain> —— 单域名巡检,追加 Prometheus textfile 指标
# 适用:OpenSSL 3.0.13 / 1.1.1w
set -uo pipefail
CA=${CA:-/etc/ssl/certs/ca-certificates.crt} # RHEL/Rocky 改为 /etc/pki/tls/certs/ca-bundle.crt
OUT=${OUT:-/var/lib/node_exporter/textfile/ssl_cert.prom}
d=$1
tmp=$(mktemp)
# timeout 10:防止黑洞路由 / CDN 限速导致单域名挂起;-servername 必须显式传 SNI,
# 否则多站点 CDN 会回落默认证书,造成 "Verify return code: 62 (hostname mismatch)" 误报
timeout 10 openssl s_client -connect "$d:443" -servername "$d"
-verify_hostname "$d" -verify_return_error -CAfile "$CA"
< /dev/null > "$tmp" 2>&1
rc=$? # 0=链与主机名均通过;非 0 时具体原因在 Verify return code 行
pem=$(sed -n '/BEGIN CERTIFICATE/,/END CERTIFICATE/p' "$tmp")
if [ -z "$pem" ]; then # 连不上或超时
echo "ssl_cert_up{domain="$d"} 0" >> "$OUT"; rm -f "$tmp"; exit 0
fi
end=$(openssl x509 -noout -enddate <<<"$pem" | cut -d= -f2)
days=$(( ($(date -d "$end" +%s) - $(date +%s)) / 86400 ))
# -checkend 2592000(30 天):剩余不足时退出码为 1,与上面的天数互为校验
openssl x509 -noout -checkend 2592000 <<<"$pem" >/dev/null || warn=1
printf 'ssl_cert_expiry_days{domain="%s"} %dn' "$d" "$days" >> "$OUT"
printf 'ssl_cert_verify_ok{domain="%s"} %dn' "$d" "$([ "$rc" -eq 0 ] && echo 1 || echo 0)" >> "$OUT"
printf 'ssl_cert_chain_len{domain="%s"} %dn' "$d" "$(grep -c 'BEGIN CERTIFICATE' "$tmp")" >> "$OUT"
rm -f "$tmp"
注意不要把 s_client 和 openssl x509 串成一条管道后再取 $?——命令替换里的 PIPESTATUS 拿不到管道各段状态,你只会得到 sed 的退出码,校验失败会被静默吞掉。上面用临时文件承接 stdout+stderr,是更稳的写法。另外 -checkend 的 2592000 单位为秒,与剩余天数分开记录,避免”日期算错但 checkend 通过”的互相掩盖。
阈值怎么分级?据 Let’s Encrypt 文档,其证书有效期默认 90 天,官方 ACME 客户端在剩余 30 天时触发续期。因此”剩余 < 30 天”在 LE 场景下几乎等价于”自动续期没跑”,应查 systemctl list-timers | grep certbot 或 acme.sh 的 cron。
| 剩余天数 | 级别 | 动作 | 常见根因 |
|---|---|---|---|
| > 30 | 正常 | 不通知 | — |
| 7 ~ 30 | warning | IM / 邮件 | ACME 定时任务未执行、DNS-01 挑战失败 |
| 1 ~ 7 | critical | 值班电话 | CAA 拒绝签发、80 端口被封 |
| ≤ 0 或 verify_ok=0 | critical | 值班电话 | 已过期、链不完整(Verify return code: 20 (unable to get local issuer certificate)) |
并发与限速怎么做?用 xargs 控制并发度,单域名超时仍由脚本内的 timeout 10 兜底:
# domains.txt 每行一个域名;-P 10 并发 10 路,-n 1 每次传一个参数
xargs -a domains.txt -n 1 -P 10 -I{} ./cert_check.sh {}
# 巡检频率:普通站点每 6 小时一次;核心域名每 1 小时。对 Cloudflare/Akamai 等
# 前置 CDN 的域名不要更密,否则可能触发其边缘节点风控或返回 403 干扰判断
结果怎么接进监控?node_exporter 开启 --collector.textfile.directory=/var/lib/node_exporter/textfile 后,上面的 ssl_cert_expiry_days 会以 ssl_cert_expiry_days{domain="example.com"} 30 形式暴露,再用 Alertmanager 分级:
# prometheus/rules/ssl_cert.yml
groups:
- name: ssl_cert
rules:
- alert: SSLCertExpiring30d
expr: ssl_cert_expiry_days < 30
for: 1h
labels: { severity: warning }
annotations: { summary: "{{ $labels.domain }} 剩余 {{ $value }} 天" }
- alert: SSLCertExpiring7d
expr: ssl_cert_expiry_days < 7
labels: { severity: critical }
- alert: SSLCertVerifyFailed
expr: ssl_cert_verify_ok == 0 or ssl_cert_up == 0
for: 5m
labels: { severity: critical }
告警体里至少落四个字段:域名、notAfter、Verify return code、证书链张数(grep -c 'BEGIN CERTIFICATE'),OCSP 状态可另跑 openssl s_client -status 补充——只报”快过期”而丢掉 verify code,会把链配置错误误判成续期问题。
为什么必须固定 OpenSSL 版本?不同版本默认 SECLEVEL、TLS 1.3 支持与信任库路径都不同,同一份脚本在构建机和容器里可能给出相反结论。
| 版本 | 默认 SECLEVEL | TLS 1.3 | 状态 |
|---|---|---|---|
| OpenSSL 1.1.1w | 1(Debian 系编译为 2) | 支持 | 2023-09 结束公开维护 |
| OpenSSL 3.0.13 | 2 | 支持 | LTS,维护至 2026-09 |
把 openssl version -a 的输出一并写进巡检结果(如指标 ssl_check_info{openssl="3.0.13"}),容器镜像用摘要固定而非 latest;否则某次基础镜像升级后 SECLEVEL 从 1 提到 2,一批仅支持 TLS 1.0/弱 RSA 的老站点会突然集体告警,而证书本身毫无变化。
不是。Verify return code: 0 (ok) 只代表本地信任库对服务器发送的链验证通过,还需要看 SAN 是否覆盖目标域名、notAfter 剩余天数、OCSP stapling 状态和 TLS 协议版本。返回 0 不覆盖旧客户端兼容性,也不代表证书链顺序对所有人都最优。
openssl s_client 能显示完整 Certificate chain、depth、Verify return code 和 OCSP response,适合定位链缺失;curl -vI 只显示叶证书 subject、issuer、expire date,但证书错误时返回 60,适合快速健康检查。脚本巡检建议用 openssl s_client 加 -verify_return_error,快速看过期用 curl -vI。
因为 s_client 不会自动从 -connect 参数推导 SNI,RFC 6066 定义的 SNI 扩展需要显式发送。共享 IP 或 CDN 场景下不加 -servername 会拿到默认站点证书,常见结果是 verify error:num=62:hostname mismatch。
先看服务器是否只发了叶证书:用 -showcerts 统计 PEM 块数量,若只有 1 张,把 intermediate 拼入 fullchain.pem 并重载 Nginx/Apache。若服务器链完整,则本地 CA 信任库缺失,用 -CAfile 指定 /etc/ssl/certs/ca-certificates.crt 或 /etc/pki/tls/certs/ca-bundle.crt 复测。
可以,加 -status 参数。成功时输出 OCSP Response Status: successful (0x0),并带有 This Update 和 Next Update;显示 no response sent 表示服务器未启用 stapling 或未缓存到有效响应。Nginx 需要 ssl_stapling on、ssl_stapling_verify on 和可用 resolver。
Let's Encrypt 证书默认 90 天有效期,链通常包含 ISRG Root X1 或交叉签名中间证书,老 Android 兼容性要看交叉签名是否保留。用 openssl s_client -showcerts 确认链张数,用 openssl x509 -checkend 2592000 在剩余 30 天时告警。
s_client 会等待标准输入,命令末尾加
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。