設定リファレンス · コアとクライアント
V2Ray 設定ファイルのリファレンス
ローカルのinboundからoutboundの選択まで、接続の流れに沿って設定項目とトラブルシューティングの手がかりを解説します。
初めてのインストール、サブスクリプションのインポート、接続確認には、まずv2rayN クイックスタートをご覧ください。このガイドは、具体的な設定項目を調べるためのリファレンスです。前半の6章ではコアが読み込むJSONを、最後の2章ではGUIクライアントでのコア選択、サブスクリプション管理、通信の取り込みを解説します。例ではV2FlyとXrayに共通することの多い項目を扱います。各機能が使えるかどうかは、実際に起動しているコアにより異なります。
JSON構造と接続処理の流れ
まず、コアが読み込んだ設定ファイルを確認
v2rayNでは、サーバー項目やサブスクリプション情報、画面の設定はクライアントが管理します。一方、コアが実際に読み込むのは起動時に渡された設定ファイルです。項目を画面上に保存できても、それはクライアントが入力を受け付けたというだけで、コアが生成された設定を読み込めたとは限りません。調査の際は、選択中の項目、起動中のコア、ログの起動時刻を確認してください。一時生成ファイルを編集した場合、項目の再選択や再起動で再生成されることがあります。変更を継続して使うには、クライアントが対応する設定箇所に記述するか、自分で管理する設定ファイルのコピーに保存してください。
最小構成:ローカル接続と直接接続
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} }
]
}
これは動作を比較するための独立したサンプルです。アプリはローカルのSOCKSリスナーに接続し、コアはfreedomアウトバウンドで接続先へ直接接続します。リモートサーバーは経由しません。テスト前に、サンプルで使うポートが空いていることを確認してください。起動中のv2rayNが同じポートを使っていると、別プロセスを起動した際に競合します。また、テストするアプリが実際にこのSOCKS接続先を使っているかも確認しましょう。Webページが開けても、アプリがプロキシを使っていなければ設定が有効だとは判断できません。反対に、別のプログラムがポートを使用中なら、接続できても起動したプロセスにつながったとは限りません。
設定項目の階層と値の型を確認
最上位はオブジェクトで、inboundsとoutboundsは配列です。それぞれの要素が入口または出口を表します。routing、dns、policyはオブジェクトで、その中に配列や名前付きの子オブジェクトを含められます。settingsの意味は、項目のprotocolによって変わります。同じsettingsでも、SOCKS inboundの認証設定を別のプロトコルにそのまま移すことはできません。ポートは数値、オン・オフは引用符のない真偽値、タグは文字列で記述します。手動で設定を統合する場合は、最上位に同名の配列を追加するのではなく、既存の配列に要素を追加してください。キーが重複すると後の値で上書きされ、前半の設定が存在していても反映されないことがあります。
設定ファイルは標準的なJSONで保存してください。キーと文字列は二重引用符で囲み、配列やオブジェクトの最後の要素の後にカンマを付けず、コメントも入れません。厳密な検証に対応するエディターなら、こうした問題を事前に検出できます。ただし、構文が正しいことはテキストを解析できたというだけです。プロトコルの対応状況、タグの解決、ポートのバインド可否は、コアの読み込み結果と実際の接続で確認してください。エラーが続く場合は、起動に初めて失敗した時点の最初のエラーから調べます。その後に表示される接続失敗、再試行、終了のメッセージは、連鎖して発生しているだけの場合があります。
変更内容は、後から再現できる実験として記録しましょう。入口のポート、テストするアプリ、接続先ドメイン、想定する出口、確認できた結果を書き残します。変更後に失敗した場合は、その項目だけを元に戻し、同じ接続先でもう一度試してください。接続先サービスの一時的な不具合を、設定変更による問題と取り違えないためです。「実行中」のアイコンだけでは、すべての通信経路が正常だとは判断できません。特定のリクエストがコアに届いたか、想定したルートを通ったかまでは確認できないことが多いためです。
inbounds:リスニングとアプリの接続
リッスンアドレスで接続可能な範囲が決まる
listenは、コアがどのローカルアドレスで接続を受け付けるかを指定します。ローカルのアプリからのみ接続する場合は、127.0.0.1を明示的に指定できます。これはすべてのIPv4インターフェースへのバインドや、IPv6のループバックアドレスへのバインドとは異なります。アプリがlocalhostをIPv6アドレスに解決し、コアがIPv4だけで待ち受けていると、接続を拒否されることがあります。まずアプリの接続先を、リッスン設定と同じループバックアドレスにして比較してください。ローカルのテストを通すためだけに、リッスン範囲を広げないでください。管理されたLANから接続する必要がある場合は、インターフェースの範囲、アクセス制限、認証を別途検討し、以下のローカル向けサンプルをそのまま流用しないでください。
"inbounds": [
{
"tag": "local-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
},
{
"tag": "local-http",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
この例は、概要サンプルのinbounds項目と置き換えて使います。2つのポート番号は比較しやすいように示した例で、現在のクライアントが必ず使っている番号ではありません。実際のポートは設定と起動ログで確認してください。同じアドレスで2種類のリスナーを使う場合は、それぞれに別のポートと異なるtagを割り当てます。アプリはポート番号だけではプロキシの種類を判別できません。HTTPプロキシをSOCKSポートに向けると、下位の接続が確立しても、その後のハンドシェイクに失敗します。
| 項目 | 例 | 確認ポイント |
|---|---|---|
| listen | 127.0.0.1 | アドレスがアプリのプロキシ接続先と一致していること。 |
| port | 10808 | ポートを別のインスタンスが使用していないこと。 |
| protocol | socks | アプリで選択したプロキシの種類と一致していること。 |
| tag | local-socks | ログでの識別やルーティング規則からの参照に使用します。 |
システムプロキシとUDPは別々に確認
システムプロキシは、OSがアプリに提供する設定です。OSがすべての通信を強制的に転送する仕組みではありません。自動設定を有効にしても、対象アプリがシステムプロキシに従うか、システムの除外リストに入っていないかを確認してください。独自のプロキシ設定や環境変数を優先するツールもあり、ブラウザーの設定が拡張機能や管理ポリシーで上書きされることもあります。「あるアプリは使えるのに、別のアプリはつながらない」場合は、まずプロキシの種類とポートを手動指定できるアプリでリスナーを確認します。その後、問題が起きているアプリが実際に取得した設定を調べ、すぐにサーバー側を変更しないようにしましょう。
上記のSOCKSサンプルではUDPを明示的に無効にしています。必要な場面でSOCKSのUDP機能を有効にしても、アプリが対応するSOCKSアソシエーション方式を使い、後続の出口と経路がその通信に対応している必要があります。一般的なHTTPプロキシのテストで確認できるのは、テストしたHTTPリクエストやTCPトンネルが動作したことだけです。それだけで通話などのリアルタイム通信や、コネクションレスの通信が正常だとは判断できません。アプリ、プロトコル、入口ごとにテスト結果を記録すると、ひとつの成功結果ですべての症状を説明する誤りを防げます。
終了前にシステムプロキシを手動設定した場合は、想定どおりに元へ戻ったか確認してください。ループバックアドレスが残っていると、有効なプロキシに見えても、実際には接続を受け付けるプロセスが存在しないことがあります。クライアント終了後にブラウザーがインターネットへ接続できなくなった場合は、トラブルシューティングQ&Aのシステムプロキシとローカルリスナーに関する項目を確認し、アプリが入口に接続できていないのか、入口より先の経路で問題が起きているのかを切り分けてください。
outbounds:プロトコル、タグ、トランスポート
検証できる出口で基準を作る
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} },
{ "tag": "block", "protocol": "blackhole", "settings": {} }
]
freedomは外部へ直接接続するために使い、blackholeは特定のルールに一致したリクエストを終了させるために使います。どちらもプロトコル値です。一方、directとblockはルールから参照する任意のタグで、クライアントに組み込まれた特別な動作スイッチではありません。blockをoutbound配列に追加しただけでは、すべてのリクエストが遮断されるわけではありません。特定の通信に使わせるには、対応するルーティング規則が必要です。ルールに一致しない場合、一般的な設定では先頭のoutboundが使われます。リストの順序を変えると既定の動作も変わるため、デフォルトの出口は見てすぐ分かる位置に置いてください。
リモートoutboundは3つの層に分けて確認
利用許可のある接続情報をインポートしたら、生成された設定を3つの層に分けて読み解きます。1つ目はアプリケーションプロトコルで、接続先アドレス、ポート、プロトコルに必要な認証情報を含みます。2つ目は、プロトコルデータを運ぶトランスポート方式です。3つ目は、選択したトランスポートに適用するセキュリティ設定です。接続先アドレスは、実際にどこへ接続するかを示します。セキュリティハンドシェイクで使うサービス名は、接続先が要求する名前を満たすためのもので、両者は同じ場合も異なる場合もあります。サブスクリプション内の名前が、識別しやすくするためのコメントにすぎないこともあります。サーバーアドレスやハンドシェイク名としてそのまま使わないでください。
protocolとsettingsはoutboundのプロトコル自体を指定し、対応するトランスポートやセキュリティ設定は通常streamSettingsに記述します。たとえば、画面にある接続が特定のトランスポートを使っているからといって、別の接続のパスをそのままコピーできるとは限りません。パス、名前、ハンドシェイク方式に関する接続先の要件は、実際のサービスによって異なります。証明書エラーを回避するために検証を無効にしないでください。まずシステム時刻、接続先の名前、証明書チェーンを確認し、クライアントのトランスポート設定が正しいかを調べます。異なるコアでプロトコル項目やトランスポートの種類が似ていても、すべての組み合わせを相互に使えるとは限りません。
失敗した段階からログとテスト結果を読む
ローカルのinboundがリクエストを受信しているのに、ログにoutboundが見つからないと表示される場合は、ルーティングに記述したタグを確認します。大文字・小文字、前後の空白、タグの重複、更新前の古い参照に注意してください。リモートアドレスへの接続を試みたログがある場合は、名前解決の失敗、接続タイムアウト、ハンドシェイク失敗を区別します。名前解決の失敗は、接続可能なアドレスを得る前に起こります。接続タイムアウトは、経路やネットワークの状態、接続先のリッスン状態に関係する場合があります。ハンドシェイクに失敗した場合は、プロトコル設定がサービスの要件に合っているかを確認しましょう。「接続失敗」という一般的な表示だけでは、どの段階で問題が起きたかは分かりません。
リモートoutboundをテストするときは、同じリクエストで入口を再確認してから、接続全体のテスト結果と照らし合わせます。ポートに接続できても、確認時点で接続が成立したことを示すだけで、その後のプロトコルハンドシェイクやダウンロード速度までは保証しません。Tcping・実接続の遅延・速度測定結果の違いでは、それぞれのテストで確認できる範囲を解説しています。テスト先が不安定なら、性質の近い接続先を追加して比較できますが、接続先を変更すると同時にoutboundの設定も変更すると、結果の原因を特定しにくくなります。
複数のoutboundを使う場合は、それぞれに安定した重複しないタグを付け、特定の速度測定結果ではなく用途を表す名前にしてください。outboundの詳細を更新したら、手動作成したルーティングを含め、すべての参照を再確認します。ログを同僚に共有して調査を依頼する場合は、リモート接続の認証情報、サブスクリプションURL、リクエストの詳細を削除してください。エラーの種類、入口タグ、出口タグを残せば、次に調べるべき層を特定できることがほとんどです。
routing:ルールの評価順と対象の種類
上から順に読み、最初に一致したルールを適用
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-http"],
"domain": ["full:example.org"],
"outboundTag": "block"
},
{
"type": "field",
"domain": ["domain:example.org"],
"outboundTag": "direct"
}
]
}
この例は前の2章で紹介したinboundとoutboundの設定と組み合わせ、サンプルのドメインでルールの順序を説明します。最初のルールは、リクエストの送信元がlocal-httpで、ルーティングに使う接続先名がexample.orgと完全に一致する場合にだけ適用され、通信をblockへ送ります。local-socksから同じドメインへ接続した場合は最初のルールに一致せず、2つ目のルールが適用されます。サブドメインへのリクエストも2つ目のルールに一致します。2つのルールを入れ替えると、対象範囲の広いドメインルールが先に適用され、完全一致ルールの範囲まで含むため、結果が変わります。
完全一致、ドメインのサフィックス、IPアドレス範囲を区別
full:はドメイン名の完全一致に使います。domain:は指定したドメインとそのサブドメインに一致し、文字列が任意の位置に含まれるかどうかを見るものではありません。正規表現を使う場合はregexp:を指定できますが、まず一致させたい例と一致させたくない例を挙げてルールを確認してください。バックスラッシュの一部はJSON文字列としてエスケープが必要です。geosite:はドメインデータセット、geoip:はIPアドレスデータセットを参照します。利用できるかどうかは、実行環境にデータと対応するタグが用意されているかによります。ルールをコピーする前にデータの提供元を確認し、読み込み失敗をルールの評価順の問題と取り違えないようにしましょう。
ipは、明示された宛先IPアドレスまたはCIDR形式のアドレス範囲に一致します。IPルールを書く前に、アプリからinboundに渡されるのがドメイン名か、名前解決済みのアドレスかを確認してください。アプリ側ですでに名前解決されている場合、ルーティングから元のドメイン名を参照できないことがあります。また、複数のドメインが同じIPアドレスを共有する場合もあるため、IPからアクセス先のサイトを確実に特定することはできません。反対に、inboundがドメイン名を受け取った場合に、名前解決後のアドレスでIPルールに一致させられるかは、domainStrategyとコアのDNSが正常に動作しているかによります。
domainStrategyで名前解決のタイミングが変わる
AsIsは、ルーティングの判定時に対象ドメインを追加で名前解決しません。IPIfNonMatchは、既存の対象情報で一致しなかった場合に名前解決して再判定できます。そのため、先に一致するルールや、最初の判定ですべての通信を拾うフォールバックルールがあると、想定したIPルールが評価されないことがあります。IPOnDemandは、IPアドレス情報が必要なルールを判定する際に名前解決を行います。選択する前に、名前解決後のアドレスを使った判定が本当に必要か確認してください。単に名前解決を増やすと、タイムアウトの可能性がある段階が増えるうえ、既存のドメインルールに一致しない理由を説明できるとは限りません。
ルールを組み合わせる場合、同じ項目に複数の候補を指定すると、通常はいずれかひとつに一致すれば適用されます。一方、1つのルールに異なる条件を指定すると、それらすべてを満たす必要があります。同じ出口で特定のドメインとIP範囲の両方を処理するなら、その出口を参照するルールを2つに分けると分かりやすくなります。ドメイン条件とIP条件をひとつのルールに書けば「OR」になるとは限りません。変更後は再読み込みし、実際に選択された出口を確認してください。詳しくはカスタムルーティング規則の構文と優先順位をご覧ください。
dns設定:問い合わせ先、静的マッピング、フォールバック
ブラウザー、コア、システムの名前解決は別々の仕組み
システムの名前解決は、OSの名前解決機能を使うプログラムに結果を返します。一方、ブラウザーなどのアプリが独自のキャッシュを持っていたり、別の名前解決サービスを使ったりすることもあります。コアのdns設定は、たとえばIPルールの判定にドメインの名前解決結果を使う場合など、コア内部で名前が必要になったときに使われます。設定ファイルに記述しただけで、PC全体のDNS問い合わせを引き受けるわけではありません。テストするアプリが最終的にinboundへIPアドレスだけを渡す場合、先行する名前解決はアプリ側やシステム側ですでに行われている可能性があります。同じリクエストがドメイン名のままコアに届くようになるわけではないため、コアのDNS設定を変更しても解決しないことがあります。
"dns": {
"hosts": {
"example.org": "192.0.2.10"
},
"servers": ["localhost"],
"queryStrategy": "UseIP"
}
これはトップレベルのdns項目を示す独立した例です。hostsではコア内部の静的マッピングを説明しています。例のIPアドレスはドキュメント用アドレス範囲に属するため、実際の接続テストには使用できません。このマッピングを残したままでは、対象名の問い合わせに実際のサービスのアドレスが返ることは期待できません。通常のテストでは、このマッピングを削除してください。ここでのlocalhostはローカルマシンの名前解決機能を使う特殊な値で、DNSパケットの送信先としてループバックアドレスを指定するための省略表記ではありません。UseIPは特定のアドレスファミリーだけに問い合わせを限定せず、IPv4とIPv6の両方が返ることも保証しません。結果は上流DNSの応答と対象レコードによります。
問い合わせに使われる経路は用途ごとに確認
ルーティングの判定に使われるアドレスが、最終的なoutboundの接続時に使われるアドレスと同じとは限りません。前者はIPルールの判定だけに使われ、outboundは元のドメイン名を使って自分で名前解決したり、接続先に処理を任せたりすることがあります。たとえばfreedomでは、outbound側のドメイン処理設定とrouting.domainStrategyは別々の段階です。両方を全体に適用されるひとつの設定として扱わないでください。どの層で名前解決されたかを確認するには、ほかのテスト通信を止め、inboundが受け取った接続先、適用されたルール、outboundのログを照らし合わせます。
複数の名前解決先を設定しても、単純に配列の順番で順次再試行するリストとは限りません。設定によっては、DNSサーバーごとに対象ドメインを限定したり、フォールバックに利用するかどうかを指定したりできます。想定したDNSサーバーがドメインに適用されていない場合、そのサーバーがタイムアウトした場合、応答が空だった場合では、それぞれ状況が異なります。細かなオプションを使うときは、別のコアの設定を流用せず、現在のコアが認識する項目を確認してください。まず動作が分かっているDNSサーバーをひとつ使い、基本的な問い合わせが成功することを確認してから、ドメイン条件を追加し、一致する場合と一致しない場合を比較しましょう。
キャッシュ、アドレスファミリー、起動時の依存関係を確認
設定を変更しても結果が変わらない場合は、テストするアプリやコアが古いキャッシュを保持していないか、既存の接続を再利用していないかを確認します。同じドメイン名をテストする際は、アプリの接続を作り直し、問い合わせと接続が発生した時刻を記録してください。IPv6アドレスが返っても接続できないからといって、必ずしもDNSの応答が誤っているとは限りません。出口がIPv6で接続できない可能性もあります。アドレスが解決できるか、ルーティングが正しいか、そのアドレスに実際に到達できるかを個別に確認してから、問い合わせるアドレスファミリーを制限する必要があるか判断してください。
起動時に問題が止まるケースもあります。上流サーバーやリモート接続先をドメイン名で指定していて、その名前解決に、まだ確立されていない接続が必要な場合です。この場合、DNSサーバーのアドレスを追加するだけでは解決しません。依存関係を整理し、接続確立前に必要な名前解決と、独立して利用できる経路があるかを確認してください。Tunモードを有効にした後も、問い合わせが実際にどのインターフェースを通るかが変わる可能性があるため、同じ点を再確認します。システム画面に設定されているDNSアドレスだけを見ても、実際の経路は分かりません。
policy:タイムアウト、ユーザーレベル、統計
レベルごとに接続のライフサイクルを設定
"policy": {
"levels": {
"0": {
"handshake": 4,
"connIdle": 300,
"uplinkOnly": 2,
"downlinkOnly": 5
}
}
}
これはトップレベルのpolicyの例であり、outboundのsettingsではありません。levelsでは文字列のキーでレベルを指定します。ここではレベル0を例に、値を秒単位で示しています。設定項目の意味を説明するための例であり、一般的な推奨値ではありません。プロトコルによって、設定内でユーザーレベルを指定する位置は異なります。レベルを変更しても効果が見えない場合は、テスト中の接続がそのレベルを使用しているか、稼働中のコアが該当する処理にその設定を適用しているかを確認してください。policyは主に接続のライフサイクルと統計を制御するもので、出口を選択したり、ユーザーにアクセス権を与えたりするものではありません。
| 項目 | 適用される段階 | よくある誤解 |
|---|---|---|
handshake | 該当プロトコルのハンドシェイク中。 | 名前解決、接続、Webページの読み込みを含む全体の制限時間ではありません。 |
connIdle | 接続中にデータの送受信がない状態。 | 接続開始から切断までの総時間ではありません。 |
uplinkOnly | 下りの送信が終了し、上りだけが残った状態。 | 上りの速度制限ではありません。 |
downlinkOnly | 上りの送信が終了し、下りだけが残った状態。 | 下りのバッファーサイズではありません。 |
ハンドシェイク失敗、アイドル切断、片方向の終了を区別
初回の接続に一度だけ失敗する場合と、しばらく安定していた接続が切れる場合は、同じ問題とは限りません。データが止まった時刻、上りまたは下りが続いているか、再接続ですぐ復旧するかを記録してください。一定のアイドル時間に近づくと必ず異常が起きる場合、コアのアイドルポリシーだけでなく、アプリ、リモートサービス、中継機器が接続を終了している可能性もあります。ローカルのポリシーを延長しても、接続先やネットワーク機器のタイムアウトは変更できません。反対に、時間を短くして切断が早まった場合は手がかりになりますが、テスト中にネットワークや設定が変わっていないかも確認が必要です。
長時間データを送信しないアプリでは、ポリシーを変更する前に、もともとキープアライブ機能があるかを確認してください。アイドル状態の接続を保持するとリソースを消費します。すべてのタイムアウトを一律に延ばすと、無効になった接続の検出が遅れることもあります。他の人の設定をそのまま使うのではなく、同じネットワークとアプリで新しい接続を作り、まず基準となる結果を記録してから、症状に関係する項目だけを変更して比較しましょう。既存の接続には変更前の状態が残ることがあるため、比較の前に設定を再読み込みし、新しいセッションを確立してください。
統計の有効化と統計の取得は別々に設定
通信方向を調べる場合は、ユーザーレベルごとに制御するpolicy.levelsの統計設定と、inboundまたはoutbound方向ごとに制御するpolicy.systemの統計設定を区別します。統計を有効にしても、GUIに数値が表示されるとは限りません。該当機能に対応するコアで統計を有効にし、クライアント側でも互換性のある方法で読み取る必要があります。タグが空、対象の選択ミス、再起動によるカウンターのリセットなどで、表示が想定と異なることがあります。画面によっては複数の接続を合算するため、数値が増えたことだけでは、どのアプリのリクエストがどの出口を使ったかを特定できません。
統計やログを扱う際は、必要な診断範囲に限定してください。1つの接続を調べるために詳細なアクセスログを長期間残すと、接続先アドレスや時刻の情報が不要に蓄積されることがあります。管理インターフェースから統計を取得する場合は、十分に保護できない管理用の入口を外部ネットワークへ公開しないでください。原因を特定したら、通常のログレベルに戻し、一時的な統計設定を解除します。症状、変更内容、結論だけをまとめた短い記録を残しておけば、同じ問題を再調査するときに役立ちます。
コア選択とサブスクリプション設定の境界
クライアント名ではなく、実際に起動したコアを確認
デスクトップ版はv2rayNインストーラーから始め、OSとプロセッサーの構成に合ったものを選んでください。クライアントはGUI、サブスクリプション管理、設定の保存を担当し、コアは読み込んだプロトコル設定と接続を処理します。Android用のv2rayNGはXrayコアを使用し、v2flyNGはV2Flyコアを選べる代替クライアントです。Project Vはこのエコシステムを理解するための出発点です。V2FlyはV2Rayのコミュニティによる開発を引き継ぎ、Xrayは関連コードから発展して独自のプロジェクトとなりました。項目名が同じでも、対応するプロトコルの組み合わせ、トランスポート方式、追加オプションが各コアで常に同じとは限りません。
GUIの選択とコアの読み込み、どちらに問題があるかを判断するには、今回の起動ログが最も役立ちます。ログが現在選択中の設定に対応しているかを確認し、想定したコアが起動しているかも調べてください。コアを変更して未知のプロトコル、未知のトランスポート、項目の型エラーが出ても、すぐに該当項目を削除して試さないでください。リモートサービスへの接続に必須の項目もあり、削除すると起動失敗が後続のハンドシェイク失敗に変わるだけの場合があります。まず動作確認済みのコアと項目に戻し、互換性を一つずつ確認するのが安全です。
共通項目を使ってローカルで比較
"log": { "loglevel": "warning" },
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} }
]
このサンプルはコア設定のトップレベル項目で、ログと直接接続のoutboundだけを記述しています。完全なテストには、概要にあるローカルinboundも組み合わせてください。独立したテスト設定で一般的な項目とローカルのリッスンが正常に動作するか確認し、その後、実際の項目との差を調べる用途に適しています。既存の設定に追加して重複項目を作ったり、GUIクライアントが生成したoutboundの一覧を上書きしたりしないでください。デスクトップ版の選択については、v2rayNデスクトップ版とWPF版の選び方を参照してください。GUIのフレームワークとコアのプロトコル対応状況は、別の選択項目です。
サブスクリプションのグループ、更新、ローカル変更
サブスクリプションのグループは、クライアント内の提供元や項目を整理するためのもので、コア設定のトップレベル項目ではありません。サブスクリプションを更新すると、クライアントは利用許可のある提供元から内容を取得し、インポートを試みます。更新処理は、内容の取得、項目の解析、画面のリスト更新という段階に分けられます。どの段階で失敗しても、リストが変わらないように見えることがあります。更新に成功したということは取得とインポートの経路が使えたというだけで、すべての項目が接続できるとは限りません。同様に、インポート済みの項目が一時的に接続できても、現在のサブスクリプションURLを更新できるとは限りません。
サブスクリプションの項目を手動で変更した場合、次回の更新で提供元のデータに上書きされることがあります。実際の挙動は、クライアントの統合方法によります。比較テストでは、利用許可のある項目を明確に区別できるローカルのテスト用コピーに保存し、変更内容を記録してください。「更新後に別の項目へ接続される」場合は、グループ、選択状態、実際の起動ログを確認します。表示名だけを頼りにしないでください。別の提供元で同じ表示名が使われていることがあります。調査依頼のスクリーンショットを共有する場合は、完全なサブスクリプションURL、認証情報、各項目のリモート接続情報を隠してください。
初回のインポートはクイックスタートのインポート手順に従えばよく、最初からプロトコル項目を手動で書く必要はありません。新しいサブスクリプションだけに問題があり、以前のものは正常な場合は、提供元へ接続できるか、クライアントが内容を認識できるかを個別に確認してください。ルーティングとコアの設定を同時に変更しないでください。問題が内容の取得、解析と登録、設定の生成、接続の確立のどの段階で起きているかを見極めてから、該当する章を参照しましょう。
Tunモード:仮想インターフェース、システムルート、動作確認
インターフェースによる通信の取り込みと、コアのルーティングを区別
システムプロキシは、アプリがOSの提供するプロキシ設定を利用する仕組みです。Tunモードは、仮想ネットワークインターフェースとシステムルートを使い、選択した通信を処理経路へ渡します。まずシステムがパケットをどのインターフェースへ送るかを決め、該当するコンポーネントに通信が届いてから、コアがルールに基づいてoutboundを選択します。この2段階は互いに置き換えられません。コアのルールを直接接続に変更しても、パケットが先に仮想インターフェースを通ることは防げません。システム側で仮想インターフェースに通信を渡していない場合、コアのルールを変更してもその通信に影響しないことがあります。
既知の入口を使って通信取り込みの問題を切り分ける
"routing": {
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"outboundTag": "direct"
}
]
}
これはコアのルーティング例です。前の章で定義したlocal-socksとdirectを参照しており、Tunの設定ではありません。独立した設定に配置し、管理されたローカル入口からルーティングの判定を確認したうえで、仮想インターフェース経由のテストと比較できます。どちらの接続方法も同じデフォルトoutboundを使う場合、接続先へ到達できたかだけでは、このルールが適用された証拠になりません。ログで入口と出口を確認してください。仮想インターフェースで取り込まれた通信もlocal-socksとして扱われるとは限りません。クライアントが生成した設定とログを確認し、実際の処理経路を特定してください。
有効化前・有効化後・無効化後の3回に分けて確認
有効化する前に、同じテストに影響する別の通信取り込みツールが動作していないことを確認します。通常の接続状態を記録し、新しいモードを無効に戻せることも確認してください。有効化時に権限エラーや仮想インターフェースの作成失敗が表示された場合は、ユーザー権限、システムの制限、クライアントの起動ログを調べます。画面のスイッチがオンでも、確認できるのはGUI上の状態だけです。仮想インターフェースが実際に作成され、必要なルートが設定されたかも確認してください。システムプロキシが残っていると、テストアプリはシステムルートではなくループバックプロキシに接続することがあります。その状態でテストに成功しても、Tun経由の通信が有効になった証明にはなりません。
有効化後のテストは2つに分けられます。1つは新しいインターフェースを通す通信、もう1つは通常どおり到達できるはずのLANや業務ネットワークのリソースです。前者が失敗する場合は、クライアントのoutboundが物理ネットワーク経由で接続できるか、接続先への通信が取り込み経路に再度捕捉されていないかを確認します。後者が失敗する場合は、インターフェースの優先順位、ネットワーク範囲の重複、既存のネットワークポリシーを調べてください。名前でのアクセスだけ失敗し、IPアドレスを直接指定すると接続できる場合は、DNSの章に戻り、名前解決を実際に行っているコンポーネント、問い合わせが取り込まれているか、確立前の接続に依存していないかを確認しましょう。
無効化した後は、仮想インターフェースに関連するルートとプロキシ設定が想定どおりに復元されたかを確認してください。ネットワークの切り替え、スリープからの復帰、クライアントの更新後に問題が起きた場合は、前回の結果をそのまま当てはめず、実際のインターフェースとルートを再確認します。組織管理下の端末では、制限を回避するために権限を昇格したり、システムルートを変更したりしないでください。承認済みのアプリプロキシ方式でテストし、必要に応じて管理者にポリシーを確認してもらいましょう。
Androidクライアントの通信取り込みは、システムのVPN権限で管理されます。アプリごとの選択方法などをデスクトップ設定にそのまま当てはめないでください。権限、バックグラウンド制限、アプリごとの対象範囲を確認する場合は、まずAndroidクイックスタートで基本的な手順を確認し、続けてv2rayNGのVPN権限・バッテリー最適化・アプリごとの設定をご覧ください。どのプラットフォームでも、原因の切り分けでは、リクエストが想定したインターフェースに入ったか、入った後にどのoutboundが選ばれたかの2点から確認します。