跳到主要内容
基础知识

SSL证书检测工具怎么用?从证书链不完整到 OCSP 超时的排查与复测

ssl证书检测工具 — SSL证书检测工具怎么用?从证书链不完整到 OCSP 超时的排查与复测
核心结论

SSL 证书检测工具的核心用途是复现客户端握手过程并定位四类问题:证书链不完整、主机名不匹配、协议或套件不兼容、证书过期或吊销,其中证书链不完整约占生产环境证书报错的六成以上。 一条命令即可看到服务器真实下发的证书链:openssl s_client -connect example.com:443 -servername example.com -showcerts,输出里出现 verify error:num=21 说明中间证书没下发。 修复链问题的最小动作是把 leaf 与 intermediate 拼成 fullchain.pem(cat cert.pem intermediate.pem > fullchain.pem),再在 nginx 的 ssl_certificate 指向该文件并 reload。 上线前用 testssl.sh 3.2 做基线(--severity HIGH --protocols --std --jsonfile out.json),对外评级可用 SSL Labs API v3 的 analyze 接口,注意结果有缓存、需加 startNew=on 强制重扫。 证书有效期已进入缩短周期:CA/Browser Forum 现行上限 398 天,SC-081 规划 2026-03 起 200 天、2027 年 100 天、2029 年 47 天,监控阈值建议设在剩余 21 天。

一、证书装了却报错?SSL 证书检测要定位的 4 类根本原因

证书装完、浏览器显示小锁,可 curl 或 Java 客户端却抛出 unable to get local issuer certificate——这类”浏览器正常、程序报错”的错配,正是 ssl证书检测工具 要回答的核心问题:不是证书有没有装,而是服务端实际下发了什么、客户端又按什么规则校验。按线上故障频次排序,根因集中在四类。

1. 证书链不完整(最高频)。服务端只下发叶子证书,没附中间证书。Chrome、Firefox 会顺着 AIA(Authority Information Access)扩展回源补齐,所以本机看着一切正常;但 Java、Python requests、Go 的 crypto/x509 默认根池、Android 7.1 都不会做这个回源动作,直接校验失败。据 RFC 5280 §4.2.2.1,AIA 只是可选的非关键扩展,规范从未要求客户端据此抓取证书,服务器必须主动下发完整链。用一条命令看清服务端到底给了几张证书:

# -servername 不可省:SNI 站点若省略,会拿到默认站点证书,排查结论全错
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | awk '/BEGIN CERT/{n++} n{print > "chain-" n ".pem"}'
# 逐张看 subject/issuer/dates:leaf 的 issuer 应等于下一张 intermediate 的 subject
for f in chain-*.pem; do echo "== $f"; openssl x509 -in "$f" -noout -subject -issuer -dates; done
# 用系统根池验证整链,-untrusted 传入中间证书;链缺失时复现 error 20
openssl verify -untrusted chain-2.pem -CAfile /etc/ssl/certs/ca-certificates.crt chain-1.pem
# 报错样例:chain-1.pem: CN = example.com
#           error 20 at 0 depth lookup: unable to get local issuer certificate

2. 主机名不匹配。判定依据是 SAN(subjectAltName),不是 CN。据 Chromium 官方公告,自 Chrome 58(2017-04)起 CN 被完全忽略,只写 CN 的证书在现代浏览器里等同无效。通配符 *.example.com 只覆盖一级子域,既不含裸域 example.com,也不含 a.b.example.com。确认方式:

openssl x509 -in chain-1.pem -noout -ext subjectAltName
# 期望输出:X509v3 Subject Alternative Name:
#             DNS:example.com, DNS:*.example.com

3. 协议与套件不兼容。服务端只开 TLS 1.3、客户端最高 TLS 1.2 时,OpenSSL 侧报 sslv3 alert handshake failure,Chrome 侧报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。RFC 8996(BCP 195,2021-03)已把 TLS 1.0/1.1 列为历史版本,现行基线是 TLS 1.2 + TLS 1.3;用 openssl s_client -tls1_2 与 -tls1_3 分别握手,就能判断是”服务端砍太狠”还是”客户端太老”。

4. 时间漂移与中间证书过期。证书 notBefore/notAfter 全部是 UTC,服务器时钟偏差超过 5 分钟即触发 NET::ERR_CERT_DATE_INVALID。同时别只看叶子证书:2021-09-30 DST Root CA X3 到期曾让大批老 Android 报错,ISRG Root X1 的交叉签名链也在逐步退役,中间证书的 notAfter 要单独核对。

timedatectl status   # 关注 System clock synchronized: yes / NTP service: active
chronyc tracking     # 关注 System time 一行,NTP 偏差应控制在 1 秒以内
根因 典型报错 一条命令定位 高发客户端
证书链不完整 unable to get local issuer certificate(OpenSSL error 20) openssl verify -untrusted … Java、Python requests、Go、Android 7.1
主机名不匹配 ERR_CERT_COMMON_NAME_INVALID / Hostname mismatch openssl x509 -ext subjectAltName 全部(CN≠SAN 时暴露)
协议/套件不兼容 sslv3 alert handshake failure openssl s_client -tls1_2 老客户端 × 只开 TLS 1.3 的服务端
时间/中间证书过期 NET::ERR_CERT_DATE_INVALID openssl x509 -dates + chronyc tracking 容器时钟漂移、交叉签名退役

