デスクトップではv2rayN、Androidではまずv2rayNGを確認し、コアの要件に応じてv2flyNGも検討してください。
v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版は新世代のクロスプラットフォームUIを採用し、WPF版は従来の操作画面を維持しています。まず使い慣れた画面を基準に選び、ダウンロードページで動作要件を確認してください。同じサブスクリプションを読み込むために、両方をインストールする必要はありません。
初回起動後、設定フォルダーに正常に書き込めることを確認してから、サブスクリプショングループを追加してください。旧環境から移行する場合は、既存の設定やカスタムルーティングを保存し、古いフォルダーを新しいインストール先へそのまま上書きしないようにします。起動に問題があるときは、実行環境と設定のどちらに原因があるかを切り分けてください。
ダウンロードへ Windows インストーラーv2rayNでは、プロセッサに応じてApple Silicon版とIntel版を選べます。macOSの「このMacについて」でチップ情報を確認し、Apple Siliconならarm64、Intelならx64を選択してください。アーキテクチャはサブスクリプションのプロトコルとは無関係です。サーバー側のプロセッサを基準に選ばないでください。
インストール後はクライアントを起動し、サーバーを選んでからシステムプロキシを設定します。ブラウザーにプロキシ拡張機能がある場合は、システム設定より拡張機能の設定が優先されていないか確認してください。ターミナルのプログラムが独自の環境変数を使うこともあります。ブラウザーで接続できても、すべてのアプリが同じ経路を使っているとは限りません。
ダウンロードへ macOS インストーラーv2rayNGはXrayコア、v2flyNGはV2Flyコアを使用します。比較的新しいAndroid端末では、まずarm64版を確認してください。アーキテクチャがわからない場合は、汎用版も検討できます。アプリはファイル名の類似性ではなく、設定との互換性や必要なコアを基準に選びましょう。
初回接続時は、アプリの通信をクライアント経由にするため、システムのVPN接続許可が必要です。画面ロック後に接続が切れる場合は、バッテリー最適化やバックグラウンド実行の制限を確認してください。アプリごとのプロキシ設定では、対象アプリを経由させるか迂回させるかを確認し、「迂回」と「プロキシのみ」を取り違えないようにしましょう。
ダウンロードへ Android インストーラーv2rayNにはdeb版とrpm版のダウンロード先があります。ディストリビューションのパッケージ形式に合わせて選び、プロセッサのアーキテクチャはx64またはarm64から選択してください。パッケージ形式は「どのパッケージ管理ツールでインストールするか」、アーキテクチャは「どのプロセッサで動かすか」を示すため、それぞれ確認が必要です。
インストール後、デスクトップセッションでGUIクライアントを起動し、ローカルの待受状態を確認してください。システムプロキシの扱いはデスクトップ環境によって異なり、アプリによってはプロキシのアドレスとポートを手動で設定する必要があります。インストールできたからといって、すべてのアプリがプロキシを使うとは限りません。
ダウンロードへ Linux インストーラーインストーラーに含まれるのはクライアントプログラムのみです。サブスクリプションURL、サーバー接続情報、アクセス権限は設定の提供元から取得し、インストール後に有効な設定を読み込む必要があります。ダウンロードページではアーキテクチャとパッケージ形式を、クライアント比較ページでは各アプリに適した環境を説明しています。
すべてのクライアントを見る →まずクライアントの設定項目を見つけ、どの設定層に影響するかを確認しましょう。
サブスクリプショングループはクライアント側の管理項目であり、コアJSONで共通に使われるトップレベルのフィールドではありません。配信元ごとにわかりやすい名前を付け、サブスクリプションURLを入力して更新したら、サーバー設定が追加されたことを確認します。更新に失敗した場合は、URLにアクセスできないのか、取得した内容を解析できないのか、現在のネットワーク経路に問題があるのかを切り分けてください。継続的に更新される配信元は、サーバーを一件ずつ手動管理するよりグループで管理する方が便利です。ただし、ローカルでの変更が保持されるかはクライアントの動作によるため、重要な設定は別途保存してください。
サブスクリプショングループ
├─ メモ
├─ サブスクリプションURL
└─ サブスクリプションを更新ルーティングルールは、コアに届いた通信をどの出力先へ渡すかを決めます。ルールは通常、上から順に評価され、一致したルールの出力タグが使われるため、具体的な条件を広い条件より前に配置します。この例では中国本土のドメインリストをdirectに振り分けています。該当する出力先とルールデータが定義済みであることが前提です。ルーティングルールだけでアプリが自動的にプロキシへ接続されるわけではなく、システムプロキシの切り替えとも別の機能です。振り分けを調べるときは、まずリクエストがコアに届いているかを確認し、その後に一致条件とタグを調べてください。異なる設定層を何度も変更するのは避けましょう。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}システムプロキシは、OSの設定に従うアプリに対して、リクエストを送るローカルアドレスとポートを指定します。有効にする前に、コアが起動していることと、ポートに対応するプロトコルが正しいことを確認してください。ブラウザー拡張機能、コマンドラインの環境変数、アプリ内蔵の設定はそれぞれ別の経路を使うことがあるため、システムプロキシだけですべての通信を切り替えられるわけではありません。コアやクライアントによっては混合型の待受に対応し、HTTPとSOCKSを別々に設定するものもあります。一般的なポート番号だけでプロトコルを判断せず、実際の待受設定を確認してください。
システムプロキシ → システムプロキシを自動設定
ローカルアドレス → 127.0.0.1
待受ポート → クライアントの実際の設定を確認GUIクライアントは設定を管理し、コアは接続を実行します。コアを切り替える前に、プロトコル、トランスポート方式、安全設定がサポートされているか確認してください。名前が似ていても、設定項目に完全な互換性があるとは限りません。v2rayNGはXray、v2flyNGはV2Flyを使用します。デスクトップでは、v2rayNで現在選択できるコアを確認してください。切り替え後は、動作確認済みの設定で接続をテストしてからカスタムルーティングを戻します。起動に失敗した場合は、サーバーアドレスとポートを同時に変更するのではなく、まず設定の解析エラーを確認してください。
クライアント管理層 → 設定の生成
コア実行層 → プロトコルとトランスポート
確認手順 → 設定の解析 → 接続の確立ローカルのループバックアドレスだけで待ち受けている場合、ほかの端末からプロキシへ直接接続できません。LANからの接続を許可すると待受範囲が広がるため、ファイアウォールやアクセス制御を設定し、正しいホストアドレスを使う必要があります。共有先の端末には、クライアントを実行しているPCのLANアドレスを指定し、共有先自身のループバックアドレスは使わないでください。信頼できるネットワークで必要なときだけ有効にし、使用後は無効にします。プロキシのポートをインターネットに公開しないでください。接続を拒否される場合は、待受アドレスとファイアウォール、プロキシのプロトコル、接続先端末のポート設定の順に確認します。
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}これはローカル端末専用のインバウンド設定例であり、LANに公開する設定ではありません。
クライアントの画面設定とコア設定は、一対一で対応しているわけではありません。サブスクリプショングループやウィンドウ設定などはクライアントが保存します。一方、インバウンド、アウトバウンド、ルーティング、DNSは一般的なコア設定のオブジェクトです。手動で編集する前に、変更対象がクライアント設定なのか、起動時に再生成される可能性がある実行設定なのかを確認してください。
JSON構造と設定項目を見る →「設定の取得元 → 通信の入口 → 接続結果」の順に進めます。
サブスクリプショングループの設定を開き、配信元がわかる名前と完全なサブスクリプションURLを入力します。保存して更新したら、利用可能な設定が一覧に表示されたことを確認し、使用するサーバーを選びます。単独の共有リンクを持っている場合はクライアントのインポート機能を使い、サブスクリプションURLの欄に入力しないでください。
インポートに成功したのは、内容を解析できたことを示すだけで、サーバーへの接続を保証するものではありません。まずアドレス、ポート、プロトコル、トランスポート、安全設定が同じ設定情報に基づいているか確認してください。サブスクリプションURLにアクセス情報が含まれる場合があるため、公開するスクリーンショットや質問文に載せないでください。ログを共有する前にも、機密情報を取り除きましょう。
接続を開始したら、待受ポートが使用中というエラーが出ていないことを確認し、必要に応じてシステムプロキシを有効にします。ブラウザーは通常システム設定を参照しますが、ターミナルや一部のデスクトップアプリでは個別設定が必要です。プロキシを手動で指定する場合は、アドレス、ポート、プロトコルをクライアントの実際の待受設定に合わせてください。
次に、用途に合ったルーティングモードを選びます。ルーティングはリクエストがコアに入った後の経路を制御し、システムプロキシはアプリからコアへリクエストを渡すかどうかを制御します。別々の設定です。初めて使う場合は、まずクライアントの基本ルールを使い、接続を確認してから独自のドメインやアドレス条件を追加しましょう。
プロキシを使うアプリで接続先にアクセスし、クライアントに対応する接続ログが表示されるか確認します。特定のアプリだけ失敗する場合は、そのアプリ独自のプロキシ設定を確認してください。すべてのアプリで失敗する場合は、コアの実行状態、サーバー設定、ネットワーク接続を調べます。原因を特定できるよう、一度に変更する条件は一つにしましょう。
ログに表示される接続拒否、タイムアウト、ハンドシェイク失敗は、それぞれ異なる段階の問題です。すべてをサブスクリプションの失効と決めつけないでください。一時的にログレベルを上げると原因を特定しやすくなりますが、解決後は通常のレベルに戻しましょう。AndroidではVPN接続の許可とアプリごとの対象範囲も確認してください。バックグラウンドで切断される場合は、サブスクリプションを何度も読み込み直すのではなく、バッテリー最適化の設定を確認します。
端末を移行したりクライアントを変更したりする前に、現在使えている設定の入手元とカスタムルールを保存してください。システムプロキシ、複雑なルーティング、LAN共有を一度に有効にせず、まず最小限の接続経路を確立してから一つずつ追加します。設定同士の干渉を減らし、問題が起きたときの確認箇所も明確になります。
使い方ガイドをすべて見る →エコシステム、実行コア、GUIの役割を分けて考えると、設定がどの層に適用されるか判断できます。
Project Vは、ネットワークプロキシツールと関連機能を中心とするオープンソースプロジェクト群です。V2Rayは、その中でも広く使われている主要プロジェクトです。「V2Rayクライアント」は一般にGUIの管理アプリを指しますが、技術文書では実行コアを指すこともあります。両者は異なる層にあるため、解説を読む際は文脈を確認してください。
コアは通常、設定ファイルでインバウンド、アウトバウンド、ルーティング条件を定義します。GUIクライアントは、これらの設定を操作可能なフォーム、一覧、メニューに置き換えます。そのため、画面に同じボタンがあっても、すべてのコアが同じJSON設定を受け付けるとは限りません。この違いを理解しておくと、メニューの場所を覚えるだけでなく、設定を長期的に管理しやすくなります。
V2FlyはV2Rayのコミュニティ開発を引き継ぎ、Xrayは関連エコシステムから分かれて独自の機能を発展させています。共通する概念もありますが、プロトコルの実装、トランスポートの選択肢、設定の詳細には違いがあります。REALITYやXTLS Visionなどを使う場合は、クライアント名にV2Rayが含まれているかではなく、Xrayの対応状況を確認してください。
あるプロトコルに対応していても、あらゆる設定の組み合わせが使えるとは限りません。トランスポート、安全レイヤー、フロー制御の選択肢、コアの機能によって可否が決まります。コアの切り替え後にエラーが出た場合は、まず設定の解析段階で表示される内容を確認し、次に実行時の接続を調べてください。設定の互換性問題をサーバーへの接続不可と取り違えないようにしましょう。
v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのGUIクライアントで、デスクトップまたはAndroid環境で設定を管理します。v2rayNは複数のデスクトップOSに対応し、v2rayNGはXray、v2flyNGはV2Flyと連携します。まずOSを基準にし、次に設定要件を確認してください。名前が似ているからといって、複数をインストールする必要はありません。
オープンソースとは、各プロジェクトのライセンスに基づいてソースコードが公開されていることを意味します。複製、改変、再配布には、各プロジェクトと依存コンポーネントのライセンス条項に従う必要があります。クライアントとコアでライセンスが異なる場合もあり、ひとつの説明ですべてのライセンスを代用することはできません。クライアントは無料で利用できますが、サーバーやサブスクリプションサービスは別の提供形態です。
クライアントの更新では、画面、設定の生成処理、同梱コアが変更されることがあります。サブスクリプションの更新で新しくなるのは主にサーバー設定、ルールデータの更新で変わるのはドメインやアドレスのリストです。それぞれ対象が異なるため、サブスクリプションを更新しただけでプログラムやコアも最新になったとは限りません。トラブルの調査前に実際の環境を記録しておくと、該当する設定項目を見つけやすくなります。
更新前にカスタムルーティング、DNS設定、サブスクリプショングループの情報を保存してください。更新後は既存の接続を確認し、カスタムルールが引き続き有効かを調べます。設定名や初期値が変わった場合は、現在の画面と対応するコアのドキュメントを確認してください。このページでは設定オブジェクトの概要を、ダウンロードページではインストーラーの選び方を、設定項目ページではJSON各部の用途を案内しています。
目的に合わせて読むページを選べます。アプリを選ぶならクライアント比較、初回接続を設定するなら使い方ガイド、個別の設定項目を調べるなら設定リファレンスを確認してください。サブスクリプションの更新失敗やシステムプロキシの不具合が起きた場合は、まずどの段階で失敗しているかを特定してから、該当するトラブル対処へ進みましょう。異なる層の問題を混同しないことが大切です。
コアの違い、プロトコル選定、Androidの動作の仕組みなど、設定を判断するための情報を解説します。
XrayがProject Vのエコシステムから分かれた経緯を整理し、XTLS VisionやREALITYなど独自機能とV2Flyとの違いを比較。v2rayNGとv2flyNGがそれぞれどのコアに対応するかも解説します。
記事を読む →暗号化方式、ハンドシェイクの構造、TLSへの依存、設定の複雑さという4つの観点から4種類のプロトコルを比較し、用途に応じた選び方を紹介します。
記事を読む →v2rayNGがAndroidのVpnServiceを使って動作する仕組みを解説します。バックグラウンドでアプリが終了される場合のバッテリー最適化対象外設定や、アプリごとのプロキシで通信を迂回する方法、プロキシ経由に限定する方法も紹介します。
記事を読む →