クライアントのインストール / 設定ファイル / ルーティングルール

V2Rayの設定ガイド

まずサブスクリプションの読み込みから始め、設定ファイルとルーティングを理解しましょう。

  • JSON
  • Xray · V2Fly
  • ソースコード公開

CLIENT SETTINGS / クライアント設定

V2Rayの使い方、設定項目から確認

まずクライアントの画面とプロキシコアの役割を区別し、項目ごとに設定します。クライアントはサーバー情報の保存、サブスクリプションの更新、実行用設定の生成を担います。コアは接続を受け付け、ルーティングを照合して通信を転送します。以下の5項目は実際の操作順に並んでいます。画面はメニューと設定の関係を示すもので、現在の端末の動作状態を表すものではありません。

v2rayN / サブスクリプショングループの設定 · 画面例
  • サーバー
  • サブスクリプショングループ
  • 設定
  • ルーティング設定
グループ名普段使い
サブスクリプションURLURL全体を貼り付け
サブスクリプションを更新まず直接接続で試す

更新が完了したら、サーバー一覧から使用する設定を選択します。

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

サブスクリプションURLは複数のサーバー設定をまとめて取得・更新するためのものです。共有リンクは通常、1つの設定を表します。v2rayNではサブスクリプショングループの設定にURLを保存してから更新します。v2rayNGではサブスクリプショングループの画面から追加できます。読み込む前に、コピーしたものが完全なURLであり、ページタイトルやログイン画面のURLではないことを確認してください。初回の更新は直接接続で試し、サブスクリプションサービスからプロキシ経由を指定された場合に限り、プロキシ経由での更新を試します。URLにアクセス情報が含まれることがあるため、公開するスクリーンショットに写さないよう注意してください。読み込み後は使用する設定を選択します。一覧に項目が表示されても、接続が確立したとは限りません。

設定リファレンスを見る →

初回設定:まず最短の接続経路を作る

使用できるサーバー設定またはサブスクリプションURLを用意し、読み込んだら設定を1つ選んで、適切なプロキシ接続方法を有効にします。まずブラウザーで到達可能なことが分かっている宛先にアクセスし、クライアントのログに該当する接続が記録されるか確認します。この段階で確認するのは現在の設定とアプリの組み合わせです。複雑なルーティング、仮想インターフェース、独自DNSをすぐに有効にする必要はありません。基本の接続経路が動作してから、設定を1つずつ追加し、変更ごとに元に戻せる状態を保ちましょう。

テスト結果はそれぞれ分けて考える必要があります。サーバー設定が一覧にあるのは、クライアントが形式を受け付けたことを示します。ポートテストで結果が出ても、ある段階で接続できる可能性が分かるだけです。実際にWebページへアクセスできて初めて、ドメインの名前解決、通信のハンドシェイク、アプリからのリクエストまで確認できます。テストによって測定対象は異なります。結果に食い違いがある場合は、遅延の数値だけを比べるより、テスト方法とログを記録するほうが役立ちます。

設定を読む:通信の流れに沿って項目を確認

JSON設定を理解するには、インバウンド、ルーティング、アウトバウンドの順に読むと分かりやすくなります。インバウンドはローカル接続の入り口、ルーティングは処理経路の選択、アウトバウンドは最終的な転送先を示します。DNSは名前解決を担い、ポリシー項目は接続管理の動作を調整します。チュートリアルに記載されているポートやルールは構文の例です。実際にはクライアントの設定を確認してください。特に、すべてのクライアントが同じデフォルトポートを使うと思い込まないようにしましょう。

GUIクライアントは起動時に設定ファイルを再生成する場合があるため、生成済みファイルを直接編集しても変更が維持されないことがあります。まず画面に用意されたカスタムルーティングや設定の入力欄を使い、変更前にバックアップをエクスポートしてください。項目の型、配列の構造、タグの対応関係を確認する場合はV2Ray設定ファイルのリファレンスを、インバウンド、アウトバウンド、通信方式などの用語を確認する場合は用語集をご覧ください。

DOWNLOAD / OS別クライアントとインストーラー

v2rayNのダウンロード、デバイスに合わせて選択

デスクトップではv2rayN、Androidではv2rayNGをまず確認してください。V2Flyの設定が必要な場合は、v2flyNGも選択肢になります。ダウンロードページでファイルを選ぶ前に、OS、CPUアーキテクチャ、パッケージ形式を確認してください。クライアントのインストールとサブスクリプションは別のものです。インストールしてもサーバー設定は自動で取得されず、サブスクリプションを読み込んでもOS側で必要なインストールや許可設定は省略できません。

