跳到主要内容

NET::ERR_SSL_OBSOLETE_VERSION 完整解决指南:关闭 TLS 1.0/1.1 并正确启用 TLS 1.2/1.3

问题背景:这个报错到底是什么触发的

NET::ERR_SSL_OBSOLETE_VERSION 是 Chromium 网络栈返回的错误码(源码中为 net::ERR_SSL_OBSOLETE_VERSION)。Chrome 84(2020 年 7 月)起,只要 TLS 握手协商出的协议版本低于 TLS 1.2,浏览器就直接拦截页面,地址栏显示「此连接使用的加密技术已过时」。同一时期 Firefox 74 关闭了 TLS 1.0/1.1,Safari 13.1 与 Edge 84 跟进;IETF 在 2021 年 3 月以 RFC 8996 正式废弃 TLS 1.0(RFC 2246)与 TLS 1.1(RFC 4346)。PCI DSS 更早在 2018 年 6 月就要求 TLS 1.2 以上。

关键认知:这个报错和证书完全无关。续签证书、换 CA、重装证书链都不会让它消失,因为协议版本协商发生在证书校验之前。排障第一步永远是确认服务端实际协商出的协议版本,而不是先怀疑证书。顺便区分几个容易混淆的错误码:证书过期是 NET::ERR_CERT_DATE_INVALID,域名不匹配是 NET::ERR_CERT_COMMON_NAME_INVALID,协议过时才轮到 ERR_SSL_OBSOLETE_VERSION。

还有一层容易被忽略:现代架构中浏览器看到的 TLS 通常由 CDN / WAF / 负载均衡终止。源站 Nginx 的 ssl_protocols 改了,但 CDN 控制台里的「最低 TLS 版本」或「回源协议」没改,用户侧问题依旧存在,甚至会出现边缘节点正常、回源握手失败的 502/522。因此排查必须逐层做:边缘节点一层、源站一层、内网调用链再一层。

根因定位:用命令确认站点仍在用 TLS 1.0/1.1

在任意一台 OpenSSL 1.1.1+ 的机器上逐个协议探测,不要靠猜:

# 探测 TLS 1.0(OpenSSL 3.x 必须降安全等级,否则是本地失败不是服务端失败)
openssl s_client -connect example.com:443 -servername example.com -tls1 -cipher 'DEFAULT@SECLEVEL=0' </dev/null 2>&1 | grep -E 'Protocol|Cipher|alert'

# 探测 TLS 1.1
openssl s_client -connect example.com:443 -servername example.com -tls1_1 -cipher 'DEFAULT@SECLEVEL=0' </dev/null 2>&1 | grep -E 'Protocol|Cipher|alert'

# 探测 TLS 1.2 / 1.3
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>&1 | grep -E 'Protocol|Cipher'

输出中出现 Protocol: TLSv1 或 Protocol: TLSv1.1 说明旧协议仍然开放;只有出现 alert handshake failure 或 no protocols available 才算真正关闭。全量枚举协议与密码套件用 nmap:

nmap --script ssl-enum-ciphers -p 443 example.com

curl 侧验证必须带 –tls-max,否则 curl 会自动向上协商,永远成功,测不出问题:

curl -sS -o /dev/null -w '%{http_code}n' --tlsv1.0 --tls-max 1.0 https://example.com

站点在 CDN 后面时,还要绕过边缘直连源站 IP,并用 -servername 命中正确的虚拟主机:openssl s_client -connect 203.0.113.10:443 -servername example.com -tls1。想一次性拿到评级和协议清单,可调用 SSL Labs 接口:curl -s 'https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done' | jq '.endpoints[].details.protocols'。注意 OpenSSL 3.0 默认安全等级为 2,TLS 1.0 不显式加 @SECLEVEL=0 会直接报错,很容易被误判成「服务端已关闭」。

Nginx 完整实操:从默认值到生产配置

Nginx 1.23.4 之前的 ssl_protocols 默认值是 TLSv1 TLSv1.1 TLSv1.2——也就是说,大量站点从未写过这一行,却一直在对外提供 TLS 1.0。这是最常见、也最隐蔽的根因。可直接落地的配置:

server {
    listen 443 ssl;
    http2 on;                 # Nginx 1.25.1+;旧版本用 listen 443 ssl http2;
    server_name example.com;

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

    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;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_session_tickets off;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}

几个必须注意的点:第一,不要只写 TLSv1.3,Windows 7/8.1、Android 5 以下、JDK 8u31 之前的客户端最高只到 TLS 1.2,会直接 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。第二,ssl_ciphers 只对 TLS 1.2 及以下生效,TLS 1.3 的套件由 OpenSSL 固定(TLS_AES_128_GCM_SHA256 等),写在这里也不会报错但毫无作用。第三,TLS 1.3 需要 Nginx 链接 OpenSSL 1.1.1+,用 nginx -V 2>&1 | grep -o 'OpenSSL [0-9.]*' 确认。第四,CBC 类套件和 RSA 密钥交换套件应全部删除,只保留 ECDHE + AEAD。改完执行 nginx -t && systemctl reload nginx,务必用 reload 而非 restart,避免中断长连接。

