跳到主要内容

curl: (35) SSL connect error 完全排查指南:TLS 握手失败的原因、命令与修复

curl: (35) SSL connect error 到底是什么

curl 退出码 35 对应 CURLE_SSL_CONNECT_ERROR,含义是 TLS 握手阶段失败:TCP 三次握手已经成功,但 TLS 协商没有走完,curl 拿不到可用的加密通道。它和证书验证失败(退出码 60)是两回事——35 通常发生在证书验证之前,根因集中在协议版本、密码套件、SNI、中间设备拦截,或本地 OpenSSL 太旧。

典型触发链路有三类:

  • 协议/套件不匹配:服务端只开 TLS 1.3,而客户端 OpenSSL 1.0.2 最高只到 TLS 1.2;或服务端禁用 RSA 密钥交换而客户端只提供 RSA 套件。
  • 中间设备拦截:WAF、防火墙、企业代理按 TLS 指纹(JA3/JA4)、ALPN 或 UA 识别命令行客户端,直接 RST 或回 handshake_failure alert。
  • 客户端环境过旧或残缺:CentOS 7 自带 curl 7.29 + OpenSSL 1.0.2k、Alpine 精简镜像缺 CA、Windows 上 schannel 后端不支持某些套件。

先确认你手上的 curl 用的是什么 TLS 后端,后面所有排查都依赖这个信息:

curl -V
# curl 8.5.0 (x86_64-pc-linux-gnu) libcurl/8.5.0 OpenSSL/3.0.13 zlib/1.3 brotli/1.1.0
# Protocols: dict file ftp ftps gopher gophers http https imap ...
# Features: alt-svc AsynchDNS brotli GSS-API HSTS HTTP2 HTTPS-proxy IDN IPv6 ...

openssl version -a

第一步:用 -v 和 –trace 把握手过程打出来

不要凭猜测改参数,先把握手细节拿到手。

# 基础详细输出:能看到 TLS 版本、套件、SNI、证书链
curl -v https://example.com

# 更完整:包含时间戳和双向数据
curl -v --trace-time --trace-ascii /tmp/curl-trace.log https://example.com

# 只看 TLS 相关行
curl -v https://example.com 2>&1 | grep -Ei 'tls|ssl|alpn|subject|issuer|certificate'

输出中重点关注这几行:

*   Trying 93.184.216.34:443...
* Connected to example.com (93.184.216.34) port 443
* ALPN: curl offers h2,http/1.1
* TLSv1.2 (OUT), TLS handshake, Client hello (1):
* TLSv1.2 (IN), TLS alert, handshake failure (552):
* OpenSSL/3.0.13: error:0A000410:SSL routines::sslv3 alert handshake failure
* Closing connection
curl: (35) OpenSSL/3.0.13: error:0A000410:SSL routines::sslv3 alert handshake failure

判断方法很简单:

  • 有 Client hello 发出但没有 Server hello,服务端直接回 alert → 服务端或中间设备拒绝了你的 ClientHello,看协议版本与套件。
  • 连 Client hello 都没有,直接 SSL_ERROR_SYSCALL → TCP 层就被切断,多半是防火墙、SNI 阻断或 MTU 问题。
  • 有 Server hello 但之后失败 → 证书、密钥交换或安全级别(SECLEVEL)问题。

常见错误信息与根因速查表

