跳到主要内容
基础知识

SSL Labs 测试评级怎么拿到 A+:从 B 到 A+ 的证书链、TLS 与 HSTS 实操指南

ssl labs 测试评级 — SSL Labs 测试评级怎么拿到 A+:从 B 到 A+ 的证书链、TLS 与 HSTS 实操指南
核心结论

SSL Labs 测试评级要稳定到 A+,关键不是买贵证书,而是证书链完整、仅启用 TLS 1.2/1.3、禁用弱套件与 TLS 1.0/1.1、HSTS max-age≥15768000 且覆盖子域,再用 API 复核 endpoints[].grade。 证书链必须用 fullchain.pem;OpenSSL 验证应返回 Verify return code: 0 (ok),否则浏览器会出现 NET::ERR_CERT_AUTHORITY_INVALID。 Nginx 1.24+ 推荐 ssl_protocols TLSv1.2 TLSv1.3;ssl_prefer_server_ciphers off;ssl_session_tickets off;HSTS 先用 max-age=300 灰度再升到 31536000。 SSL Labs API v3 查询命令:curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off' | jq -r '.status, (.endpoints[]? | [.ipAddress,.grade,.gradeTrustIgnored] | @tsv)';testssl.sh 3.2 可本地复核协议、套件、HSTS 与 OCSP。

SSL Labs 测试评级为什么总卡在 B 或 A?先看封顶规则与根因

很多人第一次跑 SSL Labs 测试评级时会困惑:证书是 DV 还是 OV、是不是知名 CA 签的,几乎不影响分数;真正决定等级的是 Qualys 的四项逐项打分——Certificate、Protocol Support、Key Exchange、Cipher Strength(各 0–100 分),再叠加 HSTS 等附加项,并且存在若干”一票封顶”(cap)规则。据 Qualys SSL Labs 的 SSL Server Rating Guide,A+ 不是独立评分,而是”先拿到 A,再满足 HSTS 长 max-age 等条件”的附加档位。所以卡在 B 或 A,几乎总是先踩了封顶线。

触发条件 评级上限 根因说明
仍启用 TLS 1.0 / 1.1 B 2020 年后评分标准;TLS 1.0/1.1 已被 RFC 8996 正式弃用
启用 SSLv3、RC4、3DES、RSA < 2048 位、SHA-1 证书 更低(C 及以下) 弱协议/弱套件直接拉低 Protocol Support 与 Cipher Strength
证书链不完整 无法通过证书项 SSL Labs 显示 Chain issues: Incomplete
无 HSTS,或 max-age < 15768000(约 6 个月) A HSTS 是 A+ 的必要条件,但不影响 A 的取得
HSTS max-age ≥ 31536000 且含 includeSubDomains A+ 候选 仍需先满足 A 的全部条件

最常见的 B:老 Nginx 配置里写着 ssl_protocols TLSv1 TLSv1.1 TLSv1.2;。注意这是 nginx 1.23.4 之前的默认值(1.23.4 起默认改为 TLSv1.2 TLSv1.3),同时旧版本 ssl_prefer_server_ciphers 默认为 on,也会压低 Key Exchange 分。改成下面这样即可(适用于 nginx 1.20+):

# /etc/nginx/conf.d/ssl.conf
ssl_protocols TLSv1.2 TLSv1.3;                 # 去掉 1.0/1.1,解除 B 封顶
ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';  # Mozilla intermediate 推荐集;nginx 默认值为 HIGH:!aNULL:!MD5
ssl_prefer_server_ciphers off;                 # 1.23.4 起默认 off,让客户端选套件更利于 HTTP/2
ssl_ecdh_curve X25519:prime256v1:secp384r1;    # 默认 auto,显式指定避免弱曲线
ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 必须是 fullchain
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;  # A+ 需要 >=15768000

“A 都拿不到”的高频原因是链不全。据 Let’s Encrypt 文档,cert.pem 只有叶子证书,必须部署 fullchain.pem(叶子 + 中间证书),否则 SSL Labs 报 Chain issues: Incomplete,浏览器报 NET::ERR_CERT_AUTHORITY_INVALID。自检命令:

# 1) 证书有效期与 SAN 是否覆盖被测域名
openssl x509 -noout -dates -subject -ext subjectAltName 
  -in /etc/letsencrypt/live/example.com/cert.pem
