デスクトップクライアント
ダウンロードへ
Windows
Windowsではv2rayNを使用し、新しいデスクトップUIと従来のWPF UIから選択できます。前者は他のデスクトッププラットフォームに近い構成で、後者は従来のメニューやタスクトレイ操作に慣れた方に適しています。インストール後はサブスクリプションを導入し、必要に応じてシステムプロキシまたはTUNモードを設定します。
クライアントのダウンロード
お使いのデバイスに合うインストーラーを選択
デスクトップではv2rayNを使い、Androidではv2rayNGとv2flyNGから選べます。ダウンロードページではプロセッサーのアーキテクチャやパッケージ形式ごとに入口が分かれています。まずプラットフォームを確認し、後のインストールで不適切なファイルを選ばないようにしましょう。
デスクトップクライアント
ダウンロードへ
macOS
macOSではv2rayNデスクトップ版を使用します。ダウンロード前に、Apple SiliconかIntelプロセッサーかを確認してください。アーキテクチャはインストーラーの選択にのみ影響し、サブスクリプション形式やルーティング設定は変わりません。初回起動後はシステム権限を確認し、サブスクリプションを導入してブラウザーがシステムプロキシに従うか確認しましょう。
モバイルクライアント
ダウンロードへ
Android
Androidではv2rayNGが一般的で、通常のサブスクリプション設定に適したカーネルと操作性を備えています。V2Flyカーネルを使う場合はv2flyNGを選択できます。比較的新しい端末の多くはarm64版を利用できますが、アーキテクチャが不明な場合はユニバーサル版を選んでください。接続前に、クライアントによるローカルネットワーク接続を許可する必要もあります。
デスクトップクライアント
ダウンロードへ
Linux
Linuxではv2rayNを使用し、ディストリビューションのパッケージ体系に合わせてdebまたはrpmを選び、さらにx64とarm64を区別します。インストール後、GUIは起動するのにアプリの通信がクライアントへ入らない場合は、デスクトップ環境のプロキシ設定、端末の環境変数、TUNに必要な権限をそれぞれ確認してください。
設定のポイント
サブスクリプションから実際の通信経路まで
クライアントに接続済みと表示されても、コアプロセスが動作段階に入ったことしかわかりません。設定が整っているか判断するには、サブスクリプションの内容、アクティブなサーバー、プロキシの適用方法、ルーティング結果、実行ログも確認する必要があります。次の4つのテーマは、よくある設定の流れに対応しています。
まずサブスクリプションURLとグループを確認し、サーバー一覧をローカルに更新します。
ルールは順番にマッチし、最初に一致したルールがリクエストの送信方法を決めます。
まずシステムプロキシで基本接続を確認し、アプリの対象範囲に応じてTUNを有効にします。
ステータスバーは結果を示すだけで、実行ログに接続失敗がどの段階で起きたかが記録されます。
まず基本経路を確認し、その後でルールを追加する
初回設定では、明確に利用できるサーバーを1つだけ残し、最も簡単なシステムプロキシ方式で接続を確認することをおすすめします。ブラウザーのリクエストがクライアントを経由したことを確認してから、ルーティングルール、DNSポリシー、TUNなどを追加してください。最初からサブスクリプション、カーネル、ルーティング、通信適用方式を同時に変更すると、問題の原因を特定しにくくなります。
設定変更を追跡できる範囲に抑える
毎回、関連する設定だけを1グループ変更し、変更前後の状態を記録します。たとえばサーバーを変更したら接続結果だけを確認し、ルーティングを調整したらマッチと送信先だけを確認し、TUNを有効にしたら権限とDNSを重点的に確認します。この手順は確認が1つ増えるものの、再インストールや見当違いの設定変更にかかる時間を大幅に減らせます。
クイックスタート
インストールから確認までの3ステップ
以下は、サブスクリプションURLを用意できているユーザー向けに、完全な手順を簡潔にまとめたものです。各ステップには明確な確認ポイントがあります。クライアントが起動すること、サーバー一覧を更新できること、実際のリクエストがプロキシを通ることです。確認できたら次のステップへ進みます。
プラットフォームを選んでインストールする
ダウンロードセンターで、まずOSに合わせてプラットフォームを切り替えます。Windowsはデスクトップ版または従来のWPF版を操作感で選び、macOSはプロセッサーに合うインストーラーを選びます。Androidはカーネルの系統に応じてv2rayNGまたはv2flyNGを選択し、Linuxはディストリビューションのパッケージ体系とプロセッサーアーキテクチャに合うファイルを選びます。インストール後にクライアントを起動し、メイン画面、トレイメニュー、接続権限が正常に使えることを確認してください。
初回起動をシステムに阻止された場合は、OSが提供するアプリ権限の入口からファイルの入手元と実行権限を確認してください。問題を解決するために、何度も解凍や再インストールを繰り返してはいけません。Linux環境ではデスクトップコンポーネントとインストール依存関係も確認します。この段階では複雑なルーティングを変更せず、クライアントを安定して起動し設定画面へ入れることを目標にします。
サブスクリプションを導入してサーバーを選ぶ
サブスクリプショングループにURLを追加して保存し、そのグループを手動で1回更新します。更新に成功するとサーバー項目が表示されます。グループが存在するのに一覧が空の場合は、まずURLが完全か確認し、正しいグループに対して更新を実行したか確認してください。一覧が表示されたらサーバーを1つアクティブ項目として選び、実際の接続テストまたは直接アクセスで確認します。ネットワーク層の単純な応答だけに頼らないでください。
サブスクリプションには複数のプロトコルとトランスポートの組み合わせが含まれる場合があり、クライアントは設定に応じて対応するカーネル機能を呼び出します。通常、各フィールドを手作業で書き換える必要はありませんが、サーバー側とクライアント側のパラメーターは一致していなければなりません。ログに認証、アドレス、トランスポートパラメーターのエラーが出た場合は、ローカル設定を適当に切り替えるのではなく、サブスクリプションの提供元で設定を確認してください。
プロキシを有効にして通信を確認する
デスクトップではまずシステムプロキシを有効にし、システム設定に従うブラウザーやアプリからクライアントを利用します。Androidでは接続時に、システムネットワーク接続の許可を確認してください。その後、キャッシュされていないページを開いて確認し、同時にクライアントログに対応するリクエストが出ているか確認します。リクエストが正しい送信先に入ったことを確認できて初めて、アプリ、システムプロキシ、クライアントコアの経路が確立したと判断できます。
ブラウザーは使えるのにコマンドラインツールが使えない場合、通常は両者がプロキシ設定を読み取る仕組みが異なります。TUNを有効にしてすべてのリクエストが異常になった場合は、権限、DNS、ルーティングの競合を確認してください。クライアントの接続アイコンだけで判断せず、実際のアクセス、ログ、ルールのマッチ結果を総合して確認します。
エコシステムとカーネル
Project V、V2Fly、Xrayの関係
クライアント名、カーネル名、プロトコル名は同時に登場することがよくあります。3つの階層を理解すると、ダウンロードやトラブルシューティングがスムーズになります。GUIクライアントは操作と設定管理を担い、カーネルはネットワーク処理を担います。プロトコルとトランスポートのパラメーターは、クライアントとサーバーの通信方法を定義します。
Project Vエコシステムからクライアントの構造を理解する
Project Vは、プロキシプロトコル、ルーティング機能、ネットワークトランスポートを中心とするツールエコシステムを形成しました。プロジェクトの発展に伴い、V2FlyはV2Ray関連の実装とコミュニティによる保守を引き継ぎ、Xrayは同じ技術的系譜のもとで異なる機能の重点と更新ペースを持つ形で発展しました。2つのカーネル系統には共通する概念が多い一方、具体的なプロトコル機能、設定項目、実装状況は完全には一致しない場合があります。
v2rayN、v2rayNG、v2flyNGはGUIクライアントであり、基盤となるカーネルそのものではありません。サブスクリプション管理、サーバー一覧、システムプロキシ、ルーティング設定、ログ表示を担当し、整理した設定をカーネルに渡して実行します。そのため、画面が正常に表示されても、すべてのカーネルパラメーターが有効とは限りません。接続に問題がある場合は、クライアント設定、現在のカーネル、サーバー設定を同時に確認する必要があります。
この階層構造があるため、同じサブスクリプションでもクライアントによって表示が少し異なる場合があります。クライアントは独自のUIモデルに従って設定を読み込み、カーネルは対応範囲に基づいて実行します。クライアントを選ぶ際は、使用OS、必要なカーネル系統、操作習慣を優先し、すべての製品名を完全に同じ代替品として扱わないことが大切です。
v2rayN：デスクトップの設定入口
v2rayNはWindows、macOS、Linuxに対応し、サブスクリプショングループ、サーバー選択、システムプロキシ、TUN、ルーティング、ログなどをGUIで設定できます。デスクトッププラットフォームによってインストール形式は異なりますが、サブスクリプション導入と基本設定の流れは共通しており、複数のデスクトップ端末で同じ手順を使いたい方に適しています。
v2rayNG：AndroidとXray系統
v2rayNGはAndroid向けで、通常はXrayカーネル系統と組み合わせて使います。モバイル端末の接続許可、サーバー切り替え、ルーティング、アプリごとの通信処理を中心に構成されています。モバイルネットワークは切り替わりやすいため、トラブルシューティングでは設定だけでなく、Wi-Fiとモバイルデータ通信の変化、バックグラウンド制限、システムのネットワーク許可も確認してください。
v2flyNG：AndroidとV2Fly系統
v2flyNGもAndroid向けで、主な違いはV2Flyカーネル系統を採用している点です。サブスクリプション設定がV2Flyの実装方式に明確に依存している場合や、このカーネル体系を一貫して使いたい場合はv2flyNGを選択できます。選定時はサーバー設定と実際に必要なプロトコルを基準にしてください。
オープンソースライセンスとコードレビュー
これらのプロジェクトはオープンソースで保守されており、ライセンスによってコードの利用、変更、再配布の条件が定められています。オープンソースの実質的な価値は、実装の詳細を確認でき、具体的なコードや設定に基づいて問題を議論できることにあります。派生クライアントも該当するライセンスに従う必要があります。利用者は自分のプラットフォームに適したビルドを明確なダウンロード入口から入手し、バージョン情報と設定変更を確認してください。
コミュニティによる保守と更新ペース
GUIクライアントと基盤カーネルは別々のプロジェクトによって保守されており、リリース時期が完全に一致するとは限りません。クライアントの更新ではUI、インストール方法、設定変換ロジックが変わることがあり、カーネルの更新ではプロトコル実装、ルーティング動作、パラメーター対応が変わる場合があります。アップデート後に挙動が変わったときは、まずクライアント層とカーネル層のどちらの変更かを判断し、そのうえで設定、ログ、サブスクリプションを確認します。
プロトコル対応は単一のラベルではありません
プロトコル名は設定の一部にすぎず、アドレス、ポート、認証情報、トランスポート方式、TLS関連設定、ルーティングアクションも接続に影響します。2つのクライアントに同じプロトコルが表示されていても、呼び出すカーネル、パラメーターの対応範囲、設定形式を確認してください。互換性の問題では、プロトコル名だけを比較するより、設定全体の経路を確認するほうが効果的です。
よくある質問
インストール後にまず確認する場所
初回設定で多い問題は、サブスクリプションが更新されていない、アクティブなサーバーが選択されていない、アプリがシステムプロキシを読み取っていない、ルーティングやDNSを変更しすぎている、といったものです。次の4つの入口で確認の方向性を示します。関連する概念は用語集でさらに確認できます。
サブスクリプション導入後にサーバーが表示されないのはなぜ？
まずサブスクリプショングループが保存されていることを確認し、そのグループを手動で更新してログを確認します。グループ名が存在していても、リンクの登録が完了しただけで、内容のダウンロードと解析が成功したとは限りません。ログにリクエストエラーがある場合は、URLの完全性と現在のネットワークを確認します。ダウンロードは完了しても解析に失敗する場合は、サブスクリプション形式を確認してください。
サブスクリプションとノードの用語を見る →システムプロキシを有効にしても一部のプログラムで反映されないのはなぜ？
プログラムによってプロキシ設定の読み取り方法は異なります。ブラウザーは通常システムプロキシに従いますが、一部のターミナルツール、開発環境、独立したネットワークプログラムでは、個別のプロキシパラメーターやTUNによる通信の取り込みが必要です。まず特定のプログラムだけが接続されていないのか、すべての通信がクライアントを経由していないのかを切り分けてください。
システムプロキシとTUNを見る →テストでは利用可能なのに、ウェブページが開けない場合は？
テスト結果で確認できるのは、接続過程の一部だけです。システム時刻、DNS、ルールのマッチ、アクティブなサーバー、アプリのプロキシ設定を続けて確認し、ログを消去してからもう一度アクセスします。対応するリクエストがログにない場合、問題は主にアプリからクライアントまでの間にあります。リクエストとエラーがある場合は、キーワードからカーネルまたは設定を特定します。
ログとトラブルシューティングの用語を見る →TUNモードはいつ有効にすべき？
対象アプリがシステムプロキシを読み取らない場合や、より広い範囲のネットワーク通信をまとめて処理したい場合は、TUNを検討できます。有効にする前にシステムプロキシで基本接続を確認し、その後で権限、DNS、LANルーティングを設定してください。これにより、サーバー設定の問題と通信適用の問題を分けて判断できます。
ルーティングと分流の用語を見る →
更新情報
最近の設定・トラブルシューティング記事
記事では、実際の操作で起きる個別の問題を取り上げ、確認する順序、ログの根拠、設定項目の関係を説明しています。具体的な障害が起きたときは、まずタイトルから近い状況の記事を選び、完全なドキュメントに戻って関連概念を補足してください。
プロキシ接続済みなのにインターネットへアクセスできない：v2rayNとv2rayNGの確認リスト
サーバーの可用性、システム時刻、DNS、ルーティングルール、システムプロキシの5段階を順番に確認し、接続状態と実際のリクエストがクライアントを経由したかを切り分けます。
記事を読む →v2rayNの実行ログの読み方：よくあるエラーの意味と原因の特定方法
rejected、timeout、invalid userなど、よくあるログのキーワードを解説し、エラー発生時刻、宛先アドレス、送信タグから具体的な設定項目を特定する方法を説明します。
記事を読む →XrayとV2Flyカーネルの違いを詳しく解説：バージョン関係とクライアントの選び方
Project Vの技術的系譜における2つのカーネルの関係を整理し、v2rayN、v2rayNG、v2flyNGのプラットフォームとカーネル選択につなげて解説します。
記事を読む →