2026年10月21日 · トラブル対処 · 約8分

V2Rayのシステムプロキシが効かないときの対処法|ブラウザーとターミナルを別々に確認

ブラウザーでは接続できるのにターミナルでは使えない、またはその逆の場合に。ブラウザー拡張機能やPAC設定、ターミナルのhttp_proxy環境変数やローカルポートを個別に確認し、システムプロキシが効かない原因を切り分けます。

この記事のポイント

ブラウザーとコマンドラインで結果が異なる場合は、まずcurlからv2rayNのローカルプロキシへ明示的に接続し、その後ブラウザーが参照するプロキシ設定とターミナルの環境変数をそれぞれ確認します。アプリがプロキシを使っていない、ローカルポートに接続できない、リクエストがコアに届いた後で通信に失敗する、という3つの問題を切り分けられます。

まずローカルプロキシの接続先を確認

システムプロキシは、すべての通信を一括して中継する仕組みではありません。プロキシ設定を読み取り、利用するアプリだけがその設定に従ってリクエストを送信します。ブラウザーはOSの設定を参照する場合も、独自のプロキシ設定を使う場合もあります。一方、コマンドラインツールが参照するのは、引数や環境変数、独自の設定ファイルだけということもあります。また、v2rayNのシステムプロキシ設定とコアの待ち受け状態は別々に確認が必要です。OSにプロキシアドレスが設定されていても、そのポートでサービスが待ち受けているとは限りません。

アプリからのリクエストプロキシの選択ローカルの待ち受けルールの照合接続先

v2rayNの「設定」→「パラメーター設定」でローカルの待ち受けに関する項目を確認し、コアの起動ログも確認します。以下は設定例であり、現行バージョンのデフォルト値を示すものではありません。混合待ち受けでは、HTTPとSOCKSのリクエストが同じポートを使う場合があります。個別に待ち受ける構成では、実際のプロトコルに合わせて指定してください。ポート番号が近いという理由だけで置き換えることはできません。

10809
HTTP待ち受けポートの例
10808
SOCKS待ち受けポートの例

ここではHTTP待ち受けを使って、基準となるリクエストを送信します。例のポート番号を実際の値に置き換えてください。Windows PowerShellでは、同名のエイリアスではなくコマンドを実行するためにcurl.exeを使います。以降のテストでも同じ接続先を使い、クライアントのログと照合できるようリクエストの時刻を記録してください。

curl -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10809 https://example.com/

--noproxy ""を指定すると、既存のプロキシ除外リストが今回のテストに影響するのを防げます。詳細出力のConnected to 127.0.0.1が示すのは、ローカルポートに接続できたことだけです。その後、CONNECTが成功したか、接続先から応答があったかも確認してください。接続先から応答があっても、それだけでリクエストがリモートノード経由だとは判断できません。コアのルーティングルールによって、直接接続されている可能性もあります。

ブラウザーで効かない場合:拡張機能とPACを確認

プロキシを明示したリクエストは成功するのにブラウザーで失敗する場合は、まずブラウザーが実際にどのプロキシ設定を使っているか確認します。拡張機能、ブラウザー独自の設定、OSの設定が同時に有効なこともあります。原因を特定できなくなるのを避けるため、一度に変更する項目は1つにしてください。

  1. プロキシ設定の参照元を確認

    Windowsでは「設定」→「ネットワークとインターネット」→「プロキシ」を開き、セットアップスクリプトと手動プロキシの設定を分けて確認します。Firefoxでは「設定」→「一般」→「ネットワーク設定」→「設定」を開き、システムプロキシ、手動設定、自動設定URLのどれが選択されているか確認してください。

  2. プロキシ拡張機能を切り分ける

    権限のあるブラウザー設定で、プロキシ管理やルール切り替えを行う拡張機能を一時的に無効にし、同じ接続先を再度開きます。シークレットウィンドウで試すだけでは、拡張機能が無効になった証拠にはなりません。拡張機能によってはシークレットウィンドウでの実行が許可されているためです。組織のポリシーで管理されている設定は、管理者に確認してください。

  3. PACルールを確認

    自動設定スクリプトを使っている場合は、スクリプトのURLを読み込めるか確認し、対象ドメインに適用されるルールがプロキシ経由かDIRECTかを調べます。後者は、ブラウザーが直接接続するルールです。プロキシ経由の場合は、指定されたアドレスとポートがローカルの待ち受け設定と一致していることを確認してください。

  4. 同じ接続先で再テスト

    開いているタブを閉じてから同じリクエストを再実行し、クライアントのアクセスログが利用できる場合は、時刻と接続先を照合します。特定のドメインだけで失敗する場合は、そのドメインの除外リストやPACの照合条件を確認してください。個別のルールによる問題を、システムプロキシ全体の不具合と混同しないようにします。