# 2) 本地验证链完整性,期望输出 "OK"
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted /etc/letsencrypt/live/example.com/chain.pem 
  /etc/letsencrypt/live/example.com/cert.pem
# 3) 从外部看服务端真实下发的链,应看到 2 张证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -E "^( *[0-9]+ s:| *i:|Verify return code)"
# 链不全时典型输出:Verify return code: 21 (unable to verify the first certificate)

HSTS 的阈值要记牢:据 RFC 6797 与 SSL Labs 评分规则,max-age 至少 15768000 秒(6 个月)才算”长有效期”,低于此值只能停在 A。要冲 A+ 建议 max-age=31536000; includeSubDomains;preload 务必等所有子域都强制 HTTPS 后再加——一旦进入浏览器预加载列表,撤回需要数月,属于不可逆操作。

最后别忽略架构层:如果站点前面有 CDN/WAF,SSL Labs 测试评级测的是边缘节点的证书与 TLS 配置,不是源站。Cloudflare、阿里云 CDN 等要分别核对”边缘评级”和”回源协议”(Cloudflare 应为 Full (strict),回源也校验证书),否则边缘 A+、源站却仍是 TLS 1.0,风险并未消除。

从 B 到 A+ 的完整实操步骤:按 6 步执行并留回滚

六步顺序不能颠倒:先留下可回滚的基线,再动配置;每一步结束都要有可验证的检查点。下面所有命令都可以直接复制执行,域名和路径请按需替换。

  1. 第 1 步:备份与基线。先把当前状态固化成证据,再谈改配置。回滚只需要一条命令:cp -a /root/nginx-2025-01-01/. /etc/nginx/ && nginx -t && systemctl reload nginx。
# 带日期备份整个配置目录(-a 保留权限与时间戳,回滚时不丢 mtime)
cp -a /etc/nginx /root/nginx-$(date +%F)

# 记录每个 IP 的当前评级,写入变更单;publish=off 避免公开到 SSL Labs 榜单
curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off' 
  | jq -r '.endpoints[] | [.ipAddress,.grade] | @tsv' | tee baseline-$(date +%F).tsv
# 输出示例:104.21.x.x	B
  1. 第 2 步:修证书链。评级卡在 B 的第一大原因是只下发叶证书、漏了中间证书。Nginx 必须指向 fullchain.pem(叶证书 + 中间证书),Apache 的 SSLCertificateFile 同理,SSLCertificateChainFile 自 2.4.8 起已废弃。
# Nginx: ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
# Apache: SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
openssl s_client -showcerts -connect example.com:443 -servername example.com </dev/null 
  | grep -c 'BEGIN CERTIFICATE'
# 期望 ≥2;只返回 1 就是缺中间证书,部分客户端会报
# "unable to get local issuer certificate"

据 OpenSSL 文档,-showcerts 打印的是服务端实际发送的整条链,这正是 SSL Labs 与浏览器判断链完整性的依据。

  1. 第 3 步:收紧协议与套件。删掉 TLSv1/1.1(PCI DSS 与主流浏览器早已弃用),套件只留 ECDHE + AES-GCM / CHACHA20。
# nginx 1.24+,需 OpenSSL 1.1.1+ 才支持 TLSv1.3
ssl_protocols TLSv1.2 TLSv1.3;
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_prefer_server_ciphers off;   # TLSv1.3 套件由客户端排序,保持 off

nginx -t && systemctl reload nginx   # 先 -t 再 reload,绝不 restart 硬断连接
# Apache: SSLProtocol -all +TLSv1.2 +TLSv1.3 后执行 apachectl configtest

这套参数等价于 Mozilla SSL Configuration Generator 的 intermediate 档位,也是拿到 A+ 的最低成本基线。

  1. 第 4 步:HSTS 灰度上线。HSTS 一旦下发就无法远程撤销,只能等 max-age 过期,所以先用 300 秒试水。
# 第一阶段:5 分钟
add_header Strict-Transport-Security "max-age=300" always;
# 观察 24 小时、确认无 HTTP 子资源混合内容报错后,改为一年 + 子域
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
# 确认全部子域都有 HTTPS 后,才考虑追加 ; preload 并提交 hstspreload.org

max-age 单位为秒,默认值是不下发(即无该响应头)。HSTS 只影响后续请求,首次明文请求仍靠 301 兜底。

  1. 第 5 步:处理 OCSP 与会话复用。据 Let’s Encrypt 官方公告,其 OCSP 响应服务已停止,对 LE 证书强行开启 stapling 只会在 error_log 里刷 ssl_stapling ignored,白忙一场;该配置只对仍提供 OCSP 的商业 CA 证书有意义。