Windows

v2rayN / Desktop · WPF

ダウンロードページにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォームの画面を採用し、WPF版は従来のデスクトップ操作を維持しています。OS環境や使い方に合わせて選び、同じ設定で2つのクライアントを同時に動かす必要はありません。インストール前に旧バージョンを終了し、ローカルの待ち受けポートが競合しないようにしてください。

初回起動後は設定を読み込み、ローカルサービスが起動していることを確認してからシステムプロキシを設定します。ブラウザーに独自のプロキシ拡張機能や手動設定がある場合は、接続先を別途確認してください。待ち受けポートを変更した場合、そのポートを使うアプリ側の設定も変更する必要があります。

ダウンロードへ Windowsクライアント

macOS

v2rayN / Apple Silicon · Intel

まずOSの「このMacについて」でチップの種類を確認し、Apple Silicon版またはIntel版のインストーラーを選びます。アーキテクチャの選択はサーバーのプロトコルとは無関係なので、サブスクリプション名から判断することはできません。インストール手順に従ってアプリを配置し、初回起動時はOSに表示されるアクセス許可やセキュリティに関する案内を確認してください。

システムプロキシとTUNモードでは必要な許可の範囲が異なるため、まず通常のプロキシで接続を確認するのがおすすめです。特定のアプリだけが接続できない場合は、そのアプリがシステムプロキシに従うかを確認し、すぐに端末全体の通信を取り込む設定に切り替えないでください。ダウンロードページには、アーキテクチャ別のリンクとインストール前の確認事項をまとめています。

ダウンロードへ macOSクライアント

Android

v2rayNG / v2flyNG

v2rayNGはXrayコア、v2flyNGはV2Flyコアを使用し、必要な設定に応じて選べます。比較的新しい端末ではまずarm64版を確認し、アーキテクチャが分からない場合は汎用版も検討してください。インストールできるかどうかはOSとアプリの要件にも左右されるため、端末の購入時期だけで判断しないでください。

読み込み後に設定を選んで接続を開始します。初回起動時は通常、OSから表示されるネットワーク接続の確認が必要です。省電力設定によってバックグラウンド動作が制限されることがあります。画面ロック後に切断される場合は、アプリのバックグラウンド実行権限を確認してください。サブスクリプションURLやQRコードにアクセス情報が含まれることがあるため、操作画面を共有する前に該当部分を隠しましょう。

ダウンロードへ Androidクライアント

Linux

v2rayN / deb · rpm

ディストリビューションのパッケージ管理方式に合わせてdebまたはrpmを選び、CPUアーキテクチャがx64かarm64かも確認してください。パッケージ形式とCPUアーキテクチャは別の条件です。ファイルをダウンロードできても、現在の環境にインストールできるとは限りません。デスクトップ環境や関連する実行時の依存関係も、クライアントの要件を満たす必要があります。

デスクトップ環境によってシステムプロキシの対応状況は異なり、ターミナルのプログラムがデスクトップのプロキシ設定を参照するとも限りません。動作確認ではブラウザーとコマンドラインの接続を分け、それぞれのプロキシ接続先を確認してください。まずGUIクライアントとローカルの待ち受けが正常に動作することを確かめてから、仮想インターフェースの権限やシステムルートを検討します。

ダウンロードへ Linuxクライアント

すでに端末にクライアントをインストールしている場合は、更新前にサブスクリプショングループ、カスタムルール、必要なアプリ設定を保存してください。設定の互換性を確認せず、唯一使える環境を上書きするのは避けましょう。インストーラーで解決できるのはプログラムの導入に関する問題です。接続の問題は、設定、プロキシの接続先、ルーティング、ログの順に確認してください。

クライアント一覧を見る →

PROJECT V / コアとGUIクライアント

V2Rayのオープンソースエコシステム、プロジェクトとクライアントを区別

V2Rayはよく検索される名称であると同時に、Project Vエコシステムに属するソフトウェアや設定体系とも関連しています。日常的な操作は主にGUIクライアントで行い、実際の通信転送は使用中のコアが担います。この関係を理解すると、チュートリアルやJSON設定が、現在インストールしているクライアントに適用できるか正しく判断できます。

エコシステムの概要

Project V

コアの系統

V2Fly / Xray

GUIクライアント

v2rayN / v2rayNG / v2flyNG

Project Vと設定構造

