クライアントと設定ドキュメント · Project V エコシステムガイド

V2Ray使い方ガイド
v2rayN のダウンロードとサブスクリプション設定

クライアント選びから始め、サブスクリプション導入ルーティング設定トラブル対処の順に進めます。デスクトップとAndroidのクライアントを扱い、XrayとV2Flyという2つのコア系列の使い分けも説明します。

完全無料 オープンソース 日本語ドキュメント 複数コアに対応
サブスクリプションURLを貼り付け、v2rayNにワンクリックで導入
サブスクリプションを導入
場所:サブスクリプショングループ → サブスクリプションを追加 → サブスクリプションを更新

CLIENT WORKBENCH

クライアント作業台:サブスクリプションからコアのログまで

よく使う操作は、サブスクリプショングループ、ルーティングモード、システムプロキシ、コア選択、ログウィンドウの5か所に集約されています。まず設定の階層を見分けてから具体的なパラメーターを変更すると、設定を何度も導入し直すより原因を特定しやすくなります。

サブスクリプショングループ
  • グループ名よく使うサブスクリプション
  • 自動更新
  • 更新場所サブスクリプショングループ

サブスクリプションURLとノードを分けて管理

サブスクリプションは、サーバー側で管理される設定の入口です。クライアントで更新して初めて、そこに含まれるノード、プロトコル、トランスポート設定がローカルへ書き込まれます。実際に使うときは、まず分かりやすい名前のグループを作成し、完全なサブスクリプションURLを貼り付けて更新します。更新に失敗しても連続してクリックせず、ネットワークアクセスの失敗なのか、返却内容の形式が不正なのか、URLが無効になったのかを確認してください。グループ管理の利点は、取得元を分けて保持できることです。複数のサブスクリプションが互いに上書きせず、1つのグループを無効にしても他の設定には影響しません。手動で追加した単一ノードは一時的なテストに向いているため、長期運用するサブスクリプションと同じグループに混在させないようにします。

PLATFORM ENTRY

システムに合わせてクライアントとインストールパッケージを選ぶ

プラットフォーム別ページで、対応クライアント、インストール形式、アーキテクチャの選択肢をまとめて紹介します。ホームページではファイルを直接配布せず、対象プラットフォームのページで端末に合ったインストールパッケージを選びます。

Windows

デスクトップではまずv2rayNを選びます。新しいデスクトップ版は標準的なインストールに適し、クラシックなWPF版は従来の操作レイアウトを好むユーザー向けです。どちらもサブスクリプション、ルーティング、システムプロキシを管理できます。

ダウンロードページへ

macOS

macOSではv2rayNデスクトップクライアントを使用します。ダウンロード前にシステム情報でプロセッサーの種類を確認し、Apple SiliconまたはIntel対応のパッケージを選んで、インストール形式と端末のアーキテクチャが合わない事態を避けてください。

ダウンロードページへ

Android

Androidではv2rayNGとv2flyNGから選べます。前者はXrayコア系列、後者はV2Flyコア系列を採用しています。近年の端末の多くはarm64を選択でき、アーキテクチャが分からない場合は汎用パッケージを使用します。

ダウンロードページへ

Linux

Linuxデスクトップではv2rayNを使用します。ディストリビューションのパッケージ体系に合わせてdebまたはrpmを選び、プロセッサーのアーキテクチャに応じてx64またはarm64を選択してください。インストール後も、デスクトップセッションでシステムプロキシを設定する必要があります。

ダウンロードページへ

OPEN SOURCE ECOSYSTEM

Project V、V2Fly、Xrayの関係

クライアント、コア、プロトコル、サブスクリプションは同じ階層ではありません。それぞれの役割を理解して初めて、障害時にGUI、設定ファイル、基盤となるプロトコル実装のどこを確認すべきか判断できます。

Project Vエコシステムから2つのコア系列へ

Project Vは、設定を中心に動作するネットワークツールのエコシステムを形成しました。初期のV2Rayプロジェクトは、インバウンド、アウトバウンド、ルーティング、DNS、ポリシー、トランスポート層などの基本的な設定構造を確立し、その後コミュニティの保守によってV2FlyとXrayという代表的な2つのコア系列が発展しました。両者は多くの基本概念を共有しており、JSON設定でリッスン入口、リモート出口、照合ルールを記述しますが、新しいプロトコル、トランスポート機能、フィールド拡張、バージョンの進み方にはそれぞれ特徴があります。

そのため、「V2Rayクライアント」は通常、この種のコアと設定を管理するGUIツールを指し、単一のプログラム名ではありません。v2rayNはデスクトップでサブスクリプション、ノード、ルーティング、システムプロキシ、コアの起動を管理し、v2rayNGとv2flyNGはAndroidで設定を管理します。GUIクライアントはユーザーの操作をコアが読み込める設定へ変換し、ローカルのリッスンポートを起動します。接続の成否は最終的に、サブスクリプションの内容、プロトコルパラメーター、トランスポート設定、ドメイン名解決、システム時刻、ローカルネットワーク環境が複合的に影響して決まります。