Apache 与 IIS 配置示例

Apache 通过 mod_ssl 控制,配置文件通常位于 /etc/httpd/conf.d/ssl.conf 或 /etc/apache2/mods-enabled/ssl.conf:

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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305
SSLHonorCipherOrder off
SSLSessionTickets off
SSLUseStapling on

Apache 2.4.53+ 更推荐写成 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1,可读性更好且不会误伤未来版本。TLS 1.3 同样要求 OpenSSL 1.1.1+。校验并生效:apachectl configtest && systemctl reload httpd。

IIS 走 Schannel 注册表,用管理员 PowerShell 一次改完(注意路径拼接用单引号,避免转义问题):

$base = 'HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols'
foreach ($p in 'TLS 1.0','TLS 1.1') {
  New-Item -Path ($base + '' + $p + 'Server') -Force | Out-Null
  Set-ItemProperty -Path ($base + '' + $p + 'Server') -Name Enabled -Value 0 -Type DWord
  Set-ItemProperty -Path ($base + '' + $p + 'Server') -Name DisabledByDefault -Value 1 -Type DWord
}
New-Item -Path ($base + 'TLS 1.2Server') -Force | Out-Null
Set-ItemProperty -Path ($base + 'TLS 1.2Server') -Name Enabled -Value 1 -Type DWord
Set-ItemProperty -Path ($base + 'TLS 1.2Server') -Name DisabledByDefault -Value 0 -Type DWord
Restart-Computer

要点:Schannel 的协议开关在系统启动时读取,只重启 IIS 或 w3wp 不生效,必须重启服务器;应用作为客户端调用外部 HTTPS 时,还要配置 ...ProtocolsTLS 1.2Client 的 Enabled=1、DisabledByDefault=0;.NET Framework 4.5/4.6 需额外设置 SchUseStrongCrypto=1 才会默认使用 TLS 1.2。也可用 IIS Crypto 图形工具勾选,本质写的是同一批键值。

协议版本与兼容性对比表

下表用于决策「到底保留哪些版本」,不要凭感觉一刀切:

协议 RFC 发布年份 密钥交换 主流客户端支持 建议
TLS 1.0 RFC 2246 1999 RSA / 静态 DH,无前向保密 Chrome 84+、Firefox 74+ 已移除 必须关闭
TLS 1.1 RFC 4346 2006 同上,仅修 CBC IV 同上 必须关闭
TLS 1.2 RFC 5246 2008 ECDHE + AEAD(GCM/ChaCha20) 全平台,Win7 SP1 需手动启用 保留
TLS 1.3 RFC 8446 2018 仅 ECDHE,1-RTT,加密握手 Chrome 70+、Firefox 63+、Win10 1809+ 保留

策略取舍对比:

服务端策略 安全性 老客户端(Win7/Android 5/JDK8 早期) 适用场景
仅 TLSv1.3 最高 全部连接失败 内部服务、明确已知客户端较新
TLSv1.2 + TLSv1.3 高 正常 绝大多数公网站点的推荐值
TLSv1.1 + 1.2 + 1.3 不达标 正常 仅用于过渡期,Chrome 仍报错

结论很明确:公网站点保留 TLSv1.2 与 TLSv1.3 两级即可,安全性由密码套件(只留 ECDHE+AEAD)和 HSTS 保证,而不是靠砍掉 TLS 1.2。若业务确实要求兼容极老终端,也应通过独立子域或独立端口承载,而不是把主站降级。

常见错误排查(含真实报错)

以下报错均来自实际工单,按出现频率排序:

  • nginx: [emerg] invalid value "TLSv1.3" in /etc/nginx/nginx.conf:42:Nginx 链接的 OpenSSL 低于 1.1.1,不认识 TLSv1.3。用 nginx -V 确认版本,升级 OpenSSL 后重编译,或暂时只写 TLSv1.2。
  • nginx: [emerg] SSL_CTX_set_cipher_list(...) failed (SSL: error:1410D0B9:SSL routines:SSL_CTX_set_cipher_list:no cipher match):ssl_ciphers 里混入了 OpenSSL 不认识的名称,最常见是照抄了 IANA 的 TLS_ 前缀写法。Nginx 要用 ECDHE-RSA-AES128-GCM-SHA256 这种 OpenSSL 名称。
  • ERR_SSL_VERSION_OR_CIPHER_MISMATCH:服务端只留 TLSv1.3,客户端最高 TLSv1.2,无交集。补回 TLSv1.2 即可。
  • SSL_ERROR_NO_CYPHER_OVERLAP:协议版本对得上但密码套件无交集,多见于 ssl_ciphers 收得过窄又遇到只支持 RSA 密钥交换的老终端。临时加回 ECDHE-RSA-AES128-GCM-SHA256 复测。
  • javax.net.ssl.SSLHandshakeException: Received fatal alert: protocol_version:客户端侧默认协议太低。JDK 8 加启动参数 -Djdk.tls.client.protocols=TLSv1.2,.NET 设置 ServicePointManager.SecurityProtocol 或注册表 SchUseStrongCrypto=1。
  • curl: (35) error:0A000102:SSL routines::unsupported protocol:不是服务端问题,是本地 OpenSSL 3.x 已禁用旧协议。加 -cipher 'DEFAULT@SECLEVEL=0' 复测。
  • SSL routines:ssl3_get_record:wrong version number:把 80 端口当 443 探测,或该 server 块漏写 listen 443 ssl,明文端口回了 HTTP。

