デスクトップではv2rayN、Androidではv2rayNGがおすすめです。OSとアーキテクチャを選び、ガイドに沿って既存の設定を取り込みましょう。
デスクトップ版はクロスプラットフォームのインターフェースを採用しています。従来のWPF版では、使い慣れたWindowsの操作画面を引き続き利用できます。初回インストール時はシステム要件を確認し、書き込み権限のあるフォルダーにプログラムを配置してください。サブスクリプションを取り込んだら、使用する設定を選び、システムプロキシの自動設定を有効にして、ブラウザーで接続を確認します。画面によってメニューの位置は異なりますが、サブスクリプション、ルーティング、ローカルリスニングポートの確認手順は共通です。
ダウンロードへ →Xrayコアを使うv2rayNGが基本です。V2Flyコアが必要な場合はv2flyNGを検討してください。一般的な端末ではarm64を選び、アーキテクチャが不明な場合は汎用パッケージの説明を確認します。初回起動時の接続には、システムVPNの許可が必要です。アプリごとのプロキシ設定やバックグラウンドのバッテリー制限によって、転送される範囲が変わる場合があります。クライアントを切り替える前に設定を保存してください。2つのアプリの設定は自動では同期されません。
ダウンロードへ →「このMacについて」でチップの種類を確認し、Apple Silicon版またはIntel版を選んでください。インストール後はシステムの案内に従ってアプリの起動を許可し、クライアントのコアが起動していることを確認してからシステムプロキシを有効にします。ブラウザーでは接続できても他のアプリで使えない場合は、そのアプリがシステムプロキシを参照するか確認してください。より多くのトラフィックを転送する必要がある場合に限り、TUNに必要な権限とルーティング設定を確認しましょう。
ダウンロードへ →ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、端末のアーキテクチャがx64かarm64かを確認してください。GUIクライアントで設定を管理できますが、デスクトップ環境がシステムプロキシを使うかどうかは別途確認が必要です。ターミナルのプログラムが独自のプロキシ設定を使う場合もあるため、ブラウザーでの接続だけで、すべてのリクエストが転送されているとは判断できません。起動に失敗したら、まず依存パッケージとフォルダーの権限を確認し、その後クライアントのログを確認してください。
ダウンロードへ →設定の取得元、リクエストの転送先、トラフィックの取り込みを分けて考えましょう。一度に変更する設定は1種類に絞り、動作を確認してから次に進みます。
取得元ごとに管理し、更新後に設定を選択
サブスクリプションリンクは、複数の接続設定を取得するためのもので、単一ノードのアドレスではありません。まずクライアントにサブスクリプショングループを作成し、完全なリンクを入力して更新します。取得元ごとに分けて保存すると、どのサブスクリプションから設定が生成されたか確認しやすく、手動で追加した項目との混在も防げます。更新後、グループに選択可能な設定が表示されることを確認し、使用するサーバーとして選択してください。共有リンクを1件ずつ管理するより、定期的に設定が更新される場合に便利ですが、取得元が有効かどうかは別途確認が必要です。
サブスクリプションの取り込み方 →サブスクリプションURLと個別設定を区別する
個別の共有リンクには通常、プロトコル、アドレス、ポート、通信パラメーターが含まれます。一時的な追加や特定の設定内容の確認に適しています。コピーする際は内容をすべて保持し、改行や空白、チャットツールによる途中切れがないか確認してください。取り込み後はプロトコルと通信方式が正しく認識されていること、現在のクライアントとコアが各項目に対応していることを確認します。共有リンクとサブスクリプションURLでは取り込み口が異なる場合があります。誤った場所に貼り付けると、一覧が空になったり解析エラーが表示されたりします。一度の解析失敗だけでネットワーク障害と判断しないでください。
取り込み手順を見る →まず接続を確認し、次に実際の使い心地を判断
ノードテストの結果は、特定のテスト方法とその時点のネットワーク状況を示すもので、ブラウザーや他のアプリでの実際の使用感と同じとは限りません。まずテストが成功するか確認し、その後、使いたいアプリから対象サービスにアクセスしてください。すべてタイムアウトする場合は、端末のネットワーク、コアの起動状態、サブスクリプションの有効性を優先して確認します。一部の設定だけ失敗する場合は、サーバーアドレスと通信パラメーターを確認してください。異なるテスト方法の結果を同じ基準で並べたり、数値だけを見て設定を何度も切り替えたりしないでください。
接続の診断を見る →リンクの状態から更新処理を確認
サブスクリプション一覧が空の場合と、既存ノードに接続できない場合では、問題の段階が異なります。まずリンクの有効期限とコピー漏れを確認し、次にクライアントの表示がリクエスト失敗なのか内容の解析失敗なのかを確認してください。現在のネットワークからサブスクリプションURLにアクセスできない場合、利用可能な接続がすでにあるなら、プロキシ経由での更新を試せます。リクエストが成功しても設定が生成されない場合は、返された内容と対応フォーマットを確認します。サブスクリプションURLにはアクセス権限が含まれることがあります。調査用のスクリーンショットを共有する際はURL全体を隠し、公開の掲示板に貼り付けないでください。
サブスクリプション更新失敗の確認項目 →プリセットでリクエストの転送先を確認
ルールによって、コアに入ったリクエストをプロキシ経由、直接接続、またはブロックのいずれにするかが決まります。これはシステムプロキシによるトラフィックの取り込みとは別の機能です。初めて使う場合は目的に合ったプリセットを選び、よく使うWebサイトやローカルサービスへの接続を確認してからカスタマイズしましょう。通常、グローバルはルールの対象範囲内のリクエストをプロキシ経由にする設定であり、すべてのアプリがクライアントを経由するという意味ではありません。振り分けの問題を調べるときは、まずアプリのリクエストがコアに届いているか確認し、その後、どのルールに一致したかを調べます。誤った段階でモードを何度も切り替えないようにしましょう。
ルーティング設定の基本 →個別ルールを先に、最終ルールを後に
複数のルーティングルールが同じリクエストに一致する場合、並び順が結果を左右します。ドメインやアドレスのカスタムルールを追加する前に、使用中のコアの照合方式を確認し、より上位の広範なルールに上書きされないか調べてください。直接接続するローカルリソースは明示的に設定し、グローバルモードの頻繁な切り替えでアクセスを維持しようとしないでください。変更前に元の設定を保存し、一度に追加するルールは少数にして、実際のリクエストで適用結果を確認します。ルールは多いほど振り分けが正確になるわけではありません。長期間使っていない重複項目は整理しましょう。
ルーティングと通信の振り分けを理解する →名前解決と通信経路をあわせて確認
Webサイトが開かない原因は、ノードが使えないことだけではありません。ドメイン名の解決段階で問題が起きている場合もあります。ドメインルール、アドレスルール、ドメインポリシーが照合に影響し、IPアドレスだけを使うリクエストとドメイン名を保持するリクエストで結果が異なることがあります。まずログの名前解決エラーを確認し、次にDNSリクエストが到達できる経路を確認してください。システムDNS、ブラウザーの暗号化DNS、クライアントのDNSを同時に変更すると、どの変更が効果をもたらしたか判断しにくくなります。元に戻せる基本設定を残し、1項目ずつ確認すると原因を特定しやすくなります。
DNSの問題を調べる →LANと端末上のサービスへの経路を確保
プリンター、ルーターの管理画面、LAN内のファイルサーバーは、通常、遠隔のプロキシを経由する必要はありません。新しいルーティング設定やTUNを有効にした後、これらにアクセスできなくなった場合は、まずアドレスがローカルネットワークに属するかを確認し、直接接続や除外の設定を確認してください。デバイスの検出と通常のWeb閲覧では異なる種類の通信を使うことがあります。そのため、Webページが開けてもLAN機能がすべて正常とは限りません。ルールを変更するときは、アドレス範囲を安易に広げないでください。影響を受ける対象を記録し、必要最小限の範囲で検証して、元に戻せる手段を残しましょう。
ネットワークの診断を見る →先にコアを起動し、アプリにプロキシを使わせる
システムプロキシを自動設定すると、その設定に対応するアプリのリクエストが、クライアントのローカルリスニングアドレスに送られます。有効な設定を選び、コアが正常に起動したことを確認してから、この項目を有効にしてください。ブラウザーに独自のプロキシ拡張機能がある場合は、システム設定を上書きしていないか確認します。システムプロキシを解除しても、変更されるのはシステム側のプロキシ設定だけで、サブスクリプションやノードは削除されません。システムプロキシを変更しない設定では、既存のシステム設定が維持されます。クライアント終了後にネットワークの異常が起きた場合は、停止したポートを指すプロキシ設定が残っていないか確認してください。
システムプロキシを設定 →システムプロキシを使わないアプリの通信を転送
TUNは仮想ネットワークインターフェースを使って通信を処理するため、通常のシステムプロキシでは対象にならないアプリに適しています。ただし、権限、ルーティング、DNSなどの追加設定が必要です。有効にする前に、通常のプロキシモードで同じノードが使えることを確認し、クライアントの案内に従って必要な権限を付与してください。接続に問題がある場合は、他のVPNや同種のトラフィック転送ツールを一時的に無効にして比較します。TUNは無効なサブスクリプションを直す機能ではなく、あらゆる通信が想定どおり転送される保証もありません。問題が起きたら、まず検証済みの基本モードに戻してください。
TUNのトラブル対処を見る →クライアントとアプリで同じ接続パラメーターを使う
ローカルリスニングポートはアプリからクライアントに接続するための入口であり、遠隔サーバーのポートではありません。図中の10808は説明用の値です。実際に表示される値は、現在のパラメーター設定で確認してください。ポートが他のプログラムに使用されている場合は、まず競合するプロセスを特定し、重複したインスタンスを終了するか、リスニングポートを変更します。変更後はシステムプロキシ、ブラウザー、手動設定したアプリも確認し、プロキシのプロトコルが正しいことを確かめてください。数値を1か所変更するだけで終わらせないでください。コアが起動していても、リクエストが届いていないことがあります。
ポート競合の対処を見る →VPNインターフェースを経由するアプリを指定
AndroidのVPNモードは、デスクトップのシステムプロキシとは仕組みが異なり、初回起動時にシステムの許可が必要です。アプリごとのプロキシで転送範囲を絞れますが、一覧が対象アプリを含む設定なのか、除外する設定なのかを確認し、選択内容が意図と逆にならないようにしてください。ブラウザーは使えても他のアプリが接続できない場合は、まず対象アプリが設定範囲に含まれているか、次にルーティングを確認します。画面ロック後に切断される場合は、バックグラウンド動作とバッテリー最適化の設定も確認してください。VPNインターフェースの競合を判断しやすくするため、テスト中は通信を転送するツールを1つだけ有効にします。
モバイル版の手順を見る →設定は画面で管理し、接続はコアが処理
クライアントはサブスクリプション、設定、ログを扱う画面を提供し、コアは設定を読み込んでネットワーク接続を確立します。両者の更新時期や機能範囲は必ずしも一致しません。画面からある項目を取り込めても、使用中のコアがその機能に対応しているとは限りません。起動エラーが発生したら、まずログを読み、設定の生成に失敗したのか、コアがパラメーターを拒否したのかを判断してください。アプリ名だけを見るより、実際に動作しているコアを確認するほうが、プロトコルの互換性を調べやすく、画面の違いを接続方式の違いと誤解することも防げます。
コアに関する用語を見る →設定要件に応じて互換性を確認
XrayとV2Flyは関連しながらも独立して開発が進むコアプロジェクトです。プロトコルの実装、設定項目、新機能への対応状況が異なる場合があります。コアを選ぶときは、名称や公開時期だけで優劣を判断せず、サーバー側が指定する設定要件を基準にしてください。同じサブスクリプション内にも、異なる要件の設定が含まれることがあります。切り替え前にプロトコルと通信方式の組み合わせを確認しましょう。特定のコアでのみ動作する設定がある場合は、確認済みの組み合わせを維持し、複数の通信項目を同時に変えるより、差を個別に調べるほうが確実です。
クライアントの比較を見る →設定を保存して、いつでも元に戻せる状態に
コアの切り替えやクライアントのアップグレード前に、サブスクリプショングループ、カスタムルーティング、必要なパラメーター設定を保存してください。現在動作している設定を記録しますが、公開のメモに認証情報を保存しないでください。更新後は、まず従来の設定で基本接続を確認し、その後、新機能をテストします。起動に失敗しても、すべての設定をすぐに上書きせず、ログのエラー項目を比較してください。プロジェクトの進展に伴い設定形式が変わる場合があります。バックアップは復旧の手掛かりとして残し、復元時には対象バージョンが設定内容を正しく読み取れることを確認してください。
起動時の診断を見る →まずプラットフォーム、次にコアの要件
デスクトップではv2rayNを選び、統一された設定管理でサブスクリプションとプロキシを扱うのがおすすめです。Androidではv2rayNGが基本です。V2Flyコアが必要な場合はv2flyNGを検討してください。クライアントはまず端末のプラットフォームで選び、次に設定要件やよく使う機能を確認しましょう。画面の違いだけを理由に、何度も移行する必要はありません。移行時には有効なサブスクリプションを再度取り込めますが、ルーティング、アプリごとのリスト、権限は通常、改めて確認が必要です。これらの端末側の設定は、ノードの共有リンクですべて引き継げるわけではありません。
要件に合ったクライアントを選ぶ →オープンソースプロジェクト、接続コア、GUIクライアントの違いを理解し、ダウンロードするものと変更する設定を見極めましょう。
V2Rayは、Project Vのモジュール型ネットワークプロキシ設計から生まれました。インバウンド、アウトバウンド、ルーティング、通信方式などを分けて構成し、リクエストごとに異なる経路へ振り分けられます。現在V2Rayを検索すると、V2Fly、Xray、v2rayN、v2rayNGもあわせて見つかることがよくあります。これらはそれぞれ異なる階層の名称であり、同じインストーラーの別名ではありません。それぞれの役割を理解しておけば、問題発生時に確認すべき範囲を絞れます。
日常的な利用では、GUIクライアントが主な操作窓口になります。サブスクリプションが接続設定を提供し、コアが設定を読み込んで接続を確立します。システムプロキシやVPNインターフェースによってアプリのリクエストをクライアントに取り込み、ルーティングによってその行き先を決定します。この4つは相互に関係しますが、互いの代わりにはなりません。サブスクリプションの取得に成功しても接続できるとは限らず、接続できてもすべてのアプリがプロキシを使うとは限りません。この順番で確認するほうが、サブスクリプションを何度も取り込んだり、アプリを再インストールしたりするより効果的です。
Project Vの設計思想は、ネットワークの動作を1つのスイッチにまとめるのではなく、役割ごとに分けたモジュールを組み合わせることです。インバウンドはアプリからのリクエストを受け取り、アウトバウンドは接続先やプロキシサーバーへの接続を担います。ルーティングは経路を選び、トランスポート層は接続の運び方を定めます。この役割分担があるため、クライアントにはサブスクリプション、ルーティング、DNS、リスニングポートなど複数の設定項目があります。画面には多くの項目が並びますが、それぞれに適用範囲があります。
たとえばローカルリスニングポートを変更すると、アプリがクライアントに接続する場所が変わります。一方、遠隔サーバーのポートを変更すると、クライアントからサーバーへの接続先が変わります。同じ「ポート」でも、互いに置き換えることはできません。同様に、グローバルルーティングはコアに届いた後の経路選択に影響しますが、システムプロキシを参照しないアプリが自動的にプロキシを使うようにはなりません。こうした境界を理解すれば、まず基本設定で接続を確立し、その後、通信の振り分けやトラフィックの取り込みを段階的に追加できます。
技術資料を探すときは、その資料がどのクライアント、コア、設定階層を対象としているかも確認してください。コアの設定ファイルについて解説した記事にある項目を、GUIの入力欄にそのまま入力できるとは限りません。まず概念を理解し、現在の画面と照らし合わせることで、異なるプロジェクトの説明を混同するミスを防げます。
専門用語を確認 →V2FlyコミュニティはV2Ray関連の実装を継続して保守し、Xrayは関連コードを基盤に独立したコアプロジェクトとして開発されています。共通の技術的背景を持ちながら、それぞれ異なる実装方針と機能開発のペースがあります。利用者にとって重要なのは、どちらが優れているかを決めることではありません。使用中のコアが、ノードで必要なプロトコル、通信方式、安全性に関する設定に対応しているか確認することです。
v2rayNはバージョンと設定に応じて適切なコアを利用できます。Android版ではv2rayNGが主にXrayコアを使い、v2flyNGはV2Flyコアを選べます。コアの切り替えは万能な解決策ではありません。サブスクリプションリンクの失効、システム時刻のずれ、ローカルポートの競合が原因なら、コアを変えても同じ症状が続くことがあります。まずログが示す問題箇所を確認し、実装の変更が必要か判断してください。
サーバーから指定されたパラメーターは、互換性を確認する際の基準になります。エラーを消すために証明書の検証を安易に無効化したり、認識できない項目をすべて削除して使い続けたりしないでください。まず元の設定を保存し、クライアントとコアの組み合わせを確認します。パラメーターの意味が分からない場合は、対応する用語解説とトラブル対処を参照してください。
症状から問題を診断 →v2rayN、v2rayNG、v2flyNGはいずれもオープンソースのGUIクライアントで、アプリ自体は無料で利用できます。オープンソースとは、プロジェクトのコードとライセンスを確認できるという意味です。遠隔サーバー、サブスクリプションの利用枠、接続設定が自動的に提供されるわけではありません。実際に接続するには、アクセス権のあるサブスクリプション、または自身で管理するサーバー設定が必要です。
オープンソースのエコシステムでは、すべてのコンポーネントが同じライセンスを使うわけではありません。v2rayNプロジェクトはGPL-3.0、v2rayNGとv2flyNGのプロジェクトもGPL-3.0を採用し、V2FlyとXray関連のコアプロジェクトはMPL-2.0を採用しています。配布パッケージ内の他のコンポーネントには、それぞれ別のライセンスが適用される場合があります。通常の利用と、改変・再配布に関する義務は異なります。改変や再配布を予定している場合は、使用するプロジェクトと各コンポーネントのライセンス全文を確認してください。
設定管理とネットワークサービスも分けて考える必要があります。クライアントがサブスクリプションを保存・解析できても、その有効性を判断できるわけではなく、サーバーの運用や保守に代わるものでもありません。接続に問題が起きたら、アプリの設定、設定内容、遠隔サーバーの状態のどれが原因かを確認してから、適切な対処を選びましょう。既存の設定を保ちながら、設定の提供元にも実際の症状を伝えやすくなります。
3種類のクライアントを比較 →アプリの更新では画面や設定管理の仕組みが変わることがあり、コアの更新ではプロトコル機能やパラメーターの対応状況が変わる場合があります。サブスクリプションの更新は、主に接続設定を更新します。それぞれ影響する範囲が異なるため、トラブルの調査中に一度にすべて更新しないでください。接続できていたのに問題が起きた場合は、発生前に行った変更を記録し、1つの項目ずつ確認すると、更新が原因か判断しやすくなります。
アップグレード前にサブスクリプショングループとカスタムルーティングを保存し、インストーラーが現在のOSとプロセッサーアーキテクチャに対応していることを確認してください。アップグレード後はまず従来の設定で基本接続をテストし、次にシステムプロキシと対象アプリを確認します。TUNやアプリごとのプロキシなどの拡張設定は、基本接続の確認後に設定してください。新機能だけが動作しない場合は、検証済みのモードに戻してから、ログで権限や互換性の問題を調べます。
ログは失敗した段階の特定に役立ちますが、サーバーアドレス、サブスクリプションリンク、その他の機密パラメーターが含まれる場合があります。問題を共有する際は、必要なエラー情報だけを残し、認証情報を隠してください。あわせて端末のプラットフォーム、動作モード、影響を受けるアプリを説明しましょう。未加工の設定画面をそのまま共有するより、再現手順を明確にしたほうが役立ち、調査中の情報漏えいも防げます。
よくある質問を見る →初回設定では、確認手順をシンプルに保ちましょう。サブスクリプションを取り込み、設定を1つ選び、コアの起動を確認します。次にシステムプロキシまたはモバイル版のVPNモードを有効にし、最後に対象アプリで接続をテストしてください。基本接続が正常になってから、ルーティングルール、アプリごとのリスト、TUNを追加します。各手順を個別に元に戻せるようにしておけば、問題が起きたときも確認箇所を特定しやすくなります。
ブラウザーは使えても他のアプリで接続できない場合は、すべてのノードをすぐに更新せず、まずアプリのプロキシ設定を確認してください。すべての設定で同時にタイムアウトする場合は、端末のネットワークとコアの状態を確認します。サブスクリプションの更新結果だけが空の場合は、リンクの形式とリクエスト方法を確認してください。症状に応じた手順はトラブル診断で順に確認できます。クイックスタートで基本操作を確認し直すこともできます。
具体的な症状から探す：ポート競合、証明書エラー、サブスクリプションの解析失敗。
クライアントの起動時にポート競合が表示される場合や、システムプロキシが機能しない場合は、システムコマンドで10808・10809を使用中のプロセスを特定します。パラメーター設定でローカルリスニングポートを変更し、ブラウザーとシステムプロキシの設定もあわせて調整しましょう。
ポートのトラブル対処を見る →証明書が無効、ハンドシェイクに失敗、x509エラーが表示される場合は、まずシステム時刻を合わせ、SNI、偽装ドメイン、allowInsecureの設定を確認します。エラーの仕組みと対処法をわかりやすく解説します。
証明書エラーの対処を見る →サブスクリプションの取り込み後に一覧が空になる、解析エラーが表示される、更新が終わらないといった場合に、リンクの有効期限、Base64エンコード、共有リンクの形式、プロキシ経由の更新方法を順に確認できます。
サブスクリプションの確認項目を見る →