这四类原因决定了下一次复测该看哪一层:链、名字、协议还是时间。据 Let’s Encrypt 文档,其 ACME 客户端默认已下发完整链,若检测仍报缺链,问题多半出在反向代理或证书拼接环节,而不是签发方。

二、用 SSL 证书检测工具做一次完整体检:7 步实操流程

为什么不能只在一台机器上跑一次检测就下结论?因为证书链、HSTS 头、OCSP 装订这些东西是”每个节点各自一份”的配置:CDN 边缘节点更新了,回源的后端没更新;负载均衡 3 台里只重启了 2 台——你从本地看到的 OK,用户从另一个运营商网络看到的可能就是 unable to get local issuer certificate。所以下面 7 步的顺序是刻意设计的:先确认你测的是哪台机器,再抓它实际下发的字节,最后才做离线校验和对外评级。

  1. 步骤 1:确认解析与可达性。先排除 DNS 分流、CDN 回源、LB 只更新了部分节点这几种”假故障”。

    # 看解析结果,注意是否 CNAME 到 CDN;多条 A 记录意味着你测到的可能只是其中一台
    dig +short example.com
    dig +short example.com CNAME
    
    # -v 会把握手过程与证书链写到 stderr,2>&1 才能被 head 截到
    curl -svI https://example.com 2>&1 | head -20
    
    # 绕过 DNS 和 CDN,直连指定后端节点(1.2.3.4 换成 LB 后端真实 IP)
    curl --resolve example.com:443:1.2.3.4 -sI https://example.com
    

    把每个 A 记录、每个后端 IP 都跑一遍 --resolve,出现”有的节点正常、有的节点报错”就说明是灰度/发布不一致,跟证书本身无关。

  2. 步骤 2:抓取服务器实际下发的证书链。注意 -servername 必须给(SNI),否则在共享 IP 上你拿到的是默认虚拟主机的证书,结论完全跑偏。

    openssl s_client -connect example.com:443 -servername example.com -showcerts 
      </dev/null 2>/dev/null 
      | sed -n '/BEGIN CERTIFICATE/,/END CERTIFICATE/p' > chain.pem
    
    grep -c 'BEGIN CERTIFICATE' chain.pem
    # 期望 2:leaf + 1 个 intermediate。输出 1 就是典型的"证书链不完整"
    # 输出 3 通常是多下发了 root,不算错,但每个握手多几百字节,建议去掉
    

    据 Let’s Encrypt 文档,其签发的 fullchain.pem 就是”叶子证书 + 中间证书”两段拼接;如果你在 Nginx 里 ssl_certificate 只指向 cert.pem 而漏了 chain.pem,第 2 步数出来必然是 1。

  3. 步骤 3:本地离线校验。把链拆成单证书文件后验证,排除网络因素只看链本身。

    # 按出现顺序拆成 cert1.pem(leaf)、cert2.pem(intermediate)...
    awk 'BEGIN{n=0} /BEGIN CERT/{n++} {print > "cert"n".pem"}' chain.pem
    
    # -CAfile 用系统根库(Debian/Ubuntu 路径;RHEL 系为 /etc/pki/tls/certs/ca-bundle.crt)
    # -untrusted 可重复指定多个中间证书
    openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
      -untrusted cert2.pem cert1.pem
    # 期望输出:cert1.pem: OK
    

    最常见的失败长这样:

    cert1.pem: C = US, O = Let's Encrypt, CN = R3
    error 20 at 0 depth lookup: unable to get local issuer certificate
    error cert1.pem: verification failed
    

    error 20 基本等价于”-untrusted 给错了中间证书”或”服务器压根没下发中间证书”。其他高频错误码对照如下(来源:OpenSSL verify(1) 手册):

    报错 含义 处置
    error 20 … unable to get local issuer certificate 找不到签发者 补/换 -untrusted 中间证书,或服务器未下发 intermediate
    error 21 … unable to verify the first certificate 链里只有叶子证书 回到步骤 2,修 ssl_certificate 配置
    error 10 … certificate has expired 过期 查 notAfter,注意 UTC 时区
    error 2 … unable to get issuer certificate 本机 CA 库缺根 更新 ca-certificates 包,或显式追加根证书
    error 19 … self-signed certificate in certificate chain 链中混入自签根 内部 CA 场景需显式信任该根
  4. 步骤 4:扫描协议与加密套件。

    # nmap 7.95,ssl-enum-ciphers 会按 TLS 1.0/1.1/1.2/1.3 分组列出套件并打 A-F 分
    nmap --script ssl-enum-ciphers -p 443 example.com
    
    # testssl.sh 3.2,--severity HIGH 只报高危项,输出更聚焦
    ./testssl.sh --protocols --severity HIGH example.com
    

    重点看两件事:是否还残留 TLS 1.0/1.1(RFC 8996 已将二者置为 Historic,Mozilla Server Side TLS 指南也早已把它们归入 Old);是否还启用 RC4、3DES 或纯 CBC 套件。OpenSSL 3.x 默认 SECLEVEL=2,会拒绝 3DES 和 1024 位 RSA,可作为服务端配置的参照基线。

  5. 步骤 5:检查 OCSP 装订与吊销状态。

    # 看服务器有没有把 OCSP 响应"装订"进握手
    openssl s_client -connect example.com:443 -servername example.com -status 
      </dev/null 2>/dev/null | grep -A2 'OCSP Response'
    # 装订生效的标志:OCSP Response Status: successful
    # 若显示 no response sent,说明 ssl_stapling 未开或 stapling_verify 失败
    
    # 主动向 CA 的 OCSP 响应器查询(RFC 6960)
    openssl ocsp -issuer cert2.pem -cert cert1.pem 
      -url http://ocsp.example.com -resp_text
    

    “OCSP 超时”多数不是证书问题,而是服务器出网被防火墙拦了:Nginx 开了 ssl_stapling on 但拉不到响应时,握手会变慢甚至失败。此时可先用 curl -sv http://ocsp.example.com 从服务器本机验证出网可达性,再决定是修出网还是临时关掉装订、改用 CRL 兜底。

  6. 步骤 6:检查 HTTP 层。证书没问题但用户仍看到”不安全”,往往是混合内容或没跳转。

    curl -sI https://example.com | grep -Ei 'strict-transport|location|content-security'
    # 期望看到 strict-transport-security: max-age=31536000; includeSubDomains
    
    curl -sI http://example.com | head -1
    # 期望 301 或 308;返回 200 说明 80 端口没有强制跳转,HSTS 也等于白设
    
  7. 步骤 7:对外评级与 CT 日志核对。最后一步才是拿外部视角交叉验证。

    # SSL Labs API v3,all=done 只取完整结果,startNew=on 强制重新扫描(有频率限制,别写进循环)
    curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&startNew=on" 
      | jq -r '.endpoints[] | "(.ipAddress) (.grade) (.statusMessage)"'
    
    # 查 Certificate Transparency 日志,确认没有非预期签发(RFC 6962)
    curl -s "https://crt.sh/?q=example.com&output=json" 
      | jq -r '.[].name_value' | sort -u
    

    据 SSL Labs API 文档,新扫描按 IP 限流,反复 startNew=on 会返回 429/529;而 crt.sh 里出现你不认识的子域名或签发时间,就要走吊销流程了。整套流程跑下来,一个 ssl 证书检测工具能给你的不只是”到期时间”,而是链、协议、装订、HTTP 头、外部信誉五层证据链。

