設定リファレンス · 用語集

V2Rayの用語と設定の基礎

サブスクリプションからルーティング先のアウトバウンドまで、各設定がどの階層を担うのかを整理します。v2rayN、v2rayNG、v2flyNGでよく使われる用語を6つのカテゴリに分け、各項目を個別のアンカーで参照できるようにまとめました。

初めて設定する場合は「サブスクリプションとノード」から確認してください。接続に問題がある場合は、クライアント設定、コアの処理、サーバー設定を切り分けてから該当する項目を参照します。

設定ガイドを見る 症状からトラブルを調べる →

プロトコルと通信方式

プロトコルはプロキシデータのやり取り方法を定め、通信設定はデータの運び方を決めます。同じプロトコル名でも、アドレス、認証情報、通信パラメーターの設定が不要になるわけではありません。

VMessプロキシプロトコル
VMessは認証と暗号化の仕組みを備えたプロキシプロトコルです。一般的な設定にはサーバーアドレス、ポート、ユーザーIDが含まれます。クライアントとサーバーで通信方式やセキュリティ設定も一致させる必要があり、ユーザーIDだけを正しく入力しても接続できるとは限りません。認証に失敗する場合はシステム時刻の同期を確認してください。時刻のずれが大きいと認証に影響することがあります。古い設定項目の対応状況は、使用するコアのバージョンによって異なります。
VLESSプロキシプロトコル
VLESSは認証とデータ通信を分けたプロトコルで、プロトコル自体にデータ暗号化機能はありません。通常はTLSやREALITYなどのセキュリティ層と組み合わせます。ユーザーID、セキュリティ層、通信設定をサーバー側と一致させてください。VMess設定のプロトコル名だけを変更して、そのまま使うことはできません。組み合わせの対応可否はGUIに同名の項目があるかではなく、コアとバージョンによって決まります。
TrojanTLSプロキシプロトコル
Trojanは通常、TLSで接続を保護し、パスワードで認証します。パスワードが正しくてもハンドシェイクに失敗する場合は、サーバー名、証明書の信頼性、通信設定を順に確認してください。パスワードを何度も変更するだけでは解決しません。ノードの接続先アドレスとTLSに使うドメイン名が異なる場合もあるため、サーバーから指定されたパラメーターをそのまま設定してください。追加の通信方式に対応しているかどうかも、使用するコアで確認が必要です。
ShadowsocksSS · 暗号化プロキシプロトコル
Shadowsocksは、通信する双方で合意した暗号化方式とパスワードまたはキーを使ってプロキシ接続を確立します。プロトコルのバージョンによってキーの形式が異なる場合があり、選択した暗号化方式がクライアントのコアに対応していることも必要です。リストにある別の方式へ自由に変更できるわけではありません。共有リンクのインポート後は、サーバー、ポート、暗号化方式が正しく読み込まれたか確認してください。通信できるかどうかは、サーバーの状態やネットワーク経路にも左右されます。

コアとエコシステム

GUIクライアントは設定を管理し、コアは接続を実行します。この役割分担を理解すると、機能の設定場所やエラーの調査先を判断しやすくなります。

Project Vモジュール型プロキシシステム
Project Vは、モジュール型のプロキシ機能を中心とするプロジェクト群で、V2Rayはその中核として広く使われています。インバウンド、アウトバウンド、ルーティング、通信方式といった概念は、このモジュール型の設計に基づいており、各機能を組み合わせて動作させられます。特定のデスクトップアプリを指す名称ではありません。v2rayNにノードをインポートすると、クライアントが設定を整理し、選択したコアに渡して実行します。
V2FlyV2Rayコミュニティのコア系列
V2FlyはV2Rayコアの開発を受け継ぐコミュニティプロジェクトで、プロトコル処理、ルーティング、DNSなどの基盤機能を担います。v2flyNGはこのコア系列を採用しており、既存の設定が対応機能と合致する場合に適しています。V2FlyとXrayには技術的なつながりがありますが、その後の機能開発はそれぞれ独自に進んでいます。設定を使う前に、対象のコアが使用するプロトコル、項目、セキュアな通信方式の組み合わせに対応しているか確認してください。
Xray独立系プロキシコア
XrayはV2Rayと技術的なつながりを持ちながら、独立して開発されているコアプロジェクトです。REALITYやXTLS Visionなどが、よく使われる設定項目です。v2rayNGはXrayコアを採用しています。デスクトップ版のv2rayNが実際に使うコアは、現在のバージョンと設定で確認してください。プロトコル名が似ていても、設定全体に互換性があるとは限りません。設定をコピーする際は、セキュリティ層、フロー制御のパラメーター、バージョン要件を特に確認しましょう。
コアcore
コアは、接続の確立、プロキシプロトコルの処理、ルーティングやDNSの実行を担うプログラムです。GUIクライアントは主に操作画面を提供し、設定を生成します。画面が起動しても、コアが正常に動作しているとは限りません。ポートの競合や設定項目の誤りによって、接続が起動段階で止まることがあります。トラブル時は、タスクトレイのアイコンだけを見るのではなく、まずコアの起動ログを確認し、その後リクエストログを調べてください。

