オープンソースクライアント · 日本語設定ガイド
デスクトップではv2rayN、Androidではv2rayNGを使用します。手順に沿ってサブスクリプション、ルーティング、DNSを設定したら、アプリの通信がプロキシ経由になっているか確認しましょう。
PROJECT V / V2FLY / XRAY
まず、コアとクライアントを区別しましょう。コアはプロトコル、接続、ルーティングを処理し、GUIクライアントはサブスクリプション、各種設定、プロセスを管理します。名前が似ていても、コアの機能や設定項目が完全に同じとは限りません。
Project Vは、V2Rayの技術的な背景を知るための出発点です。V2Rayでは、インバウンド、アウトバウンド、ルーティング、トランスポートを組み合わせ可能な設定モジュールとして扱います。ローカルのリスナーでアプリからのリクエストを受け取り、ルールに応じて異なるアウトバウンドへ振り分けられます。このモジュール構造を踏まえると、クライアントでシステムプロキシ、サーバー、ルーティングを個別に設定する理由も理解できます。接続スイッチだけで完結する仕組みではありません。
プロジェクト紹介を見る →V2Flyは、V2Rayのメンテナンスを継続しているコミュニティプロジェクトで、コアの実装にもモジュール型の設定思想が受け継がれています。v2flyNGは、このコア系列を採用したAndroid向けの選択肢です。特定の機能に依存する設定を使っている場合は、クライアントを選ぶ前にプロトコル、トランスポート、設定項目の対応状況を確認してください。同じサブスクリプションをインポートできても、すべての項目を現在のコアで実行できるとは限りません。
コアとクライアントの違いを見る →XrayはV2Rayの技術基盤から発展し、プロトコルやトランスポートの実装を独自の方針でメンテナンスしています。v2rayNGはXrayコアを採用し、v2rayNもXrayの設定管理によく使われます。VLESS、Trojan、REALITYはそれぞれ異なる階層の設定概念であり、相互に置き換えられるものではありません。利用できる組み合わせかどうかは、サーバー側の要件、クライアントの設定項目、コアの機能が合致するか確認してください。
応用設定を見る →v2rayNはデスクトップ向けで、サーバー一覧、サブスクリプショングループ、システムプロキシ、ルーティングを1つの画面で管理できます。v2rayNGはAndroid向けで、システムのVPNインターフェースを通じてアプリの通信を取り込み、アプリ別プロキシなどを設定できます。v2flyNGもAndroid向けで、V2Flyコアが必要な設定に適しています。いずれもオープンソースプロジェクトに基づいており、クライアントは無料で利用できます。サーバー情報やサブスクリプションは別途用意が必要です。ダウンロードしても、接続先が自動で作成されるわけではありません。
オープンソースライセンスには、コードの利用、改変、再配布に関する条件が定められています。各コンポーネントのライセンスは個別に確認してください。GUI、プロキシコア、ルーティング用データはそれぞれ別に更新される場合があるため、クライアント、サブスクリプション、ルールデータの更新は別々の作業です。アップグレード前にサブスクリプショングループ、カスタムルーティング、DNS設定をバックアップしましょう。アップグレード後は、まず従来の設定で動作を確認し、その後に新機能を1つずつ有効にします。エラーが発生した場合は、エラー箇所と関連設定を記録しておくと、何度も再インストールするより原因を絞り込みやすくなります。
当サイトでは、クライアントの選択、インストール、設定の手順を日本語で解説しています。プロジェクト名は技術的な関係を示すものであり、当サイトのブランドはProject V、V2Fly、Xray各プロジェクトの公式メンテナーを意味しません。画面例は設定の構成を示すもので、実際のメニュー名はインストールしたクライアントにより異なります。
まず、デバイスのOSとプロセッサのアーキテクチャを確認してから、インストーラーを選びます。デスクトップではv2rayN、Androidではv2rayNGが基本の選択肢です。V2Flyコアが必要な場合はv2flyNGも検討してください。ダウンロードページでは、入手先、対応条件、インストール前の確認事項をまとめています。
v2rayNを使用します。デスクトップ版にはクロスプラットフォームのGUIと、従来型のデスクトップ画面を備えたWPF版があります。まずシステムの「バージョン情報」でアーキテクチャを確認し、ダウンロードページの案内に沿って選択してください。画面が異なっても、サーバーが別になるわけではありません。移行前に設定をバックアップしましょう。
ダウンロードへv2rayNを使用します。「このMacについて」でチップ名を確認し、Apple Silicon用またはIntel用のインストーラーを選んでください。初回起動時はシステムの案内に従ってアクセス権を許可し、その後、ネットワークのプロキシ設定を確認します。他のプロキシツールが現在の設定を上書きしないよう注意してください。
ダウンロードへまずv2rayNGを選び、v2flyNGはコアの代替候補として検討してください。一般的なデバイスではarm64を選びます。アーキテクチャがわからない場合は、ユニバーサル版の説明を確認してください。初回接続時にはシステムのVPN接続要求を許可します。アプリ別プロキシを有効にする前に、通常の接続が正常に動作するか確認しましょう。
ダウンロードへv2rayNを使用します。Debian・Ubuntu系ではdeb、Fedoraなどではrpmを選び、x64またはarm64の違いも確認してください。デスクトップ環境のシステムプロキシと、ターミナルの環境変数は別々に適用されます。インストール後は、実際に使うアプリで動作を確認しましょう。
ダウンロードへインストール後は、まず既存のサブスクリプションまたはサーバー設定をインポートし、利用可能な項目を選択します。サブスクリプションは設定を更新するための入口であり、クライアントはその内容の読み込みと管理を担います。サブスクリプションURLは機密情報として扱い、公開画像に写したり、関係のない相手に共有したりしないでください。設定を復元する場合は、サブスクリプションの内容とクライアントの設定値のどちらを戻すのか、先に切り分けましょう。復元方法はそれぞれ異なります。
初めて使う場合は、システムプロキシまたは標準のVPNモードから始めるのがおすすめです。ブラウザーや普段使うアプリで動作を確認してから、ルーティング、LAN共有、TUNを設定します。一度に変更するのは1項目だけにし、正常に動作する基本設定を残しておくと、問題発生時に比較できます。
すべてのクライアントを見る →「設定の読み込み元 → 通信の経路 → 対象アプリ → ドメイン解決」の順に確認します。以下の設定例は展開した状態で表示しているため、項目ごとに比較できます。タブを切り替えると各手順のチェックポイントを確認できます。
まず設定が読み込まれているか確認します。更新後に、現在のグループとサーバー一覧を確認してください。一覧が空でも、ネットワーク接続の障害とは限りません。サブスクリプションの更新に失敗した場合は、ログに記録されたエラーの種類を確認してから、URLと更新方法をチェックします。
サブスクリプショングループの設定を確認 ↓次に、リクエストがどのアウトバウンドに振り分けられるか確認します。ルールは設定順に評価されるため、広範囲に一致するルールが先にリクエストを処理することがあります。変更前に現在のルーティングモードを記録し、検証時には同じ接続先を使って、サーバーの変更とルールの変更を混同しないようにしましょう。
ルーティングルールの設定を確認 ↓システムプロキシとVPNの対象範囲を区別します。システムプロキシを利用するには、アプリ側がその設定を読み取る必要があります。Androidのアプリ別プロキシは、許可リストか除外リストかによって動作が異なります。テスト前に、対象アプリがリストに含まれる場合の意味を確認しましょう。スイッチがオンかどうかだけでは判断できません。
対象アプリの設定を確認 ↓最後に、ドメインの名前解決経路を確認します。DNSサーバーに到達できなければ、その後の接続も確立できません。まず動作する基本的な名前解決設定に戻し、その後ルーティングやFakeDNSをテストします。複数の設定を同時に変えないようにしましょう。
DNS項目を確認 ↓「サブスクリプショングループ設定」で配信元ごとにグループを作成し、サブスクリプションURLをすべて入力してから更新します。グループは配信元を管理するためのもので、サーバーのプロトコルや利用可否を自動で変更するものではありません。更新後は、選択中のグループを確認し、名前で絞り込んで一覧を見やすくします。一覧が空の場合は、サブスクリプションの無効化と決めつけず、絞り込み条件を確認してください。共有リンクを個別にインポートする方法と異なり、サブスクリプションでは設定を継続的に更新できますが、手動で変更した項目が更新時に上書きされることもあります。重要な変更は別途保存しておきましょう。
サブスクリプショングループと複数購読の管理を見る →現在のグループを名前で絞り込む要件に近いルーティングプリセットを選び、必要最小限のカスタムルールを追加します。ドメインとIPアドレスではマッチ条件が異なり、ルールの順序も最終的な振り分けに影響します。例では、LAN内のアドレスを直接接続へ、サンプルドメインをプロキシへ振り分けています。これらはマッチ条件の書式を示す例であり、そのまま貼り付けて使える完全な設定ではありません。グローバルモードを切り替えるだけの場合と異なり、宛先ごとの振り分けではLANアクセスを維持できますが、DNSと宛先のマッチングの関係も把握する必要があります。変更後は保存し、同じ宛先で再テストしてください。
ルーティングルールとアウトバウンドのマッチングを見る →domain:example.comgeosite:privateip:192.168.0.0/16v2rayNGで初めて接続すると、システムからVPN権限を求められます。許可すると、仮想ネットワークインターフェースを通じて通信を取り込めるようになります。一部のアプリだけを対象にする場合は、「アプリ別プロキシ」で許可リストと除外リストのどちらが選択されているか確認してください。どちらのモードかによって、同じチェック操作の意味が変わります。デスクトップのシステムプロキシよりVPNモードのほうが広い範囲の通信を取り込みますが、実際の動作はアプリのリスト、ルーティング、システムの制限によって異なります。リストを変更したら、クライアントの案内に従って再接続し、バックグラウンド動作のバッテリー制限も確認してください。プロセスの停止をサーバーの切断と誤認するのを防げます。
Androidの接続と動作確認の手順を見る →ドメインには接続できないのに、IPアドレスを直接指定するとアクセスできる場合は、すぐにすべてのサーバーを変更せず、まずDNSログを確認します。名前解決リクエストがローカルネットワーク経由かプロキシ経由かを確認し、上流のリゾルバーに到達できるか調べてください。暗号化DNSのアドレスも、接続の前に名前解決が必要な場合があります。設定によっては起動時の依存関係が発生します。DNSアドレスを1つ変更するだけの方法に比べ、ドメインごとの振り分けは細かな制御が可能ですが、ルーティングとの整合性が必要です。FakeDNSは対応するアドレスを返すため、有効にする前に関連設定を確認してください。問題の切り分けでは、まず単純で検証しやすい名前解決経路に戻しましょう。
DNSの最適化とFakeDNSを見る →223.5.5.5https://dns.example.com/dns-queryUseIPv4まずコアのプロセスが起動していることを確認し、次にローカルのリッスンポート、システムプロキシまたはVPNの状態をチェックします。最後に、対象アプリからリクエストを送信してください。クライアントに「接続済み」と表示されても、接続処理が始まったことを示すだけで、アプリからの通信確認にはなりません。ブラウザーではアクセスできてもターミナルではできない場合は、ブラウザー拡張機能、ターミナルのプロキシ環境変数、アプリ固有の設定をそれぞれ確認します。ログから、エラーが名前解決、接続確立、プロトコルのハンドシェイクのどの段階で発生したかを確認できます。ログを共有する前に、サブスクリプションURL、個人情報、サーバーの認証情報を削除してください。
特定のサイトだけに問題がある場合は、クライアントとサーバーの設定を変えずに、まず別の宛先で再テストし、対象サイトに適用されるルーティングを確認します。すべてのアプリで問題が起きる場合は、ローカルネットワークとコアの動作状態を先に確認してください。影響範囲の小さいところから切り分けると、サブスクリプション、DNS、ルーティングの設定を次々に変更して原因の手がかりを失うのを防げます。基本的な手順は使い方ガイドを、症状に応じた対処方法はヘルプセンターをご覧ください。
まず、現在の症状に合った記事を読み、設定を変更する必要があるか判断してください。以下の記事は公開日の新しい順に並んでおり、アプリのプロキシ対象範囲、設定ファイルの構造、デスクトップへのインストールを扱っています。仮想NICやLAN共有が必要な場合は、記事一覧から関連する特集もご覧ください。
ブラウザーとターミナルを分けて確認します。ブラウザーでは拡張機能やプロキシ設定がシステム設定を上書きしていないか確認し、ターミナルではhttp_proxy環境変数を設定してコマンドで個別に検証します。まずアプリがどの階層の設定を参照するか確認してから、プロキシの入口を調整しましょう。
対処手順を読む →最小構成の設定を例に、log、inbounds、outbounds、routing、dnsの順で各項目の意味と相互参照を解説します。GUIでの設定からコアの設定ファイルを読む段階へ進む際の参考になります。
設定ファイル解説を読む →Debian/Ubuntu系とFedora系ディストリビューションのインストールコマンドをそれぞれ紹介し、依存関係、デスクトップエントリー、自動起動の設定、よくある権限エラーについて解説します。まず手動で起動できることを確認してから、ログイン後の自動起動を設定しましょう。
インストール手順を読む →