Project V エコシステム · クライアントガイド

V2Rayオープンソースガイドクライアントとルーティングの使い方

OSに合わせてオープンソースクライアントを選び、サブスクリプションの追加からルーティングまで、通信経路を順に確認します。

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

03 インストーラーの選び方

OSとアーキテクチャに合ったファイルをダウンロード

まずOSを選び、次にプロセッサのアーキテクチャを確認します。デスクトップではv2rayNを使用し、Androidでは必要なコアに応じてv2rayNGまたはv2flyNGを選びます。

Windows

v2rayN Desktop / WPF

初めてインストールする場合はDesktop版がおすすめです。従来のWPF画面に慣れている場合は、クラシックWPF版を選べます。主な違いは画面とパッケージ形式であり、プロキシプロトコルが異なるわけではありません。システム情報でOSの種類を確認し、ダウンロードページの案内に従って実行環境を準備してください。

展開後は必要なファイルがそろったフォルダーから起動してください。実行ファイルだけをデスクトップに移して起動するのは避けましょう。移行時は古いフォルダーのユーザーデータを先にバックアップし、新しいプログラムがグループやノードを読み込めるか確認します。ダブルクリックしても画面が表示されない場合は、サブスクリプションを再読み込みする前に、ランタイム、フォルダーへの書き込み権限、セキュリティソフトの記録を確認してください。

ダウンロードページへ

macOS

v2rayN Apple Silicon / Intel

「このMacについて」のチップまたはプロセッサ欄を確認します。Apple Siliconならarm64、Intelならx64を選択してください。外観や購入年で判断せず、機種名を確認しましょう。同じシリーズでも世代によって搭載チップが異なる場合があります。

インストール後、接続可能と分かっている設定を1つ使い、クライアントがコアを起動できることを確認します。ブラウザーではアクセスできても特定のプログラムが接続できない場合は、そのプログラムがシステムプロキシを参照しているか確認してください。独自のプロキシ設定があるアプリでは、ローカルアドレス、待ち受けポート、プロキシの種類を個別に確認し、別のクライアントの設定をそのまま使わないようにします。

ダウンロードページへ

Android

v2rayNG / v2flyNG

v2rayNGはXrayコアを使用します。V2Flyコアが必要な場合はv2flyNGを選んでください。端末がarm64-v8aに対応していればarm64パッケージを選べます。対応アーキテクチャが分からない場合は汎用パッケージを確認してください。いずれもシステム要件を満たす必要があります。

プロキシサービスを初めて起動するときは、システムの案内に従ってVPN接続を許可します。VPNスロットを使用するほかのアプリがある場合は、先に接続を停止してからテストしてください。画面ロック後に接続が切れる場合は、VPNの状態、バックグラウンド制限、ネットワーク切り替えの履歴を個別に確認します。この現象だけでリモートノードが使えなくなったと判断しないでください。

ダウンロードページへ

Linux

v2rayN deb / rpm

DebianやUbuntu系ではdeb、FedoraなどRPMを採用するディストリビューションではrpmを確認してください。パッケージ形式とプロセッサアーキテクチャは別々の条件です。x86_64はx64、aarch64はarm64に対応します。パッケージ形式を変えても、アーキテクチャの不一致は解消できません。

インストール後は、デスクトップアプリとターミナルのプログラムをそれぞれテストします。デスクトップ環境のシステムプロキシがターミナルのプログラムにも適用されるとは限りません。ツールによっては独自のプロキシ設定や環境変数を使います。ターミナルだけで失敗する場合は、実際に参照している設定を確認してください。両方で失敗する場合は、クライアントのコア起動とローカル待ち受けを確認します。

ダウンロードページへ

04 オープンソースエコシステム

Project V、V2Fly、Xrayの関係

設定を引き継げるか判断するには、ノード名や読み込み結果だけでなく、クライアント、コア、ルールセットを個別に確認する必要があります。

コアでリクエストが処理される流れ

inbound → routing → outbound

クライアントが設定を生成または読み込み、コアに届いたリクエストはルーティングルールに従ってアウトバウンドが選ばれます。

コアとルーティングの用語を見る

