ProxyError：Python 中的“无法连接到代理”及 Node.js

Cannot connect to proxy (ProxyError)是什么意思？

urllib3 对涉及代理的每次失败都会引发一个 ProxyError，requests 会传递该异常。有用的信息位于嵌套异常中，traceback 会在长行末尾打印它。

Node.js 客户端表现不同：它们直接报告套接字错误，如 ECONNREFUSED 或 ETIMEDOUT，通常不会说明地址是代理的。

在Python、curl、Node.js和浏览器中'Cannot connect to proxy'是什么样？

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

• 拒绝连接： ProxyError('Unable to connect to proxy', NewConnectionError(... Connection refused))
• DNS： NameResolutionError(... Failed to resolve ...) 在 ProxyError 内
• 凭据问题： OSError('Tunnel connection failed: 407 Proxy Authentication Required')
• 网关错误： OSError('Tunnel connection failed: 502 Bad Gateway')
• Node.js： Error: connect ECONNREFUSED、ETIMEDOUT 或 ENOTFOUND，后跟代理地址

导致'Cannot connect to proxy'的原因是什么？

最可能的首要原因：

• 代理 URL 中的主机或端口错误。
• 缺少协议头：某些库对没有 http:// 的 host:port 解析结果令人意外。
• 网络或服务器上阻止出站流量。
• CONNECT 步骤中出现的凭据或网关错误，被同一异常包装。
• 环境变量如 HTTPS_PROXY 指向旧代理，覆盖代码配置。

如何一步步诊断'Cannot connect to proxy'？

1. 打印完整异常并查看最后嵌套的原因。
2. 打印 requests.utils.get_environ_proxies(url) 或 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 变量，查看还有什么配置。
3. 在同一台机器上运行下面的 curl 测试。
4. 将原因与下面的修复列表匹配。

# 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

如何修复'Cannot connect to proxy'？

• 拒绝或超时： 修正主机和端口，或开放出站流量到网关。
• 解析失败： 检查机器上的 DNS；尝试用 nslookup 访问主机。
• 407： 修正并 URL 编码凭据。参考 407 代理认证要求。
• 502 或 504： 在新出口重试。参考 502 和 504。
• 不需要的环境代理： 在 requests 中设置 session.trust_env = False，或清理环境变量。

遇到'Cannot connect to proxy'后要重试吗？

只重试可能会变化的网络级原因：如超时和 502、504 等网关错误。拒绝连接、DNS 失败或 407 错误会一直重现，直到你修改配置，因此应将它们视为致命错误。

Cannot connect to proxy (ProxyError)如何应用于CrawlRelay？

对 CrawlRelay，代理 URL 是 http://USERNAME:PASSWORD@，后接下面列出的网关主机和 HTTP 端口，对 HTTP 和 HTTPS 目标均适用。requests 中 http 和 https 键使用相同的 http:// 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: WRONG_VERSION_NUMBER · 407 · Python 指南。