GUIクライアント · ダウンロードと設定
デスクトップではv2rayN、Androidではv2rayNGを選びます。まずサブスクリプションの追加とルーティングから始め、メニューに沿って接続を設定しましょう。
CLIENT SETTINGS
サーバー設定、ルーティングルール、システムプロキシの役割をまず区別しましょう。それぞれ接続先、通信の出口、クライアントに通信を渡すアプリを決めます。以下は設定画面のイメージです。実際のメニューはクライアントの更新により変わる場合があります。
v2rayNの「サブスクリプショングループ → サブスクリプショングループ設定」でグループを作成し、分かりやすい名前とサブスクリプションURLを入力して保存してから更新します。グループを使うと、提供元ごとにサーバー一覧を分けて管理でき、更新時の混同を防げます。初回接続前は、まず「サブスクリプションを更新（プロキシを使わない）」を試してください。利用可能なプロキシがすでにあり、URLへのアクセスに必要な場合だけ、プロキシ経由で更新します。共有リンクは通常、個別のサーバー設定を示します。一方、サブスクリプションURLからは複数の設定を取得するため、それぞれ対応する追加メニューを使いましょう。更新後、一覧に項目が表示されたことを確認してからサーバーを選び、接続をテストします。
ルーティングでは、リクエストの出口を直接接続、プロキシ、ブロックに振り分けます。サーバーの接続設定を変更するものではありません。まず組み込みのルーティング設定で基本動作を確認し、ルーティング設定からドメインやIPアドレスのルールを追加します。ルールは通常、上から順に照合されるため、具体的なドメインは範囲の広いルールより前に配置します。「IPIfNonMatch」は、ドメインルールに一致しない場合にアドレスを解決してIPルールも照合する設定です。名前解決の負荷が増えることがあります。システムプロキシの切り替えと異なり、ルーティングが制御するのはリクエストがコアに入った後の経路です。アプリがプロキシを使っていなければ、ルールが正しくても適用されません。
ブラウザーなど、システムプロキシに従うアプリでは、まず「システムプロキシを自動設定」を試します。システムのプロキシ設定を書き換えますが、すべてのアプリがその設定を使うとは限りません。システムプロキシを無視するアプリでは、Tunの利用を検討してください。仮想ネットワークインターフェースで通信を処理するため、管理者権限やルーティング、DNSの設定が必要になる場合があります。最初のトラブルシューティングでは、通信を制御するツールを同時に複数起動しないでください。設定が互いに上書きされることがあります。クライアントを終了する前に、「システムプロキシを解除」する必要があるか確認しましょう。Androidでは、システムのVPN許可と、同じインターフェースを使用する他のVPNアプリにも注意してください。
XrayとV2Flyは共通のエコシステムを持ちますが、プロトコルの拡張、設定項目、機能の対応状況は完全には一致しません。コアをまたいで設定を移行する場合は、共有リンクを追加できるかだけでなく、利用するクライアントで選べるコアを確認してください。v2rayNGはXrayを使用し、v2flyNGはV2Fly系です。別々にインストールするクライアントであり、同じボタンで切り替えるものではありません。デスクトップでも、現行バージョンで選択可能なコアを確認しましょう。コアを変更したらサービスを再起動し、起動ログを確認してから接続をテストします。未対応の設定項目がある場合は互換性を見直し、ルーティングを何度も切り替えて対処しないでください。
PLATFORM SELECTOR
インストーラーは、まずOSとCPUアーキテクチャを確認し、次にパッケージ形式を選びます。デスクトップではv2rayN、Androidではまずv2rayNGを確認してください。V2Flyコアとの互換性が必要な場合はv2flyNGが候補です。各OSのダウンロードページで配布先とインストール要件を案内しています。
初めてインストールする場合は、クロスプラットフォームのデスクトップ版を確認してください。従来のウィンドウレイアウトに慣れている方は、WPF版も選べます。どちらの画面でも正しいサーバー設定が必要で、見た目だけではプロトコルの対応状況は判断できません。インストール前に「設定 → システム → バージョン情報」でシステムの種類を確認し、ダウンロードページで対応するアーキテクチャを選びましょう。
起動したら、まず利用可能な設定を1つ追加してサーバーを選び、システムプロキシとルーティングモードを設定します。通常のブラウザーで接続できることを確認してから、Tunが必要か検討してください。Tunの有効化時に権限不足が表示された場合は、案内に従って必要な権限で再起動します。サーバーのポートを続けて変更する必要はありません。インストール先を変更する前に設定をバックアップし、フォルダーの整理でサブスクリプショングループやカスタムルーティングを失わないようにしましょう。
ダウンロードページへ →Appleメニューから「このMacについて」を開きます。Appleチップ搭載のデバイスではApple Silicon版、Intelプロセッサ搭載のデバイスではIntel版を選んでください。アーキテクチャを間違えると起動しなかったり、追加の互換環境が必要になったりすることがあります。インストール後はクライアントを起動し、画面とログウィンドウが正常に開くことを確認してからサブスクリプションを追加しましょう。
プログラムは起動するのにブラウザーがプロキシを経由しない場合は、まず現在のネットワークサービスのプロキシ設定を確認し、次にブラウザー独自のプロキシ拡張機能を使っていないか確認します。Wi-Fiと有線LANでは、異なるシステム設定が適用される場合があります。システムのセキュリティ警告が表示された場合は、ダウンロード元と警告内容を確認し、OSが案内する手順で許可してください。システムの保護機能を無効にすることを通常のインストール手順にしないでください。
ダウンロードページへ →比較的新しいAndroidスマートフォンの多くはarm64版に対応しています。端末のアーキテクチャが分からない場合や、インストール時に非互換の警告が表示された場合は、汎用版を確認してください。まずXrayコアを採用するv2rayNGを選び、V2Flyコアとの互換性が必要な場合にv2flyNGを検討しましょう。グループ、アプリ設定、接続状態はそれぞれのクライアントで個別に保存されます。もう一方をインストールした場合も、設定を改めて確認してください。
初回接続時にシステムのVPN許可が求められます。許可すると、クライアントはそのインターフェースで通信を処理できます。他のVPNアプリを起動している場合は、いったん切断してからテストしてください。画面点灯中は使えるのに、ロック後に切断される場合は、バッテリー最適化、バックグラウンド動作の制限、省電力設定を確認しましょう。アプリごとの振り分けで特定のアプリが除外されていることもあります。ブラウザーが使えても、すべてのアプリが同じ経路を通るとは限りません。
ダウンロードページへ →まず、ディストリビューションで使われているパッケージ形式を確認します。DebianやUbuntu系では通常deb、Fedora系では通常rpmを選び、その後にx64かarm64かを確認してください。パッケージ形式とCPUアーキテクチャを混同しないようにしましょう。GUIクライアントを動かすには適切なデスクトップ環境が必要です。軽量構成のシステムやリモート端末のみの環境では、GUIを実行できるか事前に確認してください。
システムプロキシの仕組みはデスクトップ環境によって異なります。自動プロキシを設定した後、アプリがデスクトップのプロキシ設定を読み取るか確認してください。ターミナルのプログラムでは、個別にプロキシを設定する必要がある場合もあります。Tunは仮想インターフェースと権限を必要とするため、使用中のディストリビューションとクライアントの要件に従って設定しましょう。コアが起動しない場合は、ポートの競合、リソースのパス、権限に関するログを確認します。実行環境の問題をサブスクリプションの無効化と取り違えないようにしてください。
ダウンロードページへ →クライアントをダウンロードしても、用意できるのは端末上で動かすツールだけです。接続には有効なサーバー設定またはサブスクリプションURLが必要で、インストーラーに利用可能なサーバーは含まれていません。サブスクリプションURLにはアクセス情報が含まれる場合があります。スクリーンショットの共有やサポート依頼、ログの共有をする前に、URLや個人を特定できる情報を隠してください。
すべてのクライアントを見る →PROJECT V / CORE / CLIENT
クライアントとコアの役割を理解すると、設定移行時の見落としを減らせます。画面上の操作はクライアントが担当し、ネットワーク接続はコアが処理します。サブスクリプションサービスが設定を提供し、ルーティングルールがリクエストの行き先を決めます。どの層で問題が起きたかによって、確認する場所は異なります。
Project Vは、ネットワークプロキシツールを中心とするオープンソースプロジェクト群です。V2Rayはその中核として広く知られる名称です。V2Flyは関連コミュニティの開発方針を引き継ぎ、V2Rayコアと周辺機能を保守しています。一般に「V2Rayクライアント」と呼ばれるものは、単独で動くコアプログラムではなく、画面から管理できるツールを指すことが多いです。この違いを理解すると、機能が画面上のメニューで設定するものか、コアの対応に依存するものかを判断できます。
コアは通常、受信待ち受け、外向き接続、ルーティングの照合、DNSなどを処理します。GUIクライアントは、それらの設定をサーバー編集画面やサブスクリプショングループ、各種オプションにまとめます。画面上の設定を保存すると、クライアントがコア用の設定を生成または変更して、サービスを起動します。そのため、リンクを追加できたことは画面が内容を読み取れたことを示すだけです。サーバー情報が正しいことや、コアが正常に動作していることまでは保証しません。
XrayはV2Rayのエコシステムから発展し、プロトコルやトランスポート機能を独自に進化させています。VLESS、VMess、Trojanはそれぞれ異なるプロトコルを示し、REALITYは接続のセキュリティ機構に関わります。これらを互換性のあるノード種別として扱うことはできません。サーバーの構成に合わせて、プロトコル、トランスポート、セキュリティ設定と、使用するコアの対応機能を揃える必要があります。
設定を移行するときは、アドレス、ポート、ユーザーID、トランスポート方式、TLSまたはREALITYの設定を一つずつ確認してください。特定のコアでしか使えない項目もあり、クライアントの画面にすべての設定が表示されるとは限りません。「未知のフィールド」や未対応のセキュリティ方式が表示された場合は、まず互換性を確認しましょう。SNIをむやみに消したり、証明書の検証を無効にしたり、トランスポートのパスを書き換えたりすると、原因の特定がさらに難しくなることがあります。
v2rayNはデスクトップ向けのGUIクライアントで、サーバー、サブスクリプション、システムプロキシ、ルーティングを1つの画面で管理できます。v2rayNGはAndroid向けで、システムのVPNインターフェースを使ってアプリの通信を処理し、Xrayコアを採用しています。v2flyNGはV2Flyコアを使いたいAndroidユーザー向けの選択肢です。3つのプロジェクトは更新のペースが異なるため、一方のメニュー手順をそのまま他方に当てはめないでください。
3つのクライアントはGPL-3.0ライセンスで公開されています。コアや同梱コンポーネントについては、それぞれのライセンスも確認してください。オープンソースライセンスは、コードの利用、変更、再配布の条件を定めるもので、サーバーの利用規約に代わるものではなく、接続品質を決めるものでもありません。クライアントは無料で使えますが、サーバー、サブスクリプション、その他のネットワークサービスが有料かどうかは、各サービス提供元の規約を確認してください。
クライアントの更新によって、画面、設定の生成方法、コアの機能が変わる場合があります。アップデート前にサブスクリプショングループ、カスタムルーティング、重要な設定を保存し、正常に接続できる構成を記録してください。更新後は、同じサーバー、同じルーティング、同じネットワークでテストしてから、新しい機能を一つずつ有効にします。これなら、サーバー側の変動とアップデートによる変更を切り分けられます。一度にすべての条件を変えるのは避けましょう。
更新内容では、バージョン番号だけでなく、設定の移行、システム要件、コアの変更、既知の問題を確認してください。問題が起きた場合、ログに最初に記録されたエラーは、その後に繰り返されるエラーより重要なことがあります。サポートを依頼する前に、OS、クライアントの種類、操作手順、確認済みの項目を整理しましょう。ただし、サブスクリプションURL、ユーザーID、接続情報は必ず削除してください。詳しい手順はトラブルシューティングガイドをご覧ください。
TECHNICAL NOTES
技術ノートでは、設定項目ごとに手順を解説します。接続できていて通信の行き先を変えたい場合は、ルーティングの解説をご覧ください。サービスの起動失敗が表示された場合は、まずログと設定エラーを確認します。起動エラーが解決する前に、ルーティング方式を何度も変更しないでください。
コアが起動しないとき、ログのエラーをどう読み解くかを解説。ポートの競合、JSON構文エラー、未知のフィールド、geoファイルの不足を個別に特定して修正します。まず起動条件を整え、その後サーバーへの接続を確認しましょう。
技術ノートを読む →中国本土のサイトには直接接続し、それ以外のサイトはプロキシ経由、広告ドメインはブロックするルールを順に設定します。ルールの順序とドメイン判定ポリシーからリクエストの経路を確認し、範囲の広いルールが先に一致して個別ルールを妨げないようにしましょう。
技術ノートを読む →domain:、full:、regexp:、geosite:、geoip:などの照合方法を区別し、上から順に適用されるルールの優先順位を理解しましょう。カスタムドメインを追加する前に照合範囲を決め、ルールが参照するデータファイルを利用できるか確認してください。
技術ノートを読む →