ERR_TUNNEL_CONNECTION_FAILEDの裏側:プロキシのCONNECT応答を読み解く
Updated:
ERR_TUNNEL_CONNECTION_FAILEDは、Chromeがhttps://ページ用のトンネル確立をプロキシに要求し、プロキシがそれを拒否した際に発生します。ChromeはCONNECTリクエストを送信して許可を待ちますが、代わりにエラーステータスを受信します。Chromeはこのステータスコードを画面上に表示しないため、最初のステップは実際のコードを特定することです。
主な原因(可能性の高い順)
- スクリプトが認証情報なしでChromeを起動している:
--proxy-serverフラグにはホストとポートのみが指定可能で、そこに入力されたuser:pass情報は破棄されます。そのため、ヘッドレスモードのPuppeteerやSeleniumは407を受信し、トンネル確立失敗として報告します。 - パスワード認証が必要なWi-Fiプロキシ配下のアプリ: アプリにはログインプロンプトがないため、スマートフォンのブラウザで通信できていても、アプリ側のHTTPSリクエストは失敗します。
- プロキシが宛先サーバーに到達できない: プロキシがCONNECTに対して502を返しています。詳細は502 Bad Gatewayの解説ページをご確認ください。
- 特定のサイトのみ失敗する: 宛先サイトがダウンしているか接続を拒絶しており、同じプロキシで他のサイトには正常にアクセスできる状態です。
検証環境での挙動
テスト用プロキシ(ここでは203.0.113.10:8080、ログイン情報user123:pass456と表記)にて、代表的な2つのケースを再現しました。どちらのケースでも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の場合は、接続先のサイトまたはプロキシ以降のルートに問題があります。
ターミナルを使わずに確認したい場合は、プロキシチェッカーをご利用ください。同様の2つの状況が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: ログインダイアログが表示されない場合、拡張機能が干渉している可能性があります。拡張機能を無効化したウィンドウで再度お試しください。
- スマートフォン: 認証が必要なプロキシ環境でアプリを利用する場合、Android設定ガイドで解説しているように、user:pass認証に対応したプロキシ設定アプリ経由での利用が最適です。
設定手順
- 1
プロキシの応答コードを確認する
ご利用のプロキシ情報で
curl -v -xを実行するかチェッカーツールを使用して、CONNECTへの応答が407か502かを確認します。 - 2
407の場合:認証情報を正しく渡す
自動化ツールでは
--proxy-server内にuser:passを記述せず、各ライブラリの認証機能を利用します。 - 3
502の場合:別の接続先でテストする
同じプロキシ経由でexample.comなどの安定した大規模サイトにアクセスします。読み込める場合、元のサイト側に問題があります。
- 4
出口IPを確認する
トンネルが確立されたら、同じブラウザでmy 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で回避策を使うことなくそのまま動作します。
リアルタイム料金を見る