ルーティングと振り分け

ルーティングでは、各接続をどのアウトバウンドへ送るかを決めます。照合条件、ルールの順序、どのルールにも一致しない通信のデフォルト経路をあわせて確認してください。

ルーティングrouting
ルーティングは、ドメイン、IPアドレスなどの接続情報に応じて通信を異なるアウトバウンドへ振り分けます。よく使われる direct、proxy、block は、それぞれ直接接続、プロキシ経由、ブロックの意図を表します。ただし、タグは名称にすぎず、実際の動作は対応するアウトバウンドの定義で決まります。振り分けモードはシステムプロキシのオン・オフとは別の機能です。通信がまずコアに届いて初めて、ルールが適用されます。
GeoSiteドメイン分類データ
GeoSiteはドメインをカテゴリ別に整理します。ルーティングでは、geosite:cnやgeosite:category-ads-allのように指定して、該当するドメイン集合を参照できます。照合対象はドメインの分類であり、接続先サーバーの地理的位置ではありません。分類結果は使用するデータファイルによって異なります。ルールが一致しない場合は、対象のデータが存在するか、最新か、コアが照合可能なドメインを取得できているかを確認してください。
GeoIPIPアドレス範囲データ
GeoIPはIPアドレス範囲をカテゴリ別に整理します。たとえば geoip:private はプライベートアドレスなどを判定するために使われます。ドメイン集合を扱うGeoSiteとは判定基準が異なり、両方を組み合わせることもできます。ドメインのリクエストがIPアドレス照合の対象になるかどうかは、ドメイン名の解決方法にも左右されます。サイト名だけから特定のGeoIPカテゴリに一致すると判断することはできません。
ルーティングルールrouting rule
ルーティングルールは、照合条件と転送先のアウトバウンドで構成されます。条件には、ドメイン、アドレス、ポート、プロトコルの特徴などを指定できます。ルールは通常、上から順に評価されるため、具体的な条件を先に、範囲の広い条件を後に設定し、どのルールにも一致しない場合のデフォルトアウトバウンドも確認してください。同じルール内の複数項目の組み合わせ方やドメインリストの照合方法は、画面上の並び順から推測せず、コアの構文に従って判断します。

サブスクリプションとノード

サブスクリプションは設定を取得し、ノードは接続情報を記述します。テストでは個々の接続経路を確認します。更新が完了したこと、ノードが存在すること、接続できることは、それぞれ別の状態です。

サブスクリプションsubscription
サブスクリプションは、URLからノード設定を取得・更新する仕組みです。クライアントが取得した内容を解析し、指定されたグループにノードを追加します。更新の完了は設定の再取得を意味するだけで、すべてのノードが接続可能であることや、選択中のノードが切り替わったことを保証しません。URLにアクセス用の認証情報が含まれる場合があるため、スクリーンショットの共有や問い合わせ、他のデバイスとの同期の前にURL全体を隠し、クライアントが取得形式に対応しているか確認してください。
ノードサーバープロファイル
ノードは、クライアントに保存されるサーバー接続設定です。通常、アドレス、ポート、プロトコル、認証情報、通信設定などが含まれます。一覧に表示される名前は設定を区別するためのメモであり、サーバーの場所、稼働状況、実際の性能を示すものではありません。インポート後にタイムアウトする場合は、選択したノードが正しいか、設定がそろっているか、サーバーに到達できるかを確認しましょう。名前だけを見て並べ替えても解決しません。
レイテンシlatency
レイテンシは特定のテスト方法で測定した応答時間です。TCP接続テスト、プロトコルのハンドシェイク、Webページへのリクエストでは、測定する処理が異なります。数値が低くてもダウンロード速度が速いとは限らず、すべてのアプリが同じアウトバウンドを使っているとも限りません。ノードを比較する際は、できるだけ同じ方法、同じテスト先、近い時間帯で測定してください。テストに失敗した場合は、ログを確認し、タイムアウト、名前解決エラー、認証エラーを切り分けます。
実接続レイテンシreal connection latency
実接続レイテンシは通常、指定したプロキシのアウトバウンド経由でテスト先にアクセスし、リクエストの完了時間を測定する指標です。具体的な手順はクライアントの実装によって異なります。ドメインの名前解決、接続確立、プロトコルのハンドシェイク、接続先からの応答など複数の処理が含まれるため、サーバーのポートだけを測るテストより実際のリクエストに近い値になります。それでもテスト先やルーティングの影響を受けるため、テストに成功しても、他のサイトやアプリが必ず使えるとは限りません。

セキュリティと暗号化

セキュリティ層のパラメーターはサーバー側と一致させてください。ハンドシェイクエラーは原因を一つずつ特定し、検証を無効にする方法を万能な解決策として使わないでください。

