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 failureerror: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。
实战修复流程:按顺序走一遍
- 记录环境:
curl -V、openssl version -a、uname -a,以及是否存在HTTP_PROXY/HTTPS_PROXY。 - 拿握手日志:
curl -v --trace-ascii /tmp/t.log https://host,判断失败发生在 ClientHello 之前、之后还是证书阶段。 - 固定协议二分:
--tlsv1.2 --tls-max 1.2与--tlsv1.3各跑一次,找出服务端实际支持的版本。 - 固定套件二分:用
--ciphers/--tls13-ciphers缩小到单个套件,确认是否存在交集。 - 独立验证:
openssl s_client -connect host:443 -servername host -brief对照;结果不一致则怀疑 curl 后端或默认参数。 - 排除网络中间件:换 IP、换网络、
-4/-6、--resolve直连源站、--http1.1。 - 升级或替换客户端:升级 curl/OpenSSL,或用容器
docker run --rm curlimages/curl交叉验证。 - 确认修复:
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 的应用程序。