端末に合ったオープンソースクライアントを選び、サブスクリプションのインポートからルーティングまで、設定項目を確認しながら設定できます。
v2rayNとv2rayNGはGUIで操作するクライアント、XrayとV2Flyは接続を処理するコアです。まず端末に合ったクライアントを選び、サブスクリプションの設定値、プロキシモード、ルーティングルールを確認しましょう。画面上の設定とコアの設定項目を混同しにくくなります。
トラフィックの入口からルーティングの出口まで、実際の操作順に5つの設定を確認します。以下の例は項目の説明用で、リモートサーバーに接続できる完全な設定ではありません。
システムプロキシは、システム設定に従うアプリのリクエストをクライアントに渡すかどうかを決めます。サブスクリプションをインポートしてサーバーを選んだら、トレイメニューでシステムプロキシを設定し、ブラウザーで接続を確認します。これはルーティングモードとは別の設定です。システムプロキシはトラフィックをローカルの待ち受けポートに送るかを決め、ルーティングは受け取ったトラフィックの出口を決めます。独自のプロキシ設定を持つアプリでは、待ち受けアドレスとポートを個別に入力してください。トラブル時は、コアが起動していることとポート番号が一致していることを確認します。クライアントを終了する前にシステムプロキシを解除し、停止した待ち受けポートをアプリが参照し続けないようにしましょう。
設定項目の確認
ローカル混合リスニングポート：10808
ローカルアプリのプロキシアドレス：127.0.0.1
システムプロキシ：システムプロキシを自動設定
クライアント終了前：システムプロキシを解除
注意：ポートは実際の設定値を確認してください。ルーティングルールは、トラフィックがコアに入った後の出口を選びます。よく使われる条件はドメイン、宛先アドレス、ポートです。ルールは通常、上から順に評価され、最初に一致したルールが接続先を左右します。そのため、具体的な条件は広い条件より前に設定してください。この例では、プライベートアドレスの通信をdirectという出口に送ります。この出口はoutbound設定にも定義が必要です。まずクライアントのルーティングプリセットを基準にし、必要な例外を一つずつ追加するとよいでしょう。システムプロキシとは異なり、ルーティングはアプリの通信を取り込みません。ルールが正しくても、コアに届いていないリクエストには適用されません。
{
"routing": {
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}GUIクライアントとプロキシコアは別々に開発されています。画面から特定の形式の共有リンクをインポートできても、現在のコアがその設定項目すべてを実行できるとは限りません。まずプロトコル、トランスポート、安全設定を確認してから、適切なコアを選びましょう。REALITYを使う接続では、該当設定に対応しているXrayコアを選び、サーバー側の設定と一致しているか確認してください。Androidでは、v2rayNGはXray系、v2flyNGはV2Fly系に対応します。切り替える前に元の設定を保存し、起動エラーが出たらログの項目名を確認してください。複数の設定を同時に変更するのは避けましょう。
選択前に確認
プロトコル：VMess / VLESS / Trojan
トランスポート：サーバーの設定に合わせる
セキュリティ層：TLS / REALITY など
コア：上記の組み合わせへの対応を確認
クライアント：対応する設定を生成できるか確認サブスクリプションURLから設定一式を取得し、更新後に作成されるサーバー項目を実際の接続先として使います。サブスクリプショングループ設定で名前とURLを追加して保存し、該当グループを更新したら、一覧から使用するサーバーを選びます。更新に失敗した場合は、URLにアクセスできないのか、応答の形式が合わないのか、クライアントの解析に失敗したのかを切り分けてください。元のグループを残しておくと、変更前後を比較できます。サブスクリプションには認証情報が含まれる場合があるため、公開スクリーンショットに載せたり、信頼できない変換サービスに渡したりしないでください。複数の端末で使う場合も、ルーティングとプロキシモードは個別に確認しましょう。サブスクリプションに同期されるとは限りません。
サブスクリプション管理の手順
1. サブスクリプショングループを追加
2. 信頼できる提供元のサブスクリプションURLを入力
3. 対象のグループを更新
4. サーバー項目を確認
5. 使用するサーバーを選択
6. ローカルのプロキシモードを確認TUNは仮想ネットワークインターフェースを通じてトラフィックを受け取ります。システムプロキシに従わないアプリにも対応できますが、権限、ルーティング、DNSの追加設定が必要です。まずシステムプロキシでサーバーへの接続を確認し、その後でTUNを検討しましょう。接続設定の問題と通信を取り込む設定の問題を切り分けやすくなります。デスクトップ環境では権限の昇格が必要な場合があり、既存の仮想ネットワークアダプターやネットワークツールとルートが競合することもあります。AndroidクライアントのVPNモードでは、システムの許可を得て通信を取り込む経路を作ります。対象アプリのリストも確認してください。問題が起きたら、まず通信の取り込みを停止し、通常のネットワークが復旧するか確認しましょう。
有効にする前の確認
システムプロキシモードで接続できる
システム権限に関する確認内容を理解している
ほかの通信取り込みツールを同時に実行していない
DNSとルーティングの方針が一致している
通信の取り込みを停止してネットワークを復旧する方法を把握しているまず「アプリが通信を渡すか」と「コアが通信をどう処理するか」を分けて考えます。ブラウザーでアクセスできなくても、サーバー設定の誤りとは限りません。ブラウザーがシステムプロキシに従っていない、待ち受けポートを別のプログラムが使っている、クライアントの起動後すぐにコアが終了している、といった原因でも似た症状が起こります。一度に変更する設定を一つに絞り、同じ接続先で結果を確認すると、すべての設定を何度も切り替えるより原因を見つけやすくなります。
ログも段階ごとに確認しましょう。起動時は設定の解析とポートの待ち受けを、接続時は名前解決、ハンドシェイク、タイムアウトを確認します。必要に応じてログレベルを一時的に変更し、調査後は通常のレベルに戻してください。ログを共有する前に、サブスクリプションURL、認証情報、サーバー識別情報を削除しましょう。構造全体を確認するには設定項目を参照し、inbound、outbound、routingの参照関係を照らし合わせてください。
デスクトップではv2rayN、Androidではコアに合わせてv2rayNGまたはv2flyNGを選びます。各プラットフォームのパッケージ一覧から選択してください。リリース情報とファイルのダウンロード先は、ダウンロードページにまとめています。
トレイメニューからシステムプロキシ、サブスクリプショングループ、ルーティングモードを管理したいデスクトップユーザーに向いています。ダウンロードページでは、クロスプラットフォームUI版と従来のWPF版を掲載しています。選ぶ前にOSとCPUアーキテクチャを確認し、ファイルの拡張子だけで判断しないでください。
初回設定では通常の権限で起動し、サブスクリプションをインポートします。ローカルの待ち受けが正常に動作することを確認してから、システムプロキシを設定してください。追加権限が必要な通信取り込み機能を使う場合は、権限に関する確認内容を先に理解しましょう。ほかのネットワークツールがインストールされている場合は、二つのクライアントがシステム設定を繰り返し書き換えないよう、そちらの通信取り込みを先に停止してください。
ダウンロードページへチップに合わせてApple Silicon版またはIntel版を選んでください。「このMacについて」でチップ情報を確認してからダウンロードすると、アーキテクチャの不一致による起動エラーを避けられます。サブスクリプションやルーティングの基本的な考え方はデスクトップ版で共通ですが、メニューの場所は実際の画面で確認してください。
初回起動時に開発元の確認やネットワーク権限の通知が表示されたら、システム設定で内容を確認し、アプリごとに対応してください。クライアントを使うためにシステム全体の保護を無効にする必要はありません。インストール後は、システムプロキシがクライアントの待ち受けアドレスを参照しているか確認します。クライアント終了後もネットワークに接続できない場合は、プロキシ設定が残っていないか確認してください。
ダウンロードページへXrayの設定が必要なら、まずv2rayNGを確認してください。V2Flyの設定を使う場合は、v2flyNGを検討しましょう。最近の一般的な端末では通常arm64を選びます。アーキテクチャがわからない場合は、汎用パッケージの説明を確認してください。二つのクライアントの設定は個別に管理し、名前が似ているからといって設定項目が完全に互換だと判断しないでください。
サブスクリプションのインポート後、サーバーを選び、初回接続時にシステムのVPN許可を確認します。アプリごとのプロキシリストによって通信を取り込むアプリが変わるため、テストには対象に含めたアプリを使ってください。バックグラウンドに移動すると接続が切れる場合は、クライアントを再インストールする前に、システムのバッテリー管理やバックグラウンド実行の制限を確認しましょう。
ダウンロードページへディストリビューションのパッケージ管理方式に合わせてdebまたはrpmを選び、x64とarm64の違いも確認してください。GUIクライアントはデスクトップ環境でサブスクリプションを管理したり、ログを確認したりするのに便利です。インストールしただけで、すべてのアプリが自動的にローカルプロキシを使うわけではありません。
システムプロキシの扱いはデスクトップ環境によって異なる場合があります。ブラウザー、ターミナル、バックグラウンドサービスがそれぞれ独自のプロキシ設定を使うこともあるため、種類ごとに確認してください。一つのアプリでアクセスできたからといって、すべての通信が取り込まれているとは限りません。仮想ネットワークインターフェースを使う場合は、権限、システムルート、既存のネットワーク管理ツールの関係を先に確認しましょう。
ダウンロードページへデスクトップ版v2rayNとAndroid版v2rayNGを例に、インストール、設定、通信の取り込みを順に進めます。問題が起きたとき、確認すべき段階を特定しやすくなります。
OSとアーキテクチャに合ったパッケージを選び、クライアントを開いてサブスクリプショングループの設定画面を探します。見分けやすい名前を付け、信頼できる提供元のURLを入力して保存し、グループを更新してください。URLは末尾のパラメーターも含めて完全な形で入力します。チャットアプリからコピーする際は、余分な空白や改行にも注意しましょう。
更新後、一覧にサーバー項目が表示されるか確認します。グループ名だけでサーバー項目がない場合は、更新時のメッセージを見て、ネットワーク取得の失敗か内容解析の失敗かを切り分けてください。クライアントにリモートサーバーは付属していません。インストール後も、利用権限のある設定が必要です。サブスクリプションURLに機密情報が含まれる場合は、スクリーンショットに全体を表示しないでください。
サーバー一覧から使用する項目を選び、プロトコルと使用するコアが対応しているか確認します。デスクトップではシステムプロキシを設定し、AndroidではVPNモードとシステムの許可を確認してください。初めて使うときはクライアントのルーティング設定を維持し、基本的な接続ができてから、独自のドメインルールやアプリごとのリストを追加しましょう。
サーバー一覧のテスト結果は、特定のテスト方法での接続状況を示すもので、すべてのWebサイトやアプリで使えることを保証するものではありません。接続できない項目があれば、まず接続ログを確認し、サーバーアドレス、ポート、認証情報、端末の時刻を調べてください。トランスポートやセキュリティ層の設定を何度も変更すると、もともと有効だった設定との対応が崩れる場合があります。
実際に使うアプリで接続先を指定し、クライアントのログに該当する接続が記録されるか確認します。記録がなければ、まずアプリがプロキシを使っているか確認してください。記録があるのに接続できない場合は、名前解決、ハンドシェイク、タイムアウトの情報を確認します。変更は一度に一つに絞り、変更前後の結果を記録しましょう。
接続を確認したら、必要に応じてルーティングの例外、バックグラウンド実行、起動時の自動実行を設定します。PCとスマートフォンで同じサブスクリプションを使えても、システムプロキシ、VPNの許可、アプリごとのリストは端末ごとに設定が必要です。デスクトップクライアントを終了する前にシステムプロキシを解除してください。ネットワークに問題が起きたら、まず通常のネットワークに戻し、通信の取り込みを一つずつ有効にし直しましょう。
プロジェクトの系統、プロキシコア、GUIクライアントの違いを理解すると、設定をどこにインポートし、どのコンポーネントで実行するか判断しやすくなります。
Project Vは、V2Rayの技術エコシステムを理解する出発点です。モジュール型プロキシ、inbound、outbound、routingを中心に、汎用的な設定の考え方が築かれています。V2FlyはV2Rayコアを引き継いでコミュニティ開発を続けています。Xrayは関連コードを基盤とする分岐から発展し、プロトコルやトランスポート機能を独自に進化させています。共通の歴史があっても、すべての項目、既定の動作、プロトコルの組み合わせが相互に置き換えられるわけではありません。ガイドを読むときは、どのコアを対象にしているか先に確認してください。
v2rayNはサブスクリプション、サーバー選択、ログ、システムプロキシをデスクトップのGUIにまとめています。v2rayNGはAndroid端末向けで、Xrayコアを中心に設定を管理します。v2flyNGはV2Flyコアを操作するAndroid用GUIです。いずれもオープンソースのクライアントですが、GUIプロジェクトとコアプロジェクトの開発ペースは必ずしも一致しません。機能が使えるか判断するには、クライアントが対応する設定を生成できることと、実際に起動するコアがその設定をサポートしていることの両方を確認してください。
オープンソースでは、各ライセンスに基づいてソースコードが公開され、利用、変更、再配布の条件が定められています。すべてのコンポーネントが同じライセンスを採用しているわけではありません。たとえば、v2rayNのGPL-3.0、v2rayNGのGPL-3.0、V2FlyコアのMITライセンスでは、再配布前に各コンポーネントのライセンス要件を個別に確認する必要があります。一般の利用者は、クライアントの入手元、設定の利用許可、プロキシや通信の取り込み機能を理解したうえで有効にしているかを確認しましょう。
クライアントを更新すると、画面の変更、設定の生成方法、同梱コアの変更が含まれる場合があります。コアの更新によって設定項目の互換性が変わることもあります。最新の配布先はダウンロードページにまとめており、トップページでは特定のリリース番号に固定していません。更新前にサブスクリプショングループと必要な設定を保存し、更新後はまず従来のモードでテストしてから新機能を試しましょう。問題が起きたらログと設定の差分を確認し、根拠なしに特定のコアの系統だけを原因と決めつけないでください。
V2Rayリリースページでは、クライアントの配布先と中国語の設定ガイドを紹介しています。サイト名は上流プロジェクトとの関係を示すものではありません。掲載内容は操作手順と設定項目の説明を中心としており、サーバーアカウントやサブスクリプションサービスは提供していません。プロトコルの具体的な対応状況は、利用中のクライアント、コア、サーバー設定を照らし合わせて確認してください。サイトの方針とコンテンツの運営についてはこのサイトについてをご覧ください。
設定の構造、デスクトップの画面、複数端末間の同期など、実際の利用シーンに合わせて解説します。記事に記載されたメニューや設定項目は、使用中のクライアントの画面と照らし合わせてください。
サブスクリプションURL、共有用QRコード、クリップボードからのインポート、設定ファイルのエクスポートという4つの方法を比較。v2rayNとv2rayNGでノード設定をそろえる際の使い分けと注意点を解説します。
同期方法を読む →v2rayNのメイン画面を項目ごとに解説します。サーバー一覧の右クリックメニュー、サブスクリプショングループの切り替え、画面下部にあるログの読み方、設定画面への入口、トレイメニューでよく使う設定を紹介します。
画面の解説を読む →クライアントからエクスポートした完全な設定を例に、inboundの待ち受け、outboundのプロキシ、routingルールの各項目と、tagによる相互参照の仕組みを順に解説します。
設定ノートを読む →