tls 1.3 在 nginx 中需 openssl 1.1.1+ 编译支持、显式配置 ssl_protocols tlsv1.2 tlsv1.3 和专用 tls 1.3 密码套件,否则即使版本达标也会降级至 tls 1.2。

TLS 1.3 在 Nginx 中不是“开个开关”就能用的,它依赖 OpenSSL 1.1.1+ 编译支持,且必须在配置中显式启用 ssl_protocols 和适配的 ssl_ciphers —— 否则即使版本达标,浏览器仍会降级到 TLS 1.2。
确认 Nginx 和 OpenSSL 是否真正支持 TLS 1.3
很多人卡在这一步:nginx -v 显示版本 ≥1.13,但 nginx -V(大写 V)输出里没看到 OpenSSL 1.1.1 或更高,说明 Nginx 是用旧版 OpenSSL 编译的,TLS 1.3 不可用。
- 运行
nginx -V 2>&1 | grep -i openssl,必须看到类似built with OpenSSL 1.1.1w;若显示1.0.2u或1.1.0l,哪怕 Nginx 是 1.18 也没用 - Ubuntu/Debian 官方源的
nginx包默认不带 OpenSSL 1.1.1,需换用nginx-full(Ubuntu 22.04+)或自编译 - CentOS/RHEL 8+ 的
nginx模块默认支持,但 RHEL 7 需启用 EPEL + nginx-mod-http-ssl 模块 - LNMP 一键包用户注意:
lnmp.conf中的Enable_Nginx_Openssl='n'必须改为'y',并指定--with-openssl=路径
nginx.conf 里必须写的 TLS 1.3 配置项
仅加 TLSv1.3 到 ssl_protocols 不够,OpenSSL 1.1.1+ 默认启用 TLS 1.3,但 Nginx 会因加密套件不匹配而静默失败 —— 浏览器连接时可能直接报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。
-
ssl_protocols TLSv1.2 TLSv1.3;—— 不能只写TLSv1.3,否则老客户端(如 Android 4.4、IE 11)会断连 -
ssl_ciphers TLS13-AES-256-GCM-SHA384:TLS13-CHACHA20-POLY1305-SHA256:TLS13-AES-128-GCM-SHA256;—— 这三组是 RFC 8446 正式定义的 TLS 1.3 密码套件,不能混入任何TLS-开头的旧套件 -
ssl_prefer_server_ciphers off;—— TLS 1.3 下该指令已失效,设为on反而可能干扰协商,建议显式关掉 - 删除所有
ssl_ecdh_curve相关行(除非你明确需要限制曲线),TLS 1.3 自动协商 X25519 或 P-256
Let’s Encrypt 证书能否直接用于 TLS 1.3?
可以,但要注意 Certbot 自动生成的配置通常没加 TLS 1.3 支持,得手动补全 —— 即使你用 certbot --nginx 成功了,也得检查生成的 server 块。
- Certbot 1.20+ 版本会在配置里加
ssl_protocols TLSv1.2 TLSv1.3;,但ssl_ciphers行仍沿用旧值(含ECDHE等),必须手动替换为纯 TLS 1.3 套件 - 证书本身无 TLS 版本绑定,RSA 2048、ECDSA secp256r1、甚至 ed25519 签发的证书都兼容 TLS 1.3
- OCSP Stapling 对 TLS 1.3 有效,但需确保
ssl_stapling on;和ssl_trusted_certificate路径正确,否则部分浏览器(如 Safari)可能拒绝连接 - 自签名证书测试时,Chrome 110+ 和 Firefox 102+ 支持 TLS 1.3,但需访问
chrome://flags/#tls13-variant确认未禁用
验证 TLS 1.3 是否生效的可靠方法
别只信浏览器地址栏的小锁图标 —— 它可能显示“安全”,但实际走的还是 TLS 1.2。真正在用 TLS 1.3 的标志只有一个:握手完成时间明显缩短,且服务器响应头不含 alt-svc 降级提示。
- 用
openssl s_client -connect example.com:443 -tls1_3直接强制 TLS 1.3 握手,成功返回Protocol : TLSv1.3才算通过 - 访问 SSL Labs Test,看结果页 “Handshake Simulation” 区域是否有 Chrome 110+ / Firefox 102+ 显示 “TLS 1.3”
- 在 Chrome DevTools → Security 标签页,刷新后点 “View certificate”,下方 “Connection” 行明确写出
TLS 1.3 - 常见假阳性:Nginx 日志里出现
SSL_do_handshake() failed,通常是ssl_ciphers写错(比如漏了冒号、混入了 TLS 1.2 套件)
最易被忽略的是:Nginx reload 后,旧 worker 进程可能还在用老配置处理长连接,得用 nginx -s reload 并观察 ss -tnp | grep :443 确认新进程 PID 已接管;另外,CDN(如 Cloudflare)如果开启“最低 TLS 版本”限制,也会覆盖你源站的配置。











