プロキシでのnet::ERR_TUNNEL_CONNECTION_FAILEDの原因と対処方法

ERR_TUNNEL_CONNECTION_FAILEDとは何ですか？

HTTPプロキシ経由でHTTPSページを読み込むには、ブラウザはまずCONNECT host:443を送信します。プロキシが200で返せばブラウザはトンネル内でTLSを開始します。407、403、502などそれ以外は試行終了で、Chromiumは一般的なエラーを報告します。

このエラーは失敗箇所であるトンネルを示しますが理由は示しません。理由はプロキシが送ったステータスコードにあり、curlで確認できます。

ERR_TUNNEL_CONNECTION_FAILEDはPython、curl、Node.js、ブラウザではどのように表示されますか？

同じ失敗でもツールごとに異なる表示になります。ログ検索用のメッセージは以下の通りです：

• Playwright: page.goto: net::ERR_TUNNEL_CONNECTION_FAILED at https://...
• Puppeteer: Error: net::ERR_TUNNEL_CONNECTION_FAILED at https://...
• Chromeのアドレスバー: 『このサイトにアクセスできません』、コードはERR_TUNNEL_CONNECTION_FAILED
• ChromeでのSelenium: WebDriverException内部で同じコード

ERR_TUNNEL_CONNECTION_FAILEDの原因は何ですか？

最も可能性が高いのは次の通りです：

• 認証情報が送信されていません（隠された407）。Chromeは--proxy-server内のユーザー名とパスワードを無視します。
• 拒否された宛先（隠された403）。プロキシの使用ポリシーでブロックされたカテゴリなど。
• 到達不能なターゲット（隠された502または504）：死んだホスト、タイプミス、出口側のDNS障害。
• 誤ったポート: ブラウザがSOCKS5ポートをHTTPのように指定、またはその逆。

ERR_TUNNEL_CONNECTION_FAILEDを段階的に診断するには？

1. 同じURLをcurlで-vを使って実行（下記コマンド）し、CONNECTの次の行を読む。
2. 407は認証情報、403は拒否された宛先、502または504はターゲットまたは出口を意味します。
3. http://プロキシサーバーのHTTPポートをブラウザが使用しているか確認します。
4. 本来のターゲットの前にhttps://api.ipify.orgのようなシンプルなページを試してください。

# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:[email protected]:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL

ERR_TUNNEL_CONNECTION_FAILEDをどう修正しますか？

• Playwright: ブラウザまたはコンテキストごとにproxyオプションでserver、username、passwordを渡します。Playwrightガイドをご覧ください。
• Puppeteer: --proxy-server=http://host:portで起動し、最初のgotoの前にpage.authenticate()を呼び出します。Puppeteerガイドをご覧ください。
• Selenium: 認証情報を追加する小さなローカルフォワーダーを実行します。Seleniumガイドをご覧ください。
• 宛先が当社の許容利用規約に準拠しているか確認してください。

ERR_TUNNEL_CONNECTION_FAILEDの後に再試行すべきですか？

隠されたステータスを理解したら、リトライは一度だけ行ってください。隠された407や403は永遠に繰り返すため、設定を修正してください。隠された502や504は、任意のゲートウェイエラーと同様に新しい出口でリトライできます。

ERR_TUNNEL_CONNECTION_FAILEDはCrawlRelayにどう関係しますか？

CrawlRelayのHTTPポートはCONNECTトンネルでHTTPSを運ぶため、全てのChromiumベースツールでサポートされています。ブラウザにはHTTPポートを使ってください：Chromiumはユーザー名とパスワード付きのSOCKS5をサポートしていません。

ゲートウェイ：gw.crawlrelay.com、ポート7777（HTTP、HTTPSはCONNECT経由）、ポート7778（SOCKS5）。ユーザー名形式：USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}。関連情報：407 Proxy Authentication Required · ERR_PROXY_CONNECTION_FAILED · Playwrightガイド。