設定項目の違いを把握してから、変更する箇所を選びましょう。以下は操作できない画面イメージです。
v2rayNは設定を管理するためのGUIで、接続の確立やルールの実行はコアが担います。サブスクリプションはノード情報をクライアントに取り込み、システムプロキシはどのアプリのリクエストをローカルプロキシに送るかを決めます。ルーティングは、そのリクエストを直接接続するか、リモートノード経由にするかを決めます。それぞれ役割が異なるため、サブスクリプションを更新してもシステムプロキシの問題は解決せず、ルーティングを切り替えても、すべてのアプリがシステムのネットワーク設定に従うようになるわけではありません。
初めて使うときは、サブスクリプショングループを1つだけ追加し、ノードを1つ選んでからシステムプロキシを有効にし、ブラウザーで接続を確認するのがおすすめです。この順なら、変更ごとの影響を把握しやすくなります。TUNの有効化、DNSの変更、カスタムルールの追加を一度に行うと、接続に問題が起きたとき原因を特定しにくくなります。画面の表記はOSやバージョンによって異なる場合があります。実際の設定場所は、インストールしたクライアントで確認してください。
サブスクリプションURLは更新可能なノード一覧であり、クライアントのインストーラーではありません。サブスクリプショングループの設定を開き、メモとURLを入力して保存したら、グループを更新し、サーバー一覧からノードを選びます。用途ごとにグループを分けると、個別の設定とサブスクリプションの設定が混在しにくくなります。v2rayNとv2rayNGにはどちらもサブスクリプションの追加機能がありますが、ネイティブ設定の扱いは異なります。取り込む前に形式を確認してください。更新に失敗した場合は、リクエストエラーとURLの有効性を確認しましょう。ローカルのグループをむやみに削除する必要はありません。サブスクリプションURLにはアクセス用の認証情報が含まれる場合があるため、公開ページには掲載しないでください。
システムプロキシは、ローカルプロキシのアドレスをOSのネットワーク設定に登録し、その設定に従うアプリで利用できるようにします。v2rayNでシステムプロキシを自動設定しても、利用可能なノードを選び、コアを起動しておく必要があります。「システムプロキシを解除」は関連設定を削除し、「変更しない」は現在の設定を維持します。どちらも自動的に直接接続するという意味ではありません。TUNで通信を処理する方法とは異なり、システムプロキシではターミナルのツールや独自に接続を管理するアプリの通信が対象にならない場合があります。クライアントを終了する前にプロキシ設定を元に戻すと、ローカルポートが停止した後もブラウザーが古いアドレスへリクエストを送り続ける事態を避けやすくなります。
ルーティングは、リクエストがコアに渡された後、どこへ送るかを決めます。「中国本土を迂回」は通常、ドメインとIPアドレスのデータベースを組み合わせ、条件に一致する宛先には直接接続し、それ以外はプロキシ経由にします。具体的なルールはクライアントのプリセットを確認してください。システムプロキシの切り替えとは異なり、ルーティングのプリセットはアプリがプロキシを使うかどうかを変更しません。ルールを追加する前に照合順を確認しましょう。条件が広すぎるルールが先に一致すると、後続の詳細なルールが適用されなくなることがあります。LAN内のリソースにはプライベートIPアドレスのルールを、ドメインへの接続に問題がある場合はDNSも確認してください。ノードの切り替えとルーティングの切り替えは別の操作なので、トラブル時は個別に検証しましょう。
geosite:cngeoip:privateクライアントの画面でノードを管理し、実際の接続はコアが処理します。v2rayNはXrayやsing-boxなどのコアに合わせて設定を生成できますが、選べる機能はクライアントとコアの対応状況によって異なります。プロトコル名だけを見るより、トランスポート方式、TLSパラメーター、フロー制御の項目を確認したほうが、互換性の問題を特定しやすくなります。たとえばVLESSノードでREALITYとVisionを使う場合、関連項目がすべて設定され、コアが認識できる必要があります。コアを切り替える前に既存の設定を保存し、切り替え後は起動ログを確認してください。あるコアのネイティブJSONを、別のコアでも使える汎用設定として扱わないでください。
TUNは仮想ネットワークインターフェースを使って通信を処理します。システムプロキシの対象外となるアプリにも対応できますが、ルーティングやDNSの処理経路も変わります。まず通常のプロキシ接続が使えることを確認し、その後、OSの要件に従って権限を許可してTUNを有効にすると、問題の重なりを避けやすくなります。システムプロキシに従うブラウザーと比べてTUNは影響範囲が広く、ほかのネットワークツールと競合する可能性も高まります。社内ネットワーク、リモート接続、LAN機器へのアクセスに問題が起きたら、まずTUNを無効にして比較してください。初回設定時にLANからの接続まで許可する必要はありません。必要な権限とアクセス範囲は個別に確認しましょう。
ここでいう複数プラットフォームでの利用とは、互換性のあるサブスクリプション元を使い回すことであり、クライアントがクラウドアカウント同期機能を提供するという意味ではありません。デスクトップでv2rayN、Androidでv2rayNGまたはv2flyNGを使う場合、同じ提供元の対応サブスクリプションをそれぞれに追加し、各クライアントでノードを更新できます。設定フォルダー全体を直接コピーする方法と違い、各プラットフォーム固有のプロキシポート、権限、ルーティング設定を維持できます。ネイティブJSONには特定のコア専用の項目が含まれることが多いため、異なる端末へそのまま移さないでください。移行前にカスタムルールを記録し、完了後は項目ごとにテストしましょう。複数デバイスでの利用が許可されているかは、提供元の案内を確認してください。
デスクトップではv2rayN、Androidではまずv2rayNGを検討し、コアの要件に応じてv2flyNGも選択肢に加えましょう。
v2rayNにはDesktop版と従来のWPF版があります。Desktop版はクロスプラットフォームのUIを採用し、WPF版は従来のデスクトップ操作を引き継いでいます。選ぶ際はOSと実行環境の要件を確認しましょう。同じサブスクリプションを使うために、両方をインストールする必要はありません。
インストール後は、クライアントが起動し、コアが動作することを確認してからサブスクリプションを追加してください。起動直後に終了する場合は、ノードの設定を変更する前にランタイムと権限に関するメッセージを確認しましょう。既存の設定を移行する場合は、置き換える前にサブスクリプションURLとカスタムルーティングをバックアップしてください。
Macでは「このMacについて」を開き、チップを確認してください。Apple Siliconならarm64、Intelプロセッサならx64を選びます。ダウンロード後、OSの案内に従って初回起動を完了し、サブスクリプションとシステムプロキシを設定します。起動がブロックされた場合は、配布元とOSの警告内容を確認してください。
普段のブラウジングには、まずシステムプロキシの自動設定を試しましょう。ターミナルのツールでプロキシが使われない場合は、そのツールのネットワーク設定を個別に確認してください。より多くのアプリの通信を対象にする必要がある場合に、TUNの権限、DNS、ルーティングの動作を確認しましょう。最初からすべての機能を有効にする必要はありません。
v2rayNGはXrayコアを採用しており、対応するプロトコルやトランスポート機能が必要な設定に適しています。v2flyNGはV2Flyコアを採用し、そのコアを必要とする場合の選択肢になります。一般的なスマートフォンではarm64を選びます。プロセッサのアーキテクチャが不明な場合は、汎用インストーラーの説明を確認してください。
サブスクリプションを追加してグループを更新し、ノードを選んだら、OSのネットワーク接続許可を確認してください。バックグラウンド動作はバッテリー管理の影響を受けます。しばらく接続すると切断される場合は、省電力設定とネットワークの切り替わりも確認しましょう。システムのネットワーク経路を取り合う可能性があるため、2つのクライアントを同時に起動して接続するのは避けてください。
ディストリビューションに合わせてdebまたはrpmを選び、さらにx64とarm64を区別してください。パッケージ形式はシステムのパッケージ管理方式に、プロセッサアーキテクチャは実行環境に対応します。両方を正しく選ぶ必要があります。インストール前に、デスクトップ環境、依存関係、権限の要件も確認しましょう。
Linuxのデスクトップ環境によって、システムプロキシの扱いは異なります。ブラウザーは接続できるのにほかのアプリが直接接続する場合は、アプリがデスクトップのプロキシ設定を参照しているか確認してください。TUNを使う場合は、仮想インターフェースと権限を設定します。ネットワーク管理ツールの設定問題を、サブスクリプションの無効化と誤認しないようにしましょう。
まず接続を1つ確実に検証してから、ルーティングルールやTUNを追加しましょう。
クライアント自体は接続先のリモートノードを提供しません。利用が許可された有効なサブスクリプションURLまたは共有リンクを用意し、サブスクリプショングループの設定に保存してから更新してください。リンクが1つだけの場合は、クライアントが対応するクリップボードからのインポート機能で追加できます。ウェブページのURLをサブスクリプションURLとして使わないでください。
更新後、サーバー一覧に目的のノードが表示されているか確認します。一覧が空の場合は、サブスクリプションの形式、有効期限、更新ログを確認してください。URLのクエリパラメーターが認証に使われる場合があります。コピー時は省略せず、スクリーンショットを共有する際は見えないようにしてください。
一覧からノードを選んで現在の接続先に設定し、コアが正常に起動したことを確認します。デスクトップではシステムプロキシの自動設定を選び、ルーティングには用途に合ったプリセットを使いましょう。Androidではクライアントの手順に従って接続を開始し、OSに表示されるネットワーク接続の許可を確認してください。
ルーティングの「直接接続」と「プロキシ」は接続先を決める方針であり、ノードがオンラインかどうかを示すものではありません。初回の検証では設定をシンプルに保ちましょう。別のネットワークツールが動作している場合は、どちらかを停止してから接続結果を確認すると、多段プロキシによる判断の混乱を避けられます。
システムプロキシに従うことが明確なアプリから対象サービスへ接続し、該当する通信がクライアントのログに記録されているか確認します。クライアントの画面が開けても、リクエストがコアに届いているとは限りません。特定のウェブサイトに接続できても、すべてのアプリが同じ経路を使うとは限りません。
問題が起きたら、サブスクリプション、ノード、コア、システムプロキシ、DNSの順に確認してください。一度に変更するのは1項目だけにし、結果を記録しましょう。通常の接続が安定してからTUN、LANアクセス、詳細なルールを設定すると、後から元に戻すのも簡単です。
設定を保存する際は、ノードの入手元、使用中のコア、カスタムルールの用途も記録しておくと便利です。サブスクリプションの更新でグループ内のノードが変更され、手動で加えた内容が保持されないことがあります。長期的に管理する必要のある設定は、クライアントの動作を確認したうえで個別に管理してください。別のネットワークに移るときや検証を終えたとき、特にクライアントを終了する前には、システムプロキシが元に戻っているか確認しましょう。
初回の接続に失敗しても、すぐに再インストールする必要はありません。まず、サブスクリプションのリクエスト、コアの起動、リモート側とのハンドシェイクのどこでエラーが起きたかを確認し、該当する項目を調べましょう。ログにサブスクリプションURL、ノードのドメイン、IDなどが含まれる場合は、共有する前に機密情報を削除してください。具体的な操作手順は使い方ガイドを、OS別のインストールや権限の説明は詳しいドキュメントをご覧ください。
エコシステム、コア、クライアントの違いを把握すると、設定をどのプログラムに渡すべきか判断しやすくなります。
Project Vは、プロキシ関連ツールやコンポーネントを含むエコシステムの背景にあたり、V2Rayは広く使われている名称です。その後、コミュニティからさまざまなコアやクライアントのプロジェクトが生まれたため、「V2Rayクライアント」を検索すると、V2Fly、Xray、v2rayNなどの名前も見つかります。これらは同じ階層のものではありません。プロトコルは通信方式を定め、コアはプロトコルやルーティングを実装し、GUIクライアントはサブスクリプション、設定、動作状況の管理を支援します。
V2FlyはV2Rayのコミュニティ開発を引き継ぎ、Xrayは関連技術を基盤に独自のプロトコル実装や機能を発展させてきました。sing-boxは別の独立したプロキシコアプロジェクトです。機能に重なる部分はありますが、ネイティブ設定の構造や対応機能は完全には一致しません。VMess、VLESS、Trojanという同じ名称が使われていても、トランスポート層、セキュリティパラメーター、クライアントによる設定生成の方法を確認してください。名称だけで設定全体が共通だと判断することはできません。
v2rayN、v2rayNG、v2flyNGはいずれも、クライアントのコードをオープンソースで公開しています。v2rayNはデスクトップ向けで、サブスクリプション、システムプロキシ、ルーティング、コアの動作を1つの画面で管理できます。v2rayNGはAndroid向けで、Xrayコアを使用します。v2flyNGはV2Flyコアを使う別の選択肢です。オープンソースとは、ライセンス条件の範囲内でコードを閲覧・利用できるという意味です。すべてのプロジェクトが同じライセンスを採用しているわけではないため、各ライセンスを個別に確認してください。
クライアントの更新では画面、互換性、アプリの機能が改善され、コアの更新ではプロトコルの実装や動作が変わることがあります。サブスクリプションを更新すると、リモートのノード情報が更新されます。ルールデータベースには、別の更新手順が用意されている場合もあります。アップグレード前に現在の設定を記録し、設定のバックアップを保存してください。更新後は、まず既存の接続を確認してから新機能を試しましょう。互換性の問題を調べる際は、「V2Rayが使えない」とだけ記載するのではなく、クライアント、コア、ノードの設定をあわせて記録してください。
クライアントを選ぶ際は、まずデバイスのOSを確認し、次にノードが必要とするプロトコルとコアを調べ、最後に使い方が目的に合うか判断しましょう。Macではv2rayNのサブスクリプション機能とシステムプロキシから使い始めるのが一般的です。モバイル端末ではAndroidクライアントで接続を管理します。このサイトのダウンロード情報とドキュメントは、ツールの設定を案内するものです。サブスクリプションサービスは提供しておらず、アカウント、通信量、ノードの利用可否については、サブスクリプション提供元の案内をご確認ください。
REALITY、Vision、DNS、GeoSiteなどの用語は、それぞれの技術レイヤーに分けて理解しましょう。REALITYは接続のセキュリティに関わる設定、Visionは関連するフロー制御方式、DNSは名前解決、GeoSiteはドメインの集合による照合に使われます。いずれか1項目を変更しても、ほかの問題が自動で解決するわけではありません。まず動作する基本設定を残し、ログと比較テストを使って1項目ずつ拡張すると、未知の設定一式を一度にコピーするより管理しやすくなります。
システムプロキシからルールデータベースまで、実際の問題に合わせて読み進められます。
2種類のルールデータベースに収録される情報、クライアントでの一括更新方法、geosite:cnやgeoip:privateなどの一般的な記述を使ったルーティングルールの照合順と注意点を解説します。
記事を読む →OS別に、クライアントが起動直後にクラッシュする主な原因を整理します。Windowsでの.NET Desktop Runtime不足、macOSの「破損している」表示や権限エラー、Linuxでの依存関係不足を取り上げ、順を追って対処方法を説明します。
記事を読む →v2rayNの3種類のシステムプロキシ設定とルーティングのプリセットを比較し、グローバルや中国本土を迂回するモードが対象とする通信を解説します。Macでの日常業務や開発時に適した設定も紹介します。
記事を読む →