# 仅商业 CA 证书需要
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
# 会话复用:ssl_session_cache 默认 none,10m 约缓存 4 万个会话
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
  1. 第 6 步:复测与固化。改完后必须 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,.gradeTrustIgnored] | @tsv'
# 首次返回 status=IN_PROGRESS,轮询到 READY(完整扫描约 1–3 分钟)

# 纳入发布流水线,每周跑一次
testssl.sh --fast --protocols --hsts --ocsp https://example.com

注意区分 grade 与 gradeTrustIgnored:前者是用户真实看到的评级,后者忽略证书信任问题(如自签名、链不完整)后的评级。两者不一致,说明问题一定出在证书链或证书本身,而不是协议配置。

扣分现象 定位命令 典型根因与修复
评级停在 B openssl s_client -showcerts 只下发 1 张证书,改用 fullchain.pem
无 A+ curl -sI https://example.com | grep -i strict 缺 HSTS 头,或 max-age < 15768000(6 个月)
报 TLS 1.0/1.1 支持 testssl.sh --protocols ssl_protocols 未删旧协议,或旧 server 块残留
日志刷 ssl_stapling ignored tail -f /var/log/nginx/error.log LE 证书开了 stapling,关闭即可

把上述六步拆成两次变更(第 2–3 步一次,第 4–5 步一次),每次都有独立的基线快照和回滚点,是拿到 ssl labs 测试评级 A+ 最稳妥的路径;一次性全改则出问题时无法判断是哪一项引起的。

配置与命令示例:Nginx 1.24、Apache 2.4.58、OpenSSL 3.0 可直接复制

为什么把配置原样抄上去,SSL Labs 测试评级还是 B?因为评级扣分点通常不在 ssl_ciphers 这一行,而在三处:证书链漏发中间证书(Chain issues: Incomplete)、ssl_protocols 保留了默认值里的 TLS 1.0/1.1、以及缺少 HSTS 头(A 到 A+ 的唯一硬门槛)。下面三份配置分别对应 Nginx、Apache 与 OpenSSL 复核,全部可直接复制。

Nginx 1.24 / 1.25.1+ 站点配置(注意 http2 指令自 1.25.1 才存在,1.24 必须写在 listen 行):

# /etc/nginx/conf.d/example.com.conf
server {
    listen 443 ssl;
    http2 on;                      # Nginx ≥1.25.1;1.24 请删掉此行,改为 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 必须 fullchain,cert.pem 会缺中间证书
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3; # 默认值为 TLSv1 TLSv1.1 TLSv1.2,不覆盖必掉到 B
    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_prefer_server_ciphers off; # 默认 off;TLS 1.3 下该指令不生效
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;       # 默认 on,关闭以保住前向保密
    ssl_stapling off;              # OCSP stapling 不影响评级,只影响握手开销

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;  # A+ 的关键行
}

Apache httpd 2.4.58:在 ssl.conf 中设置,并确认已加载 mod_headers(Debian 系用 a2enmod headers):

LoadModule headers_module modules/mod_headers.so
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLSessionTickets off
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"

OpenSSL 3.0 复核链与协议。据 OpenSSL 文档,-verify_return_error 让握手在校验失败时直接中断:

# 期望输出 Verify return code: 0 (ok);若为 20 (unable to get local issuer certificate) 说明中间证书没发
openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error </dev/null

# 期望失败。注意 Debian/Ubuntu 的 openssl.cnf 默认 MinProtocol=TLSv1.2,
# 本机会直接报 "no protocols available",属于客户端侧限制,建议换一台机器复验
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null

用 SSL Labs API v3 与 testssl.sh 3.2 交叉验证:

curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off&startNew=on' 
 | jq -r '.status, (.endpoints[]? | [.ipAddress,.grade,.gradeTrustIgnored] | @tsv)'
# status 依次为 DNS → IN_PROGRESS → READY,首次扫描通常 1-3 分钟;同 host 约每分钟 1 次,超限返回 429

git clone --depth 1 https://github.com/drwetter/testssl.sh.git && cd testssl.sh
./testssl.sh --fast --protocols --std --hsts --ocsp https://example.com
# 重点看:TLS 1.0/1.1 → not offered;RC4 → not offered;HSTS → max-age=31536000

