在线SSL检测报告怎么看?从A+评级、HSTS到CDN回源的8步验收清单
在线SSL检测真正要确认的是三件事:证书链完整、只开TLS 1.2/1.3、HSTS响应头到位;据Qualys SSL Labs评级文档,总分由证书30%、协议支持30%、密钥交换30%、加密强度10%四项相乘得出,80分以上才是A,A+还需HSTS的max-age不低于15768000秒。 改完配置必须清缓存复测:网页端点Clear cache,API v3加startNew=on,默认复用24小时内(maxAge默认24)的结果会让你误判成“没生效”。 CDN后面的在线检测握的是边缘节点,验证源站要单独跑 openssl s_client -connect :443 -servername example.com。 OCSP stapling需要ssl_stapling、ssl_stapling_verify、ssl_trusted_certificate、resolver四项齐全,缺resolver时静默失效,报告里OCSP一栏为空。 据Let's Encrypt官方公告,其OCSP响应服务已于2025年1月30日关闭并转向CRL,因此Let's Encrypt证书在检测报告里显示未装订OCSP属预期行为。
为什么同一个域名,三个在线SSL检测工具给出三种结论?
同一个域名,在三个在线SSL检测工具里跑出 A、A+ 和 B,先别急着改配置——多数情况下三个工具测的根本不是同一台机器、同一套评分规则。想读懂报告,第一步是确认”你测的到底是哪台机器”。
1)检测节点不同,命中的 PoP 就不同。Qualys SSL Labs 的扫描器默认从境外节点发起握手,国内站长工具与 MySSL 从境内节点发起;如果域名挂在 CDN 上,GeoDNS 会把两类扫描器调度到不同的边缘节点,返回的证书序列号、TLS 套件顺序、甚至是否支持 TLS 1.3 都可能不一样。用两条命令就能验证:
# 分别向境外/境内递归要解析结果,观察是否落到不同 IP(CDN 场景极常见)
dig +short example.com @8.8.8.8 # Google DNS,通常拿到海外 PoP
dig +short example.com @223.5.5.5 # 阿里 DNS,通常拿到境内 PoP
# 对同一个 IP 做握手,打印证书序列号,多节点各跑一次做对比
openssl s_client -connect 203.0.113.10:443 -servername example.com /dev/null
| openssl x509 -noout -subject -serial -dates
2)评级算法不是同一套。据 Qualys SSL Labs 评级文档,总分由证书 30%、协议支持 30%、密钥交换 30%、加密强度 10% 加权,80 分以上才是 A;而 A+ 另有硬门槛:据同一份文档,响应头必须带 Strict-Transport-Security 且 max-age 不低于 15768000 秒(约 6 个月),否则封顶 A。国内的 MySSL、站长工具使用自建规则,权重未公开,所以”一份配置、两种等级”完全正常。
| 维度 | Qualys SSL Labs | MySSL | 站长工具类在线SSL检测 |
|---|---|---|---|
| 发起节点 | 境外(美国为主) | 境内为主 | 境内 |
| 评分模型 | 证书30/协议30/密钥交换30/加密强度10,≥80 为 A | 自建规则,未公开权重 | 自建规则,未公开权重 |
| A+ 条件 | 总分达标 + HSTS max-age ≥ 15768000 | 以站方文档为准 | 多数不区分 A+ |
| 结果缓存 | API v3 maxAge 默认 24 小时 |
通常实时 | 通常实时 |
3)SNI 缺失会直接改写结论。不带 SNI 的握手会落到 Nginx 的第一个 server 块或默认证书,检测器随即报 Certificate not valid for name(OpenSSL 侧对应 verify error:num=62:hostname mismatch),而真实浏览器带 SNI,一切正常。单 IP 多站点场景下这是最常见的误报:
# 不带 -servername:模拟无 SNI 客户端,往往拿到默认证书
openssl s_client -connect 203.0.113.10:443 /dev/null | openssl x509 -noout -subject -serial
# 带 -servername:与浏览器行为一致
openssl s_client -connect 203.0.113.10:443 -servername example.com /dev/null
| openssl x509 -noout -subject -serial
4)缓存会骗人。SSL Labs 网页端与 API v3 默认复用 24 小时内的结果(maxAge 默认 24,单位小时)。改完配置不复测缓存,等于没改;用 startNew=on 强制重扫,注意 API 有速率限制,会返回 429:
# startNew=on 丢弃缓存重新扫描;jq 只取每个端点的 IP 与等级
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&startNew=on&all=done"
| jq '.endpoints[] | {ipAddress, grade, statusDetails}'
HSTS 是否真的生效,用响应头一秒确认(Nginx 需 add_header ... always;,否则 4xx/5xx 响应不带该头):
# Nginx 1.25.x 验证;max-age=31536000 满足 SSL Labs 的 A+ 门槛
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
# 验证:应输出 strict-transport-security: max-age=31536000; includeSubDomains
curl -sI https://example.com | grep -i '^strict-transport-security'
所以下一步不是急着改套件,而是先固定测量点:用 dig 锁定 IP、用 openssl s_client 锁定 SNI 行为、用 startNew 清掉缓存,再拿同一台机器的结果去比对三份在线SSL检测报告,结论才有可比性。
在线SSL检测的四个盲区:它测不到源站、非443端口和内网
Q:为什么跑在 8443/9443 上的 K8s Ingress 或管理后台,在在线检测里永远是 ERROR?
据 Qualys SSL Labs 的 API 文档,host 参数语法确实支持 hostname:port,但它的评级模型只针对 443 端口上的 HTTPS 服务建模;而大量第三方在线 ssl 检测器根本不解析端口参数,遇到非标端口直接返回 Unable to connect to the server 或 Assessment failed。这类端口只能本地手动指定,OpenSSL 1.1.1 及 3.x 默认从 -connect 的主机名推断 SNI,但对纯 IP 连接不会发送 SNI 扩展,必须显式给 -servername:
# testssl.sh 3.2+:host:port 语法;-p 只测协议与密码套件,--severity 默认 LOW(全量输出)
testssl.sh -p --severity HIGH ingress.example.com:8443
# OpenSSL 1.1.1 / 3.x:显式 SNI + 打印证书链
openssl s_client -connect ingress.example.com:8443
-servername ingress.example.com -showcerts </dev/null 2>&1 | head -20
Q:源站还开着 TLS 1.0,为什么报告照样是 A+?
因为开启 CDN 后,检测器握手的是边缘节点,源站从不参与这次 TLS 会话。要验收回源链路,必须绕过 DNS 直连源站 IP,同时保留 SNI,否则虚拟主机只会返回默认证书:
# 直连源站 IP,SNI 仍填域名
openssl s_client -connect 203.0.113.10:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# curl 强制解析到源站,看真实协商的 TLS 版本
curl -sv --resolve example.com:443:203.0.113.10 https://example.com 2>&1 | grep -E 'SSL connection|TLSv'
Q:内网地址和双向认证为什么一律报 ERROR?
公网检测器无法路由到 10.x/172.16.x 私网,也无法出示客户端证书,握手在第一阶段就断了。私有 CA 签发的证书同样会被判为链不完整。只能用客户端证书本地验证,失败时典型输出是 sslv3 alert handshake failure 或 verify error:num=19:self-signed certificate in certificate chain:
# -verify_return_error 让校验失败直接中断,而不是静默继续
openssl s_client -connect 10.20.0.5:443 -servername internal.example.com
-cert client.crt -key client.key -CAfile private-ca.pem -verify_return_error </dev/null
Q:证书全绿,浏览器为什么还提示”不安全”?
那是混合内容问题,属于应用层而非 TLS 层,任何证书检测器都不覆盖。可先用 curl 粗筛页面里残留的 http:// 引用,再配合 Content-Security-Policy: upgrade-insecure-requests 兜底。
curl -s https://example.com | grep -oE 'http://[^"[:space:]]+' | sort -u | head
Q:响应头写了 preload,是不是就进 Chrome 列表了?
不是。据 RFC 6797,HSTS 只定义了 max-age 与 includeSubDomains;preload 是 Chromium 维护的扩展 token,写入头部只是”申请资格”,收录状态要去 hstspreload.org 查询,或在 chrome://net-internals/#hsts 的 Domain Security Policy 里查实际生效值。
curl -sI https://example.com | grep -i '^strict-transport-security'
# 期望:Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
| 检测盲区 | 在线检测报告能看到吗 | 本地补测手段 |
|---|---|---|
| 8443/9443 管理后台、Ingress | 多数工具返回 ERROR | testssl.sh host:8443 |
| CDN 后的源站 TLS 配置 | 只握手到边缘节点 | openssl s_client -connect IP:443 -servername 域名 |
| mTLS、私网 IP、私有 CA | 握手失败报 ERROR | openssl s_client -cert/-key/-CAfile |
| HTTPS 页面内的 http:// 资源 | 不检测,属浏览器层 | curl | grep 'http://' |
| HSTS preload 是否真收录 | 只读响应头,不看列表 | hstspreload.org 查询 |
Step 1:同一份配置,用三种视角各测一次
为什么同一份配置要测三次?因为 TLS 握手的结果取决于客户端是否发送 SNI。据 RFC 6066(TLS Extensions,第 3 节)定义,SNI 让客户端在 ClientHello 里声明目标主机名,服务端据此选择证书;没发 SNI 的客户端只能落到默认 server 块。CDN 场景下,边缘节点与回源站往往是两套独立配置,只测公网域名会掩盖源站问题。所以在线 SSL 检测的第一步不是”看分数”,而是固定三个视角、各留一份可复现的基线。
| 视角 | 入口 | 能看到什么 | 典型异常 |
|---|---|---|---|
| A 公网域名 | SSL Labs 网页,输入 example.com | 总分 A+~F,以及 Certificate / Protocol Support / Key Exchange / Cipher Strength 四个分项分 | 分项拖后腿却总分尚可;证书链缺中间证书 |
| B 指定 IP + SNI | openssl s_client -servername |
源站真实证书链、协议版本、协商套件 | 源站证书与边缘不是同一条链;源站仍开 TLS 1.0 |
| C 无 SNI 默认站点 | openssl s_client(不带 -servername) |
默认 server 块返回的证书 | 返回 CDN 厂商证书或自签证书,泄露默认站点 |
视角 A:公网域名。在 Qualys SSL Labs 的 SSL Server Test 页面输入域名,务必勾选 “Do not show the results on the boards”,避免测试结果被公开索引。等待 2–3 分钟,把总分和四个分项分截图存档。据 SSL Labs 评分文档,A+ 的额外条件是启用 HSTS 且 max-age 足够长、证书与协议均无扣分项——这也是后面几步要逐条核对 HSTS 与证书链的原因。
视角 B:指定 IP + SNI 直连源站。这条命令是整套验收里最有价值的一条,因为它绕开了 CDN:
# 视角B:显式指定 SNI 并直连源站 IP,取出源站证书的主体/签发者/有效期/SAN
# 注意:s_client 的会话信息走 stderr,证书走 stdout,下面分开处理
openssl s_client -connect 203.0.113.10:443 -servername example.com -showcerts /dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 同时抓协议版本与套件名(-brief 需 OpenSSL 1.1.1+,3.0.x/3.2.x 均支持)
openssl s_client -connect 203.0.113.10:443 -servername example.com -brief </dev/null
# 期望输出形如:
# Protocol version: TLSv1.3
# Cipher: TLS_AES_256_GCM_SHA384
把视角 B 拿到的证书序列号与视角 A(边缘)比对,若不同源,说明源站证书可能是自签或过期——这在回源验收里是最常见的”分数很高但源站裸奔”。
视角 C:无 SNI 的默认站点。故意不带 -servername,模拟老客户端、健康检查探针和直接 IP 访问:
# 故意不发送 SNI,看默认 server 块返回哪张证书
openssl s_client -connect 203.0.113.10:443 &1 | grep -E 'subject=|issuer=|Protocol|Cipher'
如果返回的不是期望域名,说明 nginx 的默认 server 块没单独配置。按 Mozilla SSL Configuration Generator 的推荐,可以为默认块单独签一张占位证书,或者干脆 listen 443 ssl default_server; return 444; 直接断开,避免被扫描器抓到无关证书。
把基线写进变更单。三次输出都要落三样:证书序列号、协商协议版本、套件名。改完配置后逐项 diff,而不是”以为改了”:
# 一次抓齐序列号+有效期+协议+套件,作为变更单附件
{ openssl s_client -connect 203.0.113.10:443 -servername example.com -brief </dev/null
openssl s_client -connect 203.0.113.10:443 -servername example.com /dev/null
| openssl x509 -noout -serial -dates -fingerprint -sha256; } | tee baseline-$(date +%F).txt
工具版本要先对齐。openssl version -a 确认在 3.0.x 或 3.2.x(3.0 为 LTS,3.2 起默认安全级别与 provider 行为有变化,会影响能否握手成功);批量扫描用 testssl.sh 3.2,git clone --depth 1 https://github.com/drwetter/testssl.sh 即可;curl 建议 7.88.0 以上,此时 --tlsv1.2 与 --tls-max 组合才能正确钳制协议上限,用来验证”是否真的关掉了 TLS 1.1″。三件工具的版本一并记进基线文件,否则下次在线 ssl 检测结果不可复现。
Step 2:把报告拆成五块读,每一块对应一个配置项
拿到一份在线 SSL 检测报告,别急着找那个字母评级。Qualys SSL Labs、ImmuniWeb、myssl 的页面布局不同,但底层都拆成五块:证书、协议、密钥交换、HTTP 响应头、证书链与 CT。每一块都能反向映射到一条具体的服务器配置,看懂映射关系,报告才不是一张成绩单。
| 报告分块 | 关键字段 | 不合格时的典型提示 | 对应配置项 |
|---|---|---|---|
| 证书 | SAN 列表、有效期、Signature Algorithm、Public-Key | SHA1 with RSA、Key too small | ssl_certificate |
| 协议 | TLS 1.0 / 1.1 / 1.2 / 1.3 支持矩阵 | TLS 1.0 标红、Protocol support 扣分 | ssl_protocols |
| 密钥交换 | ECDHE / DHE、Server Temp Key 曲线 | TLS_RSA_WITH_* 静态套件 | ssl_ciphers / ssl_ecdh_curve |
| HTTP 头 | HSTS max-age、includeSubDomains、preload | HSTS not implemented | add_header … always |
| 证书链 / CT | Chain issues、SCT 数量 | Chain issues: Incomplete | fullchain 顺序、CA 中间证书 |
证书块怎么读?先看 SAN 是否同时覆盖 example.com 和 www.example.com——只签裸域是新手最常踩的坑,浏览器会直接抛 NET::ERR_CERT_COMMON_NAME_INVALID。再看签名算法,SHA-1 早已不可用,Chrome 自 2017 年(Chrome 56)起对 SHA-1 证书报 NET::ERR_CERT_WEAK_SIGNATURE_ALGORITHM;密钥长度要求 RSA ≥ 2048 位或 ECDSA P-256。报告这一栏异常,八成是 nginx 里 ssl_certificate 指向了单张站点证书而非 fullchain,导致中间证书缺失。
# 检查证书 SAN、签名算法与公钥长度(OpenSSL 1.1.1+ / 3.x 均可)
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -text
| grep -E 'DNS:|Signature Algorithm|Public-Key|Not After'
# 期望输出类似:
# Signature Algorithm: sha256WithRSAEncryption
# Public-Key: (2048 bit)
# DNS:example.com, DNS:www.example.com
协议块:哪些应该是红的?报告会把 TLS 1.0/1.1/1.2/1.3 排成一行,1.0 和 1.1 必须显示为不支持。PCI DSS v3.2 明确要求 2018 年 6 月 30 日起停止使用 TLS 1.0 作为传输层保护。nginx 1.23.4(2023-04-11)起 ssl_protocols 默认值已改为 TLSv1.2 TLSv1.3,更早版本默认是 TLSv1 TLSv1.1 TLSv1.2,这就是老服务器报告泛红的原因。
# nginx.conf 中 server 块
ssl_protocols TLSv1.2 TLSv1.3; # 显式关闭 1.0/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 下由客户端择优
ssl_ecdh_curve X25519:prime256v1; # 默认 auto,显式指定可保证 P-256 在列
# 逐版本验证,TLS 1.0/1.1 应握手失败
for v in tls1 tls1_1 tls1_2 tls1_3; do
printf '%s: ' "$v"
openssl s_client -connect example.com:443 -servername example.com -$v /dev/null
| grep -q 'Cipher is' && echo OK || echo FAIL
done
# 注:OpenSSL 3.x 默认 SECLEVEL=2 会拒绝旧协议,测试端可加 -cipher 'DEFAULT@SECLEVEL=0'
密钥交换块:为什么 TLS_RSA_WITH_* 一出现分数就掉?这类静态 RSA 套件不具备前向保密(PFS),私钥一旦泄露,历史流量可被解密。SSL Labs 的 Key Exchange 项会因此直接降级。判断方法很直接:看 Server Temp Key 行,出现 X25519, 253 bits 或 ECDH, P-256, 256 bits 才算合格,RFC 8446(TLS 1.3)已强制只保留 (EC)DHE 密钥交换。
# 查看实际协商套件与临时密钥
openssl s_client -connect example.com:443 -servername example.com /dev/null
| grep -E 'Cipher is|Server Temp Key'
# 期望:Cipher is TLS_AES_256_GCM_SHA384
# Server Temp Key: X25519, 253 bits
HTTP 响应头块:HSTS 三个字段缺一不可。据 RFC 6797,max-age 是秒数,preload 列表要求至少 31536000(一年)且必须带 includeSubDomains。nginx 的坑在于 add_header 默认只对 2xx/3xx 生效,漏掉 always 参数时 4xx/5xx 响应不带 HSTS 头,扫描器会判为部分实现。
# add_header 的 always 参数需 nginx 1.7.5+
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
# 验证:连 404 页面也要带上该头
curl -sI https://example.com/not-exist | grep -i strict-transport-security
证书链与 CT 块:Chain issues 是最容易被忽略的一栏。报告显示 Chain issues: Incomplete 意味着服务器只发了站点证书,没发中间证书——桌面浏览器能靠 AIA 补链,Android 和部分 Java 客户端会直接失败。顺序也必须是从站点证书到中间证书逐级向上。CT(Certificate Transparency)方面,据 Let’s Encrypt 文档,其签发的证书默认嵌入 SCT;自签或老 CA 证书可能为 0 个,可在 crt.sh 按域名检索核实。
# 检查链顺序:第一行应为站点证书,随后逐级中间证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null
| grep -E '^ *[0-9]+ s:|i:'
# 统计 SCT 数量(0 表示未嵌入)
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -text
| grep -c 'CT Precertificate SCTs'
五块读完,你手上的就不是一个字母,而是五条待办:fullchain 路径、ssl_protocols 白名单、ECDHE 套件集合、带 always 的 HSTS 头、以及完整的中间证书链。Mozilla SSL Configuration Generator 提供的 intermediate/old 三档模板可直接对照替换。
Step 3:按报告改配置——Nginx 1.24 + OpenSSL 3.0可复制片段
照着一份旧模板改配置,最常见的后果是报告从 A+ 掉回 B——因为 Nginx 的 HTTP/2 指令写法在 1.25.1 变了,OCSP stapling 缺 resolver 会静默失效,HSTS 直接上 preload 又可能把自家子域锁死。下面这段配置适用 Nginx 1.24.0 + OpenSSL 3.0.x,可直接改路径后套用。
# /etc/nginx/conf.d/example.com.conf
# Nginx 1.25.1 及以上:把 listen 行改为 listen 443 ssl;,并在 server 内单独写 http2 on;
server {
listen 443 ssl http2; # 1.24.0 写法;http2 随 listen 开启
server_name example.com;
ssl_certificate /etc/nginx/ssl/example.com.fullchain.pem; # 必须含中间证书
ssl_certificate_key /etc/nginx/ssl/example.com.key; # chmod 600
ssl_protocols TLSv1.2 TLSv1.3; # 默认值含 TLSv1,务必显式收窄
ssl_prefer_server_ciphers off; # 默认 off;开启反而降低客户端兼容性
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_session_cache shared:SSL:10m; # 默认 none;10m 约容纳 4 万个会话
ssl_session_timeout 1d; # 默认 5m
ssl_session_tickets off; # 默认 on;关闭以免票据密钥不同步
# OCSP stapling 四件套(Nginx 1.3.7 起支持)
ssl_stapling on; # 默认 off
ssl_stapling_verify on; # 默认 off
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 只放中间证书,不含站点证书
resolver 223.5.5.5 119.29.29.29 valid=300s;
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=300" always; # HSTS 第一档
}
注意最后那段 resolver:Nginx 需要它去解析 OCSP 响应者域名,缺失时 stapling 不会报错,只是永远不生效——在线 SSL 检测报告里 OCSP stapling 一栏空白,十有八九就是这个原因。另外,上面 ssl_ciphers 只影响 TLS 1.2;TLS 1.3 的 5 个套件(TLS_AES_128_GCM_SHA256 等)由 OpenSSL 3.0 固定,改 ssl_ciphers 无效。该串取自 Mozilla Server Side TLS 5.7 的 Intermediate 档,兼顾兼容性与前向保密。
HSTS 千万不要一步到位。据 Let’s Encrypt 与 MDN 的说明,浏览器一旦缓存了 max-age=31536000,在过期前无法回退,因此建议按下表灰度:
| 阶段 | 响应头取值 | 观察时长 | 退出成本 |
|---|---|---|---|
| 灰度 | max-age=300 |
24 小时 | 5 分钟内自然过期 |
| 稳定 | max-age=86400 |
两周 | 1 天内过期 |
| 正式 | max-age=31536000; includeSubDomains |
长期 | 一年内不可回退 |
加 preload 之前,必须逐一确认 mail、api、测试环境等子域都已上 HTTPS,否则这些子域会被浏览器硬拦且无法用“继续访问”绕过。
证书链顺序错了同样过不了验收。cat example.com.crt intermediate.crt > fullchain.pem 的顺序是“站点证书在前、中间证书在后”,颠倒后 OpenSSL 会报 unable to get local issuer certificate,报告里会显示“证书链不完整”。改完先 nginx -t 验证语法,通过后执行 systemctl reload nginx 而不是 restart:reload 会平滑启动新 worker、让旧 worker 处理完存量连接再退出,TLS 握手不会中断;restart 则会瞬断所有长连接。
参数对比与选型表:TLS版本、HSTS时长、检测工具怎么选
选型时最常被问到的一句话是:TLS 1.2 到底还要不要留着?答案取决于你的用户终端分布,而不是评测分数。下面三张表,分别把协议版本、HSTS 时长、检测工具放在一起对比,先看完表再动配置,能少返工一轮。
先看协议版本,它直接决定评级上限:
| 版本 | RFC | Nginx 参数写法 | SSL Labs 处理方式 |
|---|---|---|---|
| TLS 1.3 | RFC 8446 | TLSv1.3 |
可拿满分;套件固定 5 个,需 OpenSSL 1.1.1+ 与 Nginx 1.13.0+ |
| TLS 1.2 | RFC 5246 | TLSv1.2 |
必须配置 PFS(ECDHE)套件才能满分;兼容 Java 8、Android 5 |
| TLS 1.1 | RFC 4346 | 不写(禁用) | 触发降级警告,最高 B |
| TLS 1.0 | RFC 2246 | 不写(禁用) | PCI DSS 自 2018-06-30 起明令禁用 |
# /etc/nginx/conf.d/ssl.conf
# Nginx 1.23.0 起 ssl_protocols 默认值即为 TLSv1.2 TLSv1.3;更早版本默认为 TLSv1 TLSv1.1 TLSv1.2,必须显式改
ssl_protocols TLSv1.2 TLSv1.3;
# ssl_ciphers 只作用于 TLS 1.2 及以下;TLS 1.3 套件由 OpenSSL 内部固定,改这里无效
# 默认值 HIGH:!aNULL:!MD5 —— 默认值里含非 PFS 套件,评级会被扣分
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-RSA-AES256-GCM-SHA384';
# 默认 off;OpenSSL 1.0.2+ 下开启可强制服务端套件顺序,便于稳定评级
ssl_prefer_server_ciphers on;
HSTS 时长别一步到位,max-age 是单向门:浏览器一旦缓存,到期前无法通过改服务器配置撤回,只能等下个 max-age 过期或推送 max-age=0 让已访问过的客户端清除。
| max-age | 换算 | 适用阶段 | 回滚难度 |
|---|---|---|---|
| 300 | 5 分钟 | 灰度验证,确认全站 HTTPS 无混合内容 | 低 |
| 86400 | 1 天 | 上线首周 | 低 |
| 15768000 | 6 个月 | SSL Labs 拿到 A+ 的门槛值 | 中 |
| 31536000 | 1 年 | hstspreload.org 提交硬性要求 | 高,移除需数月 |
# add_header 的 always 参数需 Nginx 1.7.5+;不加 always 时 4xx/5xx 响应不会带此头
# Nginx 本身没有 HSTS 默认值,不写就不发送
add_header Strict-Transport-Security "max-age=15768000; includeSubDomains" always;
# 提交 preload 前必须先满足:max-age>=31536000、includeSubDomains、preload 三项齐全
检测工具怎么挑?做一次在线 ssl 检测只是起点,持续回归才是重点:
| 工具 | 覆盖范围 | 输出 | 局限 |
|---|---|---|---|
| SSL Labs | 协议/套件/证书/评分,API v3 | 网页 + JSON | 单节点(美国)、结果缓存 24h |
| testssl.sh 3.2 | 200+ 检查项,支持任意端口 | CLI / JSON / CSV | 需本地或 CI 环境 |
| MySSL / 站长工具 | 国内节点,中文报告 | 网页 | 检查项偏少,多数无公开 API |
| Hardenize | 额外含 DNS、CAA、SMTP、DANE | 网页 | 免费版功能受限 |
# 用 API 做自动化回归;startNew=on 可绕过 24h 缓存强制重测
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off&startNew=on"
| jq -r '.endpoints[] | "(.ipAddress) (.grade)"'
# testssl.sh 3.2(2024 年发布,需 bash 4+ 与 OpenSSL 1.1.1+)
git clone --depth 1 https://github.com/drwetter/testssl.sh.git && cd testssl.sh
./testssl.sh --protocols --server-defaults --hsts --jsonfile report.json https://example.com:443
档位取舍:据 Mozilla Server Side TLS 5.7,Modern 档只保留 TLS 1.3 与 ECDHE+AEAD 套件,适合纯 API 与 App 后端,代价是 Windows 7 自带浏览器和 Android 5 直接握手失败;要覆盖这些终端,选 Intermediate 档并保留 TLS 1.2。实务做法是先在预发环境跑一遍 testssl.sh 与在线 ssl 检测,确认无 UNABLE_TO_NEGOTIATE 后再灰度切档。
常见错误与真实报错:从verify error 20到sslv3 alert handshake failure
线上验收时最常见的“证书装好了但客户端连不上”,几乎都能用下面 5 类报错归类。先用一条命令把链路和返回值一次性抓出来,再对症下药:
# 抓取服务端发送的完整证书链,并打印校验结果(适用于 OpenSSL 1.1.1 / 3.x)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1
| grep -E '^ *[i|s]:|Verify return code'
# 严格模式:校验失败会直接以非 0 退出码结束,适合写进 CI 验收脚本
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
# 期望最后一行:Verify return code: 0 (ok)
1)verify error:num=20:unable to get local issuer certificate / Verify return code: 21 (unable to verify the first certificate)
这不是证书过期,而是链断了:服务端只发了站点证书,没发中间证书,客户端无法回溯到受信任根。据 Let’s Encrypt 文档,其 fullchain.pem 才是“站点证书 + 中间证书”,cert.pem 只是单张站点证书。把 nginx 的 ssl_certificate 从 cert.pem 改为 fullchain.pem 后,上面的 -verify_return_error 应返回 0 (ok)。浏览器因为会自行补链(AIA Fetching)常常“看着正常”,但 Java、curl、部分 IoT 客户端会直接失败——这正是必须用在线 ssl 检测复测链路的原因。
2)nginx: [warn] “ssl_stapling” ignored, issuer certificate not found for certificate …
ssl_stapling on 需要签发者证书来验证 OCSP 响应,缺失时 nginx 只打印 warn 并静默关闭 stapling,于是在线报告的 OCSP Stapling 一栏为空。nginx -t 就能看到这条 warn,别等到上线。
server {
listen 443 ssl;
server_name example.com;
# 必须用 fullchain:站点证书 + 中间证书,否则客户端报 verify error 20
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
# 指向签发者(中间)证书,缺这行 stapling 会被 ignored
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
ssl_stapling on; # 默认 off
ssl_stapling_verify on; # 默认 off
ssl_protocols TLSv1.2 TLSv1.3;
}
3)sslv3 alert handshake failure / SSL_do_handshake() failed (SSL: error:0A000410:SSL routines::sslv3 alert handshake failure)
这是客户端发出的告警:它只支持 TLS 1.0/1.1 或已被禁用的套件,而服务端只开了 1.2/1.3。用 openssl s_client -connect example.com:443 -servername example.com -tls1_1 复现,能稳定触发即确认。是放行旧客户端(临时加回 TLSv1.1 并接受评级下滑)还是推动升级,需要在验收清单里明确决策,而不是留着随机报错。
4)curl: (60) SSL: no alternative certificate subject name matches target host name
SAN 不含目标域名,典型是只签了 example.com 未签 www.example.com,或 CDN 回源时用了源站 IP 证书。核对:openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -ext subjectAltName。
5)error:0A000006/0A080006:SSL routines::ee key too small
RHEL 9 / OpenSSL 3.0 默认 CipherString = DEFAULT:@SECLEVEL=2,拒绝 1024 位 RSA 与 SHA-1 签名证书。正确做法是重签 2048 位以上、SHA-256 的证书;@SECLEVEL=1 能临时绕过,但会同时放宽其他安全约束,不建议在生产使用。
| 报错关键字 | 根因 | 修复动作 |
|---|---|---|
| verify error 20 / return code 21 | 缺中间证书,只发了站点证书 | ssl_certificate 改 fullchain.pem |
| “ssl_stapling” ignored | 无 ssl_trusted_certificate | 指向 chain.pem,nginx -t 验证 |
| sslv3 alert handshake failure | 客户端仅支持 1.0/1.1 | 决策:放行旧协议或推动升级 |
| curl (60) subject name | SAN 未覆盖该域名 | 重签含 www 的证书 / 回源改域名 |
| ee key too small | SECLEVEL=2 拒绝弱密钥 | 换 2048 位 RSA + SHA-256 |
问:网页端和 API 复测,为什么必须先”清缓存”?
SSL Labs 对同一主机名的评级结果缓存 24 小时,直接重跑往往拿到旧分数——你刚改完 HSTS 或禁用 TLS 1.1,报告却毫无变化。据 SSL Labs 官方 API 文档,startNew 参数默认值为 off,必须显式置为 on 才会丢弃缓存重新握手探测;网页端对应勾选 “Clear cache” 复选框。完整调用如下(publish=off 为默认值,避免把内网或测试域名推到公开榜单):
# 强制重新扫描并等待全部完成;all=done 会阻塞到扫描结束(通常 1–3 分钟)
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&startNew=on&all=done&publish=off"
| jq '.endpoints[] | {ipAddress, grade, statusDetails}'
# 若不想阻塞,去掉 all=done,轮询返回体中的 status 字段直到 "READY"
多节点交叉的意思是:CDN 场景下 endpoints[] 会返回多个 IP,逐个核对 grade,避免只测到某个边缘节点或回源节点。回源若仍是旧配置,边缘 A+、回源 B 的情况很常见。
问:不想等网页排队,怎么 30 秒内验证协议版本?
用 openssl s_client 直接指定版本探测,比等评分快得多。-servername 用于发送 SNI(OpenSSL 1.0.0+ 支持),-tls1_3 需 OpenSSL 1.1.1 及以上,LibreSSL 不支持该参数。
# 1) TLS 1.1 应握手失败(返回码非 0)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 2) TLS 1.2 应成功
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep "Protocol"
# 3) TLS 1.3 应成功
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>/dev/null | grep "Protocol"
| 命令参数 | 期望输出 | 不符合期望时的典型报错/含义 |
|---|---|---|
-tls1_1 |
握手失败 | sslv3 alert handshake failure(正常,说明已禁用) |
-tls1_2 |
Protocol : TLSv1.2 |
no protocols available(服务端未开 1.2) |
-tls1_3 |
Protocol : TLSv1.3 |
旧版 OpenSSL 报 unknown option -tls1_3 |
问:HSTS 头怎么确认 always 真的生效?
只查首页不够——很多配置把 add_header 写在某个 location 里,4xx/5xx 就丢了头。据 Mozilla Server Side TLS 建议,max-age 至少 31536000(一年),并配合 includeSubDomains;申请 preload 还要求 max-age≥31536000 且带 includeSubDomains。两条命令即可判定:
# 首页应输出 max-age
curl -sI https://example.com | grep -i strict-transport-security
# 不存在的路径也必须带同样的头,证明 nginx 的 "always" 参数生效
curl -sI https://example.com/404-not-exist | grep -i strict-transport-security
若第二条无输出,检查是否为 add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;——漏掉 always 时 nginx 只在 2xx/3xx 状态码下添加该头。
问:OCSP 装订成功长什么样?Let’s Encrypt 为什么显示没装订?
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null
| grep -E "OCSP Response Status|Cert Status"
# 期望:OCSP Response Status: successful (0x0) / Cert Status: good
# 未装订时输出:OCSP response: no response sent
据 Let’s Encrypt 官方公告,其 OCSP 服务已于 2025 年 1 月 30 日起停止对外响应,因此 Let’s Encrypt 证书不再装订 OCSP、探测显示 “no response sent” 属于预期行为,不影响评级,改用 CRL 或短期证书(short-lived certificates)即可。
问:怎么把到期巡检写成每日任务?
openssl x509 -checkend 的秒数为必填参数,返回码 0 表示未到期、1 表示将在该时间内过期,适合直接接告警:
# 2592000 秒 = 30 天;可先在终端手动跑一次确认
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -checkend 2592000
# 输出 "Certificate will not expire"(退出码 0)或 "Certificate will expire"(退出码 1)
# /etc/cron.d/cert-check:每天 09:00 巡检,失败则发邮件
0 9 * * * root /usr/bin/openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | /usr/bin/openssl x509 -noout -checkend 2592000 || echo "example.com 证书 30 天内到期" | mail -s "TLS 证书告警" ops@example.com
注意 cron 环境无 PATH,命令一律写绝对路径;多域名站点把 host 列表放进 for 循环,配合 -servername 逐个检查,避免只盯住主域名而漏掉 CDN 回源证书。
检测器只验证证书与协议,浏览器还校验主机名匹配、系统时间、混合内容与HSTS。先看证书SAN是否包含当前访问的完整域名(www与裸域常被漏签),再检查页面是否引用了http://资源,最后确认客户端系统时间未偏差超过证书有效期。
多数是SNI问题。检测器如果走了不带SNI的握手,会落到Nginx第一个server块拿到默认证书。用 openssl s_client -connect IP:443(不带-servername)复现,若返回默认证书,给默认server块单独配证书或直接 return 444 即可。
两者视角不同:SSL Labs代表公网单节点(美国)看到的结果,适合对外评级;testssl.sh 3.2在你自己机器上跑,可指定端口、可进CI、可复现,适合变更验证。建议以testssl.sh做回归、以SSL Labs做对外口径,两者不一致时优先查CDN与SNI。
不需要。据Let's Encrypt官方公告,其OCSP响应服务已于2025年1月30日关闭,全面转向CRL,因此这类证书的stapling检测为空属预期行为,不影响浏览器信任判断。
常见三种原因:配置写在非目标server块、reload未生效(用 nginx -T | grep ssl_protocols 确认实际加载内容)、或者前面还有CDN/SLB保留了旧协议。先直连源站IP测一次,再逐层排查。
A+只要求HSTS的max-age不低于15768000秒,并不要求preload。提交preload后移除需要数月,且所有子域必须已全量HTTPS,建议先用 includeSubDomains 稳定运行数月,再评估是否提交。
把站点证书与中间证书按“站点证书在前、中间证书在后”的顺序拼成fullchain,例如 cat example.com.crt intermediate.crt > fullchain.pem,让 ssl_certificate 指向它,再用 openssl crl2pkcs7 -nocrl -certfile fullchain.pem | openssl pkcs7 -print_certs -noout 核对条数与顺序。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。