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 的响应Chromecurl
407,且无法输入密码(无头 Chrome)ERR_TUNNEL_CONNECTION_FAILEDcurl: (56) CONNECT tunnel failed, response 407
502,代理无法连接到该网站ERR_TUNNEL_CONNECTION_FAILEDcurl: (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. 1

    查明代理的实际响应

    使用带代理参数的 curl -v -x 或检测工具,查看代理对 CONNECT 的响应是 407 还是 502。

  2. 2

    407:正确传递认证凭据

    在自动化脚本中,请使用库自带的认证功能,而不是将 user:pass 放入 --proxy-server 中。

  3. 3

    502:测试其他目标网站

    通过同一代理访问如 example.com 等大型稳定网站。如果能正常加载,则说明是原目标网站存在问题。

  4. 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 无需额外配置即可直接支持。

查看实时价格

Related articles

代理错误排查
解决代理 407 错误:身份凭据排查清单
407 Proxy Authentication Required 表示代理拒绝登录。一表汇总原因,附 Chrome、curl、Python、Selenium 及防关联浏览器修复方法。
代理错误排查
502 错误由谁返回?排查代理背后的 Bad Gateway 报错
详解使用代理时 502 Bad Gateway 的含义,教你区分是代理还是网站本身报错,并提供在 Chrome、curl、Python、Selenium 及防关联浏览器中的修复方法。
代理配置
带认证代理的 Puppeteer 配置:启动参数加登录验证
Puppeteer 代理认证实践示例:使用 --proxy-server 设置地址,通过 page.authenticate() 验证登录,并介绍 SOCKS5、多上下文配置与错误修复。
代理配置
Playwright 代理身份认证:每个上下文独享独立静态 IP
在 Node.js 或 Python 中为每个 Playwright 浏览器上下文配置独立的 HTTP(S) 认证代理,使时区与语言环境匹配对应 IP,并验证实际出口地址。
代理配置
Selenium WebDriver 与代理认证:切实可行的解决方案
ChromeDriver的Selenium代理认证:为何--proxy-server忽略user:pass,如何用selenium-wire或onAuthRequired扩展解决并验证IP。
免费工具
批量检测代理:可用状态、出口IP与延迟
免费在线代理检测工具:粘贴多达100条 ip:port:user:pass 格式代理,即可查看可用状态、出口IP和延迟,并获取各类失败原因的说明与解决建议。
代理配置
通过专用代理路由 Google Chrome 流量
仅为 Google Chrome 配置 HTTP(S) 代理而不影响整台设备:使用按配置文件独立的扩展插件、带 --proxy-server 的启动快捷方式,或调整系统代理设置。
代理配置
在 Windows 10 和 Windows 11 上设置代理
在 Windows 10 或 11 上配置 HTTP(S) 代理:涵盖设置中的代理页面、在凭据管理器中保存认证信息、命令行工具的环境变量配置以及 netsh winhttp 设置。