• V2Ray クライアント・設定項目リファレンス

v2flyNG ダウンロード V2Ray クライアントと設定ハンドブック

プラットフォームに合ったオープンソースクライアントを選び、サブスクリプションをインポートしてから、ルーティング、DNS、TUNモードを順に設定します。

  • Xray / V2Fly
  • サブスクリプショングループ
  • ルールベースの振り分け

画面は設定項目を示すための例であり、すべての項目を有効にすることを推奨するものではありません。LANからの接続許可、ルール用リソース、コアの対応状況は、利用環境に合わせて確認してください。

CONFIGURATION INDEX

設定項目からガイドを探す

まず接続できることを確認し、その後グループ、振り分け、トラフィックの取り込み方法を順に調整します。設定例は項目の説明用であり、完全な設定ファイルとしてそのまま上書きできるものではありません。

サブスクリプショングループ:更新先とフィルター条件を分けて管理

「サブスクリプショングループ設定」を開き、配信元ごとに個別のグループを作成して、完全なサブスクリプションURLを入力します。グループ名は配信元の識別に使い、フィルター条件は一覧に表示するサーバーを決めるため、混同しないようにしてください。初回更新時はフィルターを空欄にし、内容を取得できることを確認してから名前で絞り込みます。更新後に一覧が空になった場合は、まずリンクの有効性と応答内容がサブスクリプション形式かを確認し、次にフィルター式を見直してください。共有リンクをまとめて直接インポートする方法と異なり、サブスクリプショングループなら更新先を保持でき、配信元ごとに再読み込みできます。ログを共有する前に、サブスクリプションURLに含まれるアクセス認証情報を削除してください。

v2rayN → サブスクリプショングループ設定
グループを追加 → サブスクリプションURLを入力 → 保存
サブスクリプショングループ → 現在のサブスクリプションを更新(プロキシを使用しない)
詳細ガイドでこの章を読む →

「インポート成功 → コア起動 → アプリがプロキシを利用 → ルールに一致」の順に確認します。サブスクリプションの更新と接続テストは別の操作です。サブスクリプションを読み込めても、更新先にアクセスできたことを示すだけで、各サーバーへの接続を保証するものではありません。ブラウザーでページを開けても、ほかのアプリがプロキシを利用しているとは限りません。変更は一度に1項目だけにし、変更前の値を控えておけば、結果と原因を結び付けやすくなります。

初めて設定する場合はクイックスタートから始め、接続できる状態になってから詳細ガイドへ進んでください。見慣れない項目があれば、まず用語集でプロトコル、トランスポート、コア、アウトバウンドの違いを確認します。画面の項目名はクライアントのリリースによって変わる場合があるため、実際の設定画面を基準にしてください。異なるコアのJSON設定を混ぜて貼り付けないでください。

PROJECT V / V2FLY / XRAY

オープンソースのコアとGUIクライアントを区別する

クライアントのダウンロードで解決するのはインストールと管理の問題です。設定能力はコアによって決まり、接続にはサーバーパラメーターのインポートも必要です。この3つの段階を分けて確認してください。

Project Vとコアの系譜を理解する

Project Vは、ネットワークプロキシツールとその機能を中心とするプロジェクト群で、V2Rayはその重要な構成要素です。V2FlyコミュニティはV2Rayコアの開発と保守を引き継いでいます。Xrayは関連する技術基盤から発展し、独自のコアと機能開発の道筋を持っています。一部のプロトコル概念や設定方法は共通していますが、同じプログラムの別画面というわけではありません。「V2Rayコアの違い」を調べるときは、対応プロトコル、トランスポートの組み合わせ、設定項目、クライアントとの連携方法を合わせて確認してください。

コアは設定を読み込み、インバウンド接続を受け付け、ルーティングを照合してアウトバウンドを確立します。GUIクライアントは、サブスクリプションや設定をコアが読み取れる形式に変換し、起動、停止、ログ、システム連携の機能を提供します。クライアント名が似ていてもコアが同じとは限らず、同じクライアントが複数のコアを呼び出す場合もあります。アプリ名だけで互換性を判断するより、実際に起動したコアとログを確認するほうが確実です。