Project Vはモジュール化されたネットワークプロキシ機能を基盤としています。V2Rayの設定は、インバウンド、アウトバウンド、ルーティング、DNS、接続ポリシーなどで構成されます。モジュール化によって、同じローカル接続口から異なるアウトバウンドを利用できます。一方で、プロトコル名だけでは接続全体を説明できません。設定を読む際は、認証情報、通信方式、安全レイヤーも合わせて確認し、名称が一致するかだけで判断しないでください。

V2FlyコミュニティはV2Ray関連の実装と保守を引き継いでいます。Xrayは関連技術を基盤に、独自に発展しているコアプロジェクトです。共通の概念や設定方法もありますが、機能、項目、更新のペースがすべて同じとは限りません。あるコアで有効な設定を別のコアで使う場合も、対応状況を確認してください。特に特定の通信方式やセキュリティ機構に関する項目には注意が必要です。

GUIクライアントとオープンソース

v2rayN、v2rayNG、v2flyNGはいずれもソースコードが公開されたGUIクライアントです。オープンソースでは、実装や変更履歴、ライセンス条件を公開の場で確認できますが、どの第三者の設定でもそのまま読み込めるという意味ではありません。クライアントは設定管理、コアの起動、ログの表示を支援します。サーバーのパラメーターが有効か、サブスクリプションの内容が信頼できるかは、提供元も含めて確認する必要があります。

デスクトップ向けのv2rayNは、サブスクリプション、システムプロキシ、ルーティングをまとめて管理できます。Android向けのv2rayNGとv2flyNGは、モバイルOSでの接続許可やバックグラウンド動作を中心に画面が構成されています。3つは同じプログラムの別名ではなく、メニューや設定項目もすべて一致するわけではありません。端末と設定の要件に合わせて選び、対応するクライアントのガイドを確認してください。デスクトップのメニューをそのままモバイルに当てはめないようにしましょう。

オープンソースライセンスとコンポーネントの違い

オープンソースライセンスは、コードの使用、変更、再配布に関する条件を定めるもので、サブスクリプションサービスの利用規約とは異なります。コア、GUIクライアント、同梱される依存コンポーネントは、それぞれ異なるライセンスを採用している場合があります。各プロジェクトに同梱された説明を確認してください。V2Ray関連のコア実装で採用されているMITライセンスや、Xray-coreのMPL 2.0は、それぞれのコードに適用されるライセンスです。すべてのコンポーネントが同じライセンスを使うとは限りません。

サイト名とプロジェクトの名称も別のものです。このページはクライアントと設定を読むための日本語ガイドであり、Project V、V2Fly、Xrayの技術的な関係を紹介しています。チュートリアルサイトとコアプロジェクトを混同しないでください。機能の有無は、検索結果に表示された製品の略称ではなく、インストールしたクライアントの画面、同梱の説明、実際の動作ログで確認しましょう。

更新とトラブルシューティング

クライアント、コア、サブスクリプション、ルーティング用データの更新は、それぞれ異なる問題に対処します。クライアントを更新すると、画面や設定ファイルの生成方法が変わることがあります。サブスクリプションを更新するとサーバー設定が再取得され、ルーティング用データの更新はドメインやアドレスの照合に影響します。サブスクリプションを更新してもクライアントのプログラムは置き換わりません。また、クライアントを新しくインストールしても、サブスクリプション内のサーバーパラメーターが自動で修正されるわけではありません。

問題が起きたら、まず直近の変更を記録してからログを確認してください。設定の解析に失敗する場合は、項目、形式、コアとの互換性を確認します。ローカルポートが使用中の場合は、クライアントの多重起動を確認してください。ハンドシェイクに失敗した場合は、時刻、宛先アドレス、安全レイヤーの設定を確認します。ログを公開する前に、サブスクリプションURL、ユーザー識別情報、認証情報を削除してください。複数の設定を同時に変更したり、再インストール、コアの切り替え、ルーティングの書き換えを一度に行ったりするより、層ごとに確認するほうが原因を特定しやすくなります。

READING NOTES / 設定ガイド

V2Rayの技術記事、目的別に読む

基本接続ができたら、具体的な問題に合わせて知識を補いましょう。読み込みに失敗した場合は形式の説明、設定選びならプロトコルの比較、接続に問題がある場合は実行ログの確認から始めるのがおすすめです。各記事は1つのテーマを扱っているため、設定リファレンスの項目説明と照らし合わせながら読めます。

クライアントをダウンロード