跳到主要内容
基础知识

openssl s_client 检查证书实战:SNI、证书链与 OCSP 逐项判读

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

内容审核

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