オープンソースのプロトコルとコミュニティ保守の意味

ソースコードが公開されていることで、プロトコル実装、設定構造、クライアントの動作を公開の場で議論し、継続的に改善できます。ただし、プロジェクトごとにリリースのペースは異なります。クライアントの更新で新しい画面や設定生成ロジックが導入されることがあり、コアの更新ではプロトコルフィールドの追加、互換性問題の修正、デフォルト動作の変更が行われる場合があります。更新前に変更内容を読み、利用可能な設定を保存し、現在のサブスクリプションが特定のコア機能に依存していないか確認してください。安定して使うことは毎回の更新を追いかけることではありません。明確な互換性要件、バグ修正、システム対応の変化があるときに更新するほうが、通常は条件を管理しやすくなります。

オープンソースライセンスは、コードの複製、改変、再配布の範囲も定めています。一般ユーザーが重視すべきなのは、プロジェクト名とインストールパッケージの出所が一致しているか、クライアントが実際にどのコアを呼び出しているか、設定にそのコアが対応するフィールドが含まれているかです。このサイトでは、クライアント操作とコアの概念を分けて解説します。入門手順では目に見える画面に焦点を当て、設定大全ではJSON各セクションの意味を説明し、用語集ではプロトコルとネットワークの基礎概念を調べられます。トラブル記事ではログの状況から具体的な設定をたどります。

v2rayN

デスクトップクライアント

Windows、macOS、Linuxに対応し、サブスクリプショングループ、ノード選択、システムプロキシ、ルーティングルール、コア管理をまとめて扱えます。複数の設定をGUIで管理したいデスクトップ環境に適しています。

v2rayNG

Android · Xray系列

Xrayコア系列を採用し、サブスクリプション更新、設定導入、ルーティング設定、接続ログを提供します。Xray固有の拡張フィールドを含む設定では、通常この組み合わせを優先します。

v2flyNG

Android · V2Fly系列

V2Flyコア系列を採用し、画面操作は一般的なサブスクリプション手順とよく似ています。設定要件とコアの互換範囲を基準に選べばよく、2種類のクライアントを同時にインストールする必要はありません。

サブスクリプションの更新に失敗したら、まず何を確認する?

まずURLが完全で、現在もアクセスできることを確認し、返却内容がクライアントで認識できるサブスクリプション形式か確認します。ネットワークエラー、URLの無効化、形式エラーはそれぞれ分けて対処し、ローカル設定をすべて削除しないでください。

サブスクリプション導入の手順を見る →

DNSとルーティングを一緒に確認する理由は?

ドメインルールに一致するかどうかは、名前解決の場所やドメインポリシーの影響を受けることがあります。DNSだけ、またはルーティングだけを変更すると本当の原因を隠す可能性があるため、リクエストのドメイン、名前解決の結果、最終的な出口の3段階を確認します。

DNSとroutingの設定を見る →

XrayとV2Flyはどう選ぶ?

まずサブスクリプションまたは手動設定で使われているプロトコル、フロー制御、トランスポートのフィールドを確認し、それらを正しく解析できるコアを選びます。基本設定はどちらも理解できることが多い一方、拡張機能は項目ごとの確認が必要です。

コアとプロトコルの用語を見る →

接続に失敗したら、なぜ先にログを見る?

ログから、設定解析、ポートのリッスン、DNS、接続タイムアウト、ハンドシェイクのどこで問題が起きたかを切り分けられます。一度に変更する変数を1つにし、新しく起動して最初のエラーを記録すると、対処の道筋が明確になります。

設定トラブル対処ガイドを見る →

LATEST NOTES

設定とトラブル対処の記事

コアの起動、プロトコルの仕組み、TLSエラーを中心に、再利用しやすい確認手順をまとめています。記事中の設定例はフィールド間の関係を説明するためのもので、実際のパラメーターは使用中のサブスクリプションまたはサービス設定に合わせてください。

トラブル対処

V2Rayコアの起動に失敗したときの対処法:ログでconfig.jsonの設定エラーを特定

クライアントのログウィンドウから始め、JSON構文エラー、ポート競合、フィールド名の誤記、プロトコルパラメーター不足という4つの代表的な原因別に、典型的なエラー行を読み解きます。項目ごとの修正方法と、再起動後に確認すべき基準も紹介します。

記事を読む →
プロトコル解説

REALITYプロトコルとXTLS Visionの基礎:ハンドシェイクの仕組みと性能上の利点

REALITYのハンドシェイク特性と、XTLS Visionが重複する暗号化コストを抑えるフロー制御の考え方を解説し、クライアント、コア、ノード設定で一致させるべき主要フィールドを説明します。

記事を読む →
トラブル対処

V2Ray TLS証明書エラーの確認リスト:システム時刻のずれとSNI設定を詳しく解説

certificate invalid、handshake failedなどのよくある表示を対象に、システム時刻のずれ、serverNameの不一致、証明書チェーンの問題を確認する順序を整理します。

記事を読む →
v2rayN ダウンロード