跳到主要内容
安装配置教程

https 检测工具怎么用?OpenSSL 与 testssl.sh 实操指南

https 检测工具 — 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 交叉签名退役后的完整根证书集合:

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

内容审核

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