三、配置与命令示例:OpenSSL 3.0、curl 8.x、nginx 1.26 具体参数

本节把前面提到的排查思路落到可复制粘贴的命令上。先确认工具版本,输出不一致时参数名会变(OpenSSL 1.1.1 与 3.x 的 -ciphersuites 就不同):

# 版本基线:本文命令在以下版本验证
openssl version -a      # 期望 OpenSSL 3.0.13(3.0.x 均适用)
curl --version          # 期望 curl 8.5.0,需含 OpenSSL/3.0.13 或 GnuTLS 后端
nginx -v               # 期望 nginx/1.26.x
./testssl.sh --version  # 期望 testssl.sh 3.2

1. 一条命令判定证书链是否完整(可进 CI)

# -verify_return_error 让校验失败直接返回非 0 退出码;-servername 触发 SNI
openssl s_client -connect example.com:443 
  -servername example.com 
  -verify_hostname example.com 
  -verify_return_error 
  -tls1_2 </dev/null
echo $?   # 0=链与主机名均通过;非 0 即失败

如果省略 -verify_return_error,OpenSSL 只打印 verify error:num=21:unable to verify the first certificate 却仍以 0 退出,脚本会误判为通过——这正是“证书链不完整”最常被漏检的原因。本地已有证书文件时,用 openssl x509 -in cert.pem -noout -dates -issuer -subject 快速看有效期与签发者。

2. 分版本验证 TLS 通路

# TLS 1.3 通路:注意 1.3 用 -ciphersuites,不是 -cipher
openssl s_client -connect example.com:443 -tls1_3 
  -ciphersuites TLS_AES_128_GCM_SHA256 </dev/null

# TLS 1.2 通路:用 -cipher
openssl s_client -connect example.com:443 -tls1_2 
  -cipher ECDHE-RSA-AES128-GCM-SHA256 </dev/null

两条都应握手成功;若 1.2 报 no ciphers available 或服务端返回 handshake failure,说明 nginx 的 ssl_ciphers 把该套件排除了。

3. curl 8.x 一行出结论

curl -so /dev/null -w '%{ssl_verify_result} %{http_version} %{time_appconnect}n' 
  https://example.com
# 示例输出:0 2 0.123
# 0=证书校验通过;2=HTTP/2;0.123 为 TLS 握手耗时(秒)

%{ssl_verify_result} 非 0 即校验失败,取值含义同 OpenSSL 的 X509_V_ERR 码(如 21=链不完整,10=证书过期)。

4. nginx 1.26 关键片段

server {
    listen 443 ssl;
    http2 on;                                  # 1.25.1 起取代 listen ... http2
    ssl_certificate     /etc/nginx/ssl/fullchain.pem;  # 必须含中间证书
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;       # 默认仅 TLSv1.2/1.3
    ssl_ciphers         ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:...;  # 取 Mozilla SSL Configuration Generator v5.7 的 intermediate
    ssl_prefer_server_ciphers off;             # intermediate 推荐值
    ssl_session_cache   shared:SSL:10m;        # 默认 none
    ssl_session_timeout 1d;                    # 默认 5m

    # OCSP 装订三件套 + resolver(缺 resolver 是装订不生效最常见原因)
    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    resolver 1.1.1.1 8.8.8.8 valid=300s;
}

Apache 2.4.58 对应写法:SSLUseStapling on 加 SSLStaplingCache "shmcb:logs/stapling-cache(150000)",二者缺一装订不生效。据 Mozilla SSL Configuration Generator 文档,intermediate 配置在兼容性与安全性间取平衡,适合绝大多数站点。

