プロキシ利用時の ERR_TUNNEL_CONNECTION_FAILED の解決方法

再現された2つのケース

どちらもテスト用プロキシ（ドキュメント用アドレス 203.0.113.10:8080、user123:pass456 に置き換え）で検証した結果です。通常の Chrome ウィンドウでは、407 の場合トンネルエラーにはならず、プロキシのユーザー名とパスワードを求めるログインダイアログが表示されます。そのため、407 によるトンネルエラーは、主に自動化ツールやパスワード入力ダイアログを表示できないアプリで発生します。

主な原因（可能性が高い順）

• 自動化スクリプトで認証情報が送信されていない： Chrome の --proxy-server フラグはホストとポートのみを受け付け、user:pass には対応していません。そのため、ヘッドレス Puppeteer や Selenium は 407 を受け取り、トンネルエラーを報告します。
• パスワード保護された Wi-Fi プロキシ環境下のスマートフォンアプリ： アプリ側に入力ダイアログがないため、ブラウザは動作してもアプリの HTTPS 通信が失敗します。
• プロキシが接続先ターゲットに到達できない： CONNECT に対して 502 を返します。詳しくは 502 Bad Gateway ページ を参照してください。
• 特定のサイトのみ失敗する： 同じプロキシ経由で他のサイトにはアクセスできる場合、接続先サイトがブロックしているかダウンしています。

1行の curl コマンドで実際のエラーコードを特定

実際の値に置き換えて 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 を確認できます。

環境別の解決策

• 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

   CONNECT 応答を確認する

   プロキシ情報を指定して curl -v -x を実行するか、チェッカーに貼り付けて、プロキシが 407 と 502 のどちらを返しているか特定します。

2. 2

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

   スクリプト内では --proxy-server に user:pass を含めるのではなく、ライブラリ固有の認証用フックを使用します。

3. 3

   502 の場合：別のサイトで試す

   同じプロキシ経由で example.com などの大手サイトにアクセスしてみます。正常に読み込める場合、元の接続先サイト側に問題があります。

4. 4

   再実行して出口 IP を確認する

   トンネルが開いたら、同じブラウザで my IP にアクセスし、トラフィックがプロキシを経由していることを確認します。

よくある質問