クライアントと設定ドキュメント

V2Rayヘルプセンター v2rayN クライアントのダウンロードと設定

v2rayN と v2rayNG クライアントサブスクリプションのインポート手順Windows / macOS / Android / Linux の設定方法をまとめ、インストールから接続、ルーティング、DNS設定まで順に解説します。

永久無料 オープンソース Xray · V2Fly 日本語ドキュメント

使用するプラットフォームを選択

クライアント設定のポイント

サブスクリプションのインポートから ルーティングとDNSまで

GUIクライアントの基本操作は、サブスクリプションを1件追加するだけではありません。グループ分け、プロキシの入口、ルールによる振り分け、DNSの問い合わせ経路が、接続の安定性やプロキシを経由するアプリ、LANやローカルサービスへのアクセス可否を左右します。ここでは実際の設定順に、4つの重要な段階に分けて説明します。

リスト管理

サブスクリプションとサーバーを提供元ごとに整理

複数の設定元を同時に管理するなら、サブスクリプショングループが便利です。グループごとに更新間隔、利用状態、サーバーのフィルター条件を設定できるため、更新時に異なる提供元をまとめて処理せずに済みます。初めて使う場合は、まずメインのグループを1つ作成し、サブスクリプションURLを登録して手動更新を1回実行し、サーバー項目が表示されることを確認しましょう。設定元が増えたら、名前の接頭辞だけで探すより、用途や提供元に分けてグループ化すると分かりやすくなります。

サーバー一覧が長い場合は、キーワードの包含・除外条件で表示範囲を絞り、現在のグループに対して実接続テストを行えます。フィルターは一覧の整理方法だけを変え、サブスクリプション元の設定は変更しません。元に戻すには条件をクリアしてください。

サブスクリプショングループ 有効
メインサブスクリプション 自動更新 · グループフィルター
予備設定 手動更新 · 個別管理
フィルター条件 キーワードを含む

OSから選択

4つのプラットフォームの クライアント入手先

デスクトップではv2rayNが主な選択肢です。Androidでは、コアの要件に応じてv2rayNGとv2flyNGから選べます。ダウンロードページでは、プロセッサアーキテクチャとインストール形式に合ったファイルを選択できます。

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

Windows

v2rayNがおすすめです。デスクトップ版はクロスプラットフォームのインターフェースを採用し、従来型のWindows操作を好む場合はクラシックWPF版が適しています。インストール後はサブスクリプショングループから設定を始め、システムプロキシを有効にして接続を確認します。

ダウンロードへ

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

macOS

v2rayNのmacOSビルドを使用します。ダウンロード前にシステム情報でApple SiliconかIntelかを確認し、対応するインストールファイルを選んでください。初回起動後は、システムの指示に従って必要な権限を許可します。

ダウンロードへ

モバイルクライアント

Android

Xrayコアを採用するv2rayNGを優先的に選べます。V2Flyコアが必要な場合はv2flyNGを使用してください。近年の端末の多くはarm64ビルドに適しています。プロセッサアーキテクチャを確認できない場合は、汎用ビルドを選択できます。

ダウンロードへ

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

Linux

v2rayNのLinuxビルドを使用し、ディストリビューションのパッケージ管理方式に合わせてdebまたはrpmを選択します。x64とarm64の区別も必要です。インストール後はデスクトップのランチャーから起動し、システムプロキシまたはTUNを設定できます。

ダウンロードへ

クイックスタート

インストール後に行う 3つの操作

初回設定は決まった順序で進めるのがおすすめです。まずサブスクリプションをインポートし、サーバーを選んで実接続テストを行い、最後にシステムプロキシを有効にして接続先を確認します。各段階の結果が明確になるため、問題が起きてもサブスクリプション、サーバー、本体のプロキシ設定のどこに原因があるかを切り分けやすくなります。