5. testssl.sh 3.2 作为流水线门禁

./testssl.sh --severity HIGH --protocols --std --headers 
  --jsonfile /tmp/scan-$(date +%F).json example.com
# 退出码 0 = 无 HIGH 及以上风险项,可直接 if 判断卡住发布
工具 最适合回答的问题 关键参数/默认值 失败信号
openssl s_client 链是否完整、能否强制某 TLS 版本 -verify_return_error(默认关闭) 非 0 退出码 / verify error:num=21
curl 8.x 一行拿到校验结果与握手耗时 %{ssl_verify_result},默认不输出 值非 0
testssl.sh 3.2 全量协议、套件、漏洞基线 --severity HIGH 退出码非 0

把上述命令串起来,就是一套可复现的 ssl证书检测工具 组合:先用 openssl 定位链与协议问题,再用 curl 做快速回归,最后用 testssl.sh 守住发布门禁。据 OpenSSL 官方文档,s_client 的 -verify_return_error 语义在 3.x 未变,因此脚本可长期复用。

四、在线平台、命令行与自建监控怎么选?参数对比表

先给结论:排障复现用 OpenSSL,业务侧验证用 curl,上线基线用 testssl.sh,对外评级用 SSL Labs,内网普查用 nmap,长期值守用 blackbox_exporter。这六类不是替代关系,而是覆盖”一次握手”到”一年监控”的不同时间尺度。下面这张表是选型时最该先看的部分。

工具 版本/形态 检测范围 输出格式 适用场景
OpenSSL s_client 3.0.x / 3.2.x,命令行 证书链、协议版本、加密套件、OCSP 装订 纯文本 服务器端精确复现客户端握手,排障首选
curl 8.5+,命令行 握手结果 + HTTP 响应头 + ALPN -v 文本 / -w 变量 验证 HSTS、301 跳转、ssl_verify_result 与退出码
testssl.sh 3.2,Shell 脚本 200+ 项,含漏洞、协议降级与评级 文本 / JSON / HTML 上线前基线、CI 门禁
SSL Labs API v3,HTTPS API 全量评级 A+ 至 F JSON 对外评级,注意缓存需 startNew=on
nmap ssl-enum-ciphers 7.95,NSE 脚本 端口级套件枚举 文本 批量资产扫描,适合内网普查
sslyze / blackbox_exporter 6.1 / 0.25 自动化检测、证书到期指标 JSON / Prometheus 指标 长期监控,probe_ssl_earliest_cert_expiry 告警

第一个坑在 OpenSSL 的默认值上:s_client 默认不因验证失败返回非零退出码,必须显式加 -verify_return_error,否则脚本里永远拿不到失败信号。另外 Debian/Ubuntu 的 /etc/ssl/openssl.cnf 默认写入 CipherString = DEFAULT:@SECLEVEL=2,会直接拒绝 1024 位 RSA 或 SHA-1 签名的旧证书,导致”本地连不上、浏览器却正常”的错觉。

# 一次性拿到证书链、OCSP 装订与校验结论;tee 留存现场
openssl s_client -connect example.com:443 -servername example.com 
  -showcerts -status -verify_hostname example.com 
  -verify_return_error -CAfile /etc/ssl/certs/ca-certificates.crt 
  < /dev/null 2>&1 | tee /tmp/handshake.txt

# 只看链深度与 OCSP 行,快速判断是"链不完整"还是"OCSP 超时"
grep -E 'Verify return code|OCSP response|depth=' /tmp/handshake.txt

据 OpenSSL 官方文档,-status 会发送 status_request 扩展;服务器未装订时输出 OCSP response: no response sent,装订了但响应器无响应时通常看到 OCSP response: no response sent 之前的 OCSP status request sent 后长时间无输出——这正是”OCSP 超时”与”未装订”的区分点。

verify error:num=21:unable to verify the first certificate
curl: (60) SSL certificate problem: unable to get local issuer certificate

这两条是证书链不完整最典型的报错,含义都是”服务器只发了叶子证书,没发中间 CA”。浏览器靠 AIA(Authority Information Access)自动补链,所以用户看不到问题,但 Java、Python、Go 等客户端会直接失败——这就是必须用命令行复测的原因。

# curl 8.5+:一次输出验证结果码、HTTP 版本、ALPN 与应用层连接耗时
curl -sS -o /dev/null --max-time 10 
  -w 'verify=%{ssl_verify_result} http=%{http_version} alpn=%{scheme}n' 
  https://example.com
# ssl_verify_result=0 表示通过;非 0 时结合 curl 退出码 60 判定为证书验证失败
# 默认无超时,必须显式加 --max-time,否则 OCSP/握手挂起会拖死脚本

# testssl.sh 3.2:CI 门禁只关心 HIGH 及以上严重度,输出 JSON 便于断言
./testssl.sh --quiet --severity HIGH 
  --jsonfile /tmp/tls.json --htmlfile /tmp/tls.html 
  --protocols --server-defaults https://example.com:443

# SSL Labs API v3:默认返回缓存结果,强制重扫必须 startNew=on
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&startNew=on&all=done&publish=off" 
  | jq -r '.endpoints[] | "(.ipAddress) (.grade)"'

SSL Labs 的缓存策略是复测时最容易踩的坑:同一 host 在缓存有效期内调用会直接返回旧评级,据 Qualys SSL Labs 文档,加 startNew=on 才会重新排队,而该接口对同一 IP 有速率限制,CI 里高频调用会被拒绝。批量内网资产则用 nmap 的 ssl-enum-ciphers 脚本,配合 tls.servername 参数避免 SNI 缺失导致扫到默认站点:

