Project V オープンソースクライアント

v2rayN 公式サイト · V2Ray クライアント ダウンロードと設定

デバイスに合わせてデスクトップ版またはAndroid版を選び、ガイドに沿ってサブスクリプションを追加し、ルーティングとDNSを設定します。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
  • REALITY

設定レイヤー

v2rayNのコア設定

サブスクリプションはサーバーリストの取得元を決め、システムプロキシやTUNはクライアントに流す通信を決めます。ルーティングは、その通信の行き先を決定します。問題が起きたら、この3つのレイヤーを分けて確認すると、すべての設定を一度に変更するより原因を特定しやすくなります。

接続元ごとにサブスクリプションを追加

サブスクリプショングループ → サブスクリプショングループ設定 → 追加

接続元ごとにサブスクリプションを分けて保存し、見分けやすい名前を付けます。更新する前に対象のグループを選び、「現在のサブスクリプションを更新」を実行してください。まとめて更新する場合のみ、すべてを更新します。サーバーを1件ずつ貼り付けるのとは異なり、サブスクリプションの更新では接続元からリストを再取得するため、手動で変更した項目が上書きされる場合があります。長期保存する手動設定は別途保存してください。更新に失敗したら、ダウンロードエラーか内容の解析エラーかを確認してから設定を見直します。

サブスクリプションとサーバーのフィルタリングについて

プラットフォームとインストールパッケージ

デバイスに合わせてクライアントを選ぶ

デスクトップではv2rayNを使用します。Androidでは、必要なコアに応じてv2rayNGまたはv2flyNGを選んでください。ダウンロード前にデバイスのプロセッサアーキテクチャを確認しましょう。同じクライアントでも、パッケージによって対応するチップやインストール方法が異なる場合があります。

ダウンロードページでは、v2rayNデスクトップ版と従来のWPF版を案内しています。デスクトップ版はクロスプラットフォームのUIを採用しています。これまでの操作に慣れている場合や、旧版のガイドを見ながら設定する場合は、従来のWPF版の説明を確認してください。画面上の配置は異なる場合があるため、スクリーンショットを項目ごとに照合するのではなく、機能名からサブスクリプショングループ、ルーティング、システムプロキシを探します。

ダウンロード前に「設定 → システム → バージョン情報」でシステムの種類を確認します。初回接続では、サーバーを1つ選び、システムプロキシを参照するブラウザーで動作を確認してください。他のアプリにも適用する必要がある場合は、TUNを検討します。終了後もシステムがローカルプロキシに接続しようとする場合は、システムプロキシが元に戻っているか確認してください。

「このMacについて」でチップまたはプロセッサを確認します。Appleシリコンの場合はarm64、Intelプロセッサの場合はx64を選びます。2種類のパッケージは異なるアーキテクチャ向けのため、OS名だけで選ぶことはできません。インストール後にクライアントを起動し、メイン画面が表示されることを確認してからサブスクリプションを追加してください。

アプリが起動しない場合と、起動後にプロキシを設定できない場合では、確認すべき点が異なります。前者はシステムに表示されるアプリ起動時の警告を確認し、後者はネットワーク関連の権限やプロキシ設定を調べます。管理対象のデバイスではシステムによって設定が制限される場合があるため、管理ポリシーの制限をインストールパッケージの選択ミスと誤認しないようにしてください。

Xrayコアが必要ならv2rayNG、V2Flyの設定を使うならv2flyNGを選びます。システムがarm64に対応していることを確認してから該当するパッケージを選んでください。不明な場合は汎用版を確認します。パッケージのアーキテクチャはデバイスにインストールできるかを左右し、コアの選択はサブスクリプション内のプロトコルや転送方式に対応できるかを左右します。

システムにインストールの競合が表示されたら、まず更新対象が同じアプリか、またシステムが示す具体的な原因を確認してください。アンインストールして再インストールする場合は、サブスクリプションやローカル設定を復元できるか事前に確認します。初回にVPN権限を求められたときは、別のアプリがすでにその接続を使用していないかも確認してください。

