---
title: "Mac 版 Chrome 的 ERR_TUNNEL_CONNECTION_FAILED · Kilobat 指南"
url: "https://kilobat.app/zh-hant/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-hant/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. 請參閱 [代理伺服器設定讓 App 無法在 Mac 上連線](https://kilobat.app/zh-hant/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-hant/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-hant/guides/err-proxy-connection-failed): ERR_PROXY_CONNECTION_FAILED 是 Chrome 的網路錯誤。
- [代理伺服器設定讓 Mac 上的 App 無法連線](https://kilobat.app/zh-hant/guides/proxy-settings-breaking-apps): 代理伺服器設定會讓流量經由另一台伺服器傳送。
- [公司代理伺服器憑證導致 Mac 上的終端機工具失效](https://kilobat.app/zh-hant/guides/corporate-proxy-certificates): 有些公司網路會檢查 HTTPS 流量。
- [Mac 上的「Safari can’t connect to the web proxy server」](https://kilobat.app/zh-hant/guides/safari-cant-connect-proxy-server): 網路設定中設定了網頁代理伺服器，而 Safari 連不到它。
