オープンソースクライアント · 日本語設定ガイド

V2Rayコミュニティ v2rayNの入手

クライアント選びからサブスクリプションの追加、ルーティング設定まで、OSに合ったインストール方法を確認し、同じ手順で通信経路をチェックできます。

  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

01 設定項目

V2Rayクライアントの主な機能

サブスクリプションで設定を取得し、システムプロキシやTUNで通信をクライアントに取り込み、ルーティングで接続先を決めます。設定項目ごとに見ていきましょう。

サブスクリプションURLと個別の共有リンク

サブスクリプションURLは、サービス提供元から受け取り、複数の接続設定を取得・更新するために使います。個別の共有リンクには、通常1つの接続設定だけが含まれます。v2rayNでは、まずサブスクリプショングループに見分けやすい名前を付け、URLを保存してからグループを更新します。接続を1件ずつ貼り付けるより、グループ単位で更新すれば、設定の取得元がわかりやすくなり、一時的なテスト用と普段使う接続が混ざるのも防げます。更新後は一覧に項目が追加されたことを確認してから接続先を選びましょう。インポートできても、接続できるとは限りません。

  • サブスクリプションURLを変更する前に、対象のグループを確認してください。
  • スクリーンショットを共有するときは、URL全体を隠してください。パス自体が認証情報として使われる場合があります。
サブスクリプションURLの例 · ドメイン名のみ表示・利用不可
https://example.invalid/list

vmess://またはvless://で始まる個別リンクを受け取った場合は、共有リンクのインポート機能を使います。

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

OSに合ったクライアントをダウンロード

まずOSを確認し、次にCPUアーキテクチャやパッケージ形式を選びます。同じアプリ名でも、異なる端末で同じインストーラーが使えるとは限りません。

Windows

デスクトップ版も従来のWPF版も、どちらもv2rayNです。初めて使う場合はデスクトップ版から試すとよいでしょう。従来の画面を前提にしたガイドを使う場合や、以前のメニューに慣れている場合はWPF版を確認してください。ダウンロード前にOSの「バージョン情報」でシステムの種類を確認し、OS名だけでアーキテクチャを判断しないようにしましょう。

圧縮ファイルの場合は、まずすべてのファイルを展開し、現在のアカウントで書き込み可能なフォルダーから起動してください。圧縮ソフトのプレビューから直接実行すると、メインプログラムだけが起動し、必要なファイルが見つからないことがあります。既存の設定がある場合は先にバックアップを取り、別のフォルダーで試してください。サブスクリプションとルーティングが引き継がれたことを確認してから、古いフォルダーを削除しましょう。

ダウンロードページへ

macOS

Appleメニューから「このMacについて」を開きます。「Appleチップ」と表示される場合はApple Silicon版、「Intelプロセッサ」と表示される場合はIntel版を選んでください。v2rayNをダウンロードしたら、ディスクイメージ内の案内に沿ってインストールし、「アプリケーション」フォルダーから起動します。マウントしたディスクイメージを常用の実行場所にしないでください。

起動がシステムにブロックされた場合は、互換性、配布元、権限のどれに関する警告かを確認してください。アプリのためにシステム全体の保護を無効にする必要はありません。メニューバーやDockに表示されていても、システムプロキシが有効とは限りません。クライアントで切り替えた後、システムプロキシ設定に従うアプリでテストし、必要ならターミナルにも個別設定を行いましょう。

ダウンロードページへ

Android

Xrayコアが必要ならv2rayNG、V2Flyの実装が必要な設定ならv2flyNGを検討してください。最近の端末の多くはarm64版を選べます。対応アーキテクチャがわからない場合は汎用版を確認してください。汎用版で解決できるのはインストール時のアーキテクチャの問題であり、別のコアに未対応のプロトコルを使えるようにするものではありません。

ブラウザーやファイルマネージャーからインストーラーを開く場合、インストール権限は通常、その取得元に対して付与されます。インストール後は権限を取り消せます。初回接続時にVPNの許可を求められることがあります。同じ接続を別のアプリが使用している場合は、そのアプリを切断してから試してください。インポート時は、サブスクリプション全体と個別の共有リンクを区別しましょう。

