跳到主要内容
基础知识

在线SSL检测报告怎么看?从A+评级、HSTS到CDN回源的8步验收清单

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

内容审核

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