ディストリビューションに合わせてパッケージ形式を選びます。DebianとUbuntuでは通常deb、FedoraとopenSUSEでは通常rpmを使用します。その後、システムアーキテクチャに合わせてx64またはarm64を選んでください。形式が合っていても依存関係がすべてそろっているとは限りません。インストーラーで不足コンポーネントが示された場合は、依存関係を解決してからデスクトップメニューの項目を確認します。

このガイドはグラフィカルデスクトップ環境を前提としています。ウィンドウは開くのにアプリがプロキシを使わない場合は、まずデスクトップ環境でシステムプロキシ設定が適用されているかを確認し、次に対象アプリがその設定を参照するか調べます。ブラウザーでのテストに成功しても、別のアプリが同じ設定を使うとは限りません。

デバイスの移行時に引き継ぐ設定

移行前に、サブスクリプションのURL、手動で追加したサーバー、本体の設定を分けて確認します。サブスクリプションのURLは新しいデバイスで追加し直せます。サブスクリプションに含まれない手動の設定は別途保存してください。システムプロキシ、仮想ネットワークインターフェース、アプリごとのルーティングは元のデバイスに依存することが多いため、新しいデバイスで改めて確認が必要です。バックアップにサブスクリプションのリンクや接続情報が含まれる場合は、公開するトラブルシューティング用のスクリーンショットとは分けて保管してください。

新しいデバイスでは、まず最小限の設定を行います。接続元を1つ追加し、使用実績のあるサーバーを1つ選んで、接続モードを1種類だけテストしてください。基本の接続に成功してから、カスタムDNSとルーティングルールを戻します。基本設定でも接続できない場合は、古い設定一式に頼るのではなく、アーキテクチャ、コア、権限を確認してください。

エコシステムとメンテナンス

Project V、V2Fly、Xray

クライアントは設定画面の表示や構成の管理を担い、コアは接続の確立やルーティングルールの実行を担います。両者のプロジェクトはそれぞれ独立してリリースされることがあります。接続トラブルの際は画面上の設定を確認するだけでなく、実際にどのコアが処理しているかも把握しておきましょう。

Project Vエコシステムの役割

Project Vは初期のプロジェクトエコシステムの名称で、V2Rayはその中核となるプロキシプログラムです。元のプロジェクトが段階的にコミュニティへ引き継がれた後、V2FlyがV2Rayのメンテナンスとリリースを継続し、Xrayは関連するコードを基盤に分岐して独自に発展しました。現在、クライアントに表示される名称はエコシステム全体を指す場合も、実際に動作している特定のコアを指す場合もあります。ガイドを読む際は文脈に応じて区別してください。

グラフィカルクライアントはサブスクリプションの項目を選択可能なサーバー設定に整理し、ルーティングやネットワークモードをコアが利用できる設定に変換します。サーバーリストが表示されない場合は、まず追加や更新を確認します。リストから選べるのにコアが起動しない場合は、同じアドレスを再度追加するよりログを確認するのが適切です。

コアとプロトコルの互換性

V2FlyとXrayが設定に適しているかを判断するには、プロトコル、転送方式、接続のセキュリティ機構をあわせて確認する必要があります。VMess、VLESS、Trojanはプロトコル名、WebSocketは転送方式、REALITYは接続のセキュリティ機構です。リストにあるプロトコルの略称だけでは、ほかの設定項目にも対応しているか判断できません。

たとえば、サーバー側でVLESSとREALITY、特定のフロー制御の組み合わせが必要な場合は、その組み合わせ全体に対応するコアを使い、サーバーのパラメーターに合わせて設定します。プロトコルのメニューをVLESSに変えるだけでは不十分です。設定一式を移行する際はDNSやアウトバウンドの項目も確認してください。接続パラメーターに互換性があっても、同じカスタムルーティング設定をそのまま使えるとは限りません。