另外两个高频的「改了没用」:一是 ssl_protocols 写在 http 块、被某个 server 块里的旧值覆盖,用 nginx -T | grep -n ssl_protocols 全量核对;二是 CDN/WAF 层的 TLS 策略没同步修改,浏览器连的是边缘节点而不是源站。

效果验证与持续监控

改完先做三件事:语法检查、平滑重载、复跑探测。期望输出如下:

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep -E 'Protocol|Cipher'
# Protocol  : TLSv1.3
# Cipher    : TLS_AES_128_GCM_SHA256

openssl s_client -connect example.com:443 -servername example.com -tls1 -cipher 'DEFAULT@SECLEVEL=0' </dev/null 2>&1 | tail -3
# 140020458:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure

四条 curl 一次跑完,1.0/1.1 必须失败、1.2/1.3 必须返回 200:

for v in 1.0 1.1 1.2 1.3; do printf 'TLS %s -> ' $v; curl -sS -o /dev/null -w '%{http_code}n' --tlsv$v --tls-max $v https://example.com 2>&1 | tail -1; done

浏览器侧看 Chrome DevTools → Security → Connection,应显示 TLS 1.3 或 TLS 1.2,地址栏不再标红。SSL Labs 评级应达到 A 或 A+,Protocols 一栏只剩 TLS 1.2、TLS 1.3,Key Exchange 全部为 ECDHE。建议把探测脚本接入监控:Prometheus blackbox_exporter 加自定义 openssl 探针,或 Zabbix 的 web.check 定时执行,一旦有人回滚配置立刻告警。

最后校正一个常见混淆:协议版本和证书有效期是两条独立的线。公网受信任 TLS 证书单张最长有效期目前为 398 天,按 CA/Browser Forum SC-081 计划,2026 年 3 月 15 日起缩短到 200 天、2027 年 3 月 15 日起缩短到 100 天;Let’s Encrypt 一直是 90 天。因此 certbot / acme.sh 的自动续期必须保留,但续期永远不会修复 ERR_SSL_OBSOLETE_VERSION。

常见问题

不建议。TLS 1.3 要求客户端也支持(Chrome 70+、Win10 1809+),Windows 7/8.1、Android 5 以下、JDK 8 早期版本最高只到 TLS 1.2,只留 1.3 会让这批用户直接 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。推荐 TLSv1.2 + TLSv1.3 并存,安全性靠 ECDHE+AEAD 套件和 HSTS 保证。


按三步查:用 nginx -T | grep -n ssl_protocols 确认没有 server 块或 include 覆盖旧值;确认 nginx -t 通过并已 reload 而非只改文件;若前面有 CDN/WAF/负载均衡,浏览器连的是边缘节点,必须在该层同步修改最低 TLS 版本,否则源站改了也无效。


无关。该错误由协议版本低于 TLS 1.2 触发,发生在证书校验之前;证书过期报的是 NET::ERR_CERT_DATE_INVALID。注意公网证书最长有效期目前为 398 天,2026 年 3 月起缩短至 200 天,Let’s Encrypt 为 90 天,续期要自动化,但续期不能解决协议过时。


Schannel 协议配置在系统启动时读取,仅重启 IIS 或 w3wp 不生效,必须重启服务器。同时确认 TLS 1.2 的 Server 键 Enabled=1、DisabledByDefault=0,TLS 1.0/1.1 的 Enabled=0、DisabledByDefault=1,且 .NET 应用已开启 SchUseStrongCrypto=1。


分别对 CDN 域名和源站 IP 执行 openssl s_client -tls1 探测,源站测试要加 -servername 指定域名以命中正确虚拟主机。若 CDN 已是 TLS 1.2 而源站仍接受 TLS 1.0,属于回源配置问题,需在 CDN 控制台把回源协议设为 HTTPS 并限制最低 TLS 版本。


只保留 ECDHE 密钥交换加 AEAD 算法(AES-GCM、ChaCha20-POLY1305),删除所有 CBC 套件和 RSA 密钥交换套件,保证前向保密。TLS 1.3 的套件由 OpenSSL 固定,无需也无法通过 ssl_ciphers 配置,写了不生效但也不报错。