V2Ray クライアントガイド / クライアントと設定
複数プラットフォーム対応クライアントからサブスクリプションの読み込み、ルーティングルールまで、GUIで設定し、プロキシが機能しているか確認できます。
ダウンロード先 / OSを選んでからアーキテクチャを選択
デスクトップではv2rayN、Androidではまずv2rayNGを確認し、V2Flyコアが必要な場合はv2flyNGを検討してください。クライアントのダウンロードは最初のステップです。接続には利用可能なサーバー設定が別途必要で、クライアントをインストールしてもノードやサブスクリプションは生成されません。まず端末の種類を確認し、ダウンロードページの案内に従って該当ファイルを選ぶと、アーキテクチャの不一致や再インストールを防げます。
v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォームのUIを採用しており、共通の操作方法で設定を管理したい場合に適しています。WPF版は従来の画面を維持しているため、これまでのメニューや操作に慣れている方に向いています。対応プロトコルは画面の見た目だけで判断せず、実際の設定と選択したコアを確認してください。
ダウンロード前に、システム情報でプロセッサとシステムの種類を確認してください。初回起動後はローカル待受ポートを確認し、利用可能と分かっている設定を1つ読み込んでからシステムプロキシを設定します。複数のクライアントでシステムプロキシを同時に制御しないでください。接続先ポートが繰り返し書き換えられるおそれがあります。
ダウンロードへ →v2rayNのmacOS版はApple SiliconとIntelでダウンロード先が分かれています。「このMacについて」でチップまたはプロセッサを確認し、対応するアーキテクチャを選んでください。同じクライアント名でもインストーラーを互換利用できるとは限りません。適切なアーキテクチャを選べば、不要な互換レイヤーによる負荷も避けられます。
初回起動時は、システムの案内に従って必要な権限を許可してください。設定を読み込んだら、まずシステムプロキシでブラウザーの接続を確認し、ほかのアプリがシステムプロキシを参照するかに応じて、別の接続方法が必要か判断します。アクセスに問題がある場合は、接続設定をすべて変更する前にローカルポートとプロキシ設定を確認してください。
ダウンロードへ →まずXrayコアを採用するv2rayNGを確認してください。V2Flyコアの設定が必要な場合は、v2flyNGを代替として利用できます。一般的な端末ではarm64を選び、アーキテクチャが分からない場合はユニバーサル版の案内を確認してください。名前が似た2つのクライアントでも、対応するコア機能や接続パラメーターはそれぞれ確認が必要です。
初回接続時は、システムのVPN接続許可を確認してください。VPNによる通信制御は、同時に利用できる接続がシステムによって制限されます。バックグラウンド接続の継続には、バッテリー最適化、スリープ設定、ネットワーク切り替えも影響します。まずアプリを前面に表示して接続を確認し、その後バックグラウンド動作の設定を確認すると、プロトコルの項目を何度も変更せずに問題を切り分けられます。
ダウンロードへ →v2rayNはデスクトップGUIを備えています。ダウンロードページではdeb・rpm形式を中心に、対応するarm64版も案内しています。Debian・Ubuntu系とFedora系ではパッケージ管理の方法が異なります。ディストリビューションとプロセッサのアーキテクチャを先に確認し、インストール形式とプロトコルの種類を混同しないようにしてください。
デスクトップ環境のシステムプロキシ設定が、すべてのアプリで使われるとは限りません。ブラウザーは接続できるのにほかのアプリが接続できない場合は、アプリ独自のプロキシ設定を確認してください。自動起動はクライアントが正常に接続できることを確認してから設定しましょう。設定ミスをログインのたびに持ち込むのを防げます。
ダウンロードへ →設定の見取り図 / 4つの問題を分けて確認
接続設定はサーバー情報を示し、プロキシモードはアプリの接続方法を決め、ルーティングルールは通信の行き先を決めます。それぞれを分けて確認すれば、「起動している」ことと「実際に機能している」ことを取り違えずに済みます。以下の設定例は画面上の概念を説明するもので、接続に使えるサーバー設定ではありません。
設定の追加方法 / 読み込み方法
共有リンクは通常、1件分のサーバー設定を表します。サブスクリプションURLは複数の設定を取得し、後から更新するためのものです。リンクを受け取ったら、用途に応じて読み込み方法を選んでください。個別のリンクはクリップボードやQRコードから読み込み、サブスクリプションURLはグループに追加します。読み込みに成功しても、クライアントが内容を認識しただけで、サーバーが利用可能とは限りません。サブスクリプションを更新する前に手動設定を残し、更新後はノード名、プロトコル、転送パラメーターを確認してください。サブスクリプションURLにはアクセス認証情報が含まれる場合があります。URL全体やURLが写ったスクリーンショットを公開しないでください。問い合わせる際は、情報を伏せた項目だけを共有してください。
サブスクリプションの読み込み手順を見る →接続方法 / 設定例
システムプロキシは、ローカルプロキシのアドレスをOSの設定に登録します。ただし、そのアドレスを使うかどうかはアプリによって異なります。Tunモードは仮想ネットワークインターフェースを通じて通信を取り込みます。通常は追加の権限が必要で、ルーティングやDNSとの連携も関係します。初回設定では、まずシステムプロキシでブラウザーの接続を確認し、Tunが必要か判断してください。どちらもプロトコルではなく、サーバー設定の代わりにもなりません。有効化後に問題が起きた場合は、追加の接続方法をいったん無効にし、明確なテスト経路を1つ残したうえで、権限、ポート、ほかのネットワークツールとの競合を順に確認してください。
プロキシモードの説明を見る →通信の行き先 / ルールの基本
ルーティングルールは、一致したドメイン、アドレス、その他の接続条件に応じて、指定の接続先へ通信を振り分けます。ルールは通常、記載順に判定されます。個別のルールは、それを上書きする可能性のある広範なルールより前に設定してください。普段はクライアント内蔵のルールを使い、明確な必要がある場合だけ例外を追加するとよいでしょう。変更前に現在の設定を記録し、変更後はプロキシ経由と直接接続の両方を確認してください。グローバルプロキシもルーティング方法の1つにすぎず、クライアントを経由しないアプリの通信まで自動的に取り込むわけではありません。DNSの解決場所や結果もルール判定に影響する場合があるため、ログとあわせて確認してください。
プロトコルとルーティングの違いを見る →確認の順序 / 段階的な切り分け
ポートへの接続に成功しても、プロトコルのハンドシェイク、認証、接続先へのアクセスがすべて成功したとは限りません。ノードを選んだら、クライアントの接続テストを実行し、システムプロキシが現在の待受ポートを参照しているか確認してから、ブラウザーでアクセスしてログを見てください。トレイアイコンや1つのテスト結果だけで判断しないようにしましょう。失敗した場合は、接続タイムアウト、認証エラー、名前解決エラーを切り分けます。一度に変更するパラメーターの種類を1つに絞り、同じ接続先で再テストすると、変更によって問題が解決したか判断できます。
接続トラブルの対処方法を見る →VMess、VLESS、Trojan、Shadowsocksはそれぞれ設計上の特徴が異なります。実際の使い勝手は、転送方式、セキュリティ層、サーバー負荷、ネットワーク経路にも左右されます。まず設定の互換性を確認し、同じ環境で実際にアクセスして比較してください。プロトコル名だけで性能を判断することはできません。
プロトコル選びの参考情報を見る →クライアント、コア、ルールデータはそれぞれ別々に更新されることがあります。アップデート前に現在使えている設定を残し、使用中のコアと接続方法を記録してください。アップデート後は元の接続を確認してから新機能を有効にすると、複数の箇所を一度に変更して互換性の問題を特定しにくくなるのを防げます。
コアとクライアントの用語を見る →オープンソース生態系 / UIとコアの役割
V2RayはProject Vエコシステムに属するプロキシツールのプロジェクトです。このエコシステムを理解するには、クライアントは画面上の操作を担い、コアは接続とルーティングを処理し、プロトコルは通信方式を定める、という3つの役割を分けて考えます。ダウンロードするのはGUIクライアント、選択するのはサーバー設定、実際に接続を処理するのはクライアントが呼び出すコアです。3つの名称は一致するとは限らず、相互に置き換えられるものでもありません。
v2rayN
v2rayNG / v2flyNG
設定の読み込み、サブスクリプション管理、ノード選択、ログ確認。
Xray
V2Fly
プロトコルのハンドシェイク、転送処理、ルーティング判定、外部への接続。
Project Vは、プロキシ機能をインバウンド、アウトバウンド、ルーティング、転送などのモジュールに分けています。インバウンドは端末上のアプリから接続を受け取り、ルーティングは接続先のアウトバウンドを選び、アウトバウンドが対応するプロトコルでリモートサーバーと通信します。GUIクライアントは、これらの概念をメニューや設定項目にまとめているため、日常の操作で最初から完全な設定ファイルを扱う必要はありません。問題が起きたときはこの処理の流れに沿って確認すると、何度も再インストールするより効果的です。
日常会話では、V2Rayがこうしたクライアント全般を指す言葉として使われることもありますが、特定のGUIクライアントと同じ意味ではありません。「V2Ray 公式サイト」を検索する際は、コアのプロジェクト、クライアントのプロジェクト、日本語の情報サイトを区別してください。当サイトではダウンロード先と使い方を案内しています。クライアントにそのまま使えるリモートサーバーは含まれません。接続パラメーターは、実際に利用でき、利用権限のあるサーバーから取得する必要があります。
V2FlyはV2Rayコアのコミュニティ開発を引き継ぎ、Xrayは関連コードをもとに発展したコアのフォークです。共通する概念や設定方法がある一方、それぞれ独自に進化した機能もあります。設定を読み込めたからといって、両方のコアで同じように実行できるとは限りません。特定のプロトコルの組み合わせ、転送パラメーター、セキュリティ層は、実際に使うコアの対応状況を確認してください。
たとえばREALITYはセキュリティ層に関わる機能であり、すべてのプロキシプロトコルと同じ階層にある独立したクライアントではありません。この種のパラメーターを含む設定を選ぶ際は、クライアントが項目を認識するか、コアが該当する組み合わせに対応するか、サーバー側の設定と一致するかをあわせて確認してください。同じプロトコル名でも、ポート、サーバー名、公開鍵などの項目を自由に使い回せるわけではありません。
v2rayNはデスクトップ向けで、サーバー一覧、サブスクリプショングループ、システムプロキシ、ルーティングなどをGUIで管理できます。利用できるコアは、配布内容と設定によって異なります。v2rayNGはAndroid向けで、Xrayコアを採用しています。v2flyNGもAndroid向けで、V2Flyコアを使って設定を実行します。選ぶ際は、まずOSを確認し、次に現在のサーバー設定に必要な機能を確認してください。
3つのクライアントはいずれもオープンソースプロジェクトで、公開ソースコードから機能の実装や変更の経緯を確認できます。オープンソースとは、コードの入手方法とライセンスに関するもので、各プロジェクトのメンテナンス頻度が同じという意味ではありません。GUIクライアントと同梱されるコアでライセンスが異なる場合もあります。再配布や二次開発を行う際は、それぞれのコンポーネントのライセンスと告知を確認してください。
クライアントの更新では、メニュー、読み込み時の解析、権限の扱い、コアの呼び出し方などが変わる場合があります。コアの更新ではプロトコルの実装や設定要件が、ルールデータの更新ではドメイン分類やルーティングの判定結果が変わる可能性があります。更新を別々のレイヤーの変更として捉えると、「更新後に接続できない」原因がどの段階にあるのか特定しやすくなります。ノードの問題だと決めつけないようにしましょう。
サブスクリプションの形式にも違いがあります。サブスクリプションURLは、共有リンクの一覧や特定形式の完全な設定を返す場合があり、クライアントが処理できるのは対応形式に限られます。読み込みに失敗した場合は、まず形式と取得内容を確認し、URLが完全か、アクセス認証情報が有効かを調べてください。サブスクリプションURLをブラウザー用のプロキシアドレスとして使わないでください。また、手動変更したノード設定が今後の更新後も保持されるとは限りません。
活用ガイド / プロトコル・エコシステム・プラットフォーム別
基本設定を読み込んだら、実際の課題に応じて詳しいガイドを確認してください。プロトコル選びでは設定の対応状況を、エコシステムの解説ではクライアントとコアの違いを、プラットフォーム別のガイドではインストール方法、システムプロキシ、自動起動を扱います。現在使えている設定を残し、変更のたびに動作を確認すると、一度の操作に複数の問題が重なるのを防げます。
Debian/Ubuntu系およびFedora系ディストリビューションにdeb・rpmパッケージでv2rayNデスクトップ版をインストールし、自動起動とシステムプロキシを設定する方法、よくある依存関係の問題を解説します。
まずディストリビューションとアーキテクチャを確認し、手動で起動して接続をテストします。インストール、デスクトップセッション、プロキシ設定を分けて説明し、「起動できるのにアプリがプロキシを使わない」といったレイヤーをまたぐ問題を切り分けます。
インストール手順を読む →Project Vの成り立ち、V2FlyとXrayの2つのコアの役割、v2rayN・v2rayNG・v2flyNGそれぞれが採用するコアと対応プラットフォームを整理します。
画面上のクライアント名から、実際に接続を処理するコンポーネントへと視点を移し、読み込みに成功してもコアに対応しているとは限らない理由を解説します。クライアントの切り替え、設定の移行、プロトコルパラメーターの確認前に、基本を押さえたい方に適しています。
エコシステムの解説を読む →4種類のプロキシプロトコルについて、設計思想、暗号化方式、リソース消費を比較。デスクトップでの日常利用、モバイル端末の省電力、複数端末での共有など、用途に応じた選び方を紹介します。
プロトコルだけでなく、転送方式とセキュリティ層もハンドシェイクやリソース消費に影響します。それぞれの要素を分けて解説し、名称の新しさ、パラメーターの多さ、単発のテスト結果だけで普遍的な性能順位を決めないためのポイントを紹介します。
プロトコル比較を読む →