CLIENT WORKFLOW
まずノードをクライアントに取り込み、どの通信をコアに渡すかを設定します。設定を管理するのはGUI、接続を確立するのはコアです。システムプロキシとTUNは、アプリの通信をコアへ送る経路を決めます。この3つを分けて確認すると、複数の設定を同時に変更するより問題を特定しやすくなります。
サブスクリプションURLから複数のノード設定を取得できます。個別ノードの共有リンクとは異なります。「サブスクリプショングループ設定」でグループを作成し、名前とURLを入力して保存したら、「サブスクリプションを更新（プロキシを経由しない）」を実行します。現在のネットワークからURLに接続できず、利用可能な接続がすでにある場合は、プロキシ経由での更新を試してください。取得元ごとにグループを分けると、更新やトラブルの確認が簡単です。ノード情報を一つずつ入力する代わりに一括管理できますが、更新結果はログとノード一覧で確認してください。
ルーティングでは、ドメイン名や宛先アドレスなどの条件に応じて、直接接続かプロキシ経由かを選びます。「ルーティング設定」で現在のネットワークに合ったルールを選び、デフォルトの出力先を確認してください。システムプロキシを有効にしても、すべての通信が同じ経路を通るとは限りません。LAN内の機器にアクセスする場合は、プライベートアドレスを直接接続するルールを残します。一つの経路に固定する場合と異なり、宛先ごとに通信を振り分けられますが、ルールの順序や名前解決の結果によって適用されるルールが変わります。設定変更後は同じアプリで再テストし、ログで実際の出力先を確認してください。
システムプロキシが使われるのは、OSのプロキシ設定に従うアプリです。まずブラウザーで接続を確認する場合に適しています。TUNは仮想ネットワークインターフェースを使って通信を取り込むため、システムプロキシを利用しないアプリにも適用できますが、必要な権限とルーティング設定が求められます。先に通常のプロキシ接続を確認してから「TUNモード」を有効にすると、ノードの問題と仮想ネットワークアダプターの問題を切り分けやすくなります。システムプロキシだけの場合より広い範囲の通信を扱う一方、ほかの仮想ネットワークアダプターやDNS設定、ネットワークツールの影響を受けやすくなります。終了後はOSのネットワーク設定が元に戻っているか確認してください。
コアは設定を解釈し、接続を実行します。GUIに同じ名前の項目があっても、すべてのコアで同じ組み合わせが使えるとは限りません。v2rayNの「設定」で、該当する設定形式のコアを確認し、ノードのプロトコルと転送方式に応じてXrayまたはsing-boxを選びます。切り替える前に現在の設定を記録し、切り替え後は起動ログを確認してください。複数のコアを選べるクライアントは対応範囲が広がりますが、認証情報の誤りや無効なノードは切り替えだけでは解決しません。特定のセキュリティ機能を使う場合は、クライアントとコアの両方が必要な設定項目に対応しているか確認してください。
サブスクリプショングループ設定
ルールに応じて出力先を選択
まず接続を確認し、対象範囲を広げる
Xray / sing-box コアの切り替え
インポート後、まずノードを1つ選んで使用するサーバーに設定し、コアが起動するか確認します。ノードが一覧に表示されても、設定が読み込まれたことを示すだけで、接続先に到達できるとは限りません。テスト中はログ画面を開いたままにし、起動時のエラーか、宛先へのアクセス時のタイムアウトかを記録してください。状況によって確認すべき箇所が異なります。
次にシステムプロキシを有効にし、ブラウザーで接続先が明確なページを開きます。ブラウザーはつながるのにほかのアプリで失敗する場合は、そのアプリがシステムプロキシを使う設定になっているか確認してください。すぐにクライアントを再インストールする必要はありません。通信を取り込む範囲を広げる場合は、TUNの権限とDNSの説明を確認してから設定します。OSやGUIのバージョンによってメニュー名が多少異なる場合は、機能を目印に探してください。手順の詳細はクイックスタートガイドをご覧ください。
サブスクリプションURLにはアクセス用の認証情報が含まれることがあるため、アカウント情報と同様に管理してください。スクリーンショットで質問する際は、URLのクエリパラメーターとノードの識別情報を隠します。更新できない場合は、URLが完全か、有効期限が切れていないか、返された内容がログイン画面ではないかを確認してください。すでに取り込んだノードで接続できるかどうかは、別途ノードの状態を確認します。2つの経路はそれぞれ独立して失敗するため、一方の結果で他方を判断することはできません。
PLATFORM SELECTOR
デスクトップではv2rayNから始めましょう。Androidではまずv2rayNGを確認し、使用するコアの要件に応じてv2flyNGも検討してください。ダウンロードページでは、アーキテクチャの選び方とインストール方法をまとめています。クライアントは設定を読み込んで実行するためのソフトです。インストール後、利用可能なサブスクリプションURLまたはノード情報を用意してください。
ダウンロードページからデスクトップ版またはクラシックWPF版を選べます。デスクトップ版はクロスプラットフォームのGUIを採用し、WPF版は従来の操作レイアウトを維持しています。使い慣れた方を選べばよく、同じサブスクリプションを使うために両方をインストールする必要はありません。インストール前にOSとCPUの要件を確認し、初回起動後は「サブスクリプショングループ設定」から設定を追加してください。
TUNを使う場合は、クライアントの案内に従って管理者権限を確認してください。有効にした後にネットワークが切断されたら、まずTUNを無効にし、システムプロキシ経由で接続できることを確認してから、仮想ネットワークアダプターやほかのネットワークツールを調べます。クライアントを正常に終了した後も、システムプロキシ設定が想定どおりに戻っているか確認してください。
ダウンロードへ Windows版クライアント →まずシステムメニューの「このMacについて」でチップ情報を確認し、Apple SiliconまたはIntel向けのダウンロードを選びます。アーキテクチャの選択は、アプリが正常に動作するかに関わりますが、サブスクリプションURLの形式には影響しません。アプリをアプリケーションフォルダに移動して起動し、サブスクリプションを追加して使用するノードを選択してください。
セキュリティに関する警告が表示されたら、内容とアプリの入手元を確認し、システム設定の該当項目から対処してください。セキュリティ機能全体を無効にしないでください。初回はシステムプロキシで接続を確認します。TUNを使う場合は、案内に従って許可し、ネットワーク拡張機能や仮想インターフェースの状態を確認してください。メニューの詳細はインストールガイドをご覧ください。
ダウンロードへ macOS版クライアント →v2rayNGはXrayコアを使用するため、まずはこちらを検討してください。v2flyNGはV2Flyコアを使用し、そのコアに対応した設定が必要な場合に適しています。新しめの端末ならarm64を選べます。CPUアーキテクチャが分からない場合は、汎用版の説明を確認してください。名前が似ているからといって、対応するプロトコルの組み合わせも同じとは限りません。
サブスクリプションを追加して更新し、設定を選んでから接続をタップし、OSのVPN接続許可を確認します。バックグラウンドに移動すると接続が頻繁に切れる場合は、バッテリー最適化とバックグラウンド実行の制限を確認してください。接続済みでも一部のアプリだけ使えない場合は、アプリごとのルーティング設定を調べます。トラブルの確認中は、VPNインターフェースを使用するほかのツールを同時に起動しないでください。
ダウンロードへ Android版クライアント →ディストリビューションのパッケージ形式に合わせてdebまたはrpmを選び、x64とarm64のどちらかを確認します。パッケージ形式とCPUアーキテクチャは別々の条件です。インストール後はデスクトップのアプリ一覧から起動し、まず通常のプロキシ接続を確認してから、TUNの権限やシステムサービスの設定を行ってください。
デスクトップ環境のシステムプロキシ設定を、すべてのアプリが参照するとは限りません。ブラウザーはつながるのにほかのアプリで失敗する場合は、アプリ独自のプロキシ設定を確認してください。TUNを有効にした後に名前解決の問題が起きたら、システムのDNS管理方法とほかの仮想ネットワークインターフェースを確認します。再現可能なテスト条件を保つため、複数の設定画面でDNSを何度も変更するのは避けてください。
ダウンロードへ Linux版クライアント →PROJECT V / V2FLY / XRAY
クライアント名、プロトコル名、コア名は、それぞれ異なる役割を示します。関係を理解しておくと、選択時の誤解を防ぎ、同じ設定でもクライアントによって結果が異なる理由を把握できます。
Project Vは、ネットワークプロキシツールを中心とするプロジェクト群で、V2Rayはその主要な構成要素の一つです。inboundはローカルの通信を受け取り、outboundは宛先やリモートサーバーへの接続を担い、ルーティングルールがその間の経路を選択します。サブスクリプション管理機能やGUIクライアントは、こうした設定機能を操作しやすくするもので、コアとは別の接続方式ではありません。
そのため、サブスクリプションの追加、ノードの選択、システムプロキシの有効化は、それぞれ別の操作です。サブスクリプションは設定の入手元を、使用中のノードは接続に使うリモート設定を、システムプロキシやTUNは通信の入口を決めます。この流れに沿って順番に確認すれば、すべての問題を「クライアントがつながらない」とひとまとめにするより、原因を具体的に絞り込めます。
V2FlyコミュニティはV2Rayの開発と保守を引き継ぎ、Xrayは関連するコードを基盤に分岐して独自に発展しています。共通する概念やプロトコルの背景はありますが、設定項目、転送方式への対応、機能の実装状況をそのまま置き換えられるとは限りません。VLESS、XTLS Vision、REALITYなどを使う場合は、GUIに似た入力欄があるかだけで判断せず、使用するコアが各設定に対応しているか確認してください。
設定を移行する場合は、まず元のコアを確認し、移行先のコアが対応する項目を調べます。未知の項目に関するエラーは設定の互換性の問題です。一方、接続タイムアウトはネットワーク、リモートサーバー、ハンドシェイクの段階で発生する可能性があります。異なる種類のエラーに同じ対処法を使わないでください。コアの名前だけで接続品質を判断することもできません。
v2rayN、v2rayNG、v2flyNGはいずれもオープンソースプロジェクトとして開発されており、デスクトップまたはAndroidで設定を操作するGUIを提供しています。v2rayNは複数のコアを管理でき、v2rayNGはXrayコアを、v2flyNGはV2Flyコアを使用します。クライアントを選ぶときは、まず対応プラットフォームと設定要件を確認し、必要なGUIやコアの機能で絞り込みましょう。
オープンソースライセンスでは、コードの利用や再配布に関する条件が定められています。関連するすべてのコンポーネントが同じライセンスを採用しているとは限りません。V2Flyの主要コードはMITライセンス、Xrayの主要コードはMPL 2.0で公開されており、クライアントや依存ライブラリにもそれぞれライセンスがあります。通常の利用では機能の互換性を確認し、改変、パッケージ化、再配布を行う場合は、該当するライセンス文書を個別に確認してください。
クライアントの更新でメニュー構成や設定の生成方法が変わることがあり、コアの更新では対応する設定項目が変わる場合があります。ルーティングデータの更新は、ドメイン名やアドレスの分類に影響します。変更があったときは、どの層が変わったのかを確認してから、設定の移行が必要か判断してください。接続トラブルのたびにクライアントを更新する必要はありません。
更新前に自分の設定内容を記録し、更新後は以前使えていたノードと同じ接続先で再テストしてください。特定のプロトコル構成だけ失敗する場合は、コアの起動ログとハンドシェイクログを確認します。一部の宛先だけ出力先が違う場合は、ルーティングルールとその順序を調べます。ログを共有する際は、診断に必要な情報だけを残し、サブスクリプションURLと識別情報を隠してください。このサイトでは中国語の操作ガイドを独自に提供しており、上流プロジェクトのライセンス文書や機能ドキュメントに代わるものではありません。
CONFIGURATION NOTES
ログに記録された具体的なエラーから確認を進めましょう。コアが起動しない場合は、ポートと設定項目を確認します。コアは正常でも接続できない場合は、ハンドシェイクと証明書を確認してください。設定の関係を理解したい場合は、inbound、outbound、ルーティングの構造から読み進めます。一度に変更する条件は1つに絞り、変更前後の結果を記録しましょう。
証明書の期限切れ、x509エラー、ハンドシェイクのタイムアウトが起きたら、まずシステムの日付とタイムゾーンを確認し、SNIがサーバーの指定と一致しているか調べます。記事では、証明書の検証失敗とネットワークのタイムアウトを区別し、証明書検証を無効にする方法を常用すべきでない理由を解説します。エラーの種類に応じて順番に確認し、設定の根本的な問題を見落とさないようにしましょう。
TLSのトラブル対処手順を見る →ローカルアプリから送られたリクエストを起点に、inbound、ルーティング、outboundの順に設定を読み解きます。記事ではlog、dns、各項目のtagの役割や、ルールがoutboundを参照する仕組みを解説。設定項目を誤った場所に記述すると、なぜ解析に失敗するのかも説明します。GUIでの設定を終え、ログや生成された設定ファイルを詳しく確認したい方におすすめです。
設定ファイルの構造を読む →コアが起動直後に終了したら、接続ボタンを何度も押すのではなく、最初に記録された具体的なエラーを確認してください。この記事では、待ち受けポートの競合、JSONの構文エラー、未知の設定項目、ルーティングデータファイルの欠落を取り上げ、確認範囲の絞り方を説明します。まず起動時の問題を解決してから、ノードへの接続と宛先へのアクセスをテストしましょう。
コア起動のトラブル対処を見る →