真实错误信息(节选) 含义 修复方向
error:0A000410:SSL routines::sslv3 alert handshake failure
error:14077410:SSL routines:SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure
服务端没有可接受的协议版本/套件组合,主动发 handshake_failure alert 降/升 TLS 版本,显式指定 --ciphers,检查服务端 SECLEVEL
error:1425F102:SSL routines:ssl_choose_client_version:unsupported protocol 客户端最低版本高于服务端最高版本(典型:客户端只允许 TLS1.2+,服务端只有 TLS1.0/1.1) 服务端升级;客户端临时降低 MinProtocol 或用老版本 curl 交叉验证
OpenSSL SSL_connect: SSL_ERROR_SYSCALL in connection to host:443 对端直接 RST/断开,未走完 TLS 层 查防火墙、WAF、SNI 阻断、MTU、IPv6 回退
error:0A000126:SSL routines::unexpected eof while reading 握手或读数据时对端无预警关闭(OpenSSL 3 的新文案,旧版即 SSL_ERROR_SYSCALL) 多为中间设备或服务端 keepalive 超时;试 --http1.1 关闭 HTTP/2
Cannot communicate securely with peer: no common encryption algorithm(s). 没有共同密码套件(NSS/新版 curl 文案) 用 --ciphers 或 --tls13-ciphers 指定套件
error:0A000152:SSL routines::unsafe legacy renegotiation disabled 服务端不支持 RFC 5746 安全重协商 临时在 openssl.cnf 加 Options = LEGACY_SERVER_CONNECT,根本上是升级服务端
error:0A00018E:SSL routines::ca md too weak OpenSSL 3 默认安全级别 2 拒绝 SHA-1 签名证书 --ciphers DEFAULT@SECLEVEL=1 临时绕过,或更换证书
schannel: next InitializeSecurityContext failed: SEC_E_ILLEGAL_MESSAGE (0x80090326) Windows schannel 后端与服务端套件不兼容 改用 OpenSSL 后端的 curl(WSL / Git for Windows / 容器)
gnutls_handshake() failed: The TLS connection was non-properly terminated. GnuTLS 后端被对端异常断开 同 SSL_ERROR_SYSCALL,查中间设备与 ALPN

另外别把 35 和相邻退出码搞混,它们的排查路径完全不同:

退出码 常量 典型场景
35 CURLE_SSL_CONNECT_ERROR TLS 握手失败:版本/套件/中间设备
51 CURLE_SSL_PEER_CERTIFICATE 证书校验失败(老版本 curl)
56 CURLE_RECV_ERROR 连接建立后接收数据失败,常伴 RST
58 CURLE_SSL_CERTPROBLEM 本地证书/私钥文件读取或格式问题
59 CURLE_SSL_CIPHER 指定的密码套件不可用
60 CURLE_PEER_FAILED_VERIFICATION 证书链不受信任、过期、域名不匹配
92 CURLE_HTTP2_STREAM HTTP/2 层错误,可用 --http1.1 隔离

按协议版本与密码套件逐层收窄

确认是协议还是套件问题,最快的办法是固定变量做二分。

# 1) 只允许 TLS 1.2
curl -v --tlsv1.2 --tls-max 1.2 https://example.com

# 2) 只允许 TLS 1.3
curl -v --tlsv1.3 https://example.com

# 3) 允许 TLS 1.0(老服务端)
curl -v --tlsv1.0 --tls-max 1.0 https://example.com

# 4) 指定 TLS 1.2 及以下的密码套件
curl -v --tlsv1.2 --tls-max 1.2 
  --ciphers 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384' 
  https://example.com

# 5) 指定 TLS 1.3 套件(与 --ciphers 是两套参数,别混用)
curl -v --tlsv1.3 --tls13-ciphers 'TLS_AES_128_GCM_SHA256:TLS_AES_256_GCM_SHA384' 
  https://example.com

# 6) 降低 OpenSSL 安全级别(应对 ca md too weak / 1024 位 DH)
curl -v --ciphers 'DEFAULT@SECLEVEL=1' https://example.com

如果 curl 不行但 openssl s_client 能连上,说明问题在 curl 的默认参数或 TLS 后端,而不是网络链路:

# 用 openssl 独立验证服务端能力
openssl s_client -connect example.com:443 -servername example.com -brief </dev/null

# 指定版本与套件
openssl s_client -connect example.com:443 -servername example.com -tls1_2 
  -cipher 'ECDHE-RSA-AES128-GCM-SHA256' </dev/null

# 一次性列出服务端支持的协议与套件(需要 nmap)
nmap --script ssl-enum-ciphers -p 443 example.com

注意 -servername 不能省。很多 CDN/多租户网关在没有 SNI 时返回默认站点或直接握手失败,这正好是 35 的高发原因之一。curl 会自动带上 SNI(除非 URL 里写的是 IP),所以“用 IP 直连测试”往往反而更容易失败。

升级 curl 与 OpenSSL:老系统连不上新站点的根因

