ProxyV4

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に対するプロキシの応答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の場合は、接続先のサイトまたはプロキシ以降のルートに問題があります。

ターミナルを使わずに確認したい場合は、プロキシチェッカーをご利用ください。同様の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. 1

    プロキシの応答コードを確認する

    ご利用のプロキシ情報でcurl -v -xを実行するかチェッカーツールを使用して、CONNECTへの応答が407か502かを確認します。

  2. 2

    407の場合:認証情報を正しく渡す

    自動化ツールでは--proxy-server内にuser:passを記述せず、各ライブラリの認証機能を利用します。

  3. 3

    502の場合:別の接続先でテストする

    同じプロキシ経由でexample.comなどの安定した大規模サイトにアクセスします。読み込める場合、元のサイト側に問題があります。

  4. 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で回避策を使うことなくそのまま動作します。

リアルタイム料金を見る

Related articles

プロキシエラー
プロキシの407エラーを解決:認証情報の確認手順
407 Proxy Authentication Requiredはプロキシ認証の失敗を示します。原因一覧とChrome、curl、Python、Selenium、アンチディテクトアプリでの対処法。
プロキシエラー
502エラーの発信元はどこか?プロキシ環境でのBad Gatewayの診断
プロキシ経由での502 Bad Gatewayの意味、プロキシ側とサイト側の切り分け方、Chrome、curl、Python、Selenium、アンチディテクトアプリでの修復方法。
プロキシ設定
認証プロキシ付きPuppeteer:起動フラグとログインの設定
Puppeteerのプロキシ認証:--proxy-serverでアドレス指定、page.authenticate()でログイン。SOCKS5対応、コンテキスト分離、不具合対策まで解説。
プロキシ設定
Playwrightのプロキシ認証:コンテキストごとに1つの固定IPを設定
Playwrightの各コンテキストに認証付きHTTP(S)プロキシを個別に割り当て、IPに応じたタイムゾーン設定と出口IP確認を行う方法を解説。
プロキシ設定
Selenium WebDriverと認証プロキシ:確実に動作する設定方法
ChromeDriverのSeleniumプロキシ認証:--proxy-serverがuser:passを無視する理由、selenium-wireやonAuthRequired拡張での解決とIP確認。
無料ツール
プロキシの一括チェック:稼働状況、出口IP、レイテンシ
無料のオンラインプロキシチェッカー。最大100行のip:port:user:passを貼り付けるだけで、稼働状況、出口IP、レイテンシを確認でき、エラー原因も把握できます。
プロキシ設定
専用プロキシ経由でGoogle Chromeをルーティングする方法
PC全体ではなくGoogle ChromeのみにHTTP(S)プロキシを設定する方法を解説。プロファイル別の拡張機能、--proxy-server起動ショートカット、システムプロキシ設定を比較します。
プロキシ設定
Windows 10およびWindows 11でのプロキシ設定
Windows 10や11でHTTP(S)プロキシを設定する方法。設定画面の手動構成、資格情報マネージャーへのログイン情報保存、CLI向け環境変数やnetsh winhttpまで網羅。