3つのオープンソースクライアントの特徴

v2rayNはGPL-3.0で公開されているデスクトップ向けのグラフィカルクライアントで、サブスクリプション、コア選択、ルーティング、ネットワークモードの設定に対応しています。v2rayNGとv2flyNGはオープンソースのAndroidクライアントで、それぞれXrayとV2Flyを対象としています。いずれも端末上の接続設定を管理するもので、サブスクリプションやリモートサーバーを提供するものではありません。

ライセンスを確認する際は、クライアントと、クライアントで使用するコアやコンポーネントを区別してください。クライアントのオープンソースライセンスは、そのコードに適用される条件を示します。コアやその他のコンポーネントについては、それぞれのライセンスを確認する必要があります。クライアントを無料で入手できても、リモートサービスを利用する権利が得られるわけではありません。サービスの利用条件は、実際の提供者が定めます。

クライアント、コア、サブスクリプションの更新

クライアントのリリースでは画面やプラットフォーム対応が変更される場合があります。コアのリリースでは設定項目やプロトコル対応が変わることがあります。サブスクリプションの更新では、サーバー側から提供されるサーバーリストを再取得します。これら3種類の更新はそれぞれ独立しており、サブスクリプションの更新に成功してもプログラムがアップグレードされたことにはなりません。同じクライアントのインストールパッケージでも、接続元によってサブスクリプションの動作が異なる場合があります。

更新前に、現在使用しているコア、ルーティング方式、接続モードを記録してください。更新後は、以前正常に動作していた操作を1つ再テストしてからカスタム設定を有効にします。サブスクリプションの更新後に問題が起きた場合は、まず対象グループの設定変更を比較してください。プログラムのアップグレード後に問題が始まった場合は、設定の移行やコアの起動メッセージを確認します。

使い方のヒント

コア選びとプロトコルのメモ

Androidクライアントを選ぶなら、まずXrayとV2Flyの違いを確認しましょう。名称がグラフィカルクライアントとコアのどちらを指すのか知りたい場合は、エコシステムの関係を確認します。REALITYの設定を受け取ったら、セキュリティ機構とフロー制御の項目を照らし合わせ、別々の設定を混同しないようにしてください。

· コア選び

XrayコアとV2Flyコアの違い:v2rayNGとv2flyNGの選び方

XrayとV2Flyが分岐した経緯、プロトコル対応の違い、設定の互換性を整理し、サブスクリプション内のプロトコルに応じてAndroidでv2rayNGとv2flyNGのどちらを選ぶか解説します。

よくある質問

サブスクリプションの更新に成功したのに接続できないのはなぜですか?

更新の成功は、クライアントがサーバーリストを取得できたことを示すだけです。項目を1つ選び、コアが起動しているか、アプリの通信がクライアントに渡されているかを確認してから、トラブルシューティングガイドに沿って接続エラーとDNS解決エラーを切り分けてください。

特定のアプリだけプロキシを使わないのはなぜですか?

まず、そのアプリがシステムプロキシを参照するか、独自のプロキシが設定されているか、VPNモードで除外されていないか確認します。通信がクライアントに届いていることを確認してから、ルーティングルールとアウトバウンドタグを確認してください。

DNSやTUNを変更した後、どのように原因を切り分ければよいですか?

直近で正常に動作していたモードに戻し、サーバーは変更せず、まず普段使うアプリとローカルネットワークへのアクセスを確認します。その後、DNSまたはTUNの設定を1つずつ戻してください。ある手順で問題が再発した場合は、よくある質問を参考に、そのレイヤーの設定を確認します。

同じサブスクリプションを2種類のクライアントで使えますか?

サブスクリプションを読み込めるかは、提供される形式によります。読み込み後に接続できるかは、実際のコアや設定項目にも左右されます。2台のデバイスで同時に使えるかは、サービス提供者の利用条件を別途確認してください。まずはサブスクリプションとサーバーに関する用語を参考に、3つの点を切り分けましょう。