curl -sI https://example.com | grep -i 'strict-transport-security'
# 期望 strict-transport-security: max-age=31536000; includeSubDomains
curl -sI http://example.com | head -n 3
# 期望 301 或 308,且 Location: https://example.com/
工具 版本 覆盖内容 耗时 局限
SSL Labs API v3 在线服务 最终评级、证书链、协议、HSTS 综合 1-3 分钟 需公网可达,有速率限制
testssl.sh 3.2 协议/套件/HSTS/OCSP 逐项复核 约 30 秒(–fast) 不产出 A/A+ 字母评级
openssl s_client 3.0 链验证、单协议握手、证书有效期 秒级 只测单点,不反映浏览器兼容矩阵

若 certbot 生成的站点里已 include /etc/letsencrypt/options-ssl-nginx.conf;,该文件同样会设置 ssl_protocols,后加载者生效——顺序写错会让你的 TLS 1.3 配置被覆盖。

参数对比与方案选型:TLS 版本、套件、证书、HSTS 与 OCSP 怎么选

SSL Labs 测试评级卡在 B,十有八九是这三项之一:仍在响应 TLS 1.0/1.1、套件里混着 CBC/RC4/3DES、证书用了 SHA-1 或 1024 位 RSA。据 SSL Labs 官方评分文档(SSL Server Rating Guide),2020 年 3 月起 TLS 1.0/1.1 被标记为 deprecated,继续支持即评级上限 B。下表是五个关键维度的选型对照:

项目 推荐值 旧值/默认值 对评级的影响 备注
TLS 版本 TLSv1.2 + TLSv1.3 TLSv1/1.1/1.2 支持 1.0/1.1 通常封顶 B 2020 后 SSL Labs 已按弃用处理
套件 ECDHE+AES-GCM、CHACHA20 CBC、RC4、3DES 弱套件降级或封顶 Nginx ssl_ciphers 只留 6 个左右
证书 RSA 2048/3072 或 ECDSA P-256,SHA-256 RSA 1024、SHA-1 密钥过小/签名弱降级 用 fullchain.pem
HSTS max-age=31536000; includeSubDomains 无或 max-age=300 A+ 需长 max-age preload 最后加
OCSP 商业 CA 开 stapling;Let’s Encrypt 已停 OCSP 未配置 非 A+ 硬性项 关注吊销与握手延迟
会话票据 off on 影响前向安全 与评级不直接挂钩

必须兼容 Windows 7 / 旧 Android 怎么办?别在主站上妥协。把旧协议隔离到独立域名(如 legacy.example.com)甚至独立 IP/端口,主站只留 TLS 1.2/1.3,这样 SSL Labs 对主域的评级不受牵连:

# Nginx 1.11.0+ 语法;ssl_protocols 默认值为 TLSv1 TLSv1.1 TLSv1.2(旧版),必须显式覆盖
server {
    listen 443 ssl;
    server_name www.example.com;

    ssl_protocols TLSv1.2 TLSv1.3;   # 去掉 1.0/1.1 是脱离 B 档的第一步
    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_prefer_server_ciphers off;   # TLS 1.3 下由客户端决定顺序,保持 off
    ssl_session_tickets off;         # 关闭票据,避免密钥泄露导致历史流量可解密
}

server {
    listen 443 ssl;                  # legacy 站点建议绑定独立 IP
    server_name legacy.example.com;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;   # 仅此处降级,主站不受影响
}

证书选型:RSA 还是 ECDSA?RSA 2048 兼容面最广;ECDSA P-256 握手更快、字节更小,但老客户端可能不支持。Nginx 1.11.0+ 起支持同一 server 块配置双证书,SSL Labs 会按客户端能力自动选择,评分取更优项:

ssl_certificate     /etc/nginx/ssl/example.rsa.fullchain.pem;   # RSA 证书链,必须是 fullchain
ssl_certificate_key /etc/nginx/ssl/example.rsa.key;
ssl_certificate     /etc/nginx/ssl/example.ecdsa.fullchain.pem; # ECDSA 证书链
ssl_certificate_key /etc/nginx/ssl/example.ecdsa.key;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;               # 供 OCSP stapling 校验用

HSTS 怎么选?先灰度再拉满:max-age=300 观察一周无异常,再改为 max-age=31536000; includeSubDomains。据 hstspreload.org 的要求,提交 preload 需同时满足 max-age ≥ 31536000、含 includeSubDomains 与 preload 指令,且所有子域均可 HTTPS 访问——移除周期以月计,子域没铺满 HTTPS 前不要加。