PACによる振り分けとクライアントのルーティングは、異なる段階で行われます。PACが直接接続を返すと、通常リクエストはローカルプロキシに届きません。クライアントのルールが直接接続を選んだ場合は、リクエストはすでにコアに届いていますが、通信にノードが使われていません。どの段階で接続先が選ばれたかを判断するには、ページが開くかどうかだけでなく、ブラウザーのプロキシ設定元とクライアントログの送信先も確認してください。

ターミナルで効かない場合:環境変数とプロトコルを確認

ブラウザーでは正常なのにcurlで失敗する場合は、同じターミナルからプロキシを明示したリクエストと通常のリクエストを実行し、結果を比較します。明示的なプロキシ指定だけが使えるなら、通常はローカルの待ち受け設定を変更する必要はありません。まず現在のプロセスにプロキシ設定が渡されているか確認してください。デスクトップのプロキシ設定を切り替えても、各シェルに環境変数が自動設定されるわけではありません。エディターやターミナル、サービスから起動したプロセスでは、引き継がれる環境変数が異なることもあります。

設定項目curlでの役割確認するポイント
http_proxyHTTP接続先に使うプロキシを指定大文字と小文字を区別する環境では小文字を使います。curlは大文字のHTTP_PROXYを受け付けません
https_proxyHTTPS接続先に使うプロキシを指定変数名は接続先のプロトコルを示し、値の先頭部分はプロキシへの接続に使うプロトコルを示します
all_proxy該当プロトコルの設定がない場合に使う代替プロキシ停止した古いポートが設定されたままになっていないか確認
no_proxyプロキシを経由しない接続先を指定テスト対象のドメインやワイルドカードが、直接接続の対象になっていないか確認

たとえば、ローカルの接続先が通常のHTTPプロキシなら、接続先がHTTPSでもhttps_proxyの値はhttp://127.0.0.1:10809にできます。curlはHTTPプロキシにCONNECTを送り、トンネル経由で接続先とTLS接続を確立します。接続先のURLがHTTPSだからといって、ローカルプロキシのURLまでHTTPSに変更する必要はありません。

# macOS、Linux:このcurlコマンドの実行時だけ環境変数を適用
https_proxy=http://127.0.0.1:10809 curl -v --noproxy "" https://example.com/

# Windows PowerShell:現在のセッションのプロキシ環境変数を確認
Get-ChildItem Env: | Where-Object Name -Match '^(http|https|all|no)_proxy$'

まとめ:適用範囲を確認してから恒久設定する

一時的な環境変数を使ったテストが成功したら、検証済みの設定を対象ツールの起動環境に追加します。対話型ターミナルだけで有効な設定を、バックグラウンドタスクやエディター内ターミナルの設定として扱わないようにしてください。

SOCKSの接続先を使う場合は、基準コマンドのプロキシ引数を--proxy socks5h://127.0.0.1:10808に置き換えて個別にテストできます。curlでは、socks5hは接続先のホスト名解決をプロキシに任せ、socks5はローカルで解決します。結果が異なる場合は、名前解決を行う場所とプロキシ側の名前解決設定を確認してください。この結果だけで特定のDNSサービスの障害とは判断できません。

エラーから失敗した段階を特定

原因を調べる際は、最初に失敗したメッセージと、その直前に表示された接続先を確認します。同じタイムアウトでも、ローカルポートへの接続時、プロキシによるトンネル確立待ち、接続先からの応答待ちのいずれでも発生する可能性があります。詳細出力を同時刻のコアログと照らし合わせると、ノードを何度も切り替えるより効率よく原因を絞り込めます。

Connection refused

原因と対処:127.0.0.1への接続時に拒否された場合は、まずコアがそのポートで待ち受けているか確認します。起動ログと待ち受けアドレスを確認してください。仮想マシンやコンテナ内でコマンドを実行している場合、ループバックアドレスは通常、デスクトップホストのループバックアドレスとは異なります。

Could not resolve proxy

原因と対処:接続先のWebサイトではなく、プロキシアドレスのホスト名をcurlが解決できていません。プロキシ環境変数に古いホスト名が残っていないか確認してください。同じネットワーク環境でコアがIPv4ループバックアドレスを使って待ち受けている場合は、実際のポートと127.0.0.1を指定して再テストできます。

CONNECT tunnel failed, response 502

原因と対処:HTTPプロキシはCONNECTに応答しましたが、502を返したためトンネルが確立されていません。まず、待ち受けプロセスが想定したコアであることを確認します。次に、該当リクエストの送信先、接続先の名前解決、接続ログを確認してください。ステータスコードだけでは、どの段階で失敗したか特定できません。

再テストと設定の復元

明示的なプロキシ設定でもどちらからもリクエストを完了できない場合は、接続トラブルの対処方法に戻って、コアと送信先を確認してください。リクエストがコアに届いているのに、直接接続とプロキシ経由の動作が想定と異なる場合は、ルーティングの説明を確認します。調査記録を共有する際は、ポートの種類、エラーが発生した段階、必要なログの抜粋を残し、サブスクリプションURLや認証情報、公開する必要のないリクエスト内容は削除してください。

クライアントのダウンロードとインストール