---
title: "Mac 上 Chrome 中的 ERR_TUNNEL_CONNECTION_FAILED · Kilobat 指南"
url: "https://kilobat.app/zh-hans/guides/err-tunnel-connection-failed"
description: "Mac 上的 Chrome 显示 ERR_TUNNEL_CONNECTION_FAILED。代理没有打开到网站的隧道。检查代理的回复及其规则。"
---

# Mac 上 Chrome 中的 ERR_TUNNEL_CONNECTION_FAILED

ERR_TUNNEL_CONNECTION_FAILED 是 Chrome 的网络错误。Chromium 源码对它的描述是：“A tunnel connection through the proxy could not be established.”

**让你的智能体来解决**拷贝一条提示词，适用于 Claude Code、Codex 或任何能使用终端的智能体。

我的 Mac 出现了这个问题：Mac 上 Chrome 中的 ERR_TUNNEL_CONNECTION_FAILED。请阅读 https://kilobat.app/zh-hans/guides/err-tunnel-connection-failed.md，并和我一起逐步处理。如果缺少 Kilobat CLI，请安装：brew install seifip/kilobat/kilobat。请你自己运行指南中的终端和 kilobat 检查，并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。

适用于：所有当前 macOS 版本上的 Google Chrome 和其他 Chromium 内核浏览器（Edge、Brave、Arc）。 · 核查日期：2026年10月29日

## 症状

- Chrome 显示“Unable to connect to the proxy server”。
- 错误是 ERR_TUNNEL_CONNECTION_FAILED。
- HTTPS 网站失败，HTTP 网站可能能加载。

## 可能的原因

- **代理拒绝了这个主机。**代理可能拒绝对某个主机或端口的 CONNECT 请求。
- **缺少代理凭据。**代理可能要求登录，而 Chrome 没有发送凭据。
- **代理规则或过滤器。**公司策略可能会阻止该网站。
- **代理类型不对。**在网络需要其他类型的地方设置了 HTTP 代理。

## 如何检查

1. 显示 macOS 使用的代理。

   ```
   scutil --proxy
   ```
2. 通过代理，用 curl 测试隧道。

   ```
   curl -v -x http://proxy.example.com:8080 -I https://example.com
   ```
3. 在 curl 输出中查看代理的回复代码。
4. 在另一个网络上不使用代理，试试同一个页面。

## 如何修复

1. 如果回复是 407，请登录或更正凭据。
2. 如果回复是 403，请让管理员允许该主机。
3. 关闭你用不到的代理。
4. 参见[代理设置导致 Mac 上的 App 无法连接](https://kilobat.app/zh-hans/guides/proxy-settings-breaking-apps)。

## 使用 Kilobat

1. Kilobat 的连接诊断会逐层测试这个地址：网络、代理、DNS、规则、IPv4、IPv6、TLS 和服务器，并指出失败的那一层。

   ```
   kilobat why https://example.com
   ```
2. Kilobat 的这些检查都是免费的。AI 智能体可以通过 MCP 用 `diagnose_connection` 和 `diagnose_network` 运行它们。请参阅[找出某个网站或 API 连不上的原因](https://kilobat.app/zh-hans/guides/recipes/why-cant-it-connect)。

## 常见问题

**407 回复是什么意思？**

代理要求提供凭据，而客户端没有发送。

**为什么只有 HTTPS 网站失败？**

HTTPS 通过代理必须放行的隧道传输。普通 HTTP 不使用隧道。

## 参考资料

- [Chromium 源码：net_error_list.h](https://chromium.googlesource.com/chromium/src/+/main/net/base/net_error_list.h)
- [Chrome 帮助：修复连接错误](https://support.google.com/chrome/answer/95669)

核查日期：2026 年 10 月 29 日。

## 相关指南

- [Mac 上 Chrome 中的 ERR_PROXY_CONNECTION_FAILED](https://kilobat.app/zh-hans/guides/err-proxy-connection-failed): ERR_PROXY_CONNECTION_FAILED 是 Chrome 的网络错误。
- [Mac 上代理设置导致 App 无法连接](https://kilobat.app/zh-hans/guides/proxy-settings-breaking-apps): 代理设置会让流量经由另一台服务器转发。
- [Mac 上公司代理证书导致“终端”工具出错](https://kilobat.app/zh-hans/guides/corporate-proxy-certificates): 一些公司网络会检查 HTTPS 流量。
- [Mac 上出现“Safari 浏览器无法连接到 Web 代理服务器”](https://kilobat.app/zh-hans/guides/safari-cant-connect-proxy-server): 网络设置中设定了 Web 代理，而 Safari 浏览器无法连接到它。
