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 的回應 | 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
通道開啟後,在同一瀏覽器中開啟 我的 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 皆可直接支援,無需額外因應方案。
查看即時價格