サブスクリプション管理で接続設定を整理し、ルーティングで通信先を振り分けます。用途に応じてシステムプロキシまたはTUNモードを選択してください。
CONFIGURATION / WORKSPACE
GUIクライアントは設定を管理し、実際の接続はコアが処理します。まず設定の入手元を確認し、次に通信をクライアントへ取り込む方法を調整し、最後にルールの適用結果を確認しましょう。ここでは日常的な操作に沿って主な機能を説明します。設定例は項目間の関係を示すもので、接続設定一式ではありません。
サブスクリプションを使うと、複数のサーバー設定を1つのURLでまとめて管理できます。サブスクリプショングループの設定を開き、見分けやすい名前とURLを入力して保存したら、サブスクリプションを更新します。更新後に設定が一覧へ読み込まれます。共有リンクを1件ずつ貼り付ける方法に比べ、グループなら一括更新や入手元の区別が簡単です。ただし、更新によってグループ内の項目が置き換わる場合があります。手動で変更した項目は更新前に控え、更新後に使用中のサーバーを確認してください。サブスクリプションURLにはアクセス認証情報が含まれることがあるため、機密情報として保管しましょう。トラブル調査ではエラーの種類だけを記録し、URL全体を公開しないでください。
サブスクリプションURLの形式例（サンプルドメイン）：
https://example.com/subscription
操作手順：
サブスクリプショングループ → 追加 → 保存 → サブスクリプションを更新ルーティングでは、ドメインや宛先アドレスなどの条件に応じて、通信を指定したアウトバウンドへ振り分けます。主な処理は直接接続、プロキシ経由、遮断です。システムプロキシの切り替えとは異なり、ルーティングが制御するのは通信がコアに入った後の処理です。ルールは通常、上から順に照合されるため、明確な例外を広い条件より前に置き、指定したアウトバウンドのタグが存在することを確認してください。ドメイン分類には対応するルールデータベースも必要です。例では一致したドメインをdirectアウトバウンドへ渡します。これはルールの一部であり、直接接続用アウトバウンドを自動作成するものでも、DNS設定の代わりになるものでもありません。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}システムプロキシは、アプリがシステム設定を参照して通信する仕組みです。一方、TUNは仮想ネットワークアダプターを通じて、取り込み条件に合う通信を受け取ります。プロキシ設定を参照しないアプリにはTUNが役立ちます。両者は仕組みが異なるため、接続できないときの万能な解決策としてTUNを使うべきではありません。まず通常のプロキシでサーバーに接続できることを確認し、その後に権限、仮想ネットワークアダプター、DNS、デフォルトルートを調べてください。デスクトップでは管理者権限が必要な場合があり、モバイルではシステムの接続許可を確認します。有効化後にLANや既存の接続へ影響が出た場合は、まずTUNをオフにして元の状態へ戻し、除外ルールを1つずつ調整してください。
有効にする前に：
システムプロキシで接続をテスト → 成功を確認
ほかの通信取り込みツール → 競合するプロセスを一時停止
TUNモード → オン
確認項目 → ドメイン解決 / LAN / 対象アプリGUIと接続コアは別の役割を担います。GUIはサブスクリプションや設定を保存し、コアは設定を読み込んで接続を確立します。v2rayNで選べるコアは、クライアントのビルドやプロトコル対応状況によって異なります。v2rayNGはXrayコアを使用し、v2flyNGはV2Fly系の選択肢です。クライアント名だけで判断するより、プロトコル、トランスポート、安全性に関するパラメーターを確認するほうが互換性を見極めやすくなります。切り替え前に現在の設定を保存し、切り替え後は起動ログを確認してください。項目が認識されない場合、サーバーアドレスやポートを何度も変更するのではなく、まず対応範囲を確認しましょう。
コアの種類：
Xray → プロトコル、トランスポート、安全性のパラメーターを確認
V2Fly → 設定形式と対応範囲を確認
トラブルシューティングの順序：
設定の解析 → コアの起動 → 接続の確立 → アプリからのリクエストデスクトップではv2rayNでサブスクリプションやルーティングを管理し、モバイルではv2rayNGまたはv2flyNGを選べます。サブスクリプションの入手元はプラットフォーム間で共通にできますが、システムプロキシ、権限の付与方法、インストールパッケージのアーキテクチャはそのまま流用できません。拡張子だけでパッケージを選ぶより、プロセッサのアーキテクチャとOSのバージョンを先に確認するほうが確実です。移行時はクライアント設定、ルールデータベース、システムによる通信取り込みの状態をそれぞれ確認し、URLを読み込めばすべての設定が同期されると思い込まないでください。初回インストールでは初期設定を維持し、基本的な接続を確認してから自動起動や詳細なルーティングを設定しましょう。
デスクトップの設定管理：v2rayN
モバイルの設定管理：v2rayNG / v2flyNG
パッケージ選択の順序：
OS → プロセッサアーキテクチャ → パッケージ形式 → インストール方法CLIENT / PLATFORM
まずシステム情報でプロセッサのアーキテクチャを確認し、該当するダウンロード項目を選んでください。デスクトップではv2rayNを基本とし、Androidでは必要なコアに合わせてクライアントを選びます。クライアントは端末上の設定を管理するもので、インストールしただけでは利用可能なサーバーは用意されません。利用権限のあるサブスクリプションまたは設定を別途準備してください。
v2rayNにはデスクトップ版と従来型のWPF版があります。デスクトップ版はクロスプラットフォームのUIを採用し、WPF版は従来のデスクトップ操作を引き継いでいます。ダウンロード前にOSの種類と動作要件を確認してください。インストール後は、設定を保存できないといった権限の問題を避けるため、書き込み可能な場所にアプリと設定を配置しましょう。
初回起動時はサブスクリプションを読み込み、サーバーを選んでからシステムプロキシの自動設定を有効にします。ブラウザーでは接続できてもほかのアプリで使えない場合は、そのアプリがシステムプロキシを参照するか確認してください。すぐにサブスクリプションの問題だと決めつけないようにしましょう。より広範な通信の取り込みが必要な場合は、ガイドに沿ってTUNに必要な権限を確認してください。
ダウンロードへv2rayNはApple SiliconとIntelでインストールパッケージが異なります。「このMacについて」でチップまたはプロセッサの情報を確認し、適切なアーキテクチャを選んでください。インストール後はアプリケーションフォルダから起動します。開発元の確認を求められた場合は、アプリの入手元を確認してから、システムのセキュリティ設定で許可してください。
システムプロキシと仮想ネットワークアダプターによる通信取り込みでは、異なるシステム機能を使います。初回設定では、まず通常のプロキシ接続を確認し、ブラウザーのリクエストとクライアントログを見てください。ネットワーク拡張、権限、ほかの接続ツールとの競合が起きた場合は、現在の状態を記録し、項目ごとに調べましょう。複数のネットワーク設定を一度に変更しないでください。
ダウンロードへまずXrayコアを使用するv2rayNGを確認してください。V2Flyコアが必要な場合はv2flyNGを選べます。比較的新しい一般的な端末ではarm64版が候補です。アーキテクチャがわからない場合は、端末の仕様またはユニバーサル版の説明を確認してください。インストール許可は利用する入手元に限って有効にし、インストール後は必要に応じて設定を元に戻しましょう。
サブスクリプションを読み込んで更新し、設定を選択して接続を開始します。初回起動時はシステムの接続許可が必要です。省電力設定によってバックグラウンド接続が切れる場合があるため、端末の設定で必要なバックグラウンド動作を許可してください。クライアントを切り替える前に既存の接続を停止し、通信取り込み機能の競合を防ぎましょう。
ダウンロードへv2rayNではdeb版とrpm版を用意しており、x64とarm64に対応しています。DebianやUbuntu系では通常deb、Fedoraなどでは通常rpmを選びますが、実際には各ディストリビューションのパッケージ管理方式に従ってください。まずデスクトップ環境での起動と依存関係を確認し、その後、ユーザーセッションで自動起動を設定しましょう。
デスクトップ環境によってシステムプロキシの対応状況は異なり、アプリごとにプロキシを設定する必要がある場合もあります。インストール後はGUI、コアの起動、アプリからのリクエストをそれぞれ確認してください。TUNに必要な権限やネットワークルートも別途設定が必要です。パッケージのインストールに成功しただけで、通信の取り込みが有効になったとは判断できません。
ダウンロードへQUICKSTART / THREE STEPS
設定、通信の取り込み、動作確認を分けて進めましょう。問題の発生箇所を切り分けやすくなり、変更に失敗しても前の状態へ戻せます。デスクトップ版ではv2rayNを例に説明します。Androidのv2rayNGでは操作名が異なる場合がありますが、手順は同じです。
サブスクリプショングループを開き、名前と完全なURLを追加して保存した後、更新を実行します。URL末尾のクエリパラメーターが認証に使われる場合があるため、削除しないでください。チャットや文書からコピーした場合は、空白、改行、日本語の句読点が混入していないか確認します。更新が完了すると、設定がサーバー一覧に表示されます。
一覧が空の場合は、選択中のグループを確認してから更新ログを見てください。Webページの内容が返る、認証に失敗する、解析に失敗する、といった問題は原因が異なるため、それぞれ対処が必要です。個別に共有されたリンクは、対応する読み込み画面から使用してください。見た目だけでサブスクリプションURLと判断して入力しないようにしましょう。
使う設定を選択してアクティブサーバーに設定し、まずは用途に合ったルーティングプリセットを維持してください。デスクトップではシステムプロキシの自動設定を有効にし、システム設定を参照するブラウザーでテストします。Androidでは接続開始時にシステムの許可を確認し、ステータスバーに接続中のアイコンが表示されるか確認してください。
システムプロキシはアプリからローカルの接続先へリクエストを渡す方法を制御し、ルーティングはリクエストを受け取ったコアがどのアウトバウンドを選ぶかを決めます。両者は代替関係ではありません。まず通常の接続を確認し、その後にTUNを検討してください。DNS、ルーティング、通信の取り込み方法を同時に変えると、問題発生時に原因を特定しにくくなります。
対象ページを開き、ログからリクエストがクライアントに届いているか、コアが起動しているか、接続先から応答があるかを確認します。1回の接続テストでわかるのは、そのテスト経路の結果だけです。すべてのアプリ、ドメイン、トランスポートが使えるとは限りません。確認中は直接接続するケースも残し、LAN内のサービスへ引き続きアクセスできることを確認しましょう。
接続に失敗した場合は、設定の解析、コアの起動、ドメイン解決、接続の確立の順に原因を調べます。エラーの種類と発生させた操作を記録し、ログを共有する前にサブスクリプションURLや個人情報を削除してください。クライアントを終了する際は、アプリが閉じたローカルポートへリクエストを送り続けないよう、先にシステムプロキシを解除しましょう。
PROJECT V / CORE / CLIENT
V2Ray、V2Fly、Xray、GUIクライアントは、それぞれ異なるコンポーネントです。ソフトウェア名だけを比べるより、各コンポーネントの役割を把握するほうが選びやすく、設定トラブルの原因も絞り込めます。
CONCEPT
モジュール型プロキシとルーティング設計
CORE FAMILY
設定の解析、トランスポート、アウトバウンド処理
GRAPHICAL CLIENT
サブスクリプション、GUI、システム設定
Project Vは、V2Rayの技術的な背景を理解するための出発点です。モジュール型の設計により、インバウンド、アウトバウンド、トランスポート、ルーティングなどの役割が分けられています。V2FlyコミュニティはV2Rayの開発と保守を引き継ぎ、Xrayは関連するコードを基盤に別のコアとして発展しました。共通する技術的な背景はありますが、機能の進化や設定項目への対応状況は同じではありません。同じプロトコル名が使われていても、トランスポート方式や安全性に関するパラメーターを確認してください。それだけで設定をそのまま相互利用できるとは限りません。
実際の接続を確立するのはコアで、GUIクライアントは設定の生成、保存、整理を担います。起動に失敗した場合は、まずコアの解析ログを確認してください。サブスクリプショングループ、画面上の設定、自動起動だけに問題がある場合は、クライアント側の確認が必要です。役割を分けて調べれば、画面設定を何度も変更する一方で、コアが未対応のプロトコル項目を見落とす事態を避けられます。
v2rayNはデスクトップ向けで、サーバー一覧、サブスクリプショングループ、ルーティング、システムプロキシなどを管理できます。v2rayNGはAndroid向けで、Xrayコアを使用します。v2flyNGもAndroid向けのクライアントで、V2Flyコアを採用した選択肢です。いずれもオープンソースプロジェクトを基盤としていますが、同一プログラムの別名ではありません。設定画面、システム権限、対応機能をそれぞれ確認してください。まず端末のプラットフォームで候補を絞り、必要なプロトコルとコアの互換性をもとに選びましょう。
オープンソースライセンスには、コードの使用、変更、再配布に関する条件が定められていますが、すべての実行環境での互換性を保証するものではありません。V2FlyのV2RayとXray-coreでは、採用するライセンスの系統が異なります。GUIクライアントや同梱コンポーネントにも、それぞれ別のライセンスが適用される場合があります。通常の利用と再パッケージしての配布は別のケースです。再配布する場合は、各配布物に含まれるライセンスファイルを確認し、必要な著作権表示とライセンス表示を残してください。
クライアント、コア、ルールデータベース、サブスクリプションは、それぞれ別の更新対象です。クライアントの更新は画面や設定の生成方法に影響し、コアの更新はプロトコル対応や接続動作に影響します。GeoIPとGeoSiteの更新は分類ルールの照合に、サブスクリプションの更新はサーバー項目の更新に関係します。どれか1つを更新しても、ほかの対象まで同期されるわけではありません。ルールが機能しない場合は、使用しているタグ、ルールデータベースの入手元、読み込み先を確認してください。サブスクリプションの更新だけを繰り返しても解決しないことがあります。
変更前に現在使える設定を保存し、変更する項目を記録しておきましょう。一度に変更する対象は1種類に絞り、同じリクエストで結果を再確認します。異常があれば、原因を特定して元に戻しやすくなります。サーバーのパラメーターに関する問題は、設定の提供元にも確認が必要です。クライアント自体がサーバーを提供したり、無効になった認証情報を自動修復したりすることはありません。プラットフォームごとの違いやインストール方法は、全プラットフォームのインストール・設定ガイドをご覧ください。
NOTES / CONFIGURATION
実際の操作に沿って、まずメイン画面の設定項目を確認し、次にコアの役割を理解し、最後に振り分けに使うルールデータベースを管理しましょう。記事内の設定例は、使用中のクライアントとコアの対応状況に合わせて利用してください。変更後はログと実際のリクエスト結果を確認しましょう。
GeoIPとGeoSiteのルールデータベースの役割や違いを解説し、v2rayN・v2rayNGでのルールファイル更新手順と、geosite:cnなどを使ったルーティング設定を紹介します。
Project VからV2Flyコミュニティによる保守、さらにXrayの派生に至る流れを整理し、3つのGUIクライアントが採用するコアと、選ぶ際に確認したい設定条件を解説します。
v2rayNのメイン画面を項目ごとに解説します。サーバー一覧の右クリック操作、サブスクリプショングループの更新方法、ログパネルの見方、パラメーター設定でよく変更する項目を紹介します。