Nginx 配置 TLS 1.3 与 HSTS 的实践

一台跑了两年多的轻量应用服务器,Nginx 用的是发行版默认配置,`ssl_protocols` 还停在 TLSv1 TLSv1.1 TLSv1.2。这次顺手清理掉老协议,打开 TLS 1.3 和 HSTS,记录整个过程与两个卡了一会儿的地方。

一、先确认 OpenSSL 支持 TLS 1.3

TLS 1.3 要求在 OpenSSL 1.1.1 及以上。Debian 11 / Ubuntu 20.04 以后的发行版自带版本都满足,CentOS 7 自带的 1.0.2 需要换源或自己编译,那种情况建议先升系统而不是硬上。

openssl version -a
# 期望看到 OpenSSL 1.1.1 或 3.x
nginx -V 2>&1 | tr ' ' '\n' | grep -E 'openssl|tls'
# 确认 Nginx 编译时链接的 OpenSSL 版本,而不是系统自带版本

第二步输出的 built with OpenSSL 1.1.1w 才是真正生效的版本。Nginx 编译时静态链接 OpenSSL 的情况很常见,此时系统里装了新版本也没用。

二、server 段配置

server {
    listen 443 ssl;
    http2 on;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/example.com.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;

    # 只留 1.2 和 1.3,1.0 / 1.1 已经不该出现在公网
    ssl_protocols TLSv1.2 TLSv1.3;

    # TLS 1.3 的套件名与 1.2 不同,混写会被忽略
    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;

    # 会话复用:1.3 走 ticket,1.2 走 cache
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;

    # OCSP stapling
    ssl_stapling on;
    ssl_stapling_verify on;
    resolver 223.5.5.5 119.29.29.29 valid=300s;

    # HSTS:先给 300 秒观察,确认全站 HTTPS 再拉长
    add_header Strict-Transport-Security "max-age=300" always;

    location / {
        root /var/www/site;
        index index.html;
        try_files $uri $uri/ =404;
    }
}

几个参数解释:

参数作用注意点
ssl_prefer_server_ciphers off由客户端决定优先套件TLS 1.3 下服务端顺序本就无效,保持 off 更符合现代实践
ssl_session_tickets off关闭会话票据票据密钥不轮换会削弱前向保密,省事起见直接关
add_header ... always让 4xx / 5xx 也带 HSTS 头漏掉 always 时 404 页面不带这个头,测试会误判

三、踩坑一:套件混写导致握手失败

第一次配置时把 1.2 和 1.3 的套件名写在了一行:

ssl_ciphers TLS_AES_128_GCM_SHA256:ECDHE-RSA-AES128-GCM-SHA256;

Nginx 启动不报错,但用浏览器访问直接握手失败,curl 返回 error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure。原因是 TLS_AES_128_GCM_SHA256 这类 TLS 1.3 套件名在 ssl_ciphers 里属于未知条目,Nginx 会把它当作一个无效套件处理,而剩下那个 1.2 套件又因为被要求用于 1.3 而无法协商。

正确做法:ssl_ciphers 只放 1.2 的套件;TLS 1.3 的套件由 OpenSSL 内部固定,另用 ssl_conf_command Ciphersuites 才能指定,绝大多数场景不需要动。

四、踩坑二:HSTS 与自签证书

调试阶段用了自签证书,浏览器点「继续访问」之后,HSTS 头被记录了下来。等换成正式证书再访问,浏览器仍然强制 HTTPS 且拒绝接受新证书的中间状态,只能去 chrome://net-internals/#hsts 手动删掉该域名的记录。

教训是:先在 max-age=300 的小值上验证,确认整条链路(CDN、回源、跳转、混合内容)都干净之后再拉长到一年。提交 preload 列表更要谨慎,一旦进了浏览器预置列表,撤回要等数月。

五、验证

# 1. 协商版本是否为 TLS 1.3
openssl s_client -connect example.com:443 -tls1_3 </dev/null 2>/dev/null \
  | grep -E 'Protocol|Cipher'

# 2. 1.2 是否仍然可用、1.1 是否已被拒绝
openssl s_client -connect example.com:443 -tls1_2 </dev/null 2>/dev/null | grep Protocol
openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | tail -3

# 3. 响应头是否带 HSTS
curl -sI https://example.com/ | grep -i strict-transport

# 4. 证书链是否完整(stapling 生效时能看到 OCSP response)
openssl s_client -connect example.com:443 -status </dev/null 2>/dev/null | grep -A2 'OCSP Response'

四条都过了再改配置里的 max-age。第 2 条里 1.1 的握手应该直接失败,报 alert protocol version 或 no protocols available,这才说明老协议真的关掉了。

六、性能观察

同一台机器、同一份静态页面,用 curl 循环 200 次取中位数:TLS 1.2 完整握手约 62ms,TLS 1.3 约 41ms,省下的主要是一次往返。开启会话复用后 1.2 降到 38ms 左右,1.3 的 0-RTT 在 Nginx 上默认不开,需要显式配置 ssl_early_data on,但 0-RTT 有重放风险,只适合幂等请求,静态站点可以接受。

整体收益不大,但配置成本很低,顺手做掉是划算的。真正影响感知的是首屏资源和缓存策略,加密握手只是其中一环。