詳しい手順を見る →
  1. 01

    サブスクリプションをインポートしてグループを更新

    クライアントでサブスクリプショングループを開き、新しいグループを作成してサービス提供元から渡されたサブスクリプションURLを貼り付け、保存して更新を実行します。更新後に設定項目が表示されるはずです。リストが空の場合は、グループが有効か、URLの前後に空白が混入していないか、現在のネットワークから提供元へアクセスできるかを確認してください。グループを何度も作り直す前に、ログで更新リクエストの結果を確認しましょう。

  2. 02

    サーバーを選び、実接続テストを行う

    現在のサブスクリプショングループから項目を1つ選び、実接続テストを実行するか、アクティブサーバーに設定します。テスト結果は実際の接続確立に必要な時間を示すため、単純なネットワーク探査だけの場合より日常の利用状況に近い指標になります。複数の項目に接続できない場合は、プロキシモードを連続して切り替えるのではなく、サブスクリプションの期限、システム時刻の正確さ、コアの正常な読み込みを優先して確認してください。

  3. 03

    システムプロキシを有効にして接続先を確認

    初回接続ではまずシステムプロキシを有効にし、ブラウザーで普段使うWebページを開いて接続先アドレスが想定どおり変化したか確認します。ブラウザーは正常なのに他のアプリで反映されない場合、そのアプリがシステムプロキシに従っていない可能性があります。その場合にTUNモードやアプリ独自のプロキシ設定を検討します。確認後は、ルーティングルール、起動時実行、サブスクリプションの更新間隔を設定できます。

オープンソースエコシステムの概要

Project V、V2Fly、Xrayコアファミリー

クライアントとコアの関係を理解すると、更新内容がインターフェース層、コア処理層、プロトコル実装層のどこに由来するかを判断しやすくなります。GUIクライアントはサブスクリプション、一覧、ルール、システム連携を担当し、コアはプロトコル処理、ルーティングの実行、ネットワーク接続を担当します。役割が異なるため、リリースのタイミングも異なる場合があります。

A

Project Vエコシステムの出発点

Project Vは、プロキシプロトコル、ルーティング機能、組み合わせて使えるネットワークツールを中心に形成されたオープンソースエコシステムです。初期のV2Rayは、設定構造、複数のインバウンド・アウトバウンド、ルーティング照合などの基本概念を築き、その後コミュニティのメンテナンス方針から複数の分岐が生まれました。現在よく使われるクライアントはすべての機能を一から実装するのではなく、コアを呼び出し、複雑な設定をデスクトップやモバイル端末で扱いやすいGUIに整理しています。

そのため、「V2Rayクライアント」という言葉を見たら、3つの層を区別する必要があります。ユーザーが操作するGUIクライアント、接続とルールを実行するコア、そしてサブスクリプションや手動設定で記述されるプロトコルパラメータです。トラブルシューティングも層ごとに行います。画面に項目をインポートできないならサブスクリプション管理、コアの起動失敗ならコア、特定ドメインの接続先が想定と異なるならルーティングやDNSが主な原因です。

B

V2FlyとXrayの役割の違い

V2FlyはV2Rayコミュニティの分岐を引き継ぐ方向で保守され、組み合わせ可能な設定体系を維持しながら、プロトコル、トランスポート、ルーティング機能を更新しています。Xrayはエコシステム内の別のコアファミリーで、一般的な設定方針との互換性を保ちつつ、独自のプロトコル実装と機能構成を発展させています。どちらもGUIクライアントではなく、特定OSのアプリ画面そのものでもありません。

コアを選ぶときは、サブスクリプションが必要とするプロトコル、クライアントの対応状況、既存設定との互換性を重視します。多くのユーザーはコアを頻繁に手動で切り替える必要はありません。提供元が特定のコア機能を明示的に要求している場合や、ログに現在のコアが設定項目を認識できないと表示された場合に、説明に従って調整してください。コア更新後に動作が変わったときは、すべてのサブスクリプションとルーティングを作り直すのではなく、まずクライアントログと設定移行の案内を確認します。

C

3つのクライアントの役割