ダウンロードページへ

Linux

v2rayNを選ぶ場合は、まずディストリビューションで一般的なパッケージ形式を確認します。Debian系やUbuntu系は通常deb、Fedora系は通常rpmを選び、そのうえでx64とarm64を見分けます。両方が合っていることを確認してからインストールしましょう。アーキテクチャの不一致と実行時依存関係の不足は、別の問題です。

デスクトップ環境のプロキシ設定が、ターミナルやバックグラウンドサービスに引き継がれるとは限りません。ブラウザーは使えるのにコマンドラインでタイムアウトする場合は、ローカルの待ち受けアドレスとポート、コマンドラインツールが対応するプロキシ方式、プロキシ環境変数が現在のプロセスに渡されているかを確認してください。それらを確認してから、クライアントのルーティングとアウトバウンドを調べましょう。

ダウンロードページへ

03 プロジェクトとコア

Project Vのオープンソースエコシステム

ガイドが説明しているのはクライアント、コア、サーバーのどれでしょうか。まず3つの役割を区別し、その操作方法が手元の端末に当てはまるか判断しましょう。

操作画面から接続処理まで
  1. クライアント設定のインポート・編集・選択
  2. コアインバウンド接続を受け付け、ルールに従ってアウトバウンドを選択
  3. 接続先照合結果に応じて直接接続するか、プロキシ経由で接続
  1. Project Vの基礎:クライアントとコアの役割

    Project Vは、これらのツールの仕組みを理解する出発点です。初期のV2Rayでは、インバウンド、アウトバウンド、ルーティングを組み合わせ可能な設定として分離していました。インバウンドは接続を受け付け、アウトバウンドは接続を外部へ送り、ルーティングは複数のアウトバウンドから経路を選びます。そのため、接続を開始するアプリ、通信を中継するコア、設定を操作するGUIを、1つのプログラムにまとめる必要はありません。後にコミュニティで開発されたデスクトップやモバイル向けクライアントは、この役割分担を使いやすい画面で操作できるようにしたものです。

    この背景を知っておくと、トラブル時の切り分けに役立ちます。クライアントにサブスクリプションが表示されているのは、画面上にデータがあることを示すだけです。設定を読み込めるかどうかはコアの起動結果を、特定のアプリの通信がコアを通っているかは、そのアプリの通信経路を確認する必要があります。この3つを混同すると、ネットワークの問題が起きるたびにサブスクリプションを再インポートしても、アプリがプロキシを使っていないことに気づかないままになります。

  2. V2FlyとXray:共通の基盤から独自の進化へ

    V2Flyコミュニティは、V2Rayコアの開発と保守を引き継いでいます。Xrayはこのコード系統から分岐し、その後それぞれ独自に発展しました。設定の概念が似ており、同じように見えるプロトコルや項目があっても、共通の由来だけで互換性が保証されるわけではありません。特に新しいトランスポート方式やセキュリティ層の設定では、一方が読み込める値の組み合わせを、もう一方が同じように処理できるとは限りません。サーバー側で指定された内容を確認し、現在のクライアントがどのコアを使用しているかを調べましょう。

    端末を替えるときも、元の設定一式をそのまま移せるとは限りません。接続に必要な個別のパラメーター、クライアントに保存されたサブスクリプショングループ、ローカルの待ち受けポートやシステムプロキシ設定は、それぞれ別の階層です。まず接続設定を移行し、新しい端末で接続を1件テストしてから、ルーティングルールを順に戻すとよいでしょう。接続に失敗しても、パラメーターの非互換性と新端末の設定不足を切り分けやすくなります。

  3. オープンソースライセンスとプロキシプロトコルは別物

    VMessやVLESSは、通信する双方がどのようにデータをやり取りするかを定めます。一方、オープンソースライセンスは、コードの使用、変更、再配布の条件を定めます。両者が扱う問題はまったく異なります。V2FlyコアはMITライセンス、Xray-coreはMozilla Public License 2.0を採用しています。MITライセンスは再配布時の条件が比較的少ないものの、関連する著作権表示とライセンス表示を残す必要があります。Mozilla Public License 2.0では、主にライセンスの対象となるファイルに義務が適用され、その変更を含むファイルを配布する場合は、条項に従って対応するソースコードを提供する必要があります。

    コンポーネントが別々に保守されている場合、ライセンスもそれぞれ確認しましょう。GUIクライアント、同梱されたコア、その他のコンポーネントが、インストーラーの名前だけで同一のライセンス条件になるとは限りません。一般ユーザーは、クライアントを設定する前にライセンス全文を読む必要はありません。ただし、再パッケージ、改変、派生版の公開を予定している場合は、各コンポーネントに付属するライセンスを確認してください。プロキシサービスのアカウント、プラン、利用条件はサービス提供元が定めるもので、オープンソースライセンスの対象ではありません。

  4. 設定に合わせた3つのクライアントの選び方

    v2rayNは、サブスクリプショングループ、接続先の選択、ルーティング、システムプロキシを1つの画面で管理できるオープンソースのデスクトップクライアントです。複数の設定を管理したり、アプリごとに問題を切り分けたりする場合に便利です。v2rayNGはXrayを使用するオープンソースのAndroidクライアントで、v2flyNGもオープンソースでV2Flyコアを採用しています。名前が似ているからといって、スマートフォンに両方をインストールする必要はありません。サーバーの設定値とクライアントの対応状況に合わせて1つ選び、まず基本的な接続を確認してから設定の違いを比べましょう。

    問題を人に説明するときは、「接続できない」とだけ表示されたスクリーンショットより、アプリ名、使用中のコア、エラーが起きるまでの手順を伝えるほうが役立ちます。たとえば、サブスクリプションの更新でデータを取得できないのか、接続先を選んだ後にコアがエラーを出すのか、特定のターミナルツールだけがプロキシを経由しないのかで、確認する場所は異なります。ログを共有する際は、時刻、操作手順、エラーの種類を残し、サブスクリプションURL、アカウント情報、公開に適さないサーバー設定は隠してください。

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

    クライアントの更新ではメニューの配置、インストール方法、設定の保存場所が変わることがあります。コアの更新では対応項目や起動時の動作が変わる場合があります。サブスクリプションの更新は、提供元から最新の接続設定を取得する操作です。それぞれは互いの代わりにはなりません。更新前に、選択中の接続先、コア、ルーティングモード、ローカルの待ち受けポートを控え、残したいカスタムルールは別途バックアップしてください。一度に変更するのは1つの階層だけにし、同じアプリと接続先で再テストすると、どの変更が影響したのか判断しやすくなります。

    更新後にすべてのアプリで接続できなくなった場合は、まずコアが起動しているか、インバウンドが待ち受けているか確認してください。特定のアプリだけが使えない場合は、そのアプリ側の通信設定を調べましょう。サブスクリプションの更新後に項目が減った場合も、すぐに手動設定を上書きせず、更新したグループと提供元で項目が削除されたかを確認してください。手順を追って設定する場合は全プラットフォーム向けガイドをご覧ください。接続はできても通信経路が想定と違う場合は、ヘルプセンターのルーティングとプロキシに関する項目を確認できます。

04 技術ノート

システムプロキシ・ルーティング・サブスクリプションのトラブル対処

症状から確認箇所を絞り込みましょう。ターミナルが接続を取り込めない、通信が誤ったアウトバウンドに流れる、複数のサブスクリプショングループを整理できない、といった問題はそれぞれ原因が異なります。

v2rayNのシステムプロキシが効かないときの対処法:ブラウザーは開けるのにターミナルがプロキシを使わない

ブラウザーとターミナルを分けて確認します。まずシステムプロキシが設定されているか、ブラウザー拡張機能が通信を処理しているかを確認し、次にターミナルの環境変数とローカルポートを調べて、v2rayNのシステムプロキシが効かない原因を特定します。

クライアントを再インストールする前に確認しましょう。ブラウザー拡張機能、システムプロキシ、ターミナルの設定が、それぞれ異なる接続先を指していることがあります。ツールが実際にどのポートへ接続しているかを確認してから、転送設定を調べてください。接続がクライアントに届いていないとわかった場合、アウトバウンドやルーティングを変更しても解決しません。