nmap -p 443 --script ssl-enum-ciphers 
  --script-args tls.servername=example.com -Pn 10.0.0.0/24 -oX /tmp/tls-scan.xml

长期监控交给 blackbox_exporter 0.25 的 https 探针,它把到期时间导出为 Unix 时间戳指标,告警表达式写成 (probe_ssl_earliest_cert_expiry - time()) / 86400 < 14 即可在到期前 14 天触发;同一模块还能通过 probe_tls_version_info 发现协议被误降级。至于 ssl证书检测工具 的在线形态,适合把结果截图给非技术同事看,但复测与回归必须以命令行输出为准——在线平台无法控制 TLS 版本、SNI 与信任库,也无法写进 CI。

五、常见错误与排查:从 unable to get local issuer certificate 到 key values mismatch

浏览器能打开,curl 却报 curl: (60) SSL certificate problem: unable to get local issuer certificate,问题在谁身上?

几乎都在服务端:它只下发了站点证书,没有下发中间证书。浏览器会走 AIA(Authority Information Access)扩展去补链,curl、Java、Python requests 默认不会,于是本地信任库找不到签发者。先用 -showcerts 数一数服务端到底发了几张证书,再决定是否拼接:

# 列出服务端实际下发的证书链(只有 1 张 = 缺中间证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -E '^ *[0-9]+ s:'

# 修复:站点证书在前、中间证书在后,顺序反了同样握手失败
cat cert.pem intermediate.pem > fullchain.pem

# nginx.conf 关键两行(ssl_certificate 必须指向 fullchain,私钥单独指向 key)
#   ssl_certificate     /etc/nginx/ssl/fullchain.pem;
#   ssl_certificate_key /etc/nginx/ssl/privkey.pem;
nginx -t && systemctl reload nginx

若证书由 certbot 签发,据 Let’s Encrypt 文档,fullchain.pem 本身已含中间证书,直接指向它即可,不要指向 cert.pem。

openssl s_client 的 verify error:num=21 和 num=20 有什么区别?

这是用 ssl证书检测工具 或命令行复测时最容易混淆的一对。看 depth 与返回码即可定位:

openssl 输出 含义 首查项
num=21:unable to verify the first certificate 链里第一张(站点证书)无法被验证,典型是缺中间证书 服务端 ssl_certificate 是否指向 fullchain
num=20 且 depth 0 / depth 1 本地找不到签发者 -CAfile 指定的根证书库过旧(如 CentOS 7 的 ca-bundle)
num=10:certificate has expired 已过期 notAfter,注意 UTC 时区
num=27:certificate not trusted 根证书不在信任库 自签或私有 CA
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt &1 
  | grep -E 'verify error|Verify return code'

curl: (35) error:0A000410:SSL routines::sslv3 alert handshake failure 是证书问题吗?

不是,这是协议版本或密码套件协商失败(OpenSSL 3.0 起错误前缀由 error:14094410 变为 error:0A000410,同一错误的十六进制新写法,搜索时务必按版本区分)。分别强制 TLS 1.2 与 1.3 复测,就能判断是客户端还是服务端过窄:

curl -v --tlsv1.2 --tls-max 1.2 https://example.com   # 强制 1.2
curl -v --tlsv1.3 https://example.com                  # 强制 1.3
openssl s_client -connect example.com:443 -tls1_2 &1 | grep -E 'Protocol|Cipher'

若只有 1.2 失败,查服务端是否仍禁用 ECDHE 套件;若两者都失败,查 ssl_protocols 是否漏配(nginx 1.23.4 起默认 TLSv1.2 TLSv1.3)。

Java 侧报 PKIX path building failed: unable to find valid certification path to requested target 怎么办?

JDK 8u302、11.0.12 之前的 cacerts 不含 ISRG Root X1,访问 Let’s Encrypt 证书站点即报此错。优先升级 JDK;无法升级时手动导入:

keytool -importcert -alias isrgrootx1 -file isrg-root-x1.pem 
  -keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
# 默认口令 changeit;导入前可用 keytool -list -keystore ... 确认是否已存在

nginx 启动报 X509_check_private_key:key values mismatch 怎么确认配对?

证书与私钥不是一对。RSA 比对模数指纹,ECDSA/Ed25519 比对公钥 DER:

# RSA:两行 md5 必须完全一致
openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem | openssl md5

# ECDSA / Ed25519:比对公钥 DER 的 SHA-256
openssl x509 -in cert.pem   -pubkey -noout | openssl pkey -pubin -outform der | openssl sha256
openssl pkey -in privkey.pem -pubout -outform der | openssl sha256

为什么 s_client -status 返回 OCSP response: no response sent?

服务端没做 OCSP 装订。nginx 中 ssl_stapling 与 ssl_stapling_verify 默认均为 off,且 resolver 默认未配置——没有 resolver 就解析不到 OCSP 响应器,装订同样不生效:

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;  # 需含中间证书及其签发根
resolver 8.8.8.8 1.1.1.1 valid=300s;
resolver_timeout 5s;

# 复测:期望 successful (0x0) 且 Cert Status: good
openssl s_client -connect example.com:443 -servername example.com -status /dev/null 
  | grep -A2 'OCSP response'

