Windows
Windowsデスクトップではv2rayNを推奨します。ダウンロードページでは、新世代のクロスプラットフォームデスクトップUIとクラシックWPF UIの適した用途を分けて説明しています。初回インストールでは、システムバージョンと実行環境を確認してから、普段の使い方に合うUIを選びます。古い設定を移行する場合は、先にサブスクリプションURLとカスタムルーティングをバックアップし、新しいクライアントで一つずつ復元してください。
ダウンロードへ
クライアントのリリースと日本語ドキュメント
V2Ray公式中文サイト
V2Ray公式中文サイト
v2rayN ダウンロードと設定ガイド
オープンソースクライアント3種、4つのプラットフォーム別入口、日本語の操作ドキュメントをまとめて確認できます。まず端末に合うクライアントを選び、サブスクリプションのインポート、システムプロキシ、ルーティングを設定します。
04 対応プラットフォーム
03 グラフィカルクライアント
Xray · V2Fly コアファミリー
OPEN SOURCE オープンソースエコシステム
サイト運営のお知らせ
クライアントのダウンロードから接続トラブルまで
操作の段階ごとに説明を確認できます。左側でテーマを選ぶと、右側に対象範囲、対応手順、関連ドキュメントへの入口を表示します。
まずOSに合うクライアントを選ぶ
デスクトップではまずv2rayNを選びます。Windowsはデスクトップ版とクラシック版を用途に応じて選択し、macOSはプロセッサーのアーキテクチャに合うインストーラーを選びます。Linuxはディストリビューションのパッケージ形式に応じた入口へ進みます。Androidはv2rayNGが中心で、Xrayコアを使用します。V2Flyコアが必要な場合はv2flyNGを選択してください。この構成ではOS、クライアント、コアの3層を分けて確認できるため、名前が似たファイルの取り違えを防げます。ダウンロードセンターにはアーキテクチャの確認方法とインストール条件も掲載しており、初回導入や端末変更時に役立ちます。
プラットフォーム別の入口は、対応するダウンロード画面へ案内するためのものです。トップページでファイルを直接配布してはいません。ダウンロードページでシステム要件、パッケージの違い、プロセッサー情報を確認すれば、モバイル端末でデスクトップ用ファイルを選んだり、デスクトップ端末でアーキテクチャを間違えたりする事態を減らせます。
CLIENTS · v2rayN / v2rayNG / v2flyNG · WINDOWS / macOS / ANDROID / LINUX
サブスクリプションは追加、更新、選択の順で操作
サブスクリプションURLには通常、サービス提供者が管理する接続設定の一覧が含まれています。URLをコピーしたら、まずクライアントでサブスクリプショングループを作成し、次に更新を実行してから、現在のグループで使用する設定を選びます。URLを貼り付けただけでグループを更新しなければ、選択可能な接続項目は作成されません。更新後も古い設定を使っていれば、新しい内容には切り替わりません。ガイドではデスクトップ版とAndroidのメニュー名を分けて掲載し、クリップボードからのインポート、手動追加、サブスクリプション更新の違いも説明しています。
インポート後は、現在選択されている設定を確認してからシステムプロキシのモードを決めます。サブスクリプションURLは継続的に使う設定情報のため、公開ページ、スクリーンショット、共有ドキュメントに載せないでください。端末を移行する場合は、新しい端末でグループを作り直して更新し、異なるOSへクライアントの実行ディレクトリ全体をコピーするのは避けます。
WORKFLOW · GROUP → UPDATE → SELECT → CONNECT
ルーティングが出口を決め、DNSが名前解決を担う
ルーティングルールは、ドメイン、アドレス範囲、インバウンドタグ、ネットワーク種別に基づいて、トラフィックをどのアウトバウンドへ送るか決定します。DNS設定はドメインをアドレスへ変換し、ドメインの集合ごとに使用するDNSサーバーを指定できます。両者は同時に登場しがちですが、処理段階は異なります。名前解決の結果がルーティングの判定に使われることもあれば、ルーティングによってDNS問い合わせの出口が決まることもあります。設定マニュアルでは、inbounds、outbounds、routing、dns、policyの順にJSON構造を分解し、各フィールドの階層を確認しやすくしています。
一般ユーザーはまず、クライアント内蔵の定義済みルーティングを使い、必要に応じて少数のルールを追加するのがおすすめです。変更後は設定を保存して再読み込みし、明確なドメインで一つずつ検証します。一度に大量のルールを追加すると競合しやすく、並び順の問題も判断しにくくなります。ルールが具体的であるほど、一覧内でのマッチング順序を確認する必要があります。
CONFIG · routing / dns / outbounds · XRAY / V2FLY
状態、設定、ポート、システムプロキシの順に確認
接続できないときは、まずクライアントが現在の設定で起動しているか確認し、次にサブスクリプショングループの更新状況、設定がフィルターで非表示になっていないか、システム時刻が正確かを確認します。その後、ローカルポートの使用状況、システムプロキシ、防火壁の権限、実行ログを調べます。階層ごとに確認するほうが、接続ボタンを繰り返し押すより原因を見つけやすくなります。クライアントが動作していない場合はプロセス層、設定を起動できない場合はパラメーター層、ローカルポートの競合はシステム層の問題です。一部のアプリだけ接続できない場合は、プロキシモードやアプリごとの設定を確認します。
ヘルプページでは、「まったく接続できない」「ブラウザーに反映されない」「サブスクリプション更新の異常」「DNS名前解決の異常」に分類して確認手順を整理しています。エラーが発生した時刻、使用したプラットフォーム、直前に変更した設定を記録し、ログの同じ時間帯と照合すると範囲を絞れます。設定を戻すときは一度に一項目だけ変更し、どの変更が結果を生んだか確認できるようにします。
CHECK · PROCESS → PROFILE → PORT → SYSTEM PROXY → LOG
4つのプラットフォーム別入口
端末に合うダウンロード画面へ
トップページではインストールパッケージを直接分けていません。まずOSを選ぶと、ダウンロードページでクライアント、プロセッサーアーキテクチャ、パッケージ形式を順に案内します。
macOS
macOSではv2rayNデスクトップクライアントを使用します。インストーラーはApple SiliconとIntelプロセッサーで分かれているため、端末の外観だけで判断できません。システム情報でチップまたはプロセッサー名を確認し、対応する入口へ進んでください。インストール後は、システムが求めるネットワーク関連の権限を許可し、メニューバーのクライアント状態とシステムプロキシの状態が一致していることを確認します。
ダウンロードへAndroid
Androidの主な選択肢はXrayコアを使用するv2rayNGです。v2flyNGはV2Flyコアに対応する代替クライアントです。近年の多くの端末では、まずarm64インストーラーを確認できます。アーキテクチャが不明な場合は、ユニバーサル版の説明を確認してください。インストール後は、クライアントによるローカルVPN接続を許可し、システムのバックグラウンド制限に応じて実行権限を調整して、画面ロック後に接続が停止されないようにします。
ダウンロードへLinux
Linuxデスクトップではv2rayNを使用し、ディストリビューションに合うdebまたはrpmパッケージを選びます。Debian、Ubuntuおよび派生システムでは通常deb、Fedora、RHEL系および派生システムでは通常rpmを使用します。プロセッサーアーキテクチャは別途確認が必要です。インストール後にシステムプロキシが反映されない場合は、クライアントの接続状態だけでなく、現在のデスクトップ環境のプロキシ設定を確認してください。
ダウンロードへ
クイックスタートプレビュー
ダウンロード、インポート、接続の3ステップ
以下は初回接続を完了するための流れです。具体的なメニューの場所、システム権限、トラブル対応は、完全ガイドでプラットフォーム別に説明しています。
-
クライアントを選んでインストール
まずOSを確認し、対応するクライアントを選びます。Windows、macOS、Linuxではv2rayNを使用し、Androidではv2rayNGを優先します。V2Flyコアが必要な場合はv2flyNGを選択してください。デスクトップ用インストーラーでは、プロセッサーアーキテクチャやパッケージ形式も確認します。インストール後はクライアントを起動し、メインウィンドウ、トレイアイコン、ステータス領域が正常に開くことを確認してからサブスクリプションを操作します。
初回起動時に権限を求められたら、システムの指示に従ってネットワーク接続やシステムプロキシに関する操作を許可します。インストールが完了していない段階で、古い端末の実行ディレクトリ全体をコピーしないでください。システムごとにパス、権限、実行環境が異なるためです。通常、引き継ぐべき内容はサブスクリプションURL、カスタムルーティングの考え方、少数の手動設定です。
-
サブスクリプショングループを作成して更新
有効なサブスクリプションURLをコピーし、クライアントのサブスクリプション管理でグループを追加します。識別しやすいグループ名を入力して保存し、サブスクリプションを更新します。更新が完了すると、選択可能な設定項目が生成されます。リストが空のままなら、表示中のグループが新しく作成したものか確認し、フィルター条件、URLの欠落、更新ログのメッセージを調べます。
設定が多い場合は用途ごとに複数のグループを作成できますが、同じURLを別のグループへ繰り返し追加するのはおすすめしません。更新後は接続に使う設定を一つ選び、プロトコル、アドレス、ポートなどの基本情報が揃っているか確認します。サブスクリプションの内容は提供元が管理し、クライアントはそれを読み込んで変換します。フィールドに互換性がない場合は、クライアントとコアの種類がサブスクリプションの要件に合っているか確認してください。
-
接続を開始してプロキシ範囲を確認
設定を選択してクライアントを起動し、端末に応じてシステムプロキシ、グローバルプロキシ、アプリごとのモードを選びます。デスクトップではクライアントの動作状態とシステムプロキシの状態を同時に確認します。Androidでは、システムがローカルVPN接続を許可していることを確認してください。接続後はまずブラウザーで基本的なアクセスを試し、その後ほかのアプリを確認します。アプリ固有のプロキシ設定をクライアント全体の障害と取り違えないためです。
ブラウザーは正常でほかのアプリに反映されない場合は、そのアプリがシステムプロキシに従うか、独自のネットワーク設定を有効にしていないか、現在のルーティングルールが対象の通信をカバーしているかを確認します。すべてのアプリで接続できない場合はクライアントログに戻り、設定の起動、ポートの競合、DNS名前解決、リモート応答の順に切り分けます。一度に一つの設定だけを変更し、検証してから次へ進みます。
オープンソースエコシステムの説明
Project V、V2Fly、Xrayの関係
クライアント、コア、プロトコルはそれぞれ異なる層に属します。3者を区別すると、インストーラーの選択や設定トラブルの切り分けが容易になります。
Project Vはプロトコルとツールのエコシステムの源流
Project Vは、V2Rayの設定モデル、プロキシプロトコル、トランスポート方式、ルーティング機能を中心とするオープンソースエコシステムを形成しました。日常的に使うグラフィカルクライアントは、すべての機能そのものではなく、設定、コアプロセス、システムプロキシを操作するためのUIです。サブスクリプションのインポート、設定の選択、ログの確認、システムプロキシの切り替えはクライアントが担い、接続の確立、プロトコル処理、ルーティング判定、DNS問い合わせなどは通常コアが担います。
そのため、画面の名前が似ていても同じコアを使うとは限らず、同じコアでもクライアントのメニューが完全に一致するとは限りません。トラブル時はまずクライアント名とプラットフォームを記録し、次にコアファミリーと設定プロトコルを確認します。「V2Rayに接続できない」とだけ書かれていても、問題の場所を判断するには情報が不足しています。
V2FlyとXrayは関連するコアファミリー
V2FlyはV2Rayエコシステムの中核実装、設定構造、関連コンポーネントを継承・保守しています。Xrayは近い設定思想を基盤に発展し、独自に対応するプロトコル、セキュリティ層、トランスポート機能を追加しています。両者にはインバウンド、アウトバウンド、ルーティング、DNS、ポリシー、ログなど多くの共通概念がありますが、具体的なフィールド、利用可能なプロトコル、既定の動作は異なる場合があります。設定例を使う前に、どのコア向けか確認してください。ファイル拡張子が同じという理由だけで流用してはいけません。
v2rayNGは主にXrayコアと組み合わせて使い、v2flyNGはV2Flyコアに対応します。v2rayNはデスクトップでクライアントUIと設定管理を担えますが、利用できる機能は選択したコアと現在の設定によって変わります。本サイトのドキュメントでは対応するコアの範囲を明記します。共通概念は基礎章にまとめ、差異のあるフィールドは設定マニュアルで個別に説明します。
3種類のクライアントはいずれもオープンソースプロジェクトとして保守
v2rayN、v2rayNG、v2flyNGはいずれも、公開コード、リリース履歴、ライセンスファイルを基盤として保守されています。グラフィカルクライアントは、コアのパラメーター、サブスクリプション、システムネットワーク設定を操作可能な画面に整理します。デスクトップ版は複数ウィンドウ、トレイ状態、システムプロキシ、設定編集を重視し、AndroidクライアントはローカルVPNインターフェース、アプリごとのプロキシ、バックグラウンド動作、モバイルネットワークの切り替えを重視します。
オープンソースであるため、機能の変化はリリース履歴、ドキュメント、コードの進展から確認できますが、各プロジェクトのリリース時期が揃うとは限りません。クライアントの更新でUIやサブスクリプション処理が変わることがあり、コアの更新でプロトコル機能が追加されたり接続動作が修正されたりすることもあります。アップグレード後に設定が変わった場合は、まず該当クライアントの変更履歴を読み、古い設定を移行するか判断してください。
更新の順序は要件と互換性で決める
通常の更新で、すべてのコンポーネントを同時に置き換える必要はありません。明確な互換性要件、プロトコル対応の変更、既知の問題の修正がある場合に、リリースノートに従ってクライアントを更新します。更新前にクライアント名、設定グループ、カスタムルーティング、システムプロキシモードを記録します。更新後は既存設定を読み込み、基本接続を確認してから複雑なルールを戻します。この順序なら、インストール、設定、コア動作のどこに問題があるか切り分けられます。
サブスクリプションはサービス提供者が更新し、クライアントとコアはそれぞれのプロジェクトが保守します。本サイトはダウンロード先と日本語の操作資料を整理します。3種類の更新元は互いに独立しています。サブスクリプションの内容が変わっても、すぐにクライアントを再インストールする必要はありません。クライアントのUIが変わったからといって、サブスクリプション自体が無効になったとも限りません。まず変化がどの層で起きたか判断し、対応するドキュメントを確認してください。
最新のドキュメント記事
プロトコル、インストール、トラブル対処
記事は実際の操作上の疑問に沿って構成しています。プロトコルの記事では選択の基準、インストールの記事では初回設定、トラブル対処の記事では項目ごとの確認手順を説明します。
VMessとVLESSの違いは？一般ユーザー向けに選び方を1分で解説
暗号化方式、トランスポートのオーバーヘッド、サーバー要件の3つの観点から、VMessとVLESSの実際の違いを説明します。一般ユーザーがプロトコルパラメーターを手動で書き換える必要は通常ありません。サブスクリプションの情報とサーバー設定を基準にし、手動で選ぶ場合は、クライアントの対応範囲とセキュリティ層の要件を確認してください。
記事を読む →v2rayNGの電池消費が早いときの対処法：バックグラウンド維持と省電力設定の確認手順
アプリごとのプロキシ範囲、接続ハートビート、Mux設定、システムの省電力対象外リスト、メーカー独自のバックグラウンド制限を順に確認します。クライアントの継続動作、頻繁な再接続、システムによる繰り返しの起動を区別し、電池消費の原因がネットワーク通信、設定方針、バックグラウンド管理のどこにあるか判断できるようにします。
記事を読む →VMess、VLESS、Trojan、Shadowsocksを比較：4つのプロキシプロトコルの選び方
ハンドシェイク方式、トランスポートのオーバーヘッド、サーバー要件、クライアントの対応範囲に基づいて4つのプロトコルを整理します。サブスクリプション情報やデプロイパラメーターを読み解きたいユーザー向けに、プロトコル層、トランスポート層、セキュリティ層を一つの項目として混同しないこと、単一の指標だけであらゆる場面を判断しないことを説明します。
記事を読む →