プロトコル名は通信する双方がデータをやり取りする方法を示し、トランスポート方式はデータを運ぶ経路を示します。セキュリティ設定はハンドシェイクと認証に影響します。共有リンクをインポートすると、クライアントはこれらの項目を解析しますが、サーバー側の不足した設定を補うことはできません。接続できない場合は、ソフトウェアのインストールに原因を決めつけず、まずサーバーアドレス、ポート、時刻、ハンドシェイク設定を確認し、その後コアの対応状況を調べてください。

端末に合わせて3つのオープンソースクライアントを選ぶ

v2rayNはデスクトップ向けで、サブスクリプション管理、ルーティング設定、複数コアの呼び出しなどに対応します。デスクトップ版はクロスプラットフォームのUIを採用し、クラシックWPF版は別のデスクトップUIと操作方法を維持しています。選ぶ際は、まずOSとアーキテクチャを確認し、次に必要なUI機能を比べてください。名前が同じだからといって、2種類の配布形式を同じディレクトリにインストールする必要はありません。アップグレードや移行の前に、サブスクリプショングループ、ルーティング、独自設定をバックアップし、上書き後に元へ戻せなくなるのを防ぎましょう。

v2rayNGはAndroid端末向けで、主にXrayコアを使って接続し、システムのVPNインターフェース経由でアプリの通信を受け取ります。v2flyNGはV2Flyコアを使う代替クライアントです。画面やインポート手順が似ていても、コアの対応範囲は個別に確認してください。モバイル端末では、クライアント名だけで接続できると判断せず、サーバー設定とコアの互換性を確認したうえで、アプリごとのプロキシ設定、バックグラウンド動作、バッテリー管理を確認します。

これら3つのクライアントはいずれもオープンソースプロジェクトを基盤としています。オープンソースとは、ソースコードと適用ライセンスを確認できるという意味であり、独自に変更した配布ファイルも同じ由来だという意味ではありません。ライセンスを確認する際は、クライアントと組み込まれたコアを分けて考えてください。V2RayコアはMITライセンス、XrayコアはMPL-2.0ライセンスを採用し、クライアント本体にも各プロジェクトのライセンス条件が適用されます。変更や再配布を行う場合は、それぞれに適用される条件を確認してください。

ソフトウェア、サブスクリプション、ルールを別々に更新する

ソフトウェアの更新はクライアントやコアの実行機能を変更し、サブスクリプションの更新はサーバーパラメーターを読み込み、ルールリソースの更新はドメインやアドレスの分類と照合に影響します。この3種類の更新は別のものです。サブスクリプションの失敗時にクライアントを再インストールしても、無効になったリンクは通常直りません。ルールが一致しない場合もサーバー障害とは限らず、分類リソース、照合順序、対象ドメインの識別が原因のことがあります。まず何を更新するかを特定し、適切な更新方法を選んでください。

自動サブスクリプション更新を設定する前に、まず手動で一連の操作を確認してください。リンクにアクセスできること、内容を認識できること、グループのフィルター条件が正しいことを確かめてから、配信元の実際の更新頻度に合わせて間隔を設定します。プロキシ経由で更新するかどうかは、現在のネットワークからサブスクリプションURLにアクセスできるかで判断してください。接続自体が使えない状態で、更新をその接続に依存させないでください。また、何度も更新を繰り返して証明書エラーを直そうとせず、システム時刻と具体的なエラーを確認してください。

コアやルールリソースを変更した後は、固定のテスト対象を用意してください。直接接続する想定のドメイン、プロキシを使う想定のドメイン、実際にアクセスが必要なLAN内リソースをそれぞれ1つ選びます。ログと照らし合わせ、意図したルールに一致しているか確認してください。結果を確かめてからDNSの変更やTUNの有効化に進めば、複数の要因が影響し合うのを抑えられます。設定の書き出しやスクリーンショットの共有前には、サーバーの識別情報、サブスクリプションの認証情報、トラブル対応に不要な個人情報を削除してください。

通信経路に沿ってガイドとログを読み解く

システムプロキシは、その設定を参照するアプリにプロキシの接続先を提供するだけで、すべてのプログラムに同じ経路を強制するものではありません。ルーティングルールは通信がコアに入った後でアウトバウンドを決めます。そのため「グローバルプロキシ」と「すべてのアプリの通信を取り込む」は同じ意味ではありません。ブラウザーは正常でもほかのプログラムに問題がある場合は、まずそのプログラムがシステムプロキシを使っているか、ローカルプロキシアドレスを個別に設定する必要があるかを確認します。誤った層のルールを何度も変更する前に、TUNによる取り込みが必要かを検討してください。

DNSの問題も、どの段階で起きているかを分けて考えてください。アプリがシステムリゾルバーでアドレスを取得する場合もあれば、ルーティング照合や接続時にコアが名前解決する場合もあります。ログにアドレスが表示されても、元のドメイン名が保持されているとは限りません。トラフィックの嗅ぎ分けを有効にしても、すべての接続からドメイン名を復元できるわけではありません。ドメイン単位で振り分ける場合は、インバウンド、名前解決の経路、sniffing設定の関係を確認してください。FakeDNSを使う設定は通信の取り込み範囲も含めて確認し、DNSアドレスだけを置き換えないでください。

エラーログを読むときは、まず操作時刻、対象、エラーの種類を記録し、名前解決、接続、ハンドシェイク、ルーティングのどの段階で発生したかを調べます。接続タイムアウトと証明書エラーでは対処が異なり、コアが起動しない問題と特定の接続先にアクセスできない問題も分けて考える必要があります。基本操作はクイックスタート、組み合わせ設定は詳細ガイドで紹介しています。問題の段階を特定したい場合は、FAQのカテゴリで確認手順を調べてから、該当する設定ページに進んでください。

TECHNICAL NOTES

クライアントのインストールとトラブル対処のメモ

問題を検証可能な手順に分解します。読む前にクライアントの種類、OS環境、問題が起きる条件を記録し、別のプラットフォーム向けの対処法をそのまま当てはめないようにしてください。

V2Ray初心者のよくある質問10選:コア、クライアント、サブスクリプション、接続失敗を解説

初心者からよく寄せられる10の疑問をまとめて解説します。コアとクライアントの違い、3つのクライアントの選び方、サブスクリプションのインポート方法、グローバルプロキシと振り分けの違い、接続できないときの確認項目を紹介します。

クライアントはインストール済みでも、システムプロキシとルーティングモードの違いが分からない方におすすめです。設定を提供する側と通信を受け取る側を整理し、インポートと接続を順番に確認します。用語を画面上の設定項目と対応させれば、その後のトラブル対処を始める位置が明確になります。

初心者向けの質問を読む →

v2rayNGのバッテリー消費が激しいときの対処法:最適化の対象外設定とバックグラウンド動作

Androidでv2rayNGのバッテリー消費が増える主な原因を解説します。アプリごとのプロキシ設定、ログレベル、メーカー独自のバックグラウンド制限を取り上げ、バッテリー最適化の対象外設定とVPNの常時接続に関する設定方法を紹介します。

接続を継続するための消費と、バックグラウンドで再起動を繰り返すことによる消費を分けて考えます。必要なシステム権限を維持し、プロキシが不要なアプリまで通信の取り込み対象にしていないか確認してから、ログで再接続の原因を調べてください。バックグラウンド動作を保つためだけに、システムのバッテリー管理をすべて無効にする必要はありません。

バッテリー消費の確認手順を読む →

macOSにv2rayNをインストールする方法:「開発元を検証できません」の対処とネットワーク権限

macOSでv2rayNを初めて開く際の「開発元を検証できません」という警告への対処、システムプロキシの許可、TUNモードに必要な権限、ログイン項目の設定を、システム設定の手順に沿って解説します。

初回起動時のセキュリティ警告と、起動後に必要となるネットワーク権限を分けて対処します。まずインストール元を確認し、システムに表示された選択肢に従ってください。TUNで通信を取り込む必要がある場合に限って該当する権限を許可し、端末全体のセキュリティ設定を緩める方法を一般的なインストール手順として扱わないでください。

インストールと権限の説明を読む →

すべての記事を見る →

CLIENT DOWNLOADS

OSに合わせてクライアントを選ぶ

まずOSとプロセッサーのアーキテクチャを確認し、該当するプラットフォームのインストーラーを選んでください。クライアントはローカルの設定・接続画面を提供しますが、サーバーパラメーターやサブスクリプションは別途用意する必要があります。インストールが完了しても、接続できる状態とは限りません。

Windows

v2rayN · デスクトップ版/クラシックWPF版

デスクトップ版はクロスプラットフォームのUIを採用し、クラシックWPF版はおなじみのデスクトップ操作を維持しています。ダウンロード前にOSの対応条件を確認し、用途に合った配布形式を選んでください。2種類のプログラムや設定ファイルを同じ場所に混在させず、移行前にはサブスクリプショングループと独自ルーティングをバックアップしてください。

初回起動後、まずサブスクリプションをインポートしてサーバーを選び、「システムプロキシを自動設定」を設定します。ブラウザーで接続できたら、プロキシを個別に設定する必要があるアプリを確認してください。より広い範囲の通信を取り込む必要がある場合に限ってTUNを有効にします。LAN共有を使う場合は、リッスンアドレス、ファイアウォール、アクセス範囲も確認してください。

ダウンロードへ

macOS

v2rayN · Apple Silicon / Intel

「このMacについて」でチップ情報を確認します。Apple Siliconはarm64、Intelはx64を選んでください。インストーラーのアーキテクチャは端末に合わせる必要があります。初回起動時に警告が表示された場合は、まず配布元を確認し、システム設定に表示された選択肢に従ってください。ほかのOS向けの権限操作をそのまま適用しないでください。

インストール後、システムプロキシ、ネットワーク権限、ログイン項目をそれぞれ確認します。ウィンドウを閉じてもクライアントが終了したとは限りません。実際のプロセスやメニューバーの状態を確認してください。利用を終える際は、システムプロキシを元に戻してから終了します。TUNモードでのみ問題が起きる場合は、まず権限と他のネットワークツールとの競合を確認してください。

ダウンロードへ

Android

v2rayNG · Xray / v2flyNG · V2Fly

まずv2rayNGを確認し、V2Flyコアが必要な場合はv2flyNGを検討してください。比較的新しい一般的な端末ではarm64を選びます。アーキテクチャが分からない場合は、汎用版の説明を確認してください。インストール前にOS要件を確認し、インポート後は選択したクライアントとコアが対象プロトコルに対応しているか確かめます。

初回接続時にシステムのVPN許可を求められます。これはアプリの通信を受け取るためのもので、サーバーへの接続確認が済んだことを意味しません。接続後はアプリごとのプロキシ対象を確認し、必要なアプリをテストします。画面ロック後に接続が切れる場合は、バッテリー最適化とメーカー独自のバックグラウンド制限を確認してください。必要な権限だけを維持し、VPNインターフェースを取り合う複数のツールを同時に起動しないでください。

ダウンロードへ

Linux

v2rayN · deb / rpm

ディストリビューションのパッケージ管理方式に合わせてdebまたはrpmを選び、次にx64とarm64を確認します。インストール後はデスクトップ環境からGUIクライアントを起動し、まず通常のユーザー権限でサブスクリプション管理と基本的な接続確認を行ってください。権限確認を省くために、デスクトップアプリ全体を常に高い権限で実行しないでください。

システムプロキシの参照方法はデスクトップ環境によって異なります。Webは使えても特定のプログラムが接続できない場合は、まずそのプログラムがシステム設定を参照するか、個別のプロキシ設定を備えているかを確認してください。TUNを有効にする前に、仮想インターフェースの権限、ルーティング、リゾルバーの設定も確認します。通信の取り込みを停止した後はネットワーク設定が元に戻っているかを確かめ、次回のテストに影響する設定が残らないようにしてください。

ダウンロードへ

すべてのクライアントを見る →