V2Ray Configuration Reference
V2Ray用語集：プロトコル・コア・サブスクリプション・ルーティングの基礎
実際の設定項目に沿って代表的な用語を整理し、プロトコル、コア、クライアント機能、測定指標を区別します。各項目では、解決する問題、必要なパラメータ、混同しやすい関連概念を説明します。
5
カテゴリ
28
主要用語
4
対応プラットフォーム
Quick Index
ローマ字・英語インデックス
用語名が分かっている場合は、直接ジャンプできます。英語のプロトコル名は原表記のまま、機能名は一般的な日本語表記で並べています。
プロトコルと暗号化
プロトコルは、クライアントとサーバーがデータを認証、カプセル化、転送する方法を定めます。サブスクリプションに表示されるプロトコル名だけで接続品質が決まるわけではなく、セキュリティ層、トランスポート方式、サーバー側パラメータの一致も重要です。
- VMess
- Project Vエコシステムで使われるプロキシプロトコルです。クライアントとサーバーは同じユーザー識別子、ポート、トランスポート方式、セキュリティパラメータを使う必要があり、どれか1つでも一致しないとハンドシェイクに失敗することがあります。VMessはプロトコル名であり、クライアント名ではありません。また、どのGUIで管理されているノードかを判断する名称でもありません。
- VLESS
- 比較的シンプルな構造のプロキシプロトコルで、単体ではデータ暗号化を追加で担わず、通常はTLSやREALITYなどのセキュリティ層と組み合わせます。設定時はアドレス、ポート、ユーザー識別子に加え、フロー制御、セキュリティ方式、サーバー名なども確認します。VLESSとVMessは同じサブスクリプション内に共存でき、クライアントはノードごとのプロトコルに応じて処理します。
- Trojan
- パスワードを主な認証情報として、通常はTLS上で動作するプロキシプロトコルです。クライアント側ではサーバーアドレス、ポート、パスワード、サーバー名、証明書検証の設定などを指定します。TrojanノードにVMessやVLESSの認証項目をそのまま流用することはできません。インポート後も、サブスクリプションが指定したプロトコル種別を維持してください。
- Shadowsocks
- 事前共有パスワードと指定した暗号化方式を使うプロキシプロトコルです。サーバーアドレス、ポート、パスワード、暗号化方式が設定の中心で、双方のパラメータを一致させる必要があります。SOCKSローカルプロキシとは別の概念で、前者はクライアントとサーバー間のプロトコル、後者は通常、アプリがローカルクライアントへ接続するためのインターフェースを指します。
- REALITY
- Xrayエコシステムのトランスポートセキュリティ方式で、VLESSと組み合わせて使われることが多い機能です。サブスクリプションのノードには通常、サーバー名、公開鍵、ショートID、フィンガープリントなどが含まれます。手動入力では各項目を正確に対応させてください。REALITYは独立したノードプロトコルではないため、設定画面では完全な組み合わせも通常VLESSとして表示されます。
コアとエコシステム
GUIクライアントは画面、サブスクリプション、システム設定を担当し、コアは実際のプロトコル接続、DNS、ルーティング処理を担当します。プロジェクト名、コア派生、クライアント名を区別すると、設定がどの層で実行されるかを判断しやすくなります。
- Project V
- ネットワークプロキシプロトコル、ルーティング機能、関連ツールを中心としたオープンソースの技術エコシステムです。V2Rayの設定体系やVMessなどのプロトコル、後続のコア派生プロジェクトもその発展に関係しています。特定のインストールプログラムそのものを指す名称ではありません。
- V2Ray
- Project Vエコシステムで使われる代表的なコアプログラムおよび設定体系の名称で、関連クライアント全体を指す通称としても使われます。厳密には、V2Rayコアとv2rayN、v2rayNGなどのGUIクライアントは同じソフトウェアではありません。クライアントはコアの機能を組み込み、サブスクリプション更新、ノード選択、システムプロキシ制御などの操作画面を提供します。
- V2Fly
- V2Rayの技術路線を引き継ぐコミュニティ運営プロジェクトで、v2ray-coreと関連仕様の実装を提供します。v2flyNGなどのクライアント名に含まれるv2flyは、このコアエコシステムを指します。設定の互換性に問題がある場合は、画面上の名称だけでなく、クライアントのバージョン、コア派生、プロトコルパラメータも確認してください。
- Xray
- V2Rayの設定体系と深く関係するコア派生プロジェクトで、VLESSやREALITYなどに対応し、一部のGUIクライアントで採用されています。Xrayはコアであり、サブスクリプションサービスでも特定の接続モードでもありません。クライアント画面で利用できるプロトコルは、搭載コアとクライアント側の設定対応によって決まります。
- v2rayN
- Windows、macOS、Linux向けのGUIクライアントで、サブスクリプション、ノード、システムプロキシ、ルーティング、TUNなどを管理します。v2rayNは画面上の設定を、コアが読み込める実行設定へ変換します。問題を調べる際は、クライアント操作、生成された設定内容、コアのログを分けて確認すると原因を特定しやすくなります。
サブスクリプションとノード
サブスクリプションは設定の一括配布と更新を担い、ノードは実際に選択できる個別の接続情報です。クライアントのローカル一覧は更新によって変わるため、手動編集の前に次回更新で上書きされるか確認してください。
- サブスクリプション
- サービス提供者が生成する設定一覧のURLで、クライアントはそこからノード情報を取得します。サブスクリプションURL自体は通常、直接接続するノードではなく、ノード一覧の取得元です。インポート後に更新を実行すると、クライアントが内容を取得してローカルデータベースへ保存します。
- ノード
- クライアントで選択できる個別のサーバー接続設定で、アドレス、ポート、プロトコル、認証、トランスポートのパラメータを含みます。ノード名は識別用にすぎず、接続動作を決めるのは内部の設定項目です。ノードを選択した後はコアを起動し、用途に応じてシステムプロキシまたはTUNモードを有効にします。
- サブスクリプショングループ
- 複数のサブスクリプションソースを個別に管理するクライアント機能で、メモ、更新間隔、フィルタ条件をそれぞれ設定できます。グループ分けによりノードの取得元を区別し、特定のサブスクリプションだけを更新できます。グループを削除すると、そのソースに属するノードにも影響することがあるため、実行前に確認範囲を確認してください。
- サブスクリプションの更新
- クライアントがサブスクリプションURLに再接続し、返された内容でノード一覧を更新する処理です。クライアントプログラムのアップグレードとは異なり、サーバー側の設定を自動修復するものでもありません。更新後のノード数、名称、パラメータの変化は、通常サブスクリプションソースの新しい内容によるものです。
- ノードのフィルタリング
- ノード名に含まれる地域、倍率、プロトコル、任意のキーワードなどを条件にサブスクリプションの内容を絞り込む方法です。不要な項目を減らせますが、ノード自体の接続品質は改善しません。除外ルールを使う場合はキーワードの範囲を確認し、必要なノードまで非表示にしないよう注意してください。
ルーティングと振り分け
ルーティングシステムはまず接続先を識別し、ルールの順序に従ってアウトバウンドを選択します。DNS解決がどの層で行われるか、アプリがシステムプロキシに従うか、TUNが通信を取り込むかによって、判定に利用できる情報は変わります。
- ルーティングルール
- ドメイン、IP、ポート、プロトコル、プロセスなどの条件に基づき、通信を直接接続、プロキシ経由、または遮断のいずれにするかを決めるマッチングルールです。通常は順番に判定され、最初に一致した結果が後続の処理に影響します。ルール変更後は明確なテスト対象で確認し、ノードの表示状態だけで振り分け結果を判断しないでください。
- ルーティングの振り分け
- 宛先ごとに異なるアウトバウンドへ通信を振り分ける設定方法です。たとえば一部の接続を直接アクセスにし、別の接続を選択したノード経由にできます。振り分けは単一のスイッチではなく、マッチングデータ、ルールの優先順位、DNSポリシー、アウトバウンド設定で構成されます。
- GeoIP
- IPアドレスの所在地域に基づくルーティング判定用のデータセットです。接続先がすでにIPへ解決されている場合、またはルールがIPアドレスを直接処理する場合に機能します。IPの帰属情報はネットワーク資源の変更に伴って変わるため、同じルールでもデータのバージョンによって判定結果が異なることがあります。
- GeoSite
- ドメインのカテゴリ別に整理されたルールデータの集合で、ルーティングエンジンが複数のドメインを一括判定するために使います。ドメインルールを扱うもので、GeoIPのアドレス帰属判定とは異なります。カテゴリ名、マッチング方式、ルール順序を確認し、ドメイン集合とIP集合を混同しないようにしてください。
- システムプロキシ
- クライアントがOSのプロキシ設定を変更し、その設定に従うアプリからのHTTPまたはSOCKSリクエストをローカルプロキシポートへ渡します。すべてのプログラムがシステムプロキシを読み取るわけではないため、クライアントに「有効」と表示されても全通信が取り込まれるとは限りません。ブラウザや一般的なデスクトップアプリでは、まずこの方式で動作を確認するのが一般的です。
- TUNモード
- 仮想ネットワークインターフェースを通じて、より多くのシステム通信を取り込む動作方式です。システムプロキシを読み取らないアプリにも適しています。ルーティングテーブル、DNS、仮想ネットワークアダプターの権限が関係するため、有効化する前に通常のノード接続が利用できることを確認してください。有効化後に通信異常が起きた場合は、まずTUNを無効にして権限、DNS、ルーティングを個別に確認します。
- FakeDNS
- ドメインに一時的に予約アドレスを返し、後続の接続段階でドメイン情報を復元するDNS処理機構です。TUNモードやドメインベースの振り分けと組み合わせることで、宛先IPしか提供されない接続でも元のドメインに基づくルール判定が可能になります。FakeDNSアドレスは内部マッピングの結果であり、対象サーバーの実アドレスではありません。
接続と診断
診断指標は測定方法と合わせて解釈する必要があります。Ping、実接続遅延、ダウンロード速度測定はそれぞれ異なる段階を確認します。接続に失敗した場合は、サブスクリプション内容、ノードパラメータ、コアのログ、システムの取り込み方式、DNS経路を順に確認してください。
- 遅延
- データが1往復するのにかかる時間で、通常はミリ秒で表示します。測定方法によって対象となる経路が異なるため、方式を離れて数値だけを比較することはできません。Pingが低くてもプロキシのハンドシェイクが速いとは限らず、ダウンロード帯域が広いとも限りません。
- 実接続遅延
- プロキシノードを経由して実際の接続要求を完了するまでの時間で、プロキシのハンドシェイクと接続先への接続処理を含みます。サーバーへの到達性だけを確認するPingより、普段のウェブ閲覧に近い接続段階を測定できます。テスト失敗はプロキシ経路全体が確立していないことを示しますが、具体的な原因はログと合わせて確認する必要があります。
- ダウンロード速度測定
- 実際にデータを転送して、ノードが利用可能なスループットを推定するテスト方法です。測定先、ローカルネットワーク、ノードの負荷、トランスポートプロトコル、測定時間帯の影響を受けます。実通信が発生するため、実接続遅延を確認した後に、大容量ファイルの転送や動画読み込みの性能を判断する用途に適しています。
- DNSリーク
- プロキシ接続を有効にしているにもかかわらず、一部のドメイン検索が想定外のDNS経路から送信される現象です。プロキシノードへ接続できるかどうかとは別の問題です。切り分けでは、アプリの名前解決方式、システムDNS、クライアントのDNS設定、TUNの取り込み範囲を確認し、単にノードを変更するだけでは解決しないよう注意してください。
- ハンドシェイク
- クライアントとサーバーがプロトコルセッションを確立し、必要なパラメータをネゴシエーションする段階です。認証情報、TLS、サーバー名、公開鍵、トランスポート設定の不一致は通常この段階でエラーになります。ログのハンドシェイク失敗は、画面に表示される一般的な接続失敗より具体的で、確認範囲を絞るのに役立ちます。
- パケットロス
- 通信中のデータパケットが宛先に到達しない現象です。継続的なパケットロスは接続の再試行、速度の変動、音声の途切れ、セッション切断につながることがありますが、単発の測定結果はローカル無線LANが原因の場合もあります。判断時は時間を変えて繰り返し測定し、ローカル回線、サーバー回線、接続先サイトの経路を区別してください。