OCSP stapling 还要不要开?据 Let’s Encrypt 官方公告,其已于 2025 年 8 月起在新签发证书中移除 OCSP URL,并计划 2026 年 1 月关闭 OCSP responder,因此对 LE 证书配置 stapling 只会让 Nginx 日志刷 ssl_stapling 相关告警。DigiCert、Sectigo 等商业证书仍可开启并验证:

ssl_stapling on;
ssl_stapling_verify on;
# 验证:返回 "OCSP Response Status: successful" 才算生效
openssl s_client -connect www.example.com:443 -servername www.example.com -status </dev/null 
  | grep -A2 "OCSP Response Status"

CDN 上的 A+ 能代表源站安全吗?不能。Cloudflare 需开启 Full (strict),阿里云 CDN 需启用 HTTPS 回源并校验源站证书链;否则边缘拿 A+、回源仍是明文或弱协议,SSL Labs 测试评级只反映你测的那个端点。

常见错误与排查:这些真实报错分别怎么处理

SSL Labs 测试评级卡在 B 或 A,通常不是因为某个”大配置”写错,而是握手链路上某一环有缺口。下面这 6 条报错来自真实工单与浏览器控制台,按出现频率排序,每条都给出可直接复制的定位命令。

Q1:浏览器报 NET::ERR_CERT_AUTHORITY_INVALID,curl 报 unable to get local issuer certificate,是证书买错了吗?

九成是服务器只下发了叶子证书、缺中间证书。用下面这条命令数一数实际下发了几张:正常应为 2 张(叶子 + 中间),只有 1 张就是问题所在。修复方式是让 Nginx 指向 fullchain.pem 而非 cert.pem,然后 nginx -t && systemctl reload nginx。

# 统计服务端实际下发的证书张数;输出 1 即为缺中间证书
openssl s_client -showcerts -connect example.com:443 
  -servername example.com /dev/null | grep -c 'BEGIN CERTIFICATE'

# Nginx 正确写法(Let's Encrypt 路径)
ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

Q2:客户端报 sslv3 alert handshake failure 或 no protocols available,怎么定位?

这是协议版本没有交集。逐个版本探测,哪一档 FAIL 一目了然:

for v in tls1 tls1_1 tls1_2 tls1_3; do
  printf "%-8s " "$v"
  openssl s_client -$v -connect example.com:443 -servername example.com 
    /dev/null 2>&1 && echo OK || echo FAIL
done

如果 -tls1_1 仍返回 OK,说明 ssl_protocols 没删干净。注意 nginx 1.23.4 起该指令默认值已从 TLSv1 TLSv1.1 TLSv1.2 改为 TLSv1.2 TLSv1.3,但旧配置文件里的显式写法不会自动升级。Mozilla SSL Configuration Generator 的 intermediate 档位建议只保留 TLSv1.2 TLSv1.3,这也是 SSL Labs 拿到 A+ 的协议基线。

Q3:报 no suitable key share 或 sslv3 alert illegal parameter?

TLS 1.3 的 key_share 扩展(RFC 8446 §4.2.8)里没有双方都支持的曲线组。测试时显式指定曲线,确认服务端支持哪些:

# OpenSSL 3.0.x / 3.2.x 均支持 -groups
openssl version
openssl s_client -tls1_3 -groups X25519:P-256 -connect example.com:443 
  -servername example.com </dev/null

# Nginx 侧(ssl_ecdh_curve 默认值 auto,即沿用 OpenSSL 默认曲线表)
ssl_ecdh_curve X25519:secp256r1;

Q4:SSL Labs 提示 Key size too small,日志里是 dh key too small?

DH 参数低于 2048 位,或 RSA 私钥低于 2048 位(CA/B Forum 基线要求下限即为 2048)。生成并挂载:

# 生成 2048 位 DH 参数,耗时数十秒到数分钟,生成一次即可复用
openssl dhparam -out /etc/nginx/dhparam.pem 2048

# Nginx:ssl_dhparam 默认未设置,必须显式指定才会生效
ssl_dhparam /etc/nginx/dhparam.pem;

检查证书密钥长度:openssl x509 -in fullchain.pem -noout -text | grep "Public-Key"。

Q5:OCSP response: no response sent,日志有 ssl_stapling ignored?