このサイトのドキュメント範囲を見る

  1. Project V:インバウンドからアウトバウンドまでの設定モデル

    Project VはV2Rayエコシステムの起点です。日常的な利用で特に重要なのが設定モデルです。インバウンドでリクエストを受け取り、ルーティングで通信をどのアウトバウンドに渡すか決め、アウトバウンドが直接接続、転送、または設定に応じて拒否します。GUIクライアントのノード一覧は設定の一部にすぎず、すべてのアプリのリクエストがコアに届くとは限りません。たとえばブラウザーと同じ端末のコマンドラインツールがそれぞれ別のプロキシ設定を持つ場合、同じアドレスにアクセスしても通信経路が異なることがあります。

    そのため、デスクトップ画面でノードが選択されていても、コアが正常に待ち受けているか、対象アプリが実際にその待ち受け先へリクエストを送っているかを分けて確認する必要があります。ログに対象リクエストが記録されていない場合は、まずアプリの接続方法を確認してください。コアに届いていない通信は、リモート側のトランスポート設定を繰り返し変更しても経路が変わりません。

  2. V2FlyとXray:共通する設定の考え方と異なる実装

    V2FlyはコミュニティがV2Rayコアのメンテナンスを引き継いだプロジェクトです。Xrayはこの技術の流れから分かれ、独立したプロジェクトとして発展しました。インバウンド、ルーティング、アウトバウンドなどの基本概念は共通しますが、プロトコル、トランスポート方式、セキュリティ項目はそれぞれの実装に合わせて進化しています。クライアントが共有リンクを解析できても、リンクを認識したことを示すだけです。選択したコアがすべてのパラメーターに対応していることや、接続先が同じ組み合わせを使っていることまでは保証されません。

    移行時はまずプロトコル、トランスポート、セキュリティ層を確認し、そのうえで使うクライアントとコアを選びます。たとえばREALITYのセキュリティ設定は、Xrayの該当ドキュメントに従って確認してください。共有リンクに表示されたプロトコル名だけで設定全体を判断しないようにします。通常の設定では接続できるのに特定のノードで未対応エラーが出る場合は、エラーの詳細を残し、そのノードの項目とコアの実装を優先して確認してください。

  3. 3つのオープンソースクライアントが管理するもの

    v2rayNはデスクトップ向けGUIクライアントで、サブスクリプション、サービス設定、プロキシモード、ルーティングを管理します。利用できるコアは配布パッケージと設定によって異なります。v2rayNGはAndroid向けで、主にXrayの設定に対応します。v2flyNGもAndroid向けですが、V2Flyコアを使用します。どれもノードを管理できますが、画面上の選択肢、読み込み形式、デフォルトのルーティングが同じとは限りません。

    初期設定の段階でAndroidクライアントを2つ同時にインストールする必要はありません。まずノードの要件に合わせてコアを選び、設定を1つ読み込んで基本動作をテストします。2つを比較する場合は、ネットワークと接続先を同じにし、各テスト中にVPNサービスを起動するクライアントが1つだけであることを確認してください。こうすれば、差がクライアント、コア、通信の取り込み方法のどこにあるかを切り分けられます。

  4. オープンソースライセンスとコミュニティ配布

    V2FlyのV2RayコアとXray-coreはMPL-2.0を採用しています。これはファイル単位のオープンソースライセンスです。対象となるコードを改変して配布する場合は、ライセンスに定められたソースコード公開などの義務を果たす必要があります。クライアントとコアは別々のプロジェクトであり、同梱されるほかのコンポーネントにも個別のライセンスが適用される場合があります。利用や再配布の際は、プロジェクトと配布パッケージに含まれる各コンポーネントのライセンス表記を確認してください。特定のコアのライセンスをクライアント全体のライセンスとみなさないようにしましょう。

    コミュニティでは、画面、コアの実装、ルールデータがそれぞれ別にメンテナンスされています。ドキュメントに記載された設定名は機能を探すためのものです。すべての画面構成が同じという意味でも、クライアントを更新すればサブスクリプションやルールセットも自動で更新されるという意味でもありません。パッケージを選ぶときはOS、アーキテクチャ、コアの対応機能を確認し、問題の診断では端末上の設定と実際のログを基準にしてください。

  5. サブスクリプション、ルールセット、クライアントは個別に更新

    クライアントの更新で変わるのはプログラム、サブスクリプションの更新で変わるのはノードの取得元、ルールセットの更新で変わるのは照合用データです。これらは分けて実行するのがおすすめです。更新前に動作する設定をバックアップし、現在のルールセットとローカルの待ち受けポートを記録しておきます。更新後は同じ接続先で再テストし、ローカルサービスへの直接接続とプロキシが必要なリクエストが、それぞれ想定どおりの経路を通るか確認してください。

    サブスクリプションの更新後に一部の設定だけ失敗する場合は、該当する設定のトランスポートパラメーターを比較します。ルールセットの更新後に特定のドメインだけ経路がおかしい場合は、カテゴリに変更がないか、先行ルールに一致していないかを確認してください。クライアントの更新後にすべてのリクエストが失敗する場合は、コアの起動ログと待ち受けエラーを先に確認します。変更範囲に応じて調査対象を絞るほうが、再インストール、サブスクリプション更新、DNS変更を同時に行うより原因を見つけやすくなります。

05 最新情報とトラブル対処

設定・トラブル対処の最新記事

起動に失敗したらローカルの待ち受け、インストールに失敗したらパッケージを確認。通信経路がおかしい場合はルーティングとルールセットを調べます。

V2Rayのローカルポート競合を解消:競合プロセスの特定と待ち受けポートの変更

OS標準のコマンドで10808・10809番ポートを使用中のプロセスを特定し、v2rayNでローカルSOCKS・HTTPの待ち受けポートを変更する手順と、変更後に合わせて更新すべき設定を解説します。

ポートを変更する前に、使用中のプロセスが起動済みのクライアントではないか確認してください。古いインスタンスなら、設定変更より終了して再起動するほうが簡単です。2つのプログラムを同時に使う必要がある場合は、それぞれに異なるポートを割り当てます。変更後は同じアプリで再テストし、古いプロキシアドレスが残っていないことも確認してください。

v2rayN Windows版のインストールと設定:WPF版とDesktop版の選び方

パッケージ選び、展開、初回起動、サブスクリプションの読み込みまでを順に解説。WPF版とDesktop版の違いや、ランタイム不足、セキュリティソフトによるブロック、日本語を含むパスなどのよくある問題もまとめています。

初回起動を切り分けの基準にします。画面が表示されない場合は実行環境を確認し、画面は表示されるのにノードがない場合は読み込みやサブスクリプションの更新を調べましょう。問題の種類によって確認すべきメッセージが異なります。

GeoIP・GeoSiteルールセットの更新方法とルーティングルールの書き方

geoip.datとgeosite.datの用途、クライアント内でルールセットを更新する手順、geosite:cnやgeoip:privateなどの一般的な記述をルーティングルールで組み合わせる方法を紹介します。

ルールを検証するときは、ドメイン名を使うリクエストとIPアドレスを直接使うリクエストをそれぞれ用意します。片方だけ経路がおかしい場合は、照合対象とルールの種類が一致しているかを確認してください。

クライアントをダウンロード