NET::ERR_SSL_OBSOLETE_VERSION 修复指南:彻底禁用 TLS 1.0/1.1 的完整实操(Nginx / Apache / IIS)
问题背景与根因:问题出在协议版本,与证书无关
Chrome 打开站点直接白屏,控制台给出 net::ERR_SSL_OBSOLETE_VERSION,地址栏提示“此连接使用的加密技术已过时”。这个错误与证书是否过期、域名是否匹配无关,它出现在 TLS 握手成功之后:服务端和浏览器已经协商出一个双方都支持的协议版本,但这个版本是 TLS 1.0(0x0301)或 TLS 1.1(0x0302)。Chromium 网络栈检测到版本号低于允许下限,直接中断连接并抛出该错误码,页面根本不会渲染。
时间线值得说清楚:RFC 8996 于 2021 年 3 月正式将 TLS 1.0/1.1 标记为 Historic(弃用);PCI DSS 早在 2018 年 6 月 30 日就禁止处理持卡人数据的系统使用 TLS 1.0。Chrome 从 2020 年前后在地址栏对 TLS 1.0/1.1 标注“不安全”,随后升级为直接拦截。所以这不是“新出现的问题”,而是长期没升级的服务端被浏览器强制淘汰。
根因通常有三类,排查时不要只盯着 nginx.conf:
- 服务端配置显式保留旧协议。nginx 在 1.23.0 之前的默认值是
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;,很多配置文件甚至写着SSLv3;Apache 的经典写法SSLProtocol All -SSLv2 -SSLv3同样把 TLS 1.0/1.1 留在白名单里。 - 链路最外层没改。站点前面有 CDN、WAF、SLB、四层或七层负载均衡时,TLS 在边缘节点终结,源站改了没用;反过来,nginx 反向代理到后端 Tomcat/JDK,
proxy_ssl_protocols没配也会沿用旧默认值。JDK 8u291 之前jdk.tls.disabledAlgorithms并不包含 TLSv1,这也是很多 Java 站点“改了 nginx 还报错”的原因。 - 操作系统或 OpenSSL 层被放宽过。Debian 11 / Ubuntu 22.04 的
/etc/ssl/openssl.cnf默认写入MinProtocol = TLSv1.2与CipherString = DEFAULT@SECLEVEL=2,但不少运维为了兼容老设备手工改成TLSv1或SECLEVEL=1,把整机协议下限拉低了。
结论很明确:修复目标是让服务端只接受 TLS 1.2 与 TLS 1.3,而不是只留 TLS 1.3。只保留 1.3 会让 Windows 7 上的 IE11、Android 6/7、JDK 8 早期版本等客户端从 ERR_SSL_OBSOLETE_VERSION 变成 ERR_SSL_VERSION_OR_CIPHER_MISMATCH,问题只是换了个错误码。TLS 1.2 至今仍是兼容性底线,必须保留。
先定位再改:三条命令确认服务端真实协商的版本
改配置前必须先确认“到底哪一层在讲 TLS 1.0”。以下命令可直接复制执行,把 example.com 换成你的域名。
# 1) 强制用 TLS 1.0 握手,看服务端是否接受
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null 2>&1 | head -20
如果输出里出现 Protocol : TLSv1 与 Cipher : ECDHE-RSA-AES128-SHA,说明服务端确实还在接受 TLS 1.0,这就是报错根因。如果返回 no protocols available 或 sslv3 alert handshake failure,说明该版本已被禁用,问题在别处(多半是 CDN 边缘节点)。同理可用 -tls1_1、-tls1_2、-tls1_3 逐个测试,-tls1_3 需要 OpenSSL 1.1.1 及以上。
# 2) 批量枚举服务端支持的所有版本与套件
nmap --script ssl-enum-ciphers -p 443 example.com
输出会按 TLSv1.0:、TLSv1.2: 分段列出套件和 A-F 评级,一眼能看出哪些版本还开着。该脚本同时给出 least strength,如果 TLS 1.0 段里还有 RC4、3DES,说明加密套件也要一起收紧。
# 3) 用 curl 模拟真实客户端,并区分边缘节点与源站
curl -vI https://example.com --tlsv1.0 --tls-max 1.0
curl -sv https://example.com 2>&1 | grep -i "SSL connection using"
dig +short example.com
openssl s_client -connect 203.0.113.10:443 -servername example.com </dev/null 2>&1 | grep Protocol
第三条最关键:curl -sv 输出的 SSL connection using TLSv1.3 / TLS_AES_128_GCM_SHA256 是浏览器实际看到的版本;而直接用 IP 连源站看到的是源站版本。两者不一致,就说明中间有 CDN 或负载均衡替你做了 TLS 终结,改配置要去边缘节点改。如果 curl 报 curl: (35) error:1409442E:SSL routines:ssl3_read_bytes:tlsv1 alert protocol version,表示服务端主动拒绝了这个版本——这正是我们想要的结果。
最后确认服务端软件版本,避免改了配置却不生效:nginx -v 看版本(≥1.23.0 默认已是 TLSv1.2/1.3),nginx -V 看链接的 OpenSSL 版本(TLS 1.3 需 OpenSSL 1.1.1+),nginx -T | grep -n ssl_protocols 确认实际加载的配置块,防止 include 的子配置覆盖了主配置。
Nginx 实操:ssl_protocols 只是第一步
先备份再动手:cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.bak.$(date +%F)。然后在 http 或对应的 server 块中写入下面这份完整配置,注意 ssl_protocols、ssl_ciphers、ssl_conf_command 三处都要改,只改第一处往往不够。
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;
# 核心:只允许 TLS 1.2 / 1.3
ssl_protocols TLSv1.2 TLSv1.3;
# TLS 1.2 套件:仅保留 AEAD + 前向安全
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 套件独立控制,ssl_ciphers 对它无效
ssl_conf_command Ciphersuites TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security "max-age=31536000" always;
}
几个容易踩的坑。第一,ssl_prefer_server_ciphers 应设为 off。现代客户端(Chrome/Firefox)的套件排序已经优先 AES-GCM 与 ChaCha20,服务端强行排序反而会让部分移动端选到更差的组合。第二,ssl_conf_command 需要 nginx ≥ 1.19.4 且 OpenSSL ≥ 1.1.1,老版本会报 nginx: [emerg] "ssl_conf_command" directive is not supported,此时删掉该行即可,TLS 1.3 默认套件本身就是安全的。第三,不要只写 ssl_protocols TLSv1.3; 就结束,Windows 7 IE11、Android 6/7、JDK 8/11 早期版本都不支持 1.3,这些用户会直接看到 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。
如果站点同时提供 RSA 与 ECDSA 证书(推荐),在 server 块里重复写两次 ssl_certificate / ssl_certificate_key 指向两张证书,nginx 会按客户端能力自动选择。改完执行 nginx -t && systemctl reload nginx,必须用 reload 而不是 restart,避免中断现有连接。
还有一个隐藏项:如果 nginx 作为反向代理回源到 https 后端,必须显式声明 proxy_ssl_protocols TLSv1.2 TLSv1.3;,否则回源仍可能用 TLS 1.0,部分后端会直接返回 502。
Apache 与 IIS:SSLProtocol 与 Schannel 注册表
Apache(httpd 2.4):把 SSLProtocol 写成 -all +TLSv1.2 +TLSv1.3,而不是 All -SSLv2 -SSLv3。后者是十几年前的写法,会把 TLS 1.0/1.1 一起放行,是本次报错最常见的元凶。
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/privkey.pem
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
SSLUseStapling on
SSLSessionTickets off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
生效命令:apachectl configtest && systemctl reload httpd(Debian/Ubuntu 为 apache2ctl configtest && systemctl reload apache2)。注意 TLS 1.3 需要 Apache ≥ 2.4.36 且 OpenSSL ≥ 1.1.1,低版本写 +TLSv1.3 会在启动时报 AH00526: Syntax error on line ... Invalid protocol,此时先升级或只保留 +TLSv1.2。
IIS(Schannel):IIS 本身没有 TLS 版本开关,改的是 Windows 的 Schannel 注册表。用管理员 PowerShell 执行下面这段,一次覆盖四个版本:
$cfg = @{
'TLS 1.0' = @{ Enabled = 0; DisabledByDefault = 1 }
'TLS 1.1' = @{ Enabled = 0; DisabledByDefault = 1 }
'TLS 1.2' = @{ Enabled = 1; DisabledByDefault = 0 }
'TLS 1.3' = @{ Enabled = 1; DisabledByDefault = 0 } # 仅 Windows Server 2022 / Win11
}
foreach ($p in $cfg.Keys) {
$path = "HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols$pServer"
New-Item -Path $path -Force | Out-Null
New-ItemProperty -Path $path -Name 'Enabled' -Value $cfg[$p].Enabled -PropertyType DWord -Force | Out-Null
New-ItemProperty -Path $path -Name 'DisabledByDefault' -Value $cfg[$p].DisabledByDefault -PropertyType DWord -Force | Out-Null
}
New-ItemProperty 'HKLM:SOFTWAREMicrosoft.NETFrameworkv4.0.30319' -Name SchUseStrongCrypto -Value 1 -PropertyType DWord -Force
New-ItemProperty 'HKLM:SOFTWAREWow6432NodeMicrosoft.NETFrameworkv4.0.30319' -Name SchUseStrongCrypto -Value 1 -PropertyType DWord -Force
三条硬规则:① Schannel 只在系统启动时读取注册表,必须重启服务器,iisreset 不够;② Windows Server 2012 R2 需先安装 KB2919355 才支持 TLS 1.2 服务端,Windows Server 2008 R2 需 KB3042058;③ TLS 1.3 在 SChannel 上仅 Windows 11 / Server 2022 支持,其余系统别写这个键值。改完用 Get-ItemProperty 复核,再用 openssl 从外部验证。
配置示例汇总与版本兼容性对比
把三种服务器的改动点放在一起看,避免漏项:
| 项目 | Nginx | Apache httpd | IIS / Windows |
|---|---|---|---|
| 协议开关 | ssl_protocols TLSv1.2 TLSv1.3; |
SSLProtocol -all +TLSv1.2 +TLSv1.3 |
Schannel 注册表 ProtocolsTLS 1.xServer |
| 套件配置 | ssl_ciphers + ssl_conf_command Ciphersuites |
SSLCipherSuite |
HKLM...SCHANNELCiphers 或组策略 |
| TLS 1.3 前置条件 | nginx ≥ 1.13.0 + OpenSSL 1.1.1 | httpd ≥ 2.4.36 + OpenSSL 1.1.1 | Windows 11 / Server 2022 |
| 生效方式 | nginx -t && systemctl reload nginx |
apachectl configtest && systemctl reload httpd |
重启操作系统 |
| 典型遗留错误 | 默认值含 TLSv1 TLSv1.1 |
SSLProtocol All -SSLv2 -SSLv3 |
只改 IIS 站点绑定,没动注册表 |
协议版本本身的取舍:
| TLS 版本 | RFC / 年份 | 握手 RTT | 典型客户端 | 建议 |
|---|---|---|---|---|
| TLS 1.0 | RFC 2246 / 1999 | 2-RTT | IE6-IE8、Android 2.x | 禁用(RFC 8996 已弃用) |
| TLS 1.1 | RFC 4346 / 2006 | 2-RTT | IE11 默认关闭、老 Android | 禁用 |
| TLS 1.2 | RFC 5246 / 2008 | 2-RTT | Windows 7 IE11、Android 5+、JDK 8 | 保留,作为兼容底线 |
| TLS 1.3 | RFC 8446 / 2018 | 1-RTT(支持 0-RTT) | Chrome 70+、Firefox 63+、Safari 12.1+、JDK 11+ | 启用,优先协商 |
结论:TLSv1.2 + TLSv1.3 是当前唯一合理的组合。同时注意证书侧的两个硬限制——自 2020 年 9 月 1 日起,公共 CA 签发的 SSL 证书有效期上限为 398 天,Let’s Encrypt 免费证书为 90 天,续期失败会表现为证书过期错误而非本错误,排查时别混淆。
常见错误排查:真实报错逐条对照
1. 改完配置 nginx 起不来:
nginx: [emerg] SSL_CTX_set_cipher_list("ECDHE-RSA-AES128-GCM-SHA256:...") failed (SSL: error:1410D0B9:SSL routines:SSL_CTX_set_cipher_list:no cipher match)
原因通常是套件名拼写错误,或 OpenSSL 3.0 在 SECLEVEL=2 下拒绝了含 1024 位 DH 参数的套件。先用 openssl ciphers -v 'ECDHE+AESGCM:ECDHE+CHACHA20' 确认套件名在当前 OpenSSL 下合法,再粘贴进配置。
2. 只留 TLS 1.3 后老客户端打不开:浏览器报 net::ERR_SSL_VERSION_OR_CIPHER_MISMATCH。这是“没有共同版本”,与本文的 OBSOLETE_VERSION 正好相反。解决:ssl_protocols 加回 TLSv1.2。
3. 服务端日志里的握手失败:
SSL_do_handshake() failed (SSL: error:1408A0C1:SSL routines:ssl3_get_client_hello:no shared cipher) while SSL handshaking, client: 198.51.100.7
客户端只支持已被禁用的套件(常见于只支持 AES128-SHA 的旧爬虫或监控探针)。如果是自家监控,升级探针;如果是真实用户,说明兼容性收紧过头,检查是否误删了全部 CBC 套件导致某些 Java 6/7 客户端无法连接。
4. curl 侧的真实反馈:curl: (35) error:1409442E:SSL routines:ssl3_read_bytes:tlsv1 alert protocol version 表示服务端拒绝该版本(符合预期);curl: (60) SSL certificate problem: certificate has expired 则是证书问题,与协议无关。
5. 改了源站但浏览器依旧报错:用 curl -sv https://example.com 2>&1 | grep -i "SSL connection using",如果显示 TLSv1.0 / ECDHE-RSA-AES128-SHA,说明 TLS 在 CDN/WAF/SLB 边缘终结,必须去对应控制台把“最低 TLS 版本”改为 TLS 1.2。这一步漏掉,源站改十遍也没用。
6. 反向代理回源 502:nginx → 后端 https 服务,需显式声明:
location / {
proxy_pass https://backend;
proxy_ssl_protocols TLSv1.2 TLSv1.3;
proxy_ssl_server_name on;
proxy_ssl_name backend.internal;
}
7. Java 后端仍协商 TLS 1.0:JDK 8u291 之前 jdk.tls.disabledAlgorithms 不含 TLSv1,需在 java.security 或启动参数中显式禁用:-Djdk.tls.disabledAlgorithms="TLSv1, TLSv1.1, RC4, DES, MD5withRSA, DH keySize < 2048"。
8. 回退预案:如果站点已开启 HSTS(max-age=31536000),一旦协议配置写错导致无法访问,用户浏览器在 max-age 内不允许“继续访问”,回退成本极高。首次上线建议先用 max-age=300 观察 24 小时再逐步调大。
效果验证:五层验收清单
改完不能只看浏览器能打开,按下面五层逐项验收。
第一层,协议枚举。把下面脚本保存为 tlscheck.sh,chmod +x 后执行 ./tlscheck.sh example.com:
#!/usr/bin/env bash
host=$1; port=${2:-443}
for v in tls1 tls1_1 tls1_2 tls1_3; do
if echo | openssl s_client -connect "$host:$port" -servername "$host" -$v 2>/dev/null | grep -q "Cipher is"; then
echo "$v: ENABLED"
else
echo "$v: disabled"
fi
done
期望输出严格为:tls1: disabled、tls1_1: disabled、tls1_2: ENABLED、tls1_3: ENABLED。任何一行不符就回到上一节排查。
第二层,实际协商结果。curl -sv https://example.com 2>&1 | grep -i "SSL connection using" 应返回 TLSv1.3 / TLS_AES_256_GCM_SHA384 或 TLSv1.2 的 AEAD 套件;再跑 curl -vI https://example.com --tlsv1.1 应报 tlsv1 alert protocol version。
第三层,第三方评级。访问 https://www.ssllabs.com/ssltest/analyze.html?d=example.com&hideResults=on,目标 A 或 A+;如果出现 “TLS 1.0/1.1 enabled” 会直接降到 B。同时看 Certificate 栏的有效期剩余天数。
第四层,浏览器实测。Chrome 打开 F12 → Security 面板,Connection 一行应显示 TLS 1.3 与 AES_256_GCM;地址栏锁标正常,无“加密技术已过时”提示。建议同时用一台未升级的老设备(如 Android 7 手机)访问,确认不会掉进 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。
第五层,证书与续期。协议升级后顺手检查证书:openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -subject -dates,确认 notAfter 在未来 30 天以上。公共 CA 证书有效期上限 398 天、Let’s Encrypt 90 天,务必跑一次 certbot renew --dry-run 验证自动续期链路,避免三个月后变成证书过期故障。
常见问题
不建议。TLS 1.2 仍是兼容性底线,Windows 7 上的 IE11、Android 6/7、JDK 8/11 早期版本都不支持 TLS 1.3,只留 1.3 会让这些用户从 ERR_SSL_OBSOLETE_VERSION 变成 ERR_SSL_VERSION_OR_CIPHER_MISMATCH。正确做法是 TLSv1.2 与 TLSv1.3 并存,用强套件约束 1.2。
大概率 TLS 在 CDN、WAF 或负载均衡的边缘节点终结,源站改了边缘没改。用 curl -sv https://你的域名 查看实际协商版本,若仍是 TLSv1.0,就到对应控制台把最低 TLS 版本设为 1.2,再重新验证。
前者是握手成功但版本太老(TLS 1.0/1.1),服务端放宽版本即可解决;后者是没有共同版本或共同套件,通常是只留了 TLS 1.3、证书套件不匹配或客户端过旧。两者方向相反,别用同一套方案处理。
不要在主站降级。可单独开 legacy.example.com 或独立端口保留 TLS 1.0,仅对内网或特定业务开放,配合 IP 白名单、访问日志审计和明确的到期下线时间,避免整个主域被浏览器标记为过时加密。
不影响搜索排名,HTTPS 仍是正向因素。证书与 TLS 版本相互独立,但要注意公共 CA 证书有效期上限 398 天、Let’s Encrypt 为 90 天,续期失败会显示证书过期错误,与本错误的表现不同。
TLS 1.3 的套件(TLS_AES_128_GCM_SHA256 等)与 TLS 1.2 的套件是两套独立机制,ssl_ciphers 只作用于 1.2 及以下。nginx 需用 ssl_conf_command Ciphersuites(≥1.19.4 且 OpenSSL ≥1.1.1),Apache 则依赖 OpenSSL 配置或 SSLCipherSuite 的 TLSv1.3 段。