Project V エコシステム · クライアントガイド
V2Rayオープンソースガイドクライアントとルーティングの使い方
OSに合わせてオープンソースクライアントを選び、サブスクリプションの追加からルーティングまで、通信経路を順に確認します。
CORE Xray · V2Fly
OS 4プラットフォーム
CORE LICENSE MPL-2.0
PAGE00:00
01 エコシステムの概要
GUIクライアントとコア
クライアントは設定の編集・管理を担い、コアは接続の確立、リクエストの処理、ルーティング判定を担います。画面が開いていても、コアが正常に起動しているとは限りません。
- Project VV2RayはProject Vから始まりました。インバウンド、ルーティング、アウトバウンドはそれぞれ個別に設定されます。この構成を知っておくと、コアのログから問題箇所を切り分けやすくなります。
- V2FlyコミュニティがV2Rayコアのメンテナンスを引き継いでいます。v2flyNGを使う場合は、実際に使用するコアに対応したプロトコルやルールの項目を確認してください。
- XrayV2Rayエコシステムから派生したプロジェクトです。REALITYなどを設定する際は、Xrayのドキュメントでパラメーターを確認してください。
- MPL-2.0V2FlyのV2RayコアとXray-coreが採用するオープンソースライセンスです。各クライアントにはそれぞれ独自のライセンス表記があります。
02 設定の流れ
サブスクリプション、プロキシモード、ルーティングルール
設定の取得元、通信の取り込み、ルールの適用をそれぞれ確認します。問題が起きたら、まずどの段階に原因があるかを切り分けてから設定を変更しましょう。
例外ルールを先に設定し、デフォルトのアウトバウンドを決める
v2rayNのルーティング設定で、まず現在使用中のルールセットを確認し、適用順にアウトバウンドをチェックします。コアは通常、最初に一致したルールを適用するため、LANへの直接接続や特定ドメインのブロックは、対象範囲の広いルールより前に設定します。ドメイン条件とアドレス条件は個別に確認してください。同じルールに両方を設定しても、どちらか一方に一致すれば適用されるとは限りません。変更後はリクエストを再送し、ページが開くかどうかだけで判断せず、ログでアウトバウンドを確認します。
アウトバウンドの振り分け例。デフォルトのアウトバウンドは実際の設定によって異なります
geoip:private → direct
geosite:category-ads-all → block
geosite:cn → direct
サブスクリプションURLの登録とノードの更新は別の操作
v2rayNでは、まずサブスクリプショングループの設定を開き、グループを追加してURLを保存します。その後、サブスクリプショングループのメニューから更新します。読み込み後は該当グループに切り替え、ノードが一覧に表示されていることを確認してください。手動で追加した個別の設定は、グループの更新対象になりません。更新に失敗した場合は、取得、証明書の検証、内容の解析のどこでエラーになったかを確認し、単一ノードのリンクをサブスクリプションURL欄に入力していないかもチェックします。以前のノードがすでに接続できない場合、そのノード経由での更新も失敗することがあります。
v2rayNでサブスクリプションを更新する手順
サブスクリプショングループの設定 → グループを追加
サブスクリプションを更新 → 対象グループを確認
システムプロキシは通信の入口、ルーティングは出口を制御
v2rayNのシステムプロキシ設定が影響するのは、システムプロキシに従うアプリです。グローバルルーティングを選んでも、システムプロキシを無視するアプリが自動的に接続されるわけではありません。まずシステムプロキシを参照することが分かっているアプリで確認し、対象のプログラムが独自のネットワーク設定を使っていないか調べます。より広い範囲の通信を取り込む必要がある場合は、TUNモードを別途テストし、LANへのアクセスやシステムルートの変化にも注意してください。クライアントを終了する前にシステムプロキシを解除すると、アプリが停止済みのローカルポートへ接続し続けるのを防げます。
個別に確認する2つの設定
システムプロキシ → システムプロキシを設定 / システムプロキシを解除
ルーティング設定 → 使用するルールセットを選択
ドメイン、アドレス、名前解決ポリシーを分けて確認
GeoSiteはドメインの一覧、GeoIPはIPアドレスの一覧を提供します。クライアントがドメイン名を取得していれば、そのままドメイン条件で判定できます。アドレス条件を使うルールでは、現在のルーティングポリシーでドメインが名前解決されるかも確認が必要です。ルールセットの読み込みエラーが出た場合は、まずファイルのパスとカテゴリ名が正しいかを確認し、その後でデータファイルの更新を検討します。同じサイトでもブラウザーとほかのアプリで経路が異なる場合は、ブラウザー内蔵の暗号化DNSや、アプリがリクエスト時にドメイン名とIPアドレスのどちらを使っているかも確認してください。
2種類のルールセットは照合対象が異なる
geosite.dat → geosite:cn
geoip.dat → geoip:private
コアの起動ログから対象リクエストを追う
V2Rayに接続できない場合は、まずコアが起動しているか、ローカルで待ち受けているかを確認します。実際にリクエストを送り、その時刻のログと照らし合わせてください。待ち受けに失敗している場合は、別のプロセスがポートを使用していないか確認します。リモートへの接続で失敗する場合は、アドレス、プロトコル、トランスポート、セキュリティ設定を見直します。遅延テストに成功しても、その時点でテスト用リクエストが通ったことを示すだけで、すべてのアプリがプロキシを経由するとは限りません。原因を特定したら一度に一項目だけ変更してください。そうしないと、どの変更で接続が復旧したか分からなくなります。
リクエストの処理順に確認
コアの起動 → ローカル待ち受け → リモート接続 → 対象リクエスト
03 インストーラーの選び方
まずOSを選び、次にプロセッサのアーキテクチャを確認します。デスクトップではv2rayNを使用し、Androidでは必要なコアに応じてv2rayNGまたはv2flyNGを選びます。
すべてのクライアントを見る →
04 オープンソースエコシステム
Project V、V2Fly、Xrayの関係
設定を引き継げるか判断するには、ノード名や読み込み結果だけでなく、クライアント、コア、ルールセットを個別に確認する必要があります。
コアでリクエストが処理される流れ
inbound → routing → outbound
クライアントが設定を生成または読み込み、コアに届いたリクエストはルーティングルールに従ってアウトバウンドが選ばれます。
コアとルーティングの用語を見る →
このサイトのドキュメント範囲を見る →
-
Project V:インバウンドからアウトバウンドまでの設定モデル
Project VはV2Rayエコシステムの起点です。日常的な利用で特に重要なのが設定モデルです。インバウンドでリクエストを受け取り、ルーティングで通信をどのアウトバウンドに渡すか決め、アウトバウンドが直接接続、転送、または設定に応じて拒否します。GUIクライアントのノード一覧は設定の一部にすぎず、すべてのアプリのリクエストがコアに届くとは限りません。たとえばブラウザーと同じ端末のコマンドラインツールがそれぞれ別のプロキシ設定を持つ場合、同じアドレスにアクセスしても通信経路が異なることがあります。
そのため、デスクトップ画面でノードが選択されていても、コアが正常に待ち受けているか、対象アプリが実際にその待ち受け先へリクエストを送っているかを分けて確認する必要があります。ログに対象リクエストが記録されていない場合は、まずアプリの接続方法を確認してください。コアに届いていない通信は、リモート側のトランスポート設定を繰り返し変更しても経路が変わりません。
-
V2FlyとXray:共通する設定の考え方と異なる実装
V2FlyはコミュニティがV2Rayコアのメンテナンスを引き継いだプロジェクトです。Xrayはこの技術の流れから分かれ、独立したプロジェクトとして発展しました。インバウンド、ルーティング、アウトバウンドなどの基本概念は共通しますが、プロトコル、トランスポート方式、セキュリティ項目はそれぞれの実装に合わせて進化しています。クライアントが共有リンクを解析できても、リンクを認識したことを示すだけです。選択したコアがすべてのパラメーターに対応していることや、接続先が同じ組み合わせを使っていることまでは保証されません。
移行時はまずプロトコル、トランスポート、セキュリティ層を確認し、そのうえで使うクライアントとコアを選びます。たとえばREALITYのセキュリティ設定は、Xrayの該当ドキュメントに従って確認してください。共有リンクに表示されたプロトコル名だけで設定全体を判断しないようにします。通常の設定では接続できるのに特定のノードで未対応エラーが出る場合は、エラーの詳細を残し、そのノードの項目とコアの実装を優先して確認してください。
-
3つのオープンソースクライアントが管理するもの
v2rayNはデスクトップ向けGUIクライアントで、サブスクリプション、サービス設定、プロキシモード、ルーティングを管理します。利用できるコアは配布パッケージと設定によって異なります。v2rayNGはAndroid向けで、主にXrayの設定に対応します。v2flyNGもAndroid向けですが、V2Flyコアを使用します。どれもノードを管理できますが、画面上の選択肢、読み込み形式、デフォルトのルーティングが同じとは限りません。
初期設定の段階でAndroidクライアントを2つ同時にインストールする必要はありません。まずノードの要件に合わせてコアを選び、設定を1つ読み込んで基本動作をテストします。2つを比較する場合は、ネットワークと接続先を同じにし、各テスト中にVPNサービスを起動するクライアントが1つだけであることを確認してください。こうすれば、差がクライアント、コア、通信の取り込み方法のどこにあるかを切り分けられます。
-
オープンソースライセンスとコミュニティ配布
V2FlyのV2RayコアとXray-coreはMPL-2.0を採用しています。これはファイル単位のオープンソースライセンスです。対象となるコードを改変して配布する場合は、ライセンスに定められたソースコード公開などの義務を果たす必要があります。クライアントとコアは別々のプロジェクトであり、同梱されるほかのコンポーネントにも個別のライセンスが適用される場合があります。利用や再配布の際は、プロジェクトと配布パッケージに含まれる各コンポーネントのライセンス表記を確認してください。特定のコアのライセンスをクライアント全体のライセンスとみなさないようにしましょう。
コミュニティでは、画面、コアの実装、ルールデータがそれぞれ別にメンテナンスされています。ドキュメントに記載された設定名は機能を探すためのものです。すべての画面構成が同じという意味でも、クライアントを更新すればサブスクリプションやルールセットも自動で更新されるという意味でもありません。パッケージを選ぶときはOS、アーキテクチャ、コアの対応機能を確認し、問題の診断では端末上の設定と実際のログを基準にしてください。
-
サブスクリプション、ルールセット、クライアントは個別に更新
クライアントの更新で変わるのはプログラム、サブスクリプションの更新で変わるのはノードの取得元、ルールセットの更新で変わるのは照合用データです。これらは分けて実行するのがおすすめです。更新前に動作する設定をバックアップし、現在のルールセットとローカルの待ち受けポートを記録しておきます。更新後は同じ接続先で再テストし、ローカルサービスへの直接接続とプロキシが必要なリクエストが、それぞれ想定どおりの経路を通るか確認してください。
サブスクリプションの更新後に一部の設定だけ失敗する場合は、該当する設定のトランスポートパラメーターを比較します。ルールセットの更新後に特定のドメインだけ経路がおかしい場合は、カテゴリに変更がないか、先行ルールに一致していないかを確認してください。クライアントの更新後にすべてのリクエストが失敗する場合は、コアの起動ログと待ち受けエラーを先に確認します。変更範囲に応じて調査対象を絞るほうが、再インストール、サブスクリプション更新、DNS変更を同時に行うより原因を見つけやすくなります。
05 最新情報とトラブル対処
設定・トラブル対処の最新記事
起動に失敗したらローカルの待ち受け、インストールに失敗したらパッケージを確認。通信経路がおかしい場合はルーティングとルールセットを調べます。
· トラブル対処
OS標準のコマンドで10808・10809番ポートを使用中のプロセスを特定し、v2rayNでローカルSOCKS・HTTPの待ち受けポートを変更する手順と、変更後に合わせて更新すべき設定を解説します。
ポートを変更する前に、使用中のプロセスが起動済みのクライアントではないか確認してください。古いインスタンスなら、設定変更より終了して再起動するほうが簡単です。2つのプログラムを同時に使う必要がある場合は、それぞれに異なるポートを割り当てます。変更後は同じアプリで再テストし、古いプロキシアドレスが残っていないことも確認してください。
· プラットフォーム別
パッケージ選び、展開、初回起動、サブスクリプションの読み込みまでを順に解説。WPF版とDesktop版の違いや、ランタイム不足、セキュリティソフトによるブロック、日本語を含むパスなどのよくある問題もまとめています。
初回起動を切り分けの基準にします。画面が表示されない場合は実行環境を確認し、画面は表示されるのにノードがない場合は読み込みやサブスクリプションの更新を調べましょう。問題の種類によって確認すべきメッセージが異なります。
· 応用設定
geoip.datとgeosite.datの用途、クライアント内でルールセットを更新する手順、geosite:cnやgeoip:privateなどの一般的な記述をルーティングルールで組み合わせる方法を紹介します。
ルールを検証するときは、ドメイン名を使うリクエストとIPアドレスを直接使うリクエストをそれぞれ用意します。片方だけ経路がおかしい場合は、照合対象とルールの種類が一致しているかを確認してください。
すべての記事を見る →