若 openssl ocsp 返回 OCSP Response Status: unsuccessful (6)(unauthorized),说明响应不是由 ssl_trusted_certificate 里某张证书的私钥签发的:多半只放了根证书、漏了中间证书,把完整链补进该文件后 nginx -t 再 reload 即可。

六、检测报告怎么读:证书链、协议、密钥与 HSTS 的判定标准

一张合格的检测报告,要逐项对照哪几条硬指标?

无论是 testssl.sh、SSL Labs 还是 openssl s_client,报告里真正决定“能不能上线”的只有六类:证书链、协议版本、密钥与签名、HSTS、有效期、周边记录(CAA/OCSP/CT)。下面给出判定线、默认值和可直接复制的复测命令。

判定项 合格线 不合格的典型现象 复测命令
证书链 leaf + 1~2 个 intermediate,根证书不下发,叶子在前 Android 4.4 / Java 8 报 PKIX path building failed openssl s_client -showcerts
协议版本 TLS 1.2 + 1.3 开启,1.0/1.1 关闭 SSL Labs 评级被压到 B openssl s_client -tls1_1
密钥与签名 RSA ≥2048(新签建议 3072)或 ECDSA P-256;SHA-256 及以上 Chrome 报 ERR_CERT_WEAK_SIGNATURE_ALGORITHM openssl x509 -text
HSTS max-age=31536000; includeSubDomains 首跳 HTTP 未 301 到 HTTPS curl -sI
有效期 ≤398 天,且续期已自动化 到期前 30 天仍是旧证书 openssl x509 -enddate

链长度和顺序怎么验?下发的链应当是 leaf + 1~2 个 intermediate,根证书不下发——根在客户端本地信任库里,多发一张只是浪费握手字节。数一下服务端实际发了几张:

# 统计服务端下发的证书张数,期望 2~3(leaf + 1~2 个 intermediate)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 按下发顺序拆分:chain1.pem 是叶子,chain2.pem 起是中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | awk '/BEGIN CERT/{n++} n{print > ("chain" n ".pem")}'

# 叶子在前、中间在后;用 -untrusted 把中间证书喂进去逐张校验
openssl verify -untrusted chain2.pem chain1.pem
# 正确输出:chain1.pem: OK
# 顺序颠倒时典型报错:
#   error 20 at 0 depth lookup: unable to get local issuer certificate

Nginx 应把 ssl_certificate 指向 fullchain.pem 而不是 cert.pem(默认安装包里两者都在,指错是最常见的链不完整原因);Apache 2.4.8 之后用 SSLCertificateFile 直接给 fullchain,旧的 SSLCertificateChainFile 已废弃。

协议版本探测为什么经常“测不准”?因为 OpenSSL 3.x 默认安全级别为 2,本地会先拒绝 TLS 1.0/1.1 的弱套件,导致你看到的是本地策略而非服务端配置。探测时需显式降级:

# OpenSSL 3.x 上必须加 -cipher 'DEFAULT@SECLEVEL=0',否则测的是本地策略
for v in tls1 tls1_1 tls1_2 tls1_3; do
  printf '%-8s ' "$v"
  openssl s_client -connect example.com:443 -servername example.com -$v 
    -cipher 'DEFAULT@SECLEVEL=0' </dev/null >/dev/null 2>&1 
    && echo "可用" || echo "已关闭"
done
# 期望:tls1 / tls1_1 输出"已关闭",tls1_2 / tls1_3 输出"可用"

关闭 TLS 1.0/1.1 的依据是 RFC 8996(2021-03 发布),它正式废弃了这两个版本。若业务方仍有大量 Android 4.4 客户端(其系统栈最高只支持 TLS 1.2,且默认套件偏弱),正确做法是单独评估客户端占比后决定是否保留,而不是直接把整个站点回退到 TLS 1.1。

密钥、签名和有效期怎么看?一条命令拿全:

openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -text 
  | grep -E 'Public-Key|Signature Algorithm|Not Before|Not After'
# 期望输出示例:
#   Public-Key: (2048 bit)
#   Signature Algorithm: sha256WithRSAEncryption
#   Not After: Aug 12 03:14:07 2026 GMT

SHA-1 签名证书已被主流浏览器整体拒绝,没有例外配置。有效期方面,CA/Browser Forum 现行公有 TLS 证书上限是 398 天,SC-081 又规划了三步压缩:

生效日期 最长有效期 对运维的含义
现行 398 天 手动续期尚可勉强维持
2026-03-15 200 天 一年两次手动续期开始吃力
2027-03-15 100 天 必须 ACME 自动化
2029-03-15 47 天 必须带重试与监控的自动化

Let’s Encrypt 默认就是 90 天,并在 2025 年推出 6 天短期证书选项,方向很明确:续期自动化从“加分项”变成“必需项”。

HSTS 头怎么写才算合格?据 RFC 6797,只有 HTTPS 响应里的 HSTS 头才被浏览器采纳,HTTP 响应中的会被直接忽略:

curl -sI https://example.com | grep -i strict-transport-security
# 合格示例:
# strict-transport-security: max-age=31536000; includeSubDomains; preload

申请 Chrome HSTS preload 列表还要求三条同时满足:带 preload 指令、max-age 不少于 31536000 秒、所有子域均可 HTTPS 访问且 HTTP 能 301 到 HTTPS。任何一条不满足,提交后会被退回。

周边三项在 A+ 评级里查什么?CAA 记录(RFC 8659)限制哪些 CA 能为你签发,用 dig +short CAA example.com 核对,期望看到 0 issue "letsencrypt.org" 之类;OCSP must-staple(RFC 7633)要求证书里带 TLS Feature 扩展,用 openssl x509 -noout -text | grep -A2 'TLS Feature' 应看到 status_request;CT 日志(RFC 6962)用于核对签发记录是否已公开,可用 crt.sh 按域名反查。这三项在合规审计和 SSL Labs 的 A+ 判定中都会被逐条检查。

七、效果验证:如何确认修复后配置真的生效

改完配置、执行过 reload,是不是就等于“修好了”?不一定。nginx 可能仍在跑旧 worker、证书链可能只补到了其中一台后端、SSL Labs 可能直接返回了 24 小时前的缓存结果。下面按配置层 → 握手层 → HTTP 层 → OCSP 层 → 外部复测 → 回归对比六步走一遍,每步都给出可复制的命令和明确判据。

第一步:确认新配置真的被加载了。据 nginx 官方文档,nginx -t 只做语法检查、不会生效,-T 才会打印合并后的完整配置(含 include)。重载要用 reload 而非 restart:前者发 SIGHUP,老 worker 处理完存量连接再退出,不会掐断正在进行的 TLS 握手。

# 1) 语法校验:期望 syntax is ok / test is successful
sudo nginx -t
# 2) 平滑重载(不是 restart)
sudo systemctl reload nginx
# 3) 打印最终生效配置,确认加载的是新 include 而非旧 vhost
sudo nginx -T | grep -A3 'server_name example.com'
# 常见失败:nginx: [emerg] unknown directive "ssl_stapling"
# 说明该 nginx 未编译 ngx_http_ssl_module 或版本过低(ssl_stapling 需 1.3.7+)

第二步:握手层数证书。链不完整时,OpenSSL 会报 Verify return code: 21 (unable to verify the first certificate);补全中间证书后应为 0。

# 统计服务器下发的证书条数:只有叶子证书=1,补全中间证书后=2
openssl s_client -connect example.com:443 -servername example.com -showcerts 
  </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 单独看校验结果
openssl s_client -connect example.com:443 -servername example.com 
  </dev/null 2>/dev/null | grep 'Verify return code'
# 期望:Verify return code: 0 (ok)

第三步与第四步:HTTP 头与 OCSP 装订。HSTS 与跳转决定浏览器是否还会走明文;OCSP 装订决定客户端要不要额外回源查询、从而避免 OCSP 超时。

# HSTS:期望 max-age=31536000(Mozilla 推荐至少 31536000 秒)
curl -sI https://example.com | grep -i '^strict-transport-security'
# 明文入口:期望 301 或 308,且 Location 指向 https
curl -sI http://example.com | head -1
curl -sI http://example.com | grep -i '^location'
# OCSP 装订:需 nginx 配置 ssl_stapling on; ssl_stapling_verify on;
#            并指定 ssl_trusted_certificate(否则无法验证响应签名)
openssl s_client -connect example.com:443 -servername example.com -status 
  </dev/null 2>/dev/null | grep -E 'OCSP Response Status|This Update|Next Update'
# 生效:OCSP Response Status: successful (0x0) 且带 This Update 时间戳
# 未生效:OCSP response: no response sent

第五步:外部复测必须绕开缓存。据 SSL Labs 文档,同一主机的结果默认缓存,必须带 startNew=on 才会真正重扫;同时用 --resolve 打到不同出口 IP,避免“只修好了其中一台后端”。这也正是很多 ssl证书检测工具 网页版看起来“没变化”的原因。

# 强制重扫(API v3)
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&startNew=on&all=done"
# 逐台后端复测,确认每台都下发了完整链
for ip in 203.0.113.10 203.0.113.11; do
  echo "== $ip"; curl -sI --resolve example.com:443:$ip https://example.com | head -1
done

第六步:回归对比,防止“修一个坏一个”。常见反例是为兼容老客户端误开 TLS 1.0/1.1。testssl.sh 的 JSON 输出适合做变更留档。

testssl.sh --jsonfile /var/log/tls/before.json https://example.com   # 修复前
testssl.sh --jsonfile /var/log/tls/after.json  https://example.com   # 修复后
diff <(jq -S . /var/log/tls/before.json) <(jq -S . /var/log/tls/after.json)
验证层 关键命令 通过判据 失败信号
配置层 nginx -t / nginx -T syntax is ok,且 grep 到新 include [emerg] unknown directive
握手层 openssl s_client -showcerts 证书数=2,Verify return code: 0 (ok) 21 (unable to verify the first certificate)
HTTP 层 curl -sI HSTS max-age=31536000,301/308 明文返回 200
OCSP 层 s_client -status successful + This Update no response sent
外部复测 SSL Labs startNew=on Chain issues 消失、评级 A/A+ 显示旧缓存结果

以上六步全部通过,才算真正闭环;任何一层只靠“浏览器能打开”来判断,都可能漏掉中间证书缺失或 OCSP 装订未生效这类只在部分客户端上才暴露的问题。修复后的 JSON 建议连同变更单一起归档,下次再遇到 OCSP 超时或链不完整时,可直接用 diff 定位是哪一次变更引入的降级。

八、把检测变成常态:续期监控与 CI 集成怎么做

证书到期提醒靠人肉日历,迟早会漏。要问“怎么保证一年后这张证书不会悄悄过期”,答案是把检查拆成三层:文件层、链路层、流水线层,每层都有可执行的退出码,让机器替你判断。

第一层:本地文件检查。把到期判断写进任意脚本,靠退出码而非解析输出文本:

# checkend 参数单位是秒;1814400 = 21 天
# 返回 0:剩余有效期 > 21 天;返回 1:将在 21 天内过期(或已过期)
openssl x509 -checkend 1814400 -noout -in /etc/letsencrypt/live/example.com/cert.pem
if [ $? -ne 0 ]; then
  echo "ALERT: cert.pem 剩余有效期不足 21 天" >&2
  exit 1
fi

# 对照线上实际生效的证书,取 notAfter
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -enddate
# notAfter=Jun 12 03:14:07 2025 GMT

注意 -servername 不能省,SNI 缺失时服务端可能返回默认站点的证书,你会拿到一张“看起来还很久”的错证书。两个结果不一致,八成是续期成功了但 nginx -s reload 或 systemctl reload apache2 没执行——进程仍持有旧证书句柄。

检查点 命令 能发现的问题 盲区
磁盘证书文件 openssl x509 -checkend 续期任务未运行 续期了但未 reload
线上握手证书 openssl s_client + -enddate reload 未生效、SNI 错配 需外网可达
黑盒探测 blackbox_exporter 到期趋势 + 端口不可达 内网域名需自建探针

第二层:续期演练。据 Let’s Encrypt 文档,证书有效期 90 天,certbot 默认在剩余 30 天时触发续期。上线前先跑演练,它会走完整 ACME 流程但不落盘:

certbot renew --dry-run        # certbot 2.x;成功输出 "Congratulations, all simulated renewals succeeded"
systemctl is-active certbot-renew.timer   # 期望输出 active
systemctl list-timers | grep certbot

如果 certbot-renew.timer 不是 active,说明你装的是非 systemd 集成版本,此时必须手工补 cron 条目,否则续期永远不会跑。

第三层:Prometheus 告警。blackbox_exporter 0.25 暴露 probe_ssl_earliest_cert_expiry(Unix 时间戳),注意方向是“到期时间减当前时间”:

- alert: SSLCertExpiringSoon
  expr: (probe_ssl_earliest_cert_expiry - time()) < 86400 * 21
  for: 1h
  labels: { severity: warning }
- alert: SSLProbeDown          # 关键:防止端口挂了被误判成"证书正常"
  expr: probe_success == 0
  for: 5m

CI 门禁再加一层,失败即阻断发布:

./testssl.sh --severity HIGH --quiet --jsonfile result.json "$HOST" || exit 1
openssl s_client -connect "$HOST:443" -servername "$HOST" -verify_return_error </dev/null 
  || exit 1   # 链不完整时报 verify error:num=20:unable to get local issuer certificate

每次更新后记录 openssl x509 -noout -serial -fingerprint -sha256 的输出与生效时间,一旦线上异常,可与 CT 日志(RFC 6962)快速对齐是哪一张证书出了问题。

不能。SSL Labs 的评级侧重协议配置、套件强度与已知漏洞,对证书链是否适配 Java、Android 老版本这类客户端兼容性问题覆盖有限。建议把在线评级当作对外基线,同时用 openssl s_client 与 openssl verify 在服务器侧复现真实握手,两者结论一致才算确认。

排障时先用本地命令。在线平台走的是它自己的网络出口和客户端栈,可能命中 CDN 的不同节点,也可能因缓存显示旧结果;openssl s_client -connect host:443 -servername host 能精确复现你关心的那条链路。在线平台适合做对外评级和上线前的一次性体检,日常排障与 CI 门禁用命令行更可控。

需要。Chrome 与 Firefox 会通过证书里的 AIA 地址自动下载中间证书补齐,所以桌面浏览器看起来正常;但 Java 客户端、Python requests、Go 的默认根池、Android 7.1 及更早版本不会做这个动作,会直接报 unable to get local issuer certificate。修复方式是把中间证书拼进 fullchain.pem 并 reload,成本很低。

num=21 对应 unable to verify the first certificate,含义是服务器只下发了叶子证书,本地找不到签发它的中间证书。执行 openssl s_client -showcerts 看输出中 BEGIN CERTIFICATE 的个数,只有 1 个即可确认。把中间证书与叶子证书按 leaf 在前、intermediate 在后的顺序拼接成 fullchain.pem,在 nginx 的 ssl_certificate 中指向它,nginx -t 后 reload 即可。

最常见是 nginx 缺少 resolver 指令,导致无法解析 OCSP 响应者域名;其次是 ssl_trusted_certificate 只放了叶子证书,没有包含中间证书,装订校验会失败。补齐 resolver 1.1.1.1 8.8.8.8 valid=300s; 与完整的 chain.pem 后 reload,再用 openssl s_client -status 确认出现 OCSP Response Status: successful。

多数检测工具按剩余天数分级提示,剩余 30 天以内标为警告是常见默认值;同时 CA/Browser Forum 正在缩短有效期上限,SC-081 规划 2026-03 起降至 200 天、2029 年降至 47 天,续期窗口会越来越窄。建议把监控阈值统一设在剩余 21 天,并确认 certbot 的自动续期定时器处于运行状态。

因为每个工具的客户端能力集不同。OpenSSL 3.0 默认不再启用 TLS 1.0/1.1,也不提供部分老旧套件,而 nmap 的 ssl-enum-ciphers 会主动枚举服务端支持的组合,结果通常更全。判断服务端真实能力以服务端枚举结果为准,判断客户端能否连通则以你实际使用的客户端栈(curl 版本、JDK 版本)为准,两者不要混用。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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