跳到主要内容

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 段。