两个原因:ssl_trusted_certificate 没指向 chain.pem(Nginx 默认未设置,缺它 stapling 直接不工作),或该 CA 根本不提供 OCSP。据 Let’s Encrypt 官方公告,其 OCSP 服务已于 2025 年逐步关停、新签证书不再包含 OCSP URL,因此使用 LE 证书时应直接关闭 stapling(ssl_stapling 默认值本就是 off),改由短期证书与证书透明日志保障吊销可见性,再复测 SSL Labs 评级。

Q6:curl: (60) SSL certificate problem: certificate has expired?

certbot certificates                          # 看 Expiry Date 与证书名
certbot renew --dry-run                       # 演练续期,验证钩子与权限
systemctl list-timers | grep certbot          # 确认 timer 存在且 NEXT 时间合理

速查表:

报错关键字 根因 修复动作
unable to get local issuer certificate 缺中间证书 改用 fullchain.pem 并 reload
no protocols available 协议版本无交集 ssl_protocols TLSv1.2 TLSv1.3
no suitable key share TLS 1.3 曲线不匹配 ssl_ecdh_curve X25519:secp256r1
dh key too small DH < 2048 位 openssl dhparam 2048 + ssl_dhparam
no response sent 缺 issuer 或 CA 无 OCSP 指向 chain.pem 或关闭 stapling
certificate has expired 续期链路中断 certbot renew –dry-run 排障

效果验证方法:如何确认配置生效并稳定在 A+

配置改完不等于生效,更不等于”稳定在 A+”。这一节给出一套可重复执行的验证序列,从 HSTS、协议版本、证书链、SSL Labs API、本地扫描器到 CDN 边缘/源站分离测试,逐层确认。

1) HSTS 是否真的下发?据 RFC 6797,HSTS 通过响应头生效,且 max-age 是唯一必需指令。期望值应为 max-age=31536000; includeSubDomains(如需预加载再加 preload):

# 期望输出包含 max-age=31536000; includeSubDomains
curl -sI https://example.com | grep -i 'strict-transport-security'

# 确认 HTTP 端口仍做 301/308 跳转,否则首次明文请求可绕过 HSTS
curl -sI http://example.com | grep -Ei '^(HTTP/|location:)'
# 期望:HTTP/1.1 301 Moved Permanently  →  Location: https://example.com/

注意:浏览器在收到 HSTS 头之前的那一次 HTTP 请求仍走明文,所以 http:// 必须能跳转;仅靠 HSTS 不构成完整防护。

2) 协议与套件是否按预期收窄?用 openssl s_client 做正反双向测试(OpenSSL 1.1.1 及以上支持 -tls1_3):

# 应成功:TLS 1.2 / TLS 1.3
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null

# 应失败:TLS 1.0 / 1.1(报 protocol version 或 handshake failure)
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null

# 应返回 no ciphers available(套件已被禁用)
openssl s_client -connect example.com:443 -servername example.com -cipher 'RC4-SHA' </dev/null

3) 证书链是否完整可信?缺少中间证书是”评级从 A 掉到 B”最常见的原因之一,Let’s Encrypt 文档明确要求部署 fullchain.pem 而非仅 cert.pem:

# 期望最后一行:Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com 
  -CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error </dev/null

# 检查有效期与 SAN 是否覆盖所有域名
openssl x509 -noout -dates -ext subjectAltName 
  -in <(openssl s_client -connect example.com:443 -servername example.com /dev/null)

4) SSL Labs API 是否为 READY + A+?网页结果有缓存,脚本判定要卡住 status 字段:

curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done&publish=off' 
  | jq -r '.status, (.endpoints[]? | [.ipAddress,.grade,.gradeTrustIgnored] | @tsv)'
# 只有 status=READY 且 grade=A+ 才算通过;结果被缓存时追加 &startNew=on 强制重测

5) 本地扫描器交叉验证。testssl.sh 与 nmap 不依赖第三方队列,适合放进 CI:

testssl.sh --fast --protocols --std --hsts --ocsp https://example.com
# 关注:TLS 1.0/1.1 not offered、RC4 not offered、HSTS max-age ≥ 15768000

nmap --script ssl-enum-ciphers -p 443 example.com
# 列出实际协商套件,用于比对服务端配置是否与预期一致

6) 别只测到 CDN 边缘。若站点走 CDN,边缘与源站的 TLS 配置往往不同,必须分开验证:

