通过代理出现 SSL WRONG_VERSION_NUMBER 的解决方案

SSL: WRONG_VERSION_NUMBER是什么意思？

TLS 握手从一条握手记录开始。如果返回的是 HTTP 响应，TLS 库读取了无效版本号便停止。Python 报告 WRONG_VERSION_NUMBER；具体描述随 OpenSSL 版本和客户端而异。

代理 URL 协议头决定客户端如何与代理通信。http:// 代表与代理用普通 HTTP 通信，之后通过 CONNECT 隧道与网站 TLS 通信。https:// 代表与代理本身使用 TLS（仅在代理端口支持 TLS 时有效）。

在Python、curl、Node.js和浏览器中SSL: WRONG_VERSION_NUMBER是什么样？

每个工具中相同的失败会有不同的提示信息。请在日志中搜索以下信息：

• Python requests / urllib3 2.x： 在 ProxyError 中包装的 SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number'))
• httpx： httpx.ConnectError: [SSL: WRONG_VERSION_NUMBER] wrong version number
• curl： 当对普通代理写-x https:// 时为 curl: (35) ... wrong version number
• Node.js： 错误消息中的 EPROTO ... wrong version number

导致SSL: WRONG_VERSION_NUMBER的原因是什么？

最可能的首要原因：

• 代理地址前使用 https://，但端口仅支持普通 HTTP。这是最常见的情况。
• 复制粘贴了代理端口需要 TLS 的设置。
• 端口为 80 但用的是 https://，或非代理的 TLS 端口用的是 http://。
• 继承了环境变量，如 HTTPS_PROXY=https://...。

如何一步步诊断SSL: WRONG_VERSION_NUMBER？

1. 打印代码使用的代理 URL，检查它的协议头。
2. 检查环境变量中是否有 HTTPS_PROXY 和 ALL_PROXY。
3. 用 -x http:// 运行下面的 curl 测试，确认它能工作。
4. 如果 curl 正常而你的代码不行，说明代码或环境仍在使用 https://。

# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:[email protected]:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL

如何修复SSL: WRONG_VERSION_NUMBER？

• 所有代理相关键中使用 http:// 代理 URL： {"http": "http://...", "https": "http://..."}。
• 保持 TLS 验证开启。 修复在协议头，不是 verify=False。
• 修改环境变量，而不是在单个脚本中覆盖。

遇到SSL: WRONG_VERSION_NUMBER后要重试吗？

不要重试此错误：每次尝试都会同样失败。这是一个单字符的配置错误。

SSL: WRONG_VERSION_NUMBER如何应用于CrawlRelay？

CrawlRelay 的 HTTP 端口是纯 HTTP 代理端口，通过 CONNECT 隧道运输 HTTPS 网站。TLS 在客户端与网站间端到端运行，网关不需要 https:// 代理 URL。

网关：gw.crawlrelay.com，端口7777（通过CONNECT的HTTP、HTTPS）和端口7778（SOCKS5）。用户名格式：USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}。相关内容：SSL 证书验证失败 · 无法连接到代理](/docs/errors/cannot-connect-to-proxy/) · Python 指南](/docs/python/)。