v2rayNはデスクトップで広く使われるGUIクライアントで、Windows、macOS、Linuxに対応し、サブスクリプショングループ、サーバー一覧、システムプロキシ、TUN、ルーティング、DNS、コア管理などを提供します。同じ機能でも、OSによって権限の扱いやシステム連携の詳細は異なる場合がありますが、基本的な設定ロジックは共通しています。複数のデスクトップ環境で同じ操作感を使いたい場合に適しています。

v2rayNGはAndroid向けで、通常はXrayコアと組み合わせて使用し、設定一覧、サブスクリプション更新、ルーティング、接続切り替えを中心に構成されています。v2flyNGもAndroid向けですが、V2Flyコアを使用するため、特定のコア要件がある場合の代替になります。どちらもサブスクリプションをインポートでき、個別の設定を管理することも可能です。移行時は、サブスクリプションが対応するプロトコルと項目を先に確認してください。

D

オープンソースと更新の仕組み

クライアントとコアはオープンソース方式で保守され、機能の議論、バグ修正、リリースは各プロジェクトのコミュニティが進めます。オープンソースライセンスはコードの利用と再配布の範囲を定め、実装の詳細を確認できるようにします。プロジェクトごとに具体的なライセンスは異なる場合があるため、利用、変更、再配布の際は付属するライセンス本文に従ってください。

クライアントの更新には、インターフェース、システム連携、サブスクリプション処理、コアの呼び出し方式が含まれることがあります。一方、コアの更新はプロトコル実装、トランスポート、ルーティング、DNS、実行効率に重点が置かれます。両方が常に同時に更新されるとは限りません。普段の利用では、まずリリースノートを読み、設定移行やシステム権限の変更があるか確認してから更新しましょう。異常が起きたときは、単に「接続できない」と書くより、ログと現在の設定を残すほうが原因の特定に役立ちます。

よくある質問

インストール、サブスクリプション、接続の確認手順

初回利用時の問題の多くは、「インストールファイル → サブスクリプション更新 → サーバー接続 → システムプロキシ → ルーティングとDNS」の順に確認できます。同じ操作で複数の層を変更すると、どの調整が結果をもたらしたのか分かりにくくなります。

デスクトップでは、まずどのクライアントを選べばよいですか?

Windows、macOS、Linuxでは、まずv2rayNを選べます。サブスクリプショングループ、サーバー一覧、システムプロキシ、TUN、ルーティング、DNSを同じデスクトップ画面で管理できます。ダウンロード前にOSとプロセッサアーキテクチャを確認し、インストール後はシステムプロキシで基本接続を確認してから、アプリの要件に応じてTUNを有効にしてください。

サブスクリプションをインポートした後、サーバー一覧が空なのはなぜですか?

まずサブスクリプショングループが有効になっていることを確認し、手動で1回更新します。次にログで、URLにアクセスできない、内容形式を認識できない、ネットワークリクエストに失敗したなどの表示を確認してください。サブスクリプションURLの前後に空白がないかも確認します。更新が成功しているのにフィルター後の一覧が空なら、グループのフィルター条件を解除して元の項目を確認してください。

システムプロキシとTUNモードは同時に有効にすべきですか?

初回利用では同時に有効にしないことをおすすめします。まずシステムプロキシでブラウザーと普段使うデスクトップアプリを確認し、サブスクリプション、サーバー、コアが正常に動作することを確かめます。システムプロキシを参照しないアプリを実際に引き受ける必要がある場合だけ、TUNを個別にテストしてください。切り替え中に通信異常が起きたら、まず元のモードに戻し、権限、仮想NIC、ルーティング、DNSを順に確認します。

テストは正常なのに、特定のアプリだけ接続できないのはなぜですか?

テストが正常でも、クライアントが現在のサーバーへ接続できることを示すだけで、すべてのアプリが自動的にシステムプロキシを使うとは限りません。まずアプリがシステムプロキシに従うか確認し、次に独自プロキシの設定、特殊なネットワークインターフェースの使用、対象がルールによって直接接続またはブロックになっていないかを確認します。ドメインへのアクセスだけで問題が起きる場合は、DNSの解決経路も確認してください。