ProxyV4

ERR_TUNNEL_CONNECTION_FAILED 背後原因:解讀代理的 CONNECT 回應

Updated:

當 Chrome 要求代理伺服器為 https:// 網頁建立通道卻遭到拒絕時,就會出現 ERR_TUNNEL_CONNECTION_FAILED。Chrome 會發送 CONNECT 請求並預期獲得許可,但卻收到錯誤狀態碼。問題在於 Chrome 會隱藏該狀態碼,因此首要任務就是找出實際的代碼。

專為自動化腳本打造

常見原因排序

  • 腳本啟動 Chrome 時未帶入認證資訊。 --proxy-server 旗標僅支援主機與連接埠,在此輸入的任何 user:pass 都會被忽略。因此 Puppeteer 或 Selenium 在無頭(headless)模式下會收到 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

    通道開啟後,在同一瀏覽器中開啟 我的 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

代理錯誤排解
修復 Proxy 407 錯誤:身分驗證憑證檢查清單
407 Proxy Authentication Required 代表 Proxy 拒絕登入。一覽表整理原因,並提供 Chrome、curl、Python、Selenium 及防偵測瀏覽器修復法。
代理錯誤排解
誰傳回了 502?排查代理伺服器背後的 Bad Gateway 錯誤
說明代理伺服器出現 502 Bad Gateway 的原因、如何區分是代理伺服器還是網站本身的問題,並提供在 Chrome、curl、Python、Selenium 及防關聯瀏覽器中的修復方法。
代理設定
Puppeteer 搭配需要驗證的代理伺服器:啟動參數加上登入設定
Puppeteer 代理驗證,先提供可用範例:以 --proxy-server 設定位址、page.authenticate() 登入,再介紹 SOCKS5、Context 與修復方法。
代理設定
Playwright 代理驗證:每個 Context 配置獨立靜態 IP
在 Node.js 或 Python 中為每個 Playwright 瀏覽器 Context 指派專屬驗證 HTTP(S) 代理,讓時區與語言環境符合 IP,並確認出口位址。
代理設定
Selenium WebDriver 與驗證 Proxy:實用可行方案
ChromeDriver 的 Selenium Proxy 驗證教學:解析為何忽略帳密、透過 selenium-wire 或擴充功能解決,以及驗證 IP 方法。
免費工具
批次檢測 Proxy:狀態、出口 IP 與延遲
免費線上 Proxy 檢測工具:貼上最多 100 行 ip:port:user:pass,即時查看哪些 Proxy 可用、出口 IP 與延遲,並深入了解各項失敗結果代表的意義。
代理設定
讓 Google Chrome 透過專用代理伺服器連線
僅為 Google Chrome 設定 HTTP(S) 代理伺服器,不影響整台電腦:透過個人化資料擴充功能、--proxy-server 啟動捷徑或系統代理設定即可輕鬆搞定。
代理設定
在 Windows 10 與 Windows 11 上設定 Proxy
在 Windows 10 或 11 設定 HTTP(S) Proxy:從「設定」的 Proxy 頁面、認證管理員儲存登入資訊,到 CLI 工具環境變數與 netsh winhttp。