# 直连源站,绕过 DNS 解析
curl -v --resolve example.com:443:203.0.113.10 https://example.com -o /dev/null
验证项 命令/位置 通过标准 失败典型症状
HSTS curl -sI https:// max-age=31536000; includeSubDomains 无该响应头,评级被扣至 A
协议版本 openssl s_client -tls1_1 握手失败 成功握手,评级降为 B
证书链 s_client -verify_return_error Verify return code: 0 (ok) unable to get local issuer certificate
综合评级 SSL Labs API v3 status=READY 且 grade=A+ status=IN_PROGRESS 或 grade=A
边缘/源站 curl --resolve 两者均达 A+ 仅边缘合格,源站仍开 TLS 1.0

浏览器侧最后确认一次:Chrome DevTools → Security 面板应显示 “TLS 1.3” 与 TLS_AES_256_GCM_SHA384;若显示 TLS 1.2,说明中间设备或 CDN 终止了握手。全部通过后,建议把上述命令写成定时任务,防止证书续期或配置回滚导致评级悄然下滑。

长期维护与监控:证书到期、协议弃用与 CI 检查怎么落地

证书还有 20 天到期,为什么 Certbot 没动静、SSL Labs 也没提醒?因为两边都不是”临期告警”工具。据 Let’s Encrypt 文档,Certbot 的续期窗口是到期前 30 天(renew_before_expiry 默认 30 days),它在窗口内静默续期,不续期成功也不主动通知;而 SSL Labs 的 grade 只在证书已经过期或链不完整时才崩,临期不影响评级。所以告警阈值要设在 Certbot 窗口之内,例如剩余 < 21 天,留出失败重试的余量:

# Certbot 1.10+ / 2.x:列出全部证书与到期时间
certbot certificates
# Certificate Name: example.com
#   Domains: example.com www.example.com
#   Expiry Date: 2025-06-18 03:12:44+00:00 (VALID: 27 days)   <-- 解析这一行做告警
#   Certificate Path: /etc/letsencrypt/live/example.com/fullchain.pem

# 确认定时器存在且真的在跑(缺失时 list-timers 无输出 = 静默失效)
systemctl list-timers | grep certbot
# NEXT                         LEFT    LAST                         PASSED  UNIT
# Mon 2025-05-26 00:00:00 UTC  6h left Sun 2025-05-25 00:00:00 UTC  17h ago certbot.timer

# 每月演练一次:只走 ACME 流程、不写盘,能提前暴露 DNS/80 端口/防火墙问题
certbot renew --dry-run --cert-name example.com

certbot.timer 由 OnCalendar=*-*-* 00/12:00:00 驱动,每天触发两次并带随机延迟;如果 LAST 列超过 48 小时没更新,说明 timer 被 mask 或机器时间异常,需要人工介入。

协议早就只留 TLS 1.2/1.3 了,为什么每年还要复查?因为默认值会随软件升级而变,你的显式配置也可能被模板覆盖。OpenSSL 3.0 起默认安全级别为 1(@SECLEVEL=1,拒绝 1024 位 RSA 与 SHA-1 签名),3.2 进一步收紧默认密码套件;Nginx 自 1.23.4 起把 ssl_protocols 的默认值改为 TLSv1.2 TLSv1.3(1.26.x 沿用),Apache 2.4.58 的 mod_ssl 官方示例仍建议 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1。每年用一条命令验证实际协商结果:

# 期望只出现 TLSv1.3 / TLSv1.2;若打印 TLSv1.1 说明配置被回退
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | grep -E "^ *(Protocol|Cipher)"
#     Protocol  : TLSv1.3
#     Cipher    : TLS_AES_256_GCM_SHA384

# 显式探测旧协议;OpenSSL 3.x 客户端自身禁用时会直接报 no protocols available
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 40A7C1FF:error:0A000102:SSL routines::unsupported protocol
监控对象 工具 / 命令 判定阈值 失败动作
证书到期 certbot certificates 剩余 < 21 天 告警 + 手动 certbot renew
续期定时器 systemctl list-timers LAST > 48 小时前 检查 systemctl status certbot.timer
协议版本 openssl s_client -tls1_1 能协商成功即失败 立即修 ssl_protocols
评级 SSL Labs API v3 grade 低于 A 自动开工单
HSTS 头 curl -sI max-age < 31536000 或缺 includeSubDomains 降级告警