TLSTransport Layer Security
TLSは通信データを保護し、証明書などを使ってサーバーの身元を認証します。プロキシプロトコルのセキュリティ層として広く利用されています。証明書が信頼されているか、有効期限内か、ドメインと一致しているか、システム時刻が正しいかは、いずれもハンドシェイクに影響します。証明書エラーが出た場合は、まずこれらの条件を確認してください。証明書検証をスキップすると認証の安全性が低下するため、誤ったパラメーターの修正に代わる方法ではありません。
REALITYXrayのセキュア通信方式
REALITYはXrayエコシステムのセキュアな通信方式で、VLESSやXTLS Visionと組み合わせて使われます。あらゆるTLS設定と自由に入れ替えられるスイッチではありません。クライアントの公開鍵、サーバー名、shortId、関連するフィンガープリントなどのパラメーターをサーバー側の要件に合わせてください。項目の詳細は使用するバージョンによって異なります。ハンドシェイクに失敗する場合は、接続先アドレスだけを変更せず、パラメーター一式とコアの対応状況を確認してください。
SNIServer Name Indication
SNIは、TLSハンドシェイクでサーバー名を伝え、サーバーが適切なサイトや証明書を選択できるようにする拡張機能です。ノードの接続先アドレスにはIPアドレスを指定する場合も、サーバー名と異なる名前を指定する場合もありますが、設定する名前はサーバー側の構成と証明書に合致させる必要があります。クライアント画面では「サーバー名」や serverName と表示されることがあります。ドメイン不一致のエラーが出た場合は、任意の一般的なドメインを入力せず、ノードで指定された値を確認してください。
DNSリークDNS leak
DNSリークとは、DNSクエリが想定外の経路で名前解決される状態を指します。DNSクエリが直接送信されること自体が、すべて問題というわけではありません。OS、ブラウザー、クライアントがそれぞれ異なる方法で名前解決する場合があるため、プロキシ接続が正常でもDNSの経路が想定どおりとは限りません。確認する際は、まずドメインごとにどの経路で名前解決するかを決め、クライアントログ、ブラウザーのセキュアDNS設定、システムの名前解決設定を順に確認してください。

クライアント機能

ここで扱う機能は、通信をコアに取り込む方法や、コアが接続先を識別する方法に関するものです。同じ機能名でも、対応範囲はクライアントやコアのバージョンによって異なる場合があります。

システムプロキシsystem proxy
システムプロキシは、OSがアプリに提供するプロキシ設定です。アプリがこの設定に従う場合に限り、リクエストが指定されたプロキシアドレスへ送られます。独自のプロキシ設定を使うアプリや、直接接続するアプリもあるため、システムプロキシを有効にしても全通信を転送できるわけではありません。v2rayNを使う際は、コアが起動していること、ローカルの待ち受けポートが正しいこと、アプリがシステム設定を使うことを確認してください。クライアント終了後は、使えなくなったプロキシアドレスが残っていないかも確認しましょう。
TUNモード仮想ネットワークインターフェース
TUNモードは、仮想ネットワークインターフェースで通信を受け取り、関連するプログラムに処理させる機能です。より多くのアプリの通信を対象にしたい場合に適しています。有効にすると通常、システムルート、実行権限、DNSの設定が関係し、システムプロキシだけを変更する方法とは異なる動作をします。有効化後にネットワークの問題が起きた場合は、仮想インターフェースの作成状況、ルートの競合、名前解決の経路を確認してください。無効化した後は、ネットワークが元の状態に戻っているかも確かめましょう。
FakeDNS合成IPアドレスによるドメイン対応付け
FakeDNSはドメインに合成IPアドレスを返し、ドメインとアドレスの対応関係を保存します。後続の接続時にコアがこの情報を使って元の接続先を復元します。実際のサーバーアドレスをランダムに変更する機能でも、広告を自動的にブロックする機能でもありません。コアの対応に加え、インバウンドや通信の取り込み設定との連携が必要です。アプリがこの名前解決経路を使わない場合や古いキャッシュが残っている場合、問題が発生することがあります。設定変更後は、キャッシュ、マッピング、実際の接続経路を確認してください。
トラフィックのスニッフィングsniffing
トラフィックのスニッフィングは、一部の接続からプロトコルのメタデータを読み取り、ドメインなどの情報を識別します。たとえば、読み取り可能なHTTPのホスト情報やTLSのサーバー名を取得できます。ドメインによるルーティング照合に役立ちますが、すべての接続を識別できるわけではなく、暗号化された本文を復号する機能でもありません。有効にした場合の影響がルーティング判定だけなのか、接続先アドレスにも及ぶのかは、設定内容を確認してください。互換性の問題がある場合は一時的に無効化し、ログと比較して影響を判断できます。

用語を設定に活かす

まずノードの設定がサーバー側と一致しているかを確認し、次に通信がどのインバウンドへ入ったか、最後にルーティングでどのアウトバウンドが選ばれたかを確認してください。この用語集では設定の意味を解説し、操作手順とエラーへの対処方法は設定ガイドとトラブル対処ページで紹介しています。

v2rayN をダウンロード