Windows
v2rayNにはデスクトップ版と従来のWPF版があります。新規インストールなら、まずデスクトップ版を確認しましょう。従来の画面に慣れている場合は、両バージョンのシステム要件と操作の違いを比べて選べます。
ダウンロードページへデバイスから選ぶ
V2Ray クライアントのダウンロード
デスクトップならv2rayN、モバイルならv2rayNGから確認しましょう。OSとCPUアーキテクチャを確認してインストールファイルを選びます。クライアントは設定を読み込むためのソフトです。接続に必要なサブスクリプションやノードは別途用意してください。
macOS
v2rayNデスクトップ版を使用します。「このMacについて」でチップ名を確認し、Apple SiliconまたはIntel向けのダウンロードを選んでください。初回起動時はmacOSのセキュリティ警告を確認しましょう。
ダウンロードページへLinux
v2rayNデスクトップ版を使用します。ディストリビューションに合わせてdebまたはrpmを選び、x64かarm64かを確認してください。システムプロキシをアプリが利用できるかは、デスクトップ環境やアプリの設定にも左右されます。
ダウンロードページへAndroid
まずはXrayコアを使用するv2rayNGを検討し、V2Flyコアが必要な場合はv2flyNGを確認してください。比較的新しいスマートフォンではarm64が一般的です。アーキテクチャがわからない場合は、ユニバーサル版の説明を先に確認しましょう。
ダウンロードページへインストールファイルと接続設定は別に用意
インストール後、サーバー一覧が空でも問題ありません。クライアントに利用可能なノードは付属せず、端末に応じてサブスクリプションが自動生成されることもありません。利用権限のあるサービスの管理画面から設定を取得し、有効期限内であることを確認してください。説明用のexample.comのURLを実際のサブスクリプションとして入力しないでください。入力形式を示すための例です。
デスクトップとスマートフォンで同じ設定とは限らない
同じサブスクリプションを複数のクライアントで使えるかは、形式やプロトコルのパラメーター、コアの対応状況によって決まり、クライアント名だけでは判断できません。パソコンの「システムプロキシを自動設定」と、スマートフォンでVPN接続を許可する操作は別の仕組みです。有効なサービス設定は別の端末でも使えますが、ローカルポートやアプリへの適用方法、バッテリー設定は端末ごとに確認してください。
よく使う4つの設定
サブスクリプション・プロキシ・ルーティング
まず設定をクライアントに読み込み、プロキシを使うアプリが正しい接続先を通るようにします。以下はv2rayNでよく使われるメニューをもとにした説明です。画面構成によって場所が異なる場合があるため、実際のクライアント画面を確認してください。
有効な設定を用意する
サブスクリプションURL（例）https://example.com/subプロキシを使わずに更新
サブスクリプションでは、複数のノードのアドレスや接続パラメーターをまとめて管理できます。定期的に設定を更新する場合に便利です。「サブスクリプショングループ設定」でグループを作成し、完全なURLを入力して保存した後、「サブスクリプショングループ」メニューから更新します。初回接続前は「プロキシを使わずに更新」を試してください。読み込み後はノード名、プロトコル、グループを確認しましょう。一覧が空の場合は更新ログを確認し、同じグループを何度も追加しないでください。個別に手入力するより一括管理しやすい一方、URLにアクセス情報が含まれる場合があるため、公開しないようにしましょう。
サブスクリプションの読み込み手順を見る
アプリの接続経路を確認
- システムプロキシを自動設定
- システムプロキシを解除
- システムプロキシを変更しない
ノードを選択しても、すべてのアプリが自動的にプロキシを使うわけではありません。デスクトップでは通常、「システムプロキシ」メニューで「システムプロキシを自動設定」を選び、OSの設定に従うアプリをローカル待ち受けポートに接続します。ブラウザーでページを開けたら、他のアプリに個別のプロキシ設定がないか確認してください。仮想ネットワークアダプターによる通信の取り込みとは異なり、システムプロキシですべての通信が経由されるわけではありません。特定のアプリだけ使えない場合は、まずそのアプリの接続経路を確認しましょう。使い終わったら「システムプロキシを解除」し、終了したクライアントをOSが参照し続けないようにしてください。
システムプロキシの設定を見る
マッチ条件とアウトバウンドを区別
domain:example.com→proxygeoip:private→directルーティングルールは、コアに届いたリクエストのアウトバウンドを決めるもので、アプリの通信を自動的にクライアントへ取り込む機能ではありません。まずは既定のルールで接続を確認し、必要なドメインやアドレス範囲だけ「ルーティング設定」で変更してください。図のdomainとgeoipはマッチ条件、proxyとdirectはアウトバウンドの種類です。例示した行だけでは、そのまま使える完全な設定にはなりません。すべてのリクエストを同じ経路に流すのではなく、ルーティングを分けることでLAN内アクセスなどを維持できます。ルールの順序に注意し、ログで適用結果を確認してください。出所の不明な大量のルールを一度に読み込むのは避けましょう。
ルーティングのトラブル対処を見る
信頼できるネットワークでのみ使用
ローカル待ち受けポート10808
LANからの接続を許可
LAN共有を使うと、同じ信頼できるネットワーク上の別の端末から、パソコンのプロキシ接続を利用できます。「詳細設定」の「Core 基本設定」で「LANからの接続を許可」を有効にし、実際の待ち受けポートを確認してから、パソコンのプライベートIPアドレスを他の端末のプロキシ設定に入力してください。各端末で個別にクライアントを使う場合とは異なり、パソコンを常時起動しておく必要があり、ファイアウォールやWi-Fiの端末間通信制限の影響も受けます。他の端末の接続先にループバックアドレスを指定しないでください。共有が終わったら設定を無効にし、プロキシポートを公衆ネットワークに公開しないようにしましょう。
LAN共有の設定ガイドを見るインストールから接続確認まで
v2rayN クイックスタート
初回設定では、まず動作を確認できる接続を1つ確立し、その後に自動起動やルーティングの詳細設定、共有を行いましょう。以下の3ステップは前後の依存関係に沿っているため、サーバー一覧が空の状態から始める場合にも適しています。
インストールしてサブスクリプションを読み込む
利用するプラットフォームに合ったクライアントをダウンロードし、インストール後にメイン画面を開きます。v2rayNの「サブスクリプショングループ設定」でURLを追加して保存し、サブスクリプションを更新してください。クリップボードからノードを読み込む場合は、コピーした内容がすべて含まれていることを確認してから、対応する読み込みメニューを使います。通常のWebページのURLをノードリンクとして入力しないでください。
更新が完了すると、サーバー一覧に設定が表示されます。まずグループとプロトコルを確認し、使うノードを選択してください。解析エラーが出た場合は、ログに記録された原因を確認し、設定の取得元に戻って形式を確認します。サブスクリプションURLが無効な場合、クライアントを再インストールしても解決しません。
ノードとプロキシ方式を選ぶ
使用するノードをアクティブサーバーに設定し、コアが起動するまで待ちます。デスクトップでは「システムプロキシ」から「システムプロキシを自動設定」を選び、ルーティングはまず既定の設定を使いましょう。複数のクライアントでシステムプロキシを同時に有効にすると、後から起動したプログラムが先に設定されたアドレスやポートを上書きする場合があります。
スマートフォンでv2rayNGを使う場合は、接続を開始した後、システムの案内に従ってVPN接続を許可します。これはパソコンのプロキシメニューとは別の操作です。同種の接続を使うアプリがほかにもある場合は、どのアプリが通信を取り込むのかを決めてからテストしてください。接続の競合をノードの障害と誤認するのを防げます。
通信を確認して設定を元に戻す
アクセスできることがわかっているページを開き、正常に表示されるか確認します。クライアントのログも確認し、リクエストがローカルの接続先に届いているかを調べましょう。遅延テストの結果は特定の測定方法に限られ、Webサイトやダウンロード、対象アプリでの実際の通信確認の代わりにはなりません。実効速度を直接示す値でもありません。
接続できない場合は、まずローカルの待ち受けとシステムプロキシを確認し、次にノードのパラメーターとサーバーへの到達性を調べます。テスト後はデスクトップでシステムプロキシを解除してからクライアントを終了し、通常のネットワーク接続に戻ったことを確認してください。この手順を覚えておけば、ノードを切り替えたときに設定変更とシステムに残った設定を区別しやすくなります。
エラー発生時の情報を記録する
トラブル対処を始める前に、サブスクリプションの更新、コアの起動、接続先のWebページへのアクセスのうち、どの段階でエラーが起きたか記録しましょう。ログの「解析に失敗」「接続拒否」「接続タイムアウト」は、それぞれ問題の段階が異なり、対処方法も違います。エラーの発生時刻とメッセージは記録して構いませんが、外部に相談する前にサブスクリプションURL、ユーザーID、ノードの認証情報を隠してください。詳しいガイドは操作の順に説明し、トラブル対処ページは症状別にまとめています。前者は設定を始めるとき、後者は原因を絞り込むときに役立ちます。
症状から解決方法を探す →クライアントとコアの役割
Project Vのオープンソースエコシステム
V2Rayはエコシステムに関わる技術名で、v2rayNやv2rayNGはユーザーが直接操作するクライアントです。名称だけでソフトを選ぶより、インターフェース、コア、プロトコル、サービス設定を分けて理解することが大切です。
Project VとV2Flyの関係
Project Vはプロキシ通信に関するモジュール型のツールを提供し、V2Rayは広く利用される中核プロジェクトの1つです。V2FlyコミュニティはV2Ray関連の実装やドキュメントを引き続きメンテナンスしています。そのため、クライアントの説明、設定資料、エラーログではProject V、V2Ray、V2Flyの名称が併記されることがあります。これらはそのまま置き換えられる3種類のダウンロードボタンではありません。ドキュメントを読むときは、プロジェクトの背景、コアの実装、具体的なGUIのどれについて説明しているのかを確認しましょう。
GUIクライアントはよく使う設定をメニューやフォームにまとめ、コアは設定を解釈して接続を処理します。サーバー一覧の項目を変更すると、通常はクライアントが生成する実行設定に反映されます。コア関連のオプションを変更すると、プロトコルの対応状況、ドメイン名の解決、ルーティングの動作などが変わる場合があります。この関係を理解しておけば、エラー発生時に画面操作と接続パラメーターのどちらを確認すべきか判断しやすくなります。
XrayとV2Flyのコアの違い
XrayはV2Rayの技術的な流れをくむ独立したコアプロジェクトです。V2Flyがメンテナンスする実装とは共通の背景がありますが、その後の機能開発や設定への対応は完全には一致しません。VLESSやVMessと表記されたノードでも、トランスポートやセキュリティレイヤー、拡張パラメーターが異なる場合があります。利用できるかどうかはプロトコル名だけで判断せず、すべてのパラメーターと現在のクライアントに含まれるコアを照らし合わせてください。
コア選びでまず確認すべきなのは互換性であり、単純な速度ランキングではありません。サーバー側が必要とする機能、クライアントが実際に対応する項目、ネットワーク環境はいずれも接続結果に影響します。同じ設定が一方の端末では使えて別の端末では使えない場合、まずコアとパラメーターの対応範囲を比べ、コピーやサブスクリプション変換で項目が欠落していないか確認しましょう。端末の性能不足と決めつけないでください。
3つのオープンソースクライアントの役割
v2rayNはデスクトップ向けで、サーバー一覧、サブスクリプショングループ、システムプロキシ、ルーティングなどの操作機能を備えています。デスクトップ版はクロスプラットフォームの画面を採用し、従来のWPF版は旧来の画面に慣れたユーザー向けです。v2rayNGはモバイル向けでXrayコアを使用しており、スマートフォン用の第一候補として適しています。v2flyNGはV2Flyコアを使う選択肢で、該当コアの機能が必要な設定に向いています。
3つのクライアントはいずれもオープンソースで提供されています。再配布や改変の条件は各プロジェクトに付属するライセンスを確認してください。クライアントとコアのライセンスも分けて理解する必要があります。オープンソースは実装やコミュニティのメンテナンス状況を把握する助けになりますが、サブスクリプションの取得元、実行権限、ローカル設定の確認に代わるものではありません。このサイトのダウンロード案内や使い方も、ノードサービスや接続の可用性を保証するものではありません。
更新前に変更されたレイヤーを見極める
クライアントの更新では、画面構成や設定の生成方法、同梱コアが変わる場合があります。一方、サブスクリプションの更新は主にサービス一覧やパラメーターを更新するもので、別の操作です。メニューの場所が変わったら、機能名から探してください。以前のスクリーンショットを再現するために、正常に動作している設定を変更する必要はありません。ダウンロードページでは各プラットフォームの入手先と要件をまとめており、ホームページでは特定のリリース番号を選択基準にしていません。
更新前に使用中のノードグループ、プロキシ方式、カスタムルールを記録し、必要であればクライアントの機能で設定を保存してください。更新後は基本的な接続を確認してから、カスタムルーティングやLAN共有をチェックします。更新後にだけ問題が起きた場合は、ログと設定の変更を比較して原因を絞り込みましょう。サブスクリプションの変更、コアの切り替え、ルールの書き換えを同時に行うと、影響した要因を特定しにくくなります。
目的に合わせて読む
設定・トラブル対処の記事
基本的な接続ができたら、端末や用途に合わせたガイドを確認しましょう。プロトコルの選択、システム権限、共有設定にはそれぞれ前提があります。必要な課題を先に明確にすると、高度な設定をまとめて変更するより結果を確認しやすくなります。
VMess・VLESS・Trojan・Shadowsocksの選び方：4つのプロキシプロトコルの特徴と用途
よく使われる4つのプロトコルについて、暗号化方式、トランスポートの組み合わせ、クライアントの対応状況を比較します。日常のWeb閲覧、モバイル回線、旧型端末などの用途別に選び方を紹介。まずサーバー側の設定を確認し、クライアントに必要な機能を判断しましょう。
プロトコルの比較を見る →v2rayNでLAN接続を許可する設定：スマートフォンや別のパソコンからデスクトップのプロキシを使う
LAN接続の許可、待ち受けポートとパソコンのプライベートIPアドレスの確認、他の端末へのプロキシ設定、ファイアウォールの許可まで、LAN共有の手順を解説します。同じWi-Fiに接続していても端末間で通信できないことがある理由も説明します。
LAN共有の設定を見る →macOSでv2rayNの開発元を検証できないと表示される場合：プライバシーとセキュリティでの許可、ネットワーク権限の設定
初回起動時にv2rayNがブロックされた場合の許可手順と、システムプロキシやネットワーク拡張に関する権限の設定場所、よくあるつまずきを解説します。アプリを開けない問題と、起動後に接続できない問題を分けて対処し、関係のない設定を変更しないようにします。
権限の設定方法を見る →