SSL Labs API 怎么定时跑才不被限流?据 SSL Labs API 文档,publish=off 可避免结果进入公开缓存(生产域名尤其该关),而同一 host 的并发分析会被拒绝并返回 HTTP 429,响应头 X-Max-Assessments / X-Current-Assessments 给出配额。每周一次、串行执行、失败后指数退避 5–10 分钟:

# 每周一次的评级巡检;jq 提取每个 IP 的 grade
curl -sS "https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done&maxAge=24" 
  | jq -r '.endpoints[] | "(.ipAddress) (.grade) (.statusMessage // "")"'
# 203.0.113.10 A+
# 若返回 429 或 errors 数组,等待 5-10 分钟后单次重试,切勿并发扫同一域名

CI 里怎么把”降级”挡在发布前?两道闸门,任一失败即非零退出、阻断流水线:

set -euo pipefail
DOMAIN="${DOMAIN:?需要目标域名}"

# 闸门 1:证书链完整性 + 主机名校验,-verify_return_error 让校验失败直接报错退出
openssl s_client -connect "$DOMAIN:443" -servername "$DOMAIN" 
  -verify_return_error -verify_hostname "$DOMAIN" </dev/null >/dev/null

# 闸门 2:testssl.sh 3.2.x,--severity HIGH 下发现问题返回退出码 1
./testssl.sh --fast --protocols --hsts --severity HIGH --quiet "$DOMAIN"

HSTS 开了 preload,出问题能撤回吗?只能部分撤回,且要按 RFC 6797 §6.1.1 理解:UA 收到 max-age=0 的 STS 头才会删除该主机的策略——前提是浏览器还能完成 HTTPS 握手并拿到这个响应。一旦 HTTPS 已不可用,用户只会看到证书错误,永远走不到清除那一步,只能等原 max-age 过期。所以回滚预案是”先降 max-age,再排查”,而不是”出事再改 0″:

# 回滚第一步:缩短而非清零,避免误伤还能正常握手的用户
add_header Strict-Transport-Security "max-age=300" always;
# 确认 HTTPS 恢复后,再改回 max-age=0 让 UA 删除策略
# add_header Strict-Transport-Security "max-age=0" always;

preload 名单的移除是另一条时间线:需按 hstspreload.org 的 removal 流程提交,等待 Chromium 内置列表随版本发布更新,周期以周甚至月计——据 Chrome 的 HSTS preload 说明,移除申请会在列表下次生成时生效,期间所有用户仍受强制 HTTPS 约束。这也是把 max-age 从 300 秒逐步抬到 31536000、确认无混合内容后再考虑 preload 的原因。

不是。评级取决于扫描时的证书链、TLS 版本、套件、HSTS 响应头和 CDN 边缘配置,任何一项变更都可能让 A+ 掉到 A 或 B。建议每次发布后加 startNew=on 复测,并每周用 API 巡检一次。

A+ 需要 HSTS max-age 至少 15768000 秒;若只有 300 秒、响应头被 CDN 覆盖,或只在 HTTP 响应返回,就仍是 A。用 curl -sI https://example.com | grep -i 'strict-transport-security' 检查最终响应,不要只看源站配置文件。

据 Let's Encrypt 官方公告,其 OCSP 服务已停止,Let's Encrypt 证书不再需要也不建议强行开启 stapling;SSL Labs 的 A+ 也不把 OCSP 作为硬性条件。DigiCert、Sectigo 等商业 CA 仍可开启并用 openssl s_client -status 验证。

评级不按品牌或价格给分。DV、OV、EV 证书只要受信任、证书链完整、密钥 ≥2048 位、签名算法为 SHA-256,TLS 配置相同就能拿到同样的 A+;价格主要影响保修、人工审核和合规材料,不影响协议评分。

这是缺少中间证书的典型报错。用 openssl s_client -showcerts -connect example.com:443 -servername example.com

需要。CDN 终止 TLS 后,SSL Labs 测到的是边缘节点,源站仍可能暴露弱协议或过期证书。建议回源使用 Full (strict) 或 HTTPS 校验,源站同样只开 TLS 1.2/1.3,并用 curl –resolve example.com:443:源站IP https://example.com 单独验证源站。

先等待 5-10 分钟再查,不要并发扫同一域名;API v3 有速率限制,频繁 startNew=on 会触发限制。确认配置已 reload 后再重新扫描,查询时加 publish=off,避免公开缓存影响后续结果。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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