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:确认解析与可达性。先排除 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:抓取服务器实际下发的证书链。注意
-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:本地离线校验。把链拆成单证书文件后验证,排除网络因素只看链本身。
# 按出现顺序拆成 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 failederror 20 基本等价于”
-untrusted给错了中间证书”或”服务器压根没下发中间证书”。其他高频错误码对照如下(来源:OpenSSLverify(1)手册):报错 含义 处置 error 20 … unable to get local issuer certificate 找不到签发者 补/换 -untrusted中间证书,或服务器未下发 intermediateerror 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:扫描协议与加密套件。
# 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:检查 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:检查 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:对外评级与 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 是证书问题吗?
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
不是,这是协议版本或密码套件协商失败(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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。