デスクトップではv2rayN、Androidではv2rayNG / v2flyNGを使用します。ダウンロードからサブスクリプションのインポート、ルーティング設定まで、手順に沿って進められます。
設定管理 · 画面イメージ
クライアントは設定を管理してコアを起動するもので、サーバーやサブスクリプションを自動で提供するものではありません。信頼できる提供元のサブスクリプションURLを用意し、設定を更新して接続先を選び、利用するプラットフォームに合った通信の取り込み方法を有効にします。
画面上の「サブスクリプションを更新」と「サービスを起動」は別の操作です。前者はリモートの設定を取得し、後者はローカルのコアを実行します。更新に成功しても、接続が確立したとは限りません。
設定ワークスペース
設定の取得元、ルールによる振り分け、通信の取り込み口を区別してから、各項目を調整しましょう。以下は設定項目のイメージで、実際に操作できるクライアント画面ではありません。メニューの場所は使用するクライアントによって異なります。
サブスクリプショングループを使うと、複数の提供元から取得した設定を分けて管理できます。クライアントでグループを追加し、識別しやすいメモとサブスクリプションURLを入力して保存します。更新後、該当グループから接続先を選びます。グループのメモは識別用で、サーバーの設定には影響しません。設定を1件ずつ貼り付ける方法と比べ、サブスクリプションなら提供元がパラメーターを変更した際にまとめて更新できますが、提供元が管理する項目が上書きされる場合もあります。長期的に残したい手動変更は別途バックアップしてください。サブスクリプションURLにはアクセス認証情報が含まれることが多いため、公開スクリーンショットに載せたり、オンライン変換サイトに渡したりしないでください。
ルーティングルールは、リクエストを直接接続、プロキシ、またはブロックのどれにするか決めます。アプリの通信をクライアントに取り込む機能ではありません。通常はクライアントの既定設定を維持し、ドメインやアドレスごとに必要なルールだけを追加します。複数のルールに一致する場合、優先順位や並び順によって結果が変わるため、まず使用中のコアの照合方法を確認してください。すべてのリクエストをプロキシに送るのではなく振り分けることで、ローカルネットワーク上のサービスを通常どおり利用でき、特定のサイトだけの問題も調べやすくなります。変更後は同じ接続先で再テストし、DNSで解決されたアドレスによって照合結果が変わっていないか確認しましょう。
システムプロキシは、OSのプロキシ設定を参照するブラウザーやデスクトップアプリに適しています。この設定に従わないプログラムは、直接インターネットに接続する場合があります。TUNは仮想ネットワークインターフェースを通じて通信を取り込み、より広い範囲をカバーできますが、OSの権限が必要で、ほかの仮想ネットワークアダプターやネットワークツールと競合することがあります。まずシステムプロキシで動作を確認し、必要に応じてTUNを試しましょう。両方を必ず有効にする必要はありません。Androidクライアントは通常、OSのVPN許可を使って通信を取り込みます。どの方法を選んでも、最終的な直接接続・プロキシの動作はルーティングルールによって決まります。
コアは設定を読み込み、実際の接続を確立します。GUIクライアントは設定のインポート、選択、実行を行うための画面を提供します。XrayとV2Flyは共通するエコシステムを背景に持ちますが、対応するプロトコル拡張や設定項目は完全には一致しません。REALITYを使う設定では、対応するXrayコアが使われていることを確認してください。クライアント名だけで互換性を判断しないようにしましょう。デスクトップではクライアントが対応していれば適切なコアを選び、Androidでは必要に応じてv2rayNGまたはv2flyNGを選びます。切り替え後は起動ログを確認し、未知の設定項目が表示された場合は、再インストールを繰り返すのではなく設定の提供元とコアの要件を確認してください。
サブスクリプションを更新できてもWebページが開かない場合、すぐにサブスクリプションを変更するのではなく、通信がローカルクライアントに届いているかを確認します。まずコアが正常に起動しているか、次にシステムプロキシがローカルポートを参照しているか、その後にルーティングとDNSを確認してください。一度に変更する条件は一つにし、変更前の設定も残しておけば、どの手順で状態が変わったか追跡できます。複数のクライアントによるシステムプロキシの取り合い、ブラウザー独自のプロキシ拡張機能、ほかのプログラムによる待ち受けポートの使用などがあると、画面表示と実際の接続状況が食い違う場合があります。
「グローバルプロキシ」という項目がある場合、まずどこにある設定か確認してください。システムプロキシのグローバル設定、クライアントのルーティングにおけるグローバルモード、TUNによる通信の取り込みは、それぞれ別の概念です。前者はアプリがどのようにプロキシへ接続するかに影響し、ルーティングモードは取り込まれたリクエストの行き先を決めます。用語の意味が分からない場合は、まず用語集を確認してください。項目ごとの操作が必要な場合は、設定ガイドに沿って最低限の設定を行いましょう。
プラットフォーム別ガイド
まずOSを確認し、次にプロセッサーのアーキテクチャを確認します。デスクトップではv2rayN、Androidではコアの要件に応じてv2rayNGまたはv2flyNGを選びます。各インストーラーはダウンロードセンターにまとめています。ホームページにはバージョン番号を掲載していません。
v2rayNにはデスクトップ版と従来のWPF版があります。デスクトップ版はクロスプラットフォーム対応のUIを採用し、WPF版は従来のデスクトップ操作を引き継いでいます。OSの要件や使い慣れた操作方法に合わせて選び、両方を同時に起動する必要はありません。
インストール前にプロセッサーのアーキテクチャと実行環境を確認してください。ポータブル版を使う場合は、書き込み可能で分かりやすい場所に展開し、圧縮ファイル内から直接実行しないでください。初回の動作確認ではシステムプロキシを使い、ブラウザーからアクセスできることを確かめてから、TUNやその他の詳細設定を検討しましょう。
v2rayNはApple SiliconとIntelのプロセッサー別にダウンロードできます。「このMacについて」でチップを確認してから、対応するインストーラーを選んでください。プロセッサーに合ったファイルを選ぶことと、サブスクリプションのプロトコルは別の話です。インストーラーを変えても設定は自動変換されません。
インストール後はOSの案内に従ってアプリの権限を設定してください。システムプロキシを有効にする場合は、現在のネットワークサービスのプロキシ設定にも反映されているか確認します。一部のアプリだけで失敗する場合は、そのアプリがシステムプロキシを参照しているかを先に確認してください。TUNを使う場合は、ガイドに沿って権限と仮想インターフェースの状態を確認しましょう。
v2rayNGはXrayコアを使用し、対応するプロトコルが必要な設定に適しています。v2flyNGはV2Flyコアを使用し、設定要件に応じた選択肢になります。多くの端末ではarm64を選びます。アーキテクチャが分からない場合は、端末情報を確認するか、汎用版を選んでください。
初回起動時の接続では、OSのVPN利用許可が必要です。通常、このVPNインターフェースを使用できるアプリは一つだけです。テスト前に、同種の接続を提供するほかのアプリを停止してください。バックグラウンドに移動すると切断される場合は、バッテリー最適化やバックグラウンド実行の制限を確認しましょう。同じサブスクリプションを何度もインポートするだけでは解決しません。
v2rayNはdebパッケージとrpmパッケージに対応し、x64とarm64のアーキテクチャ別に提供しています。インストーラーの形式はディストリビューションのパッケージ体系によって異なり、アーキテクチャは端末によって決まります。両方を一致させる必要があるため、ファイルの拡張子だけで判断しないでください。
デスクトップ環境、ブラウザー、アプリによって、システムプロキシの参照方法が異なることがあります。まずGUIクライアントでサブスクリプションとローカル待ち受けを設定し、対象アプリのプロキシ設定を確認してください。TUNを使うには追加の権限とネットワーク環境が必要です。仮想ネットワークインターフェースをすでに使用している場合は、一つずつ動作を確かめましょう。
通信の取り込み口 ≠ ルーティングルール
アプリはシステムプロキシまたは仮想インターフェースを通じてリクエストをクライアントに渡し、コアがルーティングルールに従って送信先を決めます。TUNを有効にしても、すべてのリクエストが必ずリモートプロキシを経由するわけではありません。ルーティングで振り分けを設定しても、すべてのアプリが自動的にクライアントへ接続されるとは限りません。
動作確認では、接続先を一つ明確に決め、ログに該当リクエストが記録されるかを確認します。リクエストがまったく記録されない場合は、まず通信の取り込み口を確認してください。記録はあるのに接続できない場合は、サーバー設定、名前解決の結果、送信先ルールを調べます。リクエストがログに記録されるかどうかは、現在のログレベルにも左右されます。
クイックスタート
初回の設定は3段階で進めます。まず基本となる動作を確認し、その後、ルールの追加、自動更新、TUNなどの設定を行います。メニューやプラットフォームごとの違いは、詳しいガイドをご覧ください。
OSとアーキテクチャを確認し、対応するクライアントをインストールします。信頼できる提供元からサブスクリプションURLまたは個別の設定を用意してください。サブスクリプションURLは一般的な案内ページのURLとは異なります。コピー時に空白、改行、説明文が混ざらないよう注意してください。古い設定がある場合は、先にバックアップを書き出し、サブスクリプショングループ、ルーティング、アプリ設定が含まれているか確認します。接続先だけのファイルを、移行に必要な設定一式と取り違えないようにしましょう。
クライアントは設定を管理できますが、設定の提供元に代わって有効なサーバーパラメーターを生成することはできません。アドレス、ポート、ユーザーID、通信方式の設定は、同じ一つの設定ファイルから取得してください。異なるガイドの項目を組み合わせて使わないでください。
サブスクリプション管理でグループを追加し、URLを保存してから更新します。設定が一覧に表示されることを確認してください。個別の共有リンクは、クライアントのインポート機能から取り込みます。使う設定を選び、プロトコルが現在のコアに対応していることを確認しましょう。更新に失敗した場合は、まずURLが有効か、現在のネットワークからサブスクリプションを取得できるかを確認してください。すべての設定をすぐに削除する必要はありません。
サブスクリプションの形式を認識できない場合は、まず対応する出力形式を提供元に確認してください。変換機能で処理できるのは、ツールが対応する形式に限られます。不足しているパラメーターを補ったり、コアが未対応のプロトコル機能を使えるようにしたりすることはできません。認証情報を含むURLを、正体の分からないオンライン変換サービスに渡すのは避けてください。
デスクトップではまずシステムプロキシを有効にし、AndroidではVPN利用を許可してから、接続先を明確にしたテストを行います。クライアントの画面で動作中と表示されても、分かるのはローカルサービスが起動していることだけです。接続先へのアクセス結果とログも確認してください。失敗した場合は「コアの起動、ローカルポート、アプリの接続口、DNS、ルーティング、サーバー設定」の順に切り分けます。一度に複数の設定を変更しないでください。
テストが終わったら、クライアントの停止機能とシステムプロキシの解除機能を使って終了します。ブラウザーが停止済みのローカルポートを参照したままだと、通常のWebページも開けなくなることがあります。設定を元に戻す場合は、まずOSのネットワーク設定を確認してから、クライアントを再起動するか判断してください。
Project V · V2Fly · Xray
クライアント名、コア名、プロトコル名はそれぞれ異なる層の名称です。まずプラットフォームを確認し、次に設定で必要となるプロトコルとコアの機能を基準に選びましょう。すべての名称を別々の接続サービスとして捉える必要はありません。
Project Vは、ネットワークプロキシツールを中心に形成されたオープンソースエコシステムで、V2Rayはその主要プロジェクトの一つです。V2FlyはV2Ray関連の開発を引き継ぎ、Xrayは共通の基盤をもとに、独自のプロトコル拡張や開発方針を築いています。それぞれ異なるペースで進化しているため、名称が似ていても設定項目が常に同じとは限りません。また、単純に「新しいものが古いものに置き換わった」と説明できる関係でもありません。
利用者にとって重要なのは、具体的な機能の違いです。設定でどのプロトコル、通信方式、セキュリティ機能を使うのか、現在のコアがそのパラメーターを受け付けるのかを確認してください。たとえばREALITYを使う場合は、使用するXrayコアとクライアントのインポート機能が対応しているかを確かめます。ログに未対応のプロトコルや設定項目が表示されたら、ネットワーク不安定と決めつけず、互換性を確認しましょう。詳しい違いは比較・選び方ガイドをご覧ください。
v2rayNはデスクトップ向けで、設定一覧、サブスクリプショングループ、ルーティング、システムプロキシをGUIにまとめています。v2rayNGはAndroid向けで、Xrayコアを使い、OSのVPNインターフェースを通じてアプリの通信を取り込みます。v2flyNGもAndroid向けで、V2Flyコアを選択できます。いずれもオープンソースのクライアントですが、画面構成、メニュー名、設定のバックアップ形式が相互にそのまま使えるとは限りません。
デスクトップでは、本ページの設定ガイドがv2rayNを中心に構成されているため、v2rayNを第一候補にしています。Androidではまずv2rayNGを確認し、コアの要件に応じてv2flyNGも検討してください。代替クライアントを選ぶ際は、既存の設定が特定のコアの動作を必要とするなど、明確な理由を基準にしましょう。複数のクライアントを同時に起動して効果を重ねようとすると、プロキシ設定やVPNインターフェースが競合し、かえって切り分けが難しくなります。
オープンソースとは、各プロジェクトのコードが、閲覧、使用、再配布などの条件を定めたライセンスのもとで提供されることです。具体的な権利と義務は、各プロジェクトに付属するライセンスを確認してください。クライアントの画面、コア、同梱コンポーネントで、異なるライセンスが採用されている場合もあります。一つのコンポーネントのライセンスを、配布パッケージ全体の説明として扱うことはできません。オープンソースのクライアントを使っても、サブスクリプションやサーバーサービスが自動的に提供されるわけではありません。
サブスクリプションの提供元は設定内容を用意し、クライアントはそれを読み込んで実行し、サイトのドキュメントは操作や概念を説明します。それぞれの役割を分けて考えましょう。ユーザーIDを含むサブスクリプションURL、QRコード、エクスポートファイルは、機密情報として保管してください。調査のためにログを共有する場合は、必要なエラー周辺だけを残し、サーバーアドレス、ユーザーID、サブスクリプションの認証情報を先に取り除いてください。接続情報をそのまま公開の場に貼り付けないようにしましょう。
クライアントの更新では、画面、設定の生成方法、OSとの連携が変わる場合があります。コアの更新では、プロトコル対応やパラメーターの処理が変わることがあります。アップグレード前に現在の動作モードを記録し、設定をバックアップしてください。更新後はまず従来の設定でテストし、正常に動くことを確認してから新機能を試します。問題が発生した場合は、インストールを繰り返すより、起動ログと設定の変更点を比較するほうが原因を特定しやすくなります。
サブスクリプションの更新、ルールデータの更新、プログラムの更新は別の操作です。サブスクリプションの更新はリモート設定を取得し、ルールデータの更新は照合対象に影響し、プログラムの更新はクライアントや関連コンポーネントを置き換えます。ダウンロード先はダウンロードセンターにまとめています。インストール、移行、プラットフォーム固有の問題は全プラットフォームのインストール・設定ガイドをご覧ください。症状がはっきりしている場合は、次の手順を決める前にFAQも確認できます。
設定ガイド
まず基本設定を済ませてから、現在の問題に関係する記事を読みましょう。プラットフォーム別ガイドではインストールと設定の順序を、コアの比較記事では互換性を、仕組みを解説する記事では詳細設定の役割と制限を確認できます。
v2rayNのデスクトップ版とWPF版の違いや選び方を解説。展開先、ランタイム、サブスクリプションのインポート、システムプロキシ、TUNの設定、Windowsでよくあるエラーを取り上げます。
インストール手順を読む →Project VエコシステムにおけるV2FlyとXrayの分岐の経緯を整理し、VLESSやREALITYなどの対応状況を比較。v2rayNGとv2flyNGがそれぞれどのような設定に適しているかを解説します。
コアの比較を読む →DNSクエリが捕捉されて仮想IPが返される仕組みから、FakeDNSとドメイン別ルーティング、TUNモードの連携を解説。利用に適さない場面も紹介します。
FakeDNSの仕組みを読む →