ERR_TUNNEL_CONNECTION_FAILED 背后:读取代理的 CONNECT 响应
Updated:
当 Chrome 请求代理为 https:// 页面建立隧道遭到拒绝时,就会出现 ERR_TUNNEL_CONNECTION_FAILED。Chrome 发送 CONNECT 请求并期望获得许可,却收到了错误状态码。棘手之处在于 Chrome 隐藏了该状态码,因此你的首要任务是查明实际的代码。
常见原因(按概率排序)
- 脚本在启动 Chrome 时未提供凭据。
--proxy-server参数仅包含主机和端口;传入的任何 user:pass 都会被丢弃。在无头模式下,Puppeteer 或 Selenium 随后会收到 407 并将其报告为隧道连接失败。 - 应用在需要密码的 Wi-Fi 代理下运行。 应用本身没有登录弹窗提示,因此即使手机浏览器可以正常使用,应用的 HTTPS 请求也会失败。
- 代理无法连接到目标网站。 代理对 CONNECT 请求返回 502。502 Bad Gateway 页面对这种情况进行了更深入的解析。
- 仅个别网站无法访问。 目标网站宕机或拒绝连接,而同一代理访问其他网站完全正常。
我们的测试结果
我们在测试代理上复现了这两种常见情况(下方用示例地址 203.0.113.10:8080 及登录凭据 user123:pass456 表示)。在每种情况下 Chrome 都会显示相同的提示信息,这也是单凭它本身无法提供有效诊断线索的原因。
| 代理对 CONNECT 的响应 | Chrome | curl |
|---|---|---|
407,且无法输入密码(无头 Chrome) | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 407 |
502,代理无法连接到该网站 | ERR_TUNNEL_CONNECTION_FAILED | curl: (56) CONNECT tunnel failed, response 502 |
查明隐藏的状态码
使用你自己的代理参数运行 curl -v -x http://user123:[email protected]:8080 https://example.com,查看 > CONNECT example.com:443 HTTP/1.1 后面的响应。如果返回 407,请转到 407 指南。如果返回 502,则说明问题出在目标网站或代理之后的网络路由上。
不想打开终端?代理检测工具也会将这两种情况分别报告为 auth failed (407) 和 HTTP 502。
请注意,普通的可见 Chrome 窗口处理 407 的方式有所不同:它会弹出输入代理用户名和密码的登录框,而不是显示隧道错误。这就是为什么由 407 引发的隧道错误大多出现在自动化脚本以及无法弹出登录提示的应用中。
各环境下的解决方法
- Puppeteer: 使用
--proxy-server=http://host:port启动,然后在首次页面跳转前调用page.authenticate({ username, password })。Puppeteer 代理指南中提供了完整示例。 - Playwright: 在启动选项中传入
proxy: { server, username, password };Playwright 会自动处理 407 认证。详见 Playwright 配置。 - Selenium: Chrome 不允许在其命令行中直接传入 user:pass。Selenium 指南列出了可行的解决策略。
- Windows 桌面版 Chrome: 如果始终没有弹出登录框,可能是某个扩展程序阻止了它。请尝试在禁用扩展程序的窗口中重新打开。
- 手机: 需要认证代理的应用最好通过支持 user:pass 的代理应用进行连接,如 Android 配置指南中所述。
操作步骤
- 1
查明代理的实际响应
使用带代理参数的
curl -v -x或检测工具,查看代理对 CONNECT 的响应是 407 还是 502。 - 2
407:正确传递认证凭据
在自动化脚本中,请使用库自带的认证功能,而不是将 user:pass 放入
--proxy-server中。 - 3
502:测试其他目标网站
通过同一代理访问如 example.com 等大型稳定网站。如果能正常加载,则说明是原目标网站存在问题。
- 4
确认出口 IP
隧道建立成功后,在同一个浏览器中打开 my IP,确认流量确实是通过该代理发出的。
常见问题
为什么 http:// 页面可以正常访问,而 https:// 页面却失败?
普通 HTTP 请求是直接转发的,不需要 CONNECT。只有 HTTPS 才会请求建立隧道,因此隧道错误只会在访问 HTTPS 页面时发生。
在 Android 上是什么原因触发了 ERR_TUNNEL_CONNECTION_FAILED?
通常是因为某个应用无法向 Wi-Fi 代理发送用户名和密码。在 Android 版 Chrome 中打开同一个页面进行测试:如果 Chrome 弹出了登录提示并能正常加载,就说明问题出在应用本身。
认证凭据可以直接写在 --proxy-server 中吗?
不行。Chrome 会丢弃这些凭据,导致代理返回 407 并出现隧道错误。请改用 Puppeteer、Playwright 或扩展程序进行身份验证。
我应该选择哪种代理类型以避免此问题?
请根据你的订单匹配对应类型:如果订购的是 HTTP 或双协议模式,请在工具中选择 HTTP(隧道错误仅在使用 HTTP 时出现);如果订购的是 SOCKS5,请选择 SOCKS5,并通过工具的认证设置填写登录信息。
专为自动化脚本打造
ProxyV4 代理采用标准的 user:pass 身份验证,Puppeteer 和 Playwright 无需额外配置即可直接支持。
查看实时价格