https 检测工具怎么用?OpenSSL 与 testssl.sh 实操指南
1) https 检测工具优先用 testssl.sh 3.2 做全量扫描,再用 openssl s_client 与 curl 复核证书链和 TLS 握手,单域名全量扫描通常 30–120 秒。 2) 证书链检查看 openssl s_client 输出 Verify return code: 0 (ok),缺中间证书时常见报错为 unable to verify the first certificate,应部署 fullchain.pem。 3) 协议基线用 Nginx 1.24+ 的 ssl_protocols TLSv1.2 TLSv1.3,禁用 TLS 1.0/1.1;HSTS 建议 max-age=31536000; includeSubDomains。 4) 外部评分用 Qualys SSL Labs API v3,目标 A/A+;商业监控常见价格 50–300 元/域名/月,DV 证书 0–300 元/年。
为什么浏览器显示小锁,https 检测工具还会报证书链或 TLS 问题?
因为小锁只证明“这一次握手成功、浏览器能把叶证书链到自己的信任库”,而 Chrome/Edge 会读取叶证书里的 AIA 字段自动下载缺失的中间证书并缓存,把服务端少发中间证书的配置缺陷掩盖掉了。据 RFC 5246 §7.4.2 与 RFC 8446 §4.4.2,服务端应发送叶证书与全部中间证书、但不发送根证书(根证书由客户端自带,多发只增加握手体积)。所以“浏览器正常”和“https 检测工具报错”经常同时成立,两者校验的对象根本不是同一件事。
# 1) 统计服务端实际发送的证书张数;-servername 必须带,等价于浏览器发送的 SNI
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| grep -c 'BEGIN CERTIFICATE' # 正常应 ≥2:叶证书 + 至少 1 张中间证书
# 2) 用系统信任库复验整条链;-CAfile 路径在 Debian/Ubuntu 为 /etc/ssl/certs/ca-certificates.crt
openssl s_client -connect example.com:443 -servername example.com
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>&1 | grep 'Verify return code'
# 期望:Verify return code: 0 (ok)
# 缺中间证书:Verify return code: 21 (unable to verify the first certificate)
返回码 21 就是 Android 7 与 Java 8u301 抛出 PKIX path building failed: unable to find valid certification path to requested target 的同一根因——它们不会像桌面 Chrome 那样去抓 AIA。第二个陷阱是 SNI:不加 -servername 时 Nginx 会命中 default_server,若该 server 块未配置证书,输出直接是 no peer certificate available,极易被误判为“服务器没装证书”。
| 检查项 | 桌面浏览器(小锁) | https 检测工具 / 老客户端 |
|---|---|---|
| 缺中间证书 | Chrome 通过 AIA 自动补链,照常显示小锁 | openssl 返回 21;Android 7、Java 8u301 直接握手失败 |
| TLS 1.0/1.1 仍开放 | Chrome 84、Firefox 74 起默认禁用,用户无感知 | testssl.sh 标记 deprecated;PCI DSS 3.2.1 起视为不合规 |
| 未发送 SNI | 浏览器总带 SNI,命中正确虚拟主机 | openssl 拿到默认站点证书,结论全错 |
| OCSP Stapling | 失败时静默回退到实时查询,不提示 | testssl.sh 3.2 输出 OCSP stapling: No |
# 单独验证 TLS 1.0 是否还开着(其余版本把 -tls1 换成 -tls1_1 / -tls1_2)
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null 2>&1 | grep -E 'Protocol|Cipher'
# 握手成功 = 仍开放;报 no protocols available = 已关闭
# 查看证书主体、签发者与有效期(CA/B Forum 规定 2020-09-01 起公开信任证书上限 398 天,Let's Encrypt 默认 90 天)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 监控阈值建议:剩余 <15 天告警,<7 天升级为紧急
OCSP Stapling 不会自动生效,Nginx 必须显式开启;按 RFC 6960,OCSP 响应由 CA 或其授权响应器签名,因此 ssl_trusted_certificate 指向的文件必须包含中间证书,且 resolver 可达。任一条件不满足,testssl.sh 都会显示 OCSP stapling: No。
# Nginx ≥1.3.7 支持 ssl_stapling,写在 server 块内
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/fullchain.pem; # 必须含中间证书,否则 stapling 静默失败
resolver 1.1.1.1 8.8.8.8 valid=300s ipv6=off; # 缺 resolver 指令时 stapling 同样不生效
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
HSTS 同理:它不是装好证书就自带的能力,必须由响应头下发。要进 Chrome 预加载列表,还需 max-age≥31536000 并提交至 hstspreload.org,从提交到随浏览器版本发布通常需要数周。一次性跑完上述全部检查:
# testssl.sh 3.2:--protocols 查协议版本,--headers 查 HSTS 等响应头,--server-defaults 看默认套件与证书
./testssl.sh --protocols --headers --server-defaults https://example.com
从零做一次 https 检测:按这 6 步走完证书链、协议与配置
想从零跑完一次完整的 https 检测,实际只需要 6 条命令,10 分钟内就能拿到证书链、协议版本、加密套件、OCSP 与安全头的全部证据。下面按顺序给出可直接复制的命令序列,以及每一步的“通过标准”和常见报错。
第 1 步:准备环境,先把“基线”记下来。检测前必须确认 A 与 AAAA 记录都指向真正提供 443 服务的那台机器——只查 A 记录是国内最常见的误判来源,因为客户端可能走 IPv6 拿到旧证书。同时把证书到期日和 DNS TTL 记录下来,出问题时才有回滚依据。本文命令基于 OpenSSL 3.0.13(2024 年 1 月发布)、curl 8.5、nmap 7.94、testssl.sh 3.2,低版本缺少 TLS 1.3 相关输出。
# 1) A/AAAA 都要查,避免 IPv6 回退到旧主机
dig +short A www.example.com
dig +short AAAA www.example.com
# 2) 记录证书到期日与 DNS TTL(TTL 建议 ≤300 秒,便于快速回滚)
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null
| openssl x509 -noout -enddate
dig +noall +answer www.example.com | awk '{print $1, $2, "TTL="$3}'
# 3) 核对工具版本,低于下列版本请先升级
openssl version -a | head -1 # 需 3.0.13+
curl --version | head -1 # 需 8.5+
nmap --version | head -1 # 需 7.94+
testssl.sh --version | head -1 # 需 3.2
第 2 步:一次握手,先看证书和 SAN。-servername 不能省,缺了 SNI 会拿到默认站点证书,检测结果毫无意义。
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
判定标准只有两条:输出里出现 Verify return code: 0 (ok);subjectAltName 列表包含被检测域名(通配符 *.example.com 不覆盖 example.com 本身)。若看到 Verify return code: 21 (unable to verify the first certificate),说明服务器漏发中间证书——这是 Let’s Encrypt 证书最常见的部署错误,按其官方文档要求需在服务端配置 fullchain.pem 而非 cert.pem。
第 3 步:枚举协议与套件。nmap 负责“全景扫描”,testssl.sh 负责“按严重级别复核”:
nmap --script ssl-enum-ciphers -p 443 www.example.com
# --severity HIGH 只输出高危及以上问题,避免被 INFO 项淹没
testssl.sh --protocols --severity HIGH https://www.example.com
通过标准:仅出现 TLSv1.2 与 TLSv1.3,且套件以 ECDHE-*-AESGCM 或 CHACHA20-POLY1305 开头(具备前向保密)。据 RFC 8996,TLS 1.0/1.1 已于 2021 年被正式弃用,出现即判不合格;纯 TLS_RSA_WITH_* 套件因无 PFS 同样应剔除。
第 4 步:查证书链、OCSP 与 HSTS。testssl.sh 3.2 中 HSTS 检查默认不启用,必须显式加 --hsts:
testssl.sh --chain --ocsp --hsts https://www.example.com
# 关注三行:Chain of trust = OK / OCSP stapling = offered / HSTS max-age 数值
第 5 步:用 curl 复核 HTTP 安全头。注意 -I 发的是 HEAD 请求,部分 CDN 对 HEAD 与 GET 返回不同头,稳妥写法是 curl -s -o /dev/null -D - https://www.example.com。
curl -sI https://www.example.com | egrep -i 'strict-transport-security|content-security-policy|server'
HSTS 建议 max-age=31536000(一年,RFC 6797 推荐下限),并配合 includeSubDomains;CSP 至少 default-src 'self'。Mozilla 的 Server Side TLS 指南把这两项列为 Modern 配置的必备项。
第 6 步:外部复核,拿一个可对外汇报的评级。Qualys SSL Labs 首次分析通常耗时 60–180 秒,期间重复请求会返回“in progress”,不要写脚本轮询过密:
curl -s "https://api.ssllabs.com/api/v3/analyze?host=www.example.com&all=done"
| jq '.endpoints[0].grade, .certs[0].issues'
# 目标:grade 为 A 或 A+,issues 为空数组(0 表示无已知证书问题)
| 检测项 | 工具与关键参数 | 通过标准 | 典型失败输出 |
|---|---|---|---|
| 证书链完整性 | openssl s_client -showcerts | Verify return code: 0 (ok) | 21 (unable to verify the first certificate) |
| 协议版本 | nmap ssl-enum-ciphers | 仅 TLSv1.2 / TLSv1.3 | 列表中出现 TLSv1.0 |
| 前向保密 | testssl.sh –protocols | 全部为 ECDHE 套件 | TLS_RSA_WITH_AES_128_CBC_SHA |
| OCSP Stapling | testssl.sh –ocsp | offered | not offered |
| HSTS | curl -sI + egrep | max-age ≥ 31536000 | 响应头缺失 |
| 综合评级 | SSL Labs API all=done | grade A/A+,issues 为空 | grade B、issues 含链问题 |
这 6 步的价值在于交叉验证:openssl 看的是单次握手,nmap 看的是服务端全部套件,testssl.sh 补齐链与 OCSP 细节,SSL Labs 则从公网视角给出第三方结论。四者结论不一致时(例如本地 0 (ok) 但 SSL Labs 报链不完整),优先相信外部视角——那才是真实用户看到的 https 检测工具结果。
问:能不能把“检测通过”的标准直接写进服务器配置里?可以,而且应该这么做。下面四组示例分别覆盖 Web 服务器基线、用 OpenSSL 3.x 复核、testssl.sh 3.2 批量扫描和证书续期,你可以把它们直接当模板使用。
Nginx 1.24+ 基线(对齐 Mozilla SSL Configuration Generator 5.7 的 intermediate 档,据 Mozilla 文档,该档兼容 TLS 1.2 及以上的主流客户端):
# /etc/nginx/conf.d/example.conf — Nginx 1.24+
server {
listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # 叶子证书 + 中间证书
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem; # OCSP stapling 校验链用
ssl_protocols TLSv1.2 TLSv1.3; # 默认值含 TLSv1/1.1,必须显式收窄
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305';
ssl_prefer_server_ciphers off; # TLS 1.3 下由客户端选序,保持 off
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_stapling on;
ssl_stapling_verify on;
resolver 1.1.1.1 8.8.8.8 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
Apache 2.4.57+ 基线:同样的密码套件,只是把 Nginx 的指令换成 Apache 的 mod_ssl 指令。下表说明两者的对应关系,也说明为什么 Apache 的 SSLHonorCipherOrder 要设为 off:在 TLS 1.3 中,服务端指定的密码套件顺序不会生效,设成 on 只会让 TLS 1.2 的连接结果与客户端偏好不一致。
| 能力 | Nginx 1.24+ | Apache 2.4.57+ | 默认值 |
|---|---|---|---|
| 协议范围 | ssl_protocols |
SSLProtocol -all +TLSv1.2 +TLSv1.3 |
Apache 默认含 TLSv1/1.1 |
| 密码套件 | ssl_ciphers |
SSLCipherSuite |
HIGH:!aNULL:!MD5 |
| 套件选序 | ssl_prefer_server_ciphers off |
SSLHonorCipherOrder off |
均为 off |
| OCSP 装订 | ssl_stapling on |
SSLUseStapling on + SSLStaplingCache "shmcb:logs/stapling-cache(150000)" |
off |
| HSTS | add_header Strict-Transport-Security |
Header always set Strict-Transport-Security |
未启用 |
问:改完配置,怎么用命令行确认 TLS 1.3 真的生效?用 OpenSSL 3.0.13 强制只走 TLS 1.3,并指定密码套件:
# OpenSSL 3.0.x — -tls1_3 强制协议,-ciphersuites 只对 TLS 1.3 生效
openssl s_client -connect www.example.com:443 -servername www.example.com
-tls1_3 -ciphersuites TLS_AES_256_GCM_SHA384
# 期望输出片段:
# Protocol : TLSv1.3
# Cipher : TLS_AES_256_GCM_SHA384
# Verify return code: 0 (ok) <-- 非 0 即链或信任库有问题
证书链是否完整,不要靠浏览器“看着正常”判断:
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt
-untrusted /etc/letsencrypt/live/example.com/chain.pem
/etc/letsencrypt/live/example.com/fullchain.pem
# 必须返回:fullchain.pem: OK
# 若返回 "unable to get local issuer certificate",说明中间证书缺失
testssl.sh 3.2 快速扫描:它是常用的批量 https 检测工具,覆盖协议、套件、HSTS、OCSP 等检查项:
# testssl.sh 3.2 — --fast 约 15–40 秒;去掉 --fast 全量约 30–120 秒
./testssl.sh --fast --severity HIGH
--protocols --ciphers --server-defaults --headers --hsts --ocsp
-oJ /tmp/ssl-report.json https://www.example.com
# 退出码 0 = 未发现 HIGH/CRITICAL 级别问题;非 0 需查看 JSON 中 severity 字段
最后别忘了续期链路:据 Let’s Encrypt 文档,生产环境由 systemd timer 每日触发 2 次 certbot renew,证书剩余 30 天时自动续期。上线前先用 certbot 2.10 演练一次:
certbot renew --dry-run --deploy-hook "systemctl reload nginx"
# --dry-run 使用 staging 环境,不消耗速率限制;--deploy-hook 仅在真正续期成功后执行
https 检测工具怎么选?OpenSSL、curl、nmap、testssl.sh 与 SSL Labs 对比
问:https 检测工具这么多,日常到底该用哪个?结论先给:它们不是互相替代的关系,而是“检测粒度 / 耗时 / 是否需要外部视角”三个维度的分工。下表按可验证的版本与参数对齐(版本号为 2024 年前后主流发行版仓库中的常见版本):
| 工具 | 典型版本 | 命令/入口 | 覆盖项 | 单次耗时 | 费用 |
|---|---|---|---|---|---|
| OpenSSL | 3.0.13 | openssl s_client -connect host:443 -servername host |
握手、证书链、SAN、协议版本 | 1–3 秒 | 免费 |
| curl | 8.5 | curl -vI https://host |
HTTP 头、TLS 版本、证书摘要 | 1–2 秒 | 免费 |
| nmap | 7.94 | nmap --script ssl-enum-ciphers -p 443 host |
协议/套件枚举 | 10–30 秒 | 免费 |
| testssl.sh | 3.2 | ./testssl.sh --fast https://host |
协议、套件、漏洞、OCSP、HSTS | 15–120 秒 | GPLv2 免费 |
| SSL Labs API | v3 | api.ssllabs.com/api/v3/analyze |
综合评分、链完整性、协议 | 60–180 秒 | 免费 |
| 商业监控 | 各厂商 | 拨测 + 告警控制台 | 持续可用性、到期提醒 | 持续 | 50–300 元/域名/月 |
1)只想确认证书是否过期、SAN 是否漏配?用 OpenSSL。加 -showcerts 可看到完整链,末尾出现的 verify error:num=20:unable to get local issuer certificate 是典型的中间证书缺失报错,据 OpenSSL 文档,这表示本地找不到签发者而非证书本身无效:
# -servername 必加,否则 SNI 虚拟主机返回默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 强制指定协议版本(默认协商最高版本,TLS 1.3 需 OpenSSL 1.1.1+)
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null
2)只想看站点是否强制跳转、协商了哪个 TLS 版本?curl 最快,-v 会把 SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384 打到 stderr:
curl -sI -v https://example.com 2>&1 | grep -Ei 'SSL connection|expire|HTTP/'
# 验证是否拒绝旧协议(预期报错:error:0A00042E:SSL routines::tlsv1 alert protocol version)
curl -sI --tlsv1.2 --tls-max 1.2 https://example.com
3)需要枚举全部协议与套件?nmap 的 ssl-enum-ciphers 会按强度打 A–F 分级。注意:据 nmap 官方脚本说明,7.94 对 TLS 1.3 套件枚举支持有限,TLS 1.3 结论应以 openssl s_client -tls1_3 与 testssl.sh 为准。
nmap --script ssl-enum-ciphers -p 443 example.com # 默认扫描全部 TLS 版本,10–30 秒
4)发布前的合规自检?testssl.sh 3.2 依赖 bash 4+ 与 OpenSSL 1.1.1+,--fast 跳过部分漏洞探测,15–40 秒出结果;留档用 -oJ 输出 JSON,便于接入 CI 或审计归档:
git clone --depth 1 https://github.com/drwetter/testssl.sh.git
cd testssl.sh
./testssl.sh --fast https://example.com # 快速巡检
./testssl.sh -oJ /tmp/ssl-report.json https://example.com # 全量 + JSON 留档
5)要一个对外可引用的评分?SSL Labs v3 API 免费但有速率限制,all=done 会阻塞到评估完成:
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off" | jq '.endpoints[].grade'
选型建议:日常巡检用 curl -sI 加 openssl s_client,秒级完成;发布前跑 testssl.sh --fast;每季度做一次全量扫描并取 SSL Labs 外部评分;内部合规留档统一用 testssl.sh 的 JSON 输出。这也是 https 检测工具最省事的组合拳——把快慢两类工具分层,而不是每次都全量跑。
成本参考:DV 证书 0–300 元/年,OV 800–3000 元/年,EV 2000–8000 元/年;商业 https 检测工具(持续监控型)常见 50–300 元/域名/月,按 1 分钟 / 5 分钟拨测频率分档。
频率与负载:生产巡检建议 5–15 分钟一次轻量握手,全量扫描每日或每周一次。全量扫描会建立数十次连接,对低配源站属于可观测的额外负载,务必错峰执行——这也是把 https 检测工具分成“轻量探活”和“重量审计”两档的根本原因。
https 检测常见报错:证书链、SNI、OCSP 与协议不匹配怎么排查
用 https 检测工具扫完站点,最常见的追问是”这些红字到底要不要改”。先给结论:下面六条报错里,只有第一条真正与证书文件本身有关,其余五条都是服务端配置或客户端环境问题。速查表先给出”报错原文 → 根因 → 复核手段”,后文逐条给可复制命令。
| 报错原文 | 根因 | 复核手段 |
|---|---|---|
| Verify return code: 21 (unable to verify the first certificate) | 服务端只发叶证书,缺中间证书 | openssl verify -untrusted |
| curl: (60) unable to get local issuer certificate | 客户端 CA 库过旧或链不完整 | update-ca-certificates |
| sslv3 alert handshake failure | 协议版本或密码套件不匹配 | s_client -tls1_2 / -tls1_3 |
| no peer certificate available | SNI 未传或默认虚拟主机无证书 | -servername |
| OCSP response: no response sent | 未开 stapling、resolver 不通或证书无 OCSP URI | dig 查 OCSP 域名 |
| HSTS header not found | add_header 被 location 内指令覆盖 |
curl -sI |
Verify return code: 21:只发了叶证书。先数服务端到底发了几张证书,1 张即代表缺中间证书:
# 统计服务端在握手中下发的证书张数;正常应为 2 张(叶证书 + 中间证书)
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null 2>/dev/null
| grep -c "BEGIN CERTIFICATE"
# 本地复核:chain.pem 为中间证书,fullchain.pem 为叶+中间
openssl verify -untrusted chain.pem fullchain.pem
# 期望输出:fullchain.pem: OK
修复方式是在 Nginx 里把 ssl_certificate 指向 fullchain.pem(而非 cert.pem),然后 nginx -t && nginx -s reload。据 Let’s Encrypt 文档,fullchain.pem 就是为这一场景设计的默认产物。
curl: (60):客户端信任库问题。先确认 ca-certificates 版本,2023 年以后的包才包含 Let’s Encrypt 交叉签名退役后的完整根证书集合:
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- SSL证书安装服务 · 腾讯云 HTTPS 部署 · 证书过期更新
- HTTPS配置 · SSL证书安装服务(各种服务器)
# Debian/Ubuntu:查看版本与更新信任库
apt list --installed ca-certificates 2>/dev/null | grep ca-certificates
update-ca-certificates --fresh
# RHEL 系
rpm -q ca-certificates && update-ca-trust extract
生产环境不要用 curl -k 掩盖问题——它跳过整条链校验,等于把中间人攻击风险留在了监控脚本里。
sslv3 alert handshake failure:协议或套件不匹配。典型情形是服务端只开 TLS 1.3,客户端却用 -tls1_2 探测。用两个版本分别复测,即可定位是哪一端的问题:
openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_2 </dev/null
openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_3 </dev/null
# Nginx 侧确认(1.23.4 起默认值为 TLSv1.2 TLSv1.3)
grep -n "ssl_protocols" /etc/nginx/nginx.conf /etc/nginx/conf.d/*.conf
no peer certificate available:SNI 没传。直接对 IP 建连会命中默认 server,若默认 server 无证书即报此错。加 -servername 即可:
openssl s_client -connect 203.0.113.10:443 -servername www.example.com </dev/null
# Nginx 1.19.4+ 让默认 server 直接拒绝握手(默认值 off,需显式开启)
server { listen 443 ssl default_server; ssl_reject_handshake on; server_name _; }
OCSP response: no response sent:装订未生效。按顺序查三件事:证书是否含 OCSP URI、DNS 是否可达、Nginx 是否开启 stapling(ssl_stapling 默认 off)。
openssl x509 -in fullchain.pem -noout -ocsp_uri
dig +short @1.1.1.1 ocsp.int-x3.letsencrypt.org
# nginx.conf 的 http 块
ssl_stapling on; # 默认 off
ssl_stapling_verify on; # 默认 off
resolver 1.1.1.1 8.8.8.8 valid=300s;
HSTS header not found:add_header 继承被切断。Nginx 的 add_header 只在当前层级没有任何同名指令时才继承上层;location 内写了一条 add_header,父级的 HSTS 就全部失效。复核与修复:
curl -sI https://www.example.com | grep -i strict-transport-security
# location 内需重复声明,建议带 always(1.7.5+)
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
把上面六条按”先查链、再查 SNI、最后查协议与响应头”的顺序跑一遍,一个 https 检测工具 报出的红项基本都能收敛。下一节讲如何用 testssl.sh 把这几项固化成可回归的巡检脚本。
怎么确认 https 检测结果已经生效?证书链、TLS 1.3、HSTS 与 OCSP 的复核方法
问:nginx 的 ssl_protocols、HSTS 头和证书链都改完了,怎么确认线上真的生效,而不是浏览器缓存或旧连接在骗我?
答:HTTPS 是否生效不是“一个开关”,要分握手层、HTTP 头层、证书链层、监控层逐级复核。下面六种方式按成本从低到高排列,任一环节不一致,说明变更没有真正生效。
1. openssl s_client:看协议版本与链验证结果
# -servername 必须显式带上,否则 SNI 站点可能返回默认证书
openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_3 /dev/null
| egrep 'Protocol|Cipher|Verify return code'
# 期望输出:
# Protocol : TLSv1.3
# Cipher : TLS_AES_256_GCM_SHA384
# Verify return code: 0 (ok)
OpenSSL 1.1.1 起才支持 -tls1_3 与 TLS 1.3 套件(RFC 8446)。若仍打印 Protocol : TLSv1.2,先查 ssl_protocols——nginx 1.23.4 起默认值为 TLSv1.2 TLSv1.3,旧版本默认还含 TLSv1;再查 CDN、SLB、WAF 是否在源站前终止了 TLS。若出现 Verify return code: 20 (unable to get local issuer certificate),说明服务器没下发中间证书,据 Let’s Encrypt 文档,应配置 fullchain.pem 而非 cert.pem。
2. curl -vI:一条命令同时看协议、SAN 与 HSTS
curl -vI https://www.example.com 2>&1 | egrep 'SSL connection|subjectAltName|Strict-Transport-Security'
# 期望:SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384
# subjectAltName: host "www.example.com" matched cert's "www.example.com"
# strict-transport-security: max-age=31536000; includeSubDomains
curl 需链接 OpenSSL 1.1.1+ 才会协商 TLS 1.3;HSTS 头缺失时,浏览器仍可能走 HTTP 首跳(RFC 6797 规定 max-age 为必选指令)。
3. testssl.sh:链、OCSP 装订、HSTS 一次跑完
./testssl.sh --fast --protocols --hsts --ocsp https://www.example.com
# 关键行:Chain of trust OK / OCSP stapling offered / HSTS 31536000
3.2 版本以上输出分级更细。即使评级 A/A+,仍要横向看两项:证书剩余天数(<30 天应视为风险)与套件顺序(前几位是否均为 AEAD 套件)。OCSP 装订未开启时,客户端需自行回源查询,增加首字节延迟(RFC 6960)。
4. SSL Labs API:拿可归档的评分
curl -s "https://api.ssllabs.com/api/v3/analyze?host=www.example.com&all=done&startNew=on"
| jq '.endpoints[0].grade, .certs[0].issues'
# 期望: "A+" 与 [](issues 为空数组)
同一域名评分缓存约 24 小时,改配置后不加 startNew=on 会拿到旧结果,这是“明明改好了评分没变”的最常见原因。
5. 浏览器 DevTools:验证终端用户的真实体验
Chrome 打开 F12 → Security:应显示 Certificate – valid and trusted,Connection 为 TLS 1.3;点 View certificate 核对 SAN 列表与有效期。若显示 Not secure 或 Certificate – invalid,问题一定在链或域名匹配上,与服务器配置无关。
6. blackbox_exporter 0.25.0:把复核变成持续告警
# blackbox.yml
modules:
https_2xx:
prober: http
timeout: 5s
http:
tls_config:
insecure_skip_verify: false # 默认即 false,切勿改成 true
# PromQL:探活失败或证书剩余不足 14 天即告警
probe_success{job="blackbox"} == 0
probe_ssl_earliest_cert_expiry{job="blackbox"} - time() < 14 * 86400
probe_success=1 表示 TCP+TLS+HTTP 全链路成功;probe_ssl_earliest_cert_expiry 为证书到期 Unix 时间戳,14 天阈值即 1209600 秒。
| 复核手段 | 覆盖点 | 典型判定值 | 局限 |
|---|---|---|---|
| openssl s_client | 协议版本、套件、链验证 | Verify return code: 0 (ok) | 不带 -servername 会误判 |
| curl -vI | 协议 + SAN + HSTS 头 | SSL connection using TLSv1.3 | 旧版 curl 不支持 TLS 1.3 |
| testssl.sh | 链、OCSP、HSTS、套件顺序 | Chain of trust OK | 全量扫描耗时较长 |
| SSL Labs API | 综合评级、证书问题列表 | grade = A+,issues 为空 | 结果缓存约 24 小时 |
| Chrome DevTools | 真实用户侧信任状态 | Certificate – valid and trusted | 无法批量、无法自动化 |
| blackbox_exporter | 持续可用性与到期时间 | probe_success = 1 | 不评估套件强度 |
六层全部通过,才算“https 检测工具的结果真正落地”:单次扫描证明配置正确,监控指标证明配置不会在证书轮换或灰度发布后悄悄回退。把这些命令串进 CI 的 post-deploy 步骤,比事后用 https 检测工具排查便宜得多。
把 https 检测接入日常运维:续期、监控与合规留痕
证书续期怎么做到“无人值守但可审计”?certbot 2.10 安装后会自带 systemd timer,无需自己写 cron。据 Let’s Encrypt 文档,官方推荐每天运行两次、并带随机延迟,避免整点集中请求。查看与核对:
# 查看 timer 是否启用(certbot 2.10 默认已 enable)
systemctl list-timers certbot.timer --all
# 输出示例:NEXT Thu 2025-03-13 03:17:42 CST LEFT 8h ...
# 关键行:OnCalendar=*-*-* 00/12:00:00(每日 0 点/12 点)
# RandomizedDelaySec=43200(最多随机延后 12 小时)
# 每月一次演练:--dry-run 走 staging 环境,不消耗生产速率限制
certbot renew --dry-run --cert-name example.com
# 成功标志:Congratulations, all simulated renewals succeeded
# 续期阈值:默认剩余 30 天触发(/etc/letsencrypt/renewal/example.com.conf 中 renew_before_expiry 可改)
grep -E 'renew_before_expiry|webroot_path' /etc/letsencrypt/renewal/example.com.conf
告警分两级:剩余 <30 天开普通工单,<7 天升级为紧急工单——因为 Let’s Encrypt 的 90 天证书一旦进入 7 天窗口,说明自动续期已经连续失败多次,通常是 80 端口验证被防火墙或 CDN 回源挡住。
用 Prometheus 监控证书,最小配置长什么样?blackbox_exporter 0.25.0 的 prober 默认是 http,只测 HTTPS 必须显式写 https,否则不会做 TLS 握手,也拿不到 probe_ssl_earliest_cert_expiry 指标。
# /etc/blackbox_exporter/config.yml (blackbox_exporter 0.25.0)
modules:
https_2xx:
prober: https # 关键:默认值是 http,必须改成 https
timeout: 10s # 默认 10s,取值范围 1s~120s
http:
valid_status_codes: [200, 301, 302]
preferred_ip_protocol: ip4
# prometheus.yml (Prometheus 2.50) —— 抓取间隔 1h,证书类指标无需高频
- job_name: blackbox_https
scrape_interval: 1h
metrics_path: /probe
params: { module: [https_2xx] }
static_configs:
- targets: ['example.com', 'api.example.com']
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- source_labels: [__param_target]
target_label: instance
- target_label: __address__
replacement: 127.0.0.1:9115
# alert.rules.yml
- alert: SSLCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 86400*14 # 14 天
for: 10m
labels: { severity: warning }
合规检查要留下哪些证据?季度扫描用 testssl.sh 3.2 输出 JSON,文件名带日期,报告头记录工具版本、OpenSSL 版本(Ubuntu 22.04 默认 3.0.13)、扫描时间与源 IP,否则审计时无法复现:
mkdir -p /var/log/ssl
testssl.sh --quiet -oJ /var/log/ssl/example.com-$(date +%F).json https://example.com
# -oJ = JSON 输出;--quiet 抑制彩色进度条,便于入日志系统
testssl.sh --version # 记录:3.2 / OpenSSL 3.0.13
| 合规项 | 要求与依据 | 验证方式 |
|---|---|---|
| TLS 版本 | PCI DSS v4.0 要求 4.2.1:仅 TLS 1.2+,禁用 1.0/1.1 | openssl s_client -tls1_1 -connect example.com:443 应握手失败 |
| HSTS | RFC 6797,max-age ≥ 31536000(1 年) |
curl -sI https://example.com | grep -i strict-transport |
| CAA | RFC 8659,限制可签发 CA | dig CAA example.com +short → 0 issue "letsencrypt.org" |
| 私钥权限 | 仅 root 可读,权限 600 | stat -c '%a %n' /etc/letsencrypt/archive/*/privkey*.pem |
换完证书的验证窗口怎么排?5 分钟内做握手级确认,30 分钟内做配置级扫描,24 小时内看第三方评级:
# T+5min:确认线上拿到的就是新证书(比对指纹)
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -subject -dates -fingerprint -sha256
curl -sSI https://example.com | head -n 5
# T+30min:快速扫描协议与加密套件
testssl.sh --fast https://example.com
# 异常回滚:保留上一版 archive 目录,恢复后立即收紧权限
chmod 600 /etc/letsencrypt/archive/example.com/privkey*.pem
systemctl reload nginx
把这四件事串起来,https 检测工具才从“临时排查手段”变成可审计的运维闭环:timer 保证续期不靠人记,blackbox_exporter 把到期时间变成可告警的时序数据,testssl.sh 的 JSON 归档回答“三个月前那次扫描结论是什么”。
testssl.sh 3.2 在本地逐项探测协议、套件、链、OCSP 与漏洞,适合发布前与内网;SSL Labs 从公网多节点综合评分,适合对外评分与竞品对比。两者结论冲突时,以 openssl s_client 的握手输出和证书链验证为最终依据。
浏览器会自动补链或缓存中间证书,openssl 默认只信任本地 CA 库;服务端未发送中间证书时就会出现该报错。把 fullchain.pem 配置到 Nginx 的 ssl_certificate,并用 openssl verify -untrusted chain.pem fullchain.pem 验证。
可以。用 openssl s_client -tls1_3 -ciphersuites TLS_AES_256_GCM_SHA384 或 testssl.sh 3.2 的 –protocols –ciphers 查看;nmap 7.94 的 ssl-enum-ciphers 对 TLS 1.3 枚举有限,不要只依赖它。
不是强制项,但开启后可减少客户端访问 OCSP 服务器的延迟。Nginx 需配置 ssl_stapling on、ssl_stapling_verify on、resolver 和 ssl_trusted_certificate;Let's Encrypt 证书可用 chain.pem 作为信任链。
常规站点建议 max-age=31536000(1 年)并加 includeSubDomains;预加载要求至少 1 年且所有子域支持 HTTPS,提交后撤销周期可达数周,先确认无 HTTP 子站再提交。
SSL Labs 的 A+ 通常在 A 基础上要求 HSTS 且 max-age≥31536000、无严重协议/套件问题;A 也可能满足 TLS 1.2/1.3,但 HSTS 或链配置不完整。不要只看等级,还要看 cert.issues 与协议明细。
免费工具适合人工排查与发布前扫描;商业监控胜在多地拨测、证书到期告警与历史报表,常见 50–300 元/域名/月。已有 Prometheus 时可用 blackbox_exporter 0.25.0 自建,成本主要是维护时间。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。