OpenSSL 1.0.x(CentOS 6/7 早期、老 Ubuntu)不支持 TLS 1.3,也不支持 X25519 等现代曲线。当服务端只开 TLS 1.3 或强制现代套件时,老客户端必然报 35。版本能力对照:

OpenSSL 版本 最高 TLS 典型系统 现状
1.0.1 / 1.0.2 TLS 1.2 CentOS 6/7、Ubuntu 14.04 已停止维护,连现代站点频繁 35
1.1.0 TLS 1.2 Ubuntu 16.04 已 EOL
1.1.1 TLS 1.3 Ubuntu 18.04/20.04、CentOS 8 仍可用,但已进入维护尾声
3.0 / 3.2 TLS 1.3 Ubuntu 22.04+、Debian 12、RHEL 9 默认 SECLEVEL=2,对老证书更严格
# Debian/Ubuntu
sudo apt-get update && sudo apt-get install --only-upgrade curl libcurl4 openssl

# RHEL/CentOS/Rocky
sudo dnf upgrade curl libcurl openssl

# Alpine(精简镜像最常见的问题)
apk add --no-cache curl ca-certificates && update-ca-certificates

# macOS(系统自带 curl 用 LibreSSL,建议换 Homebrew 版)
brew install curl && brew link --force curl

# 验证
curl -V | head -n1
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com

如果没法升级系统 OpenSSL,用自带新版 TLS 库的 curl 是最省事的绕过方案:

# 方案一:容器内交叉验证(最快,不改动宿主环境)
docker run --rm curlimages/curl:latest -v https://example.com

# 方案二:使用静态编译的 curl,不依赖系统 OpenSSL
# 从 https://github.com/stunnel/static-curl/releases 下载对应平台包后:
tar -xf curl-*.tar.xz && ./curl -V

# 方案三:源码编译时指定较新的 OpenSSL 前缀
./configure --with-openssl=/usr/local/openssl3 --with-ca-bundle=/etc/ssl/certs/ca-certificates.crt

服务端侧:WAF、防火墙与 TLS 指纹拦截

当“浏览器能开、curl 报 35”时,八成不是协议问题,而是按客户端指纹拦截。WAF(Cloudflare、Akamai、AWS WAF、雷池、ModSecurity)会看 JA3/JA4 指纹、ALPN 列表、SNI 与 User-Agent 的一致性。curl 的 ClientHello 特征非常固定,很容易被规则命中。

# 换 UA 和 ALPN 再试,判断是否是指纹拦截
curl -v -A 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36' 
  --http1.1 https://example.com

# 对比:浏览器指纹模拟工具(curl-impersonate)
curl_chrome124 -v https://example.com

客户端侧能做的验证动作:

  • 换出口 IP(手机热点/另一台机器)再试,排除 IP 段被拉黑。
  • 用 curl --resolve 直连源站 IP,绕过 CDN/WAF 对比结果。
  • 用 curl -4 与 curl -6 分别测试,排除 IPv6 路径上的设备拦截。
  • 用 openssl s_client 与 curl 对比:openssl 能过而 curl 不能过,基本可确认是 JA3/UA 规则。
# 绕过 DNS/CDN 直连源站
curl -v --resolve example.com:443:203.0.113.10 https://example.com

# 强制 IPv4 / IPv6
curl -4 -v https://example.com
curl -6 -v https://example.com

# 排除 HTTP/2 干扰
curl --http1.1 -v https://example.com

服务端侧则要检查:是否只允许 TLS 1.3、是否禁用 TLS 1.0/1.1、是否启用了 ECDSA-only 证书而客户端只支持 RSA、WAF 是否开启了“TLS 指纹异常即阻断”。用 openssl s_client -brief 从服务端本机跑一遍,再和外部客户端结果对比,能快速区分是配置问题还是拦截策略。

代理、证书链与 SNI 的隐形坑

企业环境里 35 常常来自代理:

# 确认 curl 是否走了代理
env | grep -i proxy
curl -v https://example.com 2>&1 | grep -i 'proxy|CONNECT'

# 显式指定/禁用代理
curl -x http://proxy.corp:8080 -v https://example.com
curl --noproxy '*' -v https://example.com

# HTTPS 代理自身证书不被信任时(仅测试)
curl --proxy-insecure -x https://proxy.corp:8443 https://example.com

其他容易踩的点:

  • CONNECT 隧道被代理拒绝时会返回 curl: (56) CONNECT tunnel failed, response 403,但某些代理会先断 TLS,从而表现为 35。
  • SNI 与 Host 不一致:用 --resolve 或 IP 访问时,网关按 SNI 路由失败。
  • 中间人解密设备(Zscaler、深信服等)签发的证书不在信任链时通常报 60,但握手阶段被中断时也可能表现为 35。
  • MTU 过大导致 ClientHello 分片被丢:用 ping -M do -s 1400 host 验证,必要时调小接口 MTU。

实战修复流程:按顺序走一遍

  1. 记录环境:curl -V、openssl version -a、uname -a,以及是否存在 HTTP_PROXY/HTTPS_PROXY。
  2. 拿握手日志:curl -v --trace-ascii /tmp/t.log https://host,判断失败发生在 ClientHello 之前、之后还是证书阶段。
  3. 固定协议二分:--tlsv1.2 --tls-max 1.2 与 --tlsv1.3 各跑一次,找出服务端实际支持的版本。
  4. 固定套件二分:用 --ciphers / --tls13-ciphers 缩小到单个套件,确认是否存在交集。
  5. 独立验证:openssl s_client -connect host:443 -servername host -brief 对照;结果不一致则怀疑 curl 后端或默认参数。
  6. 排除网络中间件:换 IP、换网络、-4/-6、--resolve 直连源站、--http1.1。
  7. 升级或替换客户端:升级 curl/OpenSSL,或用容器 docker run --rm curlimages/curl 交叉验证。
  8. 确认修复:curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result} %{time_total}n' https://host 稳定返回 200 且 ssl_verify_result 为 0。

记住一条原则:curl -k 只是跳过证书校验,它治不了 35。如果加 -k 后仍然报 35,问题一定在协议、套件或中间设备,而不是证书信任。

FAQ

Q1:curl: (35) 和 curl: (60) 有什么区别?
35 是握手没走完(协议/套件/被拦截),60 是握手成功但证书验证失败(自签名、过期、域名不匹配)。加 -k 能解决 60,解决不了 35。

Q2:浏览器能正常打开,为什么 curl 报 35?
浏览器的 ClientHello 指纹、ALPN、UA 与 curl 差异很大,WAF 按指纹拦截命令行客户端是常见策略。用 curl -A 伪装 UA,或使用 curl-impersonate 验证。

Q3:加上 --tlsv1.2 --tls-max 1.2 就好了,说明什么?
说明两端在 TLS 1.3 协商上不兼容,通常是中间设备不支持 TLS 1.3,或客户端 OpenSSL 存在已知 bug。长期方案是升级两端,短期可用该参数固化。

Q4:只有某几台机器报 35,其他机器正常?
对比 curl -V 的 TLS 后端与 OpenSSL 版本,以及是否走了不同的代理或出口 IP。老系统(CentOS 7 自带 curl 7.29 + OpenSSL 1.0.2)是最常见的差异来源。

Q5:Docker/Alpine 镜像里报 35 怎么办?
Alpine 默认可能没装 ca-certificates,且 musl 环境下 curl 版本偏旧。执行 apk add --no-cache curl ca-certificates && update-ca-certificates,仍不行就换 curlimages/curl 或 Debian 基础镜像。

Q6:报 unexpected eof while reading 是服务端的问题吗?
这是 OpenSSL 3 对“对端无预警关闭”的新描述,等价于旧的 SSL_ERROR_SYSCALL。常见于中间设备超时、HTTP/2 连接复用异常。先试 --http1.1,再查中间设备。

Q7:如何确认是 WAF 拦截而不是协议不匹配?
用 openssl s_client(指纹不同)对比 curl:openssl 成功而 curl 失败,且换 UA、换 IP 后行为变化,基本就是指纹或 IP 规则。抓包看到服务端直接回 RST 或 handshake_failure alert 也能佐证。

Q8:升级 curl 有风险吗?
生产环境优先升级系统包(apt/dnf upgrade curl libcurl)而非手工编译。若必须用新版,建议放在容器里,或在独立路径下配合 LD_LIBRARY_PATH 隔离,避免影响依赖旧 libcurl 的应用程序。