設定リファレンス config.json
V2Ray設定ファイルのリファレンス
リクエストがローカルポートに届いてから、タグ、ルール、接続ポリシーをたどり、カーネルが実際に選択したoutboundを確認します。
クライアントをまだインストールしていない方や、インポートから初回接続までの手順を知りたい方は、まずクイックスタートに沿って操作し、その後、クライアントが生成した設定をこのページで確認してください。
JSON構造の概要
クライアント設定とカーネル設定
クライアントが保存するのは、ノードやサブスクリプション、画面設定、動作モードです。一方、カーネルが読み込むのは起動時に指定された設定ファイルです。両者には関係がありますが、同じファイルではありません。たとえば、クライアントの「システムプロキシ」はアプリのリクエストをローカルプロキシに送るかどうかを決め、カーネルの routing は受信済みのリクエストをどう処理するかを決めます。routingを変更しても、もともとプロキシを使わないアプリがプロキシリクエストを送るようにはなりません。
デスクトップではクライアントのダウンロードページからv2rayNを選べます。Androidではv2rayNGまたはv2flyNGを利用できます。設定を読む前に、実際に起動しているカーネルを確認し、各フィールドを見てください。XrayとV2Flyには共通する構造が多くありますが、プロトコルのオプション、転送パラメーター、リソースファイルがすべて共通とは限りません。カーネルが設定を読み込めても、クライアントが同じ方法でインポートしたり、設定を保持したりするとは限りません。
手元のファイルがノードのエクスポート、完全な設定ファイル、クライアント独自の設定保存データのどれにあたるか、まず確認してください。ノードのエクスポートに記述されるのはリモート側の接続先であり、ローカルの待ち受けポートは設定されません。クライアントの保存データには画面設定や複数のノードが含まれることがあり、そのままカーネルに渡すことはできません。トラブル対処では、今回の起動で実際に使われた設定ファイルを確認します。クライアントがファイルを再生成する場合は、画面上の該当設定を変更するか、クライアントが対応するカスタム設定の入口を利用してください。
トップレベルオブジェクト、配列、タグ参照
ルートはオブジェクトです。inboundsとoutboundsは、プロセスが複数のリスナーと出口を持てるため配列になっています。routingはオブジェクトで、ルール配列はその中のrulesに置きます。dnsとpolicyもオブジェクトです。各項目が波括弧を使っていても、同じ階層のフィールドを前の項目のsettingsに入れないでください。
| フィールド | 構造 | 役割 |
|---|---|---|
inbounds | 配列 | 待ち受けアドレス、ポート、受信プロトコルを指定します。 |
outbounds | 配列 | 直接接続、拒否、リモートプロキシを指定します。先頭の項目がデフォルトのoutboundです。 |
routing | オブジェクト | リクエストを順番に照合し、条件に合った結果をoutboundまたはバランサーに渡します。 |
dns | オブジェクト | 組み込み名前解決が必要な処理に、静的レコードとリゾルバーを提供します。 |
policy | オブジェクト | レベルごとにセッションの制約を設定し、必要に応じて統計を有効にします。 |
タグはタイプ名でも配列のインデックスでもありません。outboundにdirectという名前を付けても自動的に直接接続にはならず、直接接続を実行するのはfreedomです。routingは文字列でタグを参照します。出口の名前を変更する場合は、すべての参照を検索してまとめて更新してください。定義だけを変更して参照を残すと、設定テストやリクエストの転送で問題が起きます。inboundとoutboundで異なる接頭辞を使うと、ログ上で方向を見分けやすくなります。
通常、オブジェクトのプロパティの記述順は動作に影響しませんが、配列の順序には意味がある場合があります。routingのルールを移動すると先に適用される条件が変わり、最初のoutboundを移動するとルールに一致しない通信の行き先が変わります。ファイルのインデントを統一しても、すべての配列をアルファベット順に並べ替えてはいけません。2つのファイルを比較するときは、まず配列の順序を確認し、その後に追加・削除されたフィールドを調べます。
単体で動作する最小構成
以下は単独のファイルとして保存できる基本設定です。ローカルのSOCKSリクエストを受け付け、同じ端末から直接接続します。リモートノードやルール用リソースは不要です。テスト前に、同じポートを使うクライアントを終了するか、サンプルのポートとテストツールのプロキシポートを両方変更してください。以降のコードは、特に説明がない限り同じルートオブジェクトに適用する個別の断片です。ルートの波括弧を含む複数の断片を、そのまま連結しないでください。
{
"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" }
]
}
例では厳密なJSONを使用します。キー名と文字列はダブルクォートで囲み、配列とオブジェクトの最後の項目にカンマを付けず、同じ階層に重複するキーを置かないでください。ポートは整数、オン/オフは真偽値で記述し、列挙値はカーネルが受け付ける綴りを使います。トップレベル設定が両方ともroutingを含む場合は、同名キーを2つ残すのではなく、ルールを1つずつ統合して順序を決めてください。重複キーが必ず構文エラーになるとは限りません。パーサーによっては前の値が上書きされ、ファイルは正しく見えても、実行時には後の設定しか残らないことがあります。
inboundsの待ち受け
バインドアドレスと接続エンドポイント
inboundは、アプリからカーネルに入る最初の接続です。listenでバインドするローカルアドレス、portでポート、protocolでクライアントが送る形式を指定します。この3つがすべて一致する必要があります。アプリが端末のLANアドレスをプロキシに指定しているのに、プロセスがループバックアドレスだけで待ち受けている場合、ポート番号が同じでも接続できません。プロトコルが異なると、ソケット接続後のプロキシハンドシェイクで切断されることがあります。
同じ端末内で使う場合は127.0.0.1に明示的にバインドし、アプリ側にも同じアドレスを指定します。localhostを指定したアプリがIPv6のループバックを先に試す一方、ここでの例がIPv4だけを待ち受ける場合があるため、両者を混在させた状態で原因を比較しないでください。ほかのアドレスで待ち受ける場合は、そのアドレスが端末に割り当てられているか、ポートをバインドできるか、誰がアクセスできるかを確認します。接続失敗の切り分けに、すべてのインターフェースでの待ち受けを安易に使わないでください。
複数のプロセスが同じアドレスとポートにバインドすると競合することがあります。クライアント内蔵のカーネルと手動起動したテストプロセスも例外ではありません。ポートが使用中の場合は、まず使用しているプロセスが正常動作中の古いインスタンスではないか確認してください。正体の分からないプロセスを先に終了しないでください。別のテストポートを使う場合は、アプリのプロキシ設定、カーネルの待ち受け、テストコマンドをすべて変更します。ポートを変更しても古いポートにリクエストを送り続けると、新しい設定が反映されたと誤解するおそれがあります。
SOCKSとHTTPのinboundを分ける
以下の断片は、基本設定のinbounds配列と置き換えて使えます。2つのリスナーは同じoutbound設定を共有しますが、ポートと受信プロトコルは異なります。HTTPプロキシを使うアプリには2つ目のアドレスとポートを、SOCKS5対応アプリには1つ目を指定します。inboundのtagは、送信元をroutingで照合するために使えます。アプリがシステムプロキシを受け付けるかどうかは、アプリ自体と実行環境によります。2つ目のリスナーを有効にしただけでは判断できません。
{
"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"
}
]
}
HTTPプロキシは、クライアントが送信するHTTPプロキシリクエストを処理します。トンネルに対応するクライアントはCONNECTリクエストも送信できますが、リスナーがあらゆる形式のデータを受信できるという意味ではありません。SOCKS向けのアプリはSOCKSハンドシェイクを送信するため、HTTPプロキシのポートをSOCKSポートとして使えません。まず1つのアプリにプロキシを明示的に設定し、その後でシステムプロキシ設定を確認すると、OS側の転送問題とリスナーの問題を切り分けられます。
SOCKS inboundのudpは、SOCKSのUDP転送を許可するかどうかを制御します。アプリが送信した通常のUDPデータグラムを、このポートに自動的に転送する設定ではありません。アプリ自身がSOCKSのUDPアソシエーションを実装し、その後のoutboundも実際のプロトコルに応じて処理する必要があります。ウェブサイトへのリクエストが成功しても、確認できるのは通常、テストしたTCP経路が使えることだけです。UDPを使う機能が失敗する場合は、入口、routing、outboundを個別に検証してください。同じ端末でウェブサイトを開けることだけで判断しないでください。
宛先の識別と通信の取り込み範囲
inboundが受け取る宛先はドメイン名の場合もIPアドレスの場合もあります。アプリが先に名前解決してからIPを送ると、routingは元のドメイン名としてそのIPを照合できません。一部のカーネルでは、inboundのsniffingで特定のプロトコルに含まれる宛先名を識別できますが、識別できるかは通信形式と実際に確認できる情報によります。有効にする前に、routingの条件を補う必要があるのか、接続先自体を置き換える必要があるのかを確認してください。両者は同じ動作ではありません。
宛先識別を、あらゆる振り分け問題を解決する万能スイッチとして扱わないでください。まずドメイン名を明示したプロキシリクエストで、ドメインルールが一致するか確認します。一致しない場合は、ルールの書式と順序を調べてください。ドメイン名を使ったリクエストは正常で、アプリの実際のリクエストだけがIPアドレスを送っている場合に、宛先識別やアプリのプロキシ設定を検討します。テストでは追加オプションを一度に1つだけ有効にし、routingへの入力と実際の接続先を同時に変えないでください。
システムプロキシ、アプリ内プロキシ、TUNはそれぞれ異なる入口です。システムプロキシは、関連設定を参照するアプリにプロキシアドレスを提供します。TUNは仮想ネットワークアダプターを通じて選択した通信を取り込み、システムルートや権限にも関係します。あるアプリの通信が通常のinboundに届かない場合は、outboundを何度も変更せず、まず入口の経路を確認してください。仮想ネットワークアダプターが有効な状態で通常のプロキシテストに問題がある場合は、TUNモードの説明でモードを確認し、入口を1種類だけ有効にして再テストします。
outboundsのプロトコル
デフォルトの出口と明示的な拒否
outboundは、リクエストの送信先と次の接続に使うプロトコルを定義します。freedomはリクエストの宛先に直接接続し、カーネルを実行している端末のネットワーク経路を使います。リモートノードではなく、システムのゲートウェイを変更するものでもありません。blackholeは、一致したリクエストを明示的に破棄するために使います。どちらもroutingの検証に利用できますが、宛先サービスへの実際の接続を試みるのは前者だけです。
以下の例では、基本設定のoutboundに拒否用の選択肢を追加しています。どのroutingルールからもdenyを参照していない場合、この項目だけで通信が遮断されることはありません。例ではdirectを先頭に置いているため、ルールに一致しないリクエストは直接接続します。denyを先頭に移すと、ルールに一致しない通信が拒否されます。これは一部の変更ではなく、デフォルトの経路を変える操作です。順序を変える前に、管理用通信や普段使うアプリが従来の経路に依存していないか確認してください。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{ "tag": "deny", "protocol": "blackhole" }
]
}
直接接続の意味は入口と合わせて考える必要があります。アプリがカーネルに接続し、その後outboundが宛先に接続する経路は、アプリがプロキシを完全に迂回する場合とは異なります。名前解決、アドレスファミリー、タイムアウトが違うこともあります。比較テストでは「カーネルを経由しない」と「カーネルを経由して直接接続する」の2つの結果を記録してください。後者だけが失敗する場合は、システムから同じURLを開けるかだけでなく、カーネルが受け取った宛先と実行環境を確認します。
リモートアドレス、プロキシプロトコル、転送方式
リモートプロキシには、少なくとも3つの要素があります。接続先のサーバーアドレスとポート、その接続上で使用するプロキシプロトコル、基盤となる転送方式とセキュリティ設定です。アドレスとポートはサーバーへの到達に使い、プロキシプロトコルのフィールドは認証などの意味を定め、転送フィールドは通信の運搬方式を選びます。ある段階が正常でも次の段階が正常とは限りません。サーバーのポートに接続できても、プロトコルや転送方式が一致しなければセッションを確立できないことがあります。
VLESSなどのoutboundを確認するときは、プロトコル固有のsettingsと共通のstreamSettingsを分けて確認します。ノードのアドレスはクライアントが最初に接続する宛先です。TLSを有効にした場合、ハンドシェイクで使う名前はその接続のセキュリティ検証に使用されます。アクセスするウェブサイトのドメイン名に機械的に置き換えないでください。プロキシプロトコル、転送方式、セキュリティ方式、サーバー側の対応フィールドを1つずつ照合し、別タイプのノードから転送設定全体をコピーしないでください。
共有設定を受け取ったら、リモート項目だけがインポートされたのか、実行設定全体がインポートされたのかを確認します。リモート項目が完全でも、リスナーとroutingはクライアント側で生成する必要があります。完全な設定ファイルには、ローカルポートやデフォルトのoutboundがすでに定義されている場合があります。最初のテストでは、動作確認済みのリモートを1つだけ有効にし、高度なrouting設定は変更しないでください。同じリクエストがそのoutboundを安定して通ることを確認してから複数outboundのルールに追加すると、ノードと選択ロジックのどちらに問題があるか切り分けられます。
リモート項目の認証情報やサブスクリプションURLは、管理用の情報です。クライアントからエクスポートした内容をそのまま公開の掲示板に貼り付けないでください。ハンドシェイクの失敗について相談するときは、カーネルの種類、プロキシプロトコル、転送方式、outboundタグ、識別情報を除いたログだけを共有できます。プロトコル間の違いを確認するには、まずVMessとVLESSのフィールドの違いを読み、あるプロトコルのオプションを別のプロトコルの同義語として扱わないでください。
タグの変更はフェイルオーバーではない
同じ設定内では、重複せず見分けやすいoutboundタグを使います。配列に新しいリモートを追加しても、自動的なプライマリー/バックアップ構成にはなりません。routingは選択したoutboundにだけリクエストを渡します。選択中のoutboundに接続できなくても、後ろに直接接続用の項目があるだけでは、カーネルは自動的にそちらへ切り替えません。フェイルオーバーが必要な場合は、実際に使用するカーネルが対応する負荷分散機能、候補、プローブ条件を確認してください。最後に項目を1つ追加するだけでは代わりになりません。
出口を置き換えたら、明示的に一致するリクエストと、どのルールにも一致しないリクエストを別々に再テストします。1つは新しいタグを指定したルールに一致するリクエスト、もう1つはどのルールにも一致しないリクエストにします。これにより、「先頭のoutboundを変えたが、古いルールは以前の出口を参照している」「ルールを変えた結果、意図せずデフォルトの出口まで変わった」といった問題を確認できます。出口を切り替えたら新しい接続でテストし、ブラウザーの接続プールに残った古いセッションが変更前の経路を使い続けないようにしてください。
routingルール
最初に一致したルールと条件の組み合わせ
routing.rulesは順序付きリストです。リクエストは上から順に利用可能なルールを探し、最初に一致したルールが指定するoutboundに渡されます。カーネルが候補をすべて集め、最も細かいルールを選ぶわけではありません。すべてのウェブリクエストをinboundタグだけで判定するルールを先頭に置くと、後続のドメイン例外が適用されないことがあります。優先したい条件を前に置き、どのルールにも一致しないリクエストを使ってデフォルトのoutboundを確認してください。
一般的なフィールドルールでは、同じルール内の異なる条件はすべて満たす必要があります。一方、1つのフィールドに複数の候補を指定した場合は、通常いずれかに一致すればよい設定です。inboundタグとドメイン名を同じルールに置くと、そのinboundからのリクエストで、宛先名も条件に合う場合に一致します。「どれかのinboundから、またはいずれかの指定ドメインへのリクエスト」を表すには、2つの独立したルールを書いてください。隣り合うルールをまとめると行数は減りますが、もともとOR条件だったものがAND条件になる場合があります。
以下の断片は、このページの2つのoutbound設定と組み合わせて使います。local-socksを経由し、指定した予約済みの例示用ドメインに向かうリクエストだけを拒否します。domain:はドメイン境界に沿って指定名とサブドメインに一致します。完全なホスト名だけに限定する場合はfull:に変更します。ドメインフィールドにはホスト名の条件を記入し、プロトコル、パス、クエリパラメーターを含むウェブページのURLを入れないでください。routingはブラウザーのアドレスバーの文字列全体を照合する仕組みではありません。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["domain:blocked.example"],
"outboundTag": "deny"
}
]
}
}
まず予約済みドメインを使って入力を確認し、ログでdenyに一致したか確かめられます。この例のドメインは通常のアクセス先として使うものではないため、接続に失敗しただけでは拒否ルールの動作を証明できません。比較テストでは同じドメインに2回リクエストし、一方はSOCKS inbound、もう一方は設定済みのHTTP inboundを使います。前者は拒否outboundを選び、後者はデフォルトの直接接続を選ぶはずです。どちらもウェブページの応答がなくても、選ばれる出口は異なるはずです。
ドメインポリシーとルールリソース
AsIsは現在の宛先をそのまま照合し、ドメイン名をIPアドレスに変換するための問い合わせを自発的には行いません。IPIfNonMatchは、ドメイン名の初回照合で一致しなかった場合に名前解決を行い、適用可能なIPルールも試します。それより前にドメインルールや広範なルールに一致すると、この追加の判定が行われないことがあります。IPOnDemandは照合中に必要になった時点で名前解決を行えます。これらが変えるのは照合時にアドレスが必要になるタイミングであり、システム全体の名前解決ポリシーではありません。
geosite:はカテゴリ別のドメイン項目を、geoip:はカテゴリ別のアドレス項目を参照します。利用できるカテゴリとその場所は、実行環境のリソースファイルによって異なります。カテゴリ名は、カーネルに固定で組み込まれた文字列一覧ではありません。起動ログにリソースや項目が見つからないと表示された場合は、まずカーネルがどのデータを読み込んでいるか確認し、確実に指定できるドメイン名やネットワーク範囲を使って比較します。データが見つからない状態でルールを広げないでください。リソースの読み込み問題が、気付きにくい誤照合に変わるおそれがあります。
アドレスに関するルールでは、まず宛先の種類を確認します。クライアントがIPアドレスを送っている場合、ドメインカテゴリのルールには照合対象がありません。ドメイン名を送っている場合、AsIsではroutingが自動的に名前解決してアドレスカテゴリと照合するとは限りません。組み込みリゾルバーが複数のアドレスを取得すると、アドレスファミリーの違いも関係することがあります。テストでは入力がドメイン名、IPv4、IPv6のどれかを記録し、一度に変更する入力条件は1つだけにしてください。
一致する経路と一致しない経路を確認
ルール一覧を管理するときは、重要なルールごとに「一致するはずのリクエスト」と「条件が1つだけ異なるリクエスト」を記録してください。誤照合を調べる場合は、宛先、送信元inbound、実際のoutboundを確認してから、一覧の中で先に一致した可能性のあるルールを探します。一時的にルールを前へ移動して比較できますが、正式に順序を変えるときは他の例外も再確認してください。特に、狭い条件によって保護されていたリクエストに注意します。1つのルールを動かしただけで、複数の通信経路が同時に変わることがあります。
routingは、選択したoutboundの接続問題を自動的に解決しません。ログが想定どおりのoutboundを示しているのにリクエストが失敗する場合は、routingではなく、そのoutboundの名前解決、接続、ハンドシェイクを確認してください。選択されたタグが想定と違う場合に限り、照合条件の変更を検討します。クライアント画面のグローバルプロキシやルールモードは別の層の選択です。まずプロキシモードの操作ガイドを参考に、確認中のルールセットが現在のモードで読み込まれていることを確認してください。
dns名前解決
名前解決が行われる場所
同じドメイン名でも、アプリ、カーネルを実行している端末、リモート出口のいずれかで名前解決される可能性があります。アプリが先にアドレスを調べると、inboundにはIPアドレスしか届かないことがあります。アプリがホスト名をカーネルに渡せば、routingで先にドメイン名を照合できます。outboundが宛先名をリモートに渡す場合、最終的な接続先の名前解決はリモート側で行われることもあります。結果が異なる場合は、どのリゾルバーが誤った回答をしたかをすぐに疑うのではなく、どの接続段階でどの名前を問い合わせているかを特定してください。
リモートノードのアドレスとアクセス先サイトのアドレスは、別々に名前解決する対象です。カーネルは接続を開始する前にリモートのアドレスを解決する必要があります。リモートへの接続が確立した後、宛先名はリモート側で処理される場合があります。ログにノード名の名前解決失敗が表示されている場合、アクセス先サイトのカテゴリルールを変更しても、ノードへの接続は直りません。反対に、リモートへの接続成功で確認できるのはノードのアドレスに到達できることだけです。指定した宛先を名前解決して接続できることまでは証明できません。
このセクションのdnsはカーネル独自の設定です。システムのリゾルバーを置き換えるものでも、ブラウザー、ほかのアプリ、仮想ネットワークアダプター上のすべてのDNSクエリを自動的に捕捉するものでもありません。アプリが独自の名前解決機能を使う場合、システム設定もカーネル設定も最初の問い合わせに関与しないことがあります。比較するときは入口、宛先、出口を変えず、名前解決を行う場所だけを変更してください。DNSとroutingの変更を混同せずに済みます。
静的マッピング、システムリゾルバー、問い合わせの発生条件
以下の例では、組み込みの名前解決処理にテスト用ホストの静的マッピングを登録し、それ以外の名前の問い合わせ先にlocalhostを指定します。これは実行環境のローカルなシステム名前解決機能を利用します。例のアドレスはドキュメント用に予約された範囲で、サービスを提供するテストサーバーではありません。ドメイン名がどのアドレスに変換されるかの確認に使い、ウェブページが開くかどうかの検証には使わないでください。確認後はテスト用の項目を削除し、日常使う設定に残さないでください。
{
"dns": {
"hosts": {
"reference.test": "192.0.2.10"
},
"servers": ["localhost"]
}
}
上の設定を追加しただけで、reference.testへのリクエストすべてが必ず組み込みの名前解決を使うとは限りません。routingが名前解決の結果を使うか確認するには、独立したテスト用ファイルでIPIfNonMatchを使い、先に一致する広範なルールがないことを確認してから、192.0.2.10/32に一致してdenyに渡すアドレスルールを追加します。予約済みドメイン名を使い、プロキシがホスト名を受け取るリクエストを送信して、ログでアドレスルールが一致したか確認します。このテストで確認するのはroutingの判断であり、例示用アドレスへの実際の接続は不要です。
routingがIP条件の照合のために名前解決しても、outboundが同じアドレスに接続するとは限りません。outboundがドメイン名を保持する場合もあれば、独自のアドレス選択方針で再度名前解決する場合もあります。名前解決結果の違いを調べるときは、「routingが一致した理由」と「実際にどこへ接続したか」を分けて記録してください。2つの段階で異なるアドレスが使われた場合は、各段階の入力とリゾルバーを確認します。条件一覧のIPアドレスを最終的な接続先とみなさないでください。
アドレスファミリー、キャッシュ、名前解決の依存関係
アドレスが返ってきても接続に失敗する場合は、応答がIPv4、IPv6、またはその両方を含むか確認し、それぞれのネットワークに到達できるか調べます。利用可能なIPv6経路がないことと、IPv6レコードが返されないことは別の問題です。アドレスファミリーを比較するときは、同じ宛先と同じoutboundを使ってください。別のサイトで成功しても、元のサイトに問題がある証明にはなりません。特定のアドレスファミリーに制限する前に、それが照合、問い合わせ、接続のどの段階に影響するか確認します。
名前解決設定を変更しても、アプリ、システム、カーネルがそれぞれ結果を保持している場合があり、既存の接続で古いアドレスが再利用されることもあります。再テストではまず新しい接続を確立し、必要に応じて該当コンポーネントのキャッシュを処理してください。すべてのコンポーネントを同時に更新し、複数のポリシーまで一緒に変更しないでください。ドメイン名を使うカスタムリゾルバーでは、初期アドレスをどう取得するか、まだ接続できないリモートoutboundに問い合わせが依存していないかも確認します。依存関係が循環している場合、問い合わせの待ち時間を延ばしても起動条件の不足は解決しません。
エラーは、レコードなし、応答拒否、問い合わせタイムアウト、名前解決後の接続タイムアウトを区別してください。前の3つでは問い合わせ先とリゾルバーに到達できるかを確認し、最後のケースでは実際の接続経路を調べます。端末のシステム問い合わせは比較材料になりますが、カーネルのアクセスログの代わりにはなりません。どの段階では宛先名だけが見えていて、どの段階でアドレスが確認できたかを記録すると、問題の箇所を絞り込みやすくなります。
policyセッションポリシー
ユーザーレベルと適用範囲
policy.levelsは、ユーザーレベルごとにセッションパラメーターを設定します。オブジェクトのキーは"0"のように文字列で記述しますが、プロトコル上で参照するレベル値は通常整数です。セッションに別のレベルが指定されていない場合は通常レベル0が使われますが、実際のプロトコルとカーネルの実装によります。レベルはパラメーターのインデックスであり、数値が大きいほど権限や優先度が高くなったり、速度が上がったりするわけではありません。複数のレベルを設定する前に、プロトコル内のどのオブジェクトがその値を読み取るか確認してください。
routingの役割は出口を選ぶこと、セッションポリシーの役割は、対象のセッションが特定の段階でどのように待機するかを制御することです。inboundTagとユーザーレベルは別の仕組みです。前者はリスナーを識別してルール照合に使い、後者はセッションパラメーターを選びます。inboundごとに異なるタイムアウトを設定する場合は、inboundプロトコルが対応するセッションレベルを指定できるか確認してください。inboundタグを変えたり、routingでレベル名を参照したりするだけでは、この関連付けはできません。
{
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 180,
"uplinkOnly": 5,
"downlinkOnly": 10
}
}
}
}
ここに示す値は秒単位の設定例であり、デフォルト値や一般的な推奨値ではありません。handshakeは対象inboundのプロトコルハンドシェイク段階に適用され、アクセス全体の制限時間ではありません。アプリがリスナーに接続できていない場合、値を変えてもポートに到達できない問題は解決しません。リモートからのセキュアなハンドシェイクエラーも、すぐにこの設定の問題と判断しないでください。ログに示されているのがinboundプロトコルのハンドシェイク、リモートへの接続、リモートのハンドシェイクのどれかを確認してから、見るべきパラメーターを決めます。
アイドル状態と片方向通信の終了
connIdleは接続のアイドル待機時間です。通信が続いているのに総所要時間が長い場合と、長時間通信がない場合は別の状況です。断続的にデータを送るアプリは、一定時間何も送信しないことがあります。長時間接続がほぼ同じアイドル時間で切断される場合は、出口とアプリを固定し、最後に正常なデータが送られてから切断されるまでの時間を記録して、1つのパラメーターだけを変更して再テストします。短時間の接続失敗を、すべてアイドル制限のせいにしないでください。
uplinkOnlyとdownlinkOnlyは、セッションで一方向の転送だけが残った後の待機時間に関係します。アップロードやダウンロードの速度制限ではありません。下りが終わり上りだけが残る場合は前者、上りが終わり下りだけが残る場合は後者を確認します。リクエスト送信後に上り通信が止まっても、残りの応答を待つ必要があるアプリがあります。終了までの時間が短すぎると、通常の短いウェブテストでは分からない問題が発生することがあります。同じリクエスト内容と同じ応答になる条件で再現してください。
接続の終了はアプリ、サーバー、経路上の機器が原因の場合もあります。カーネルのアイドル値を変えても切断時刻が変わらない場合は、待ち時間をさらに延ばし続けず、ほかの関係要素を確認してください。ハンドシェイク失敗、アイドル後の切断、片方向通信終了後の切断を分けて記録します。変更前後を比較できるよう、宛先、転送方式、出口、アプリのバージョン、入口モードはできるだけ同じにしてください。
統計の有効化と確認方法
統計とタイムアウトは同じポリシー領域にありますが、互いに独立しています。通常はトップレベルのstatsモジュールを有効にしてから、該当するポリシーで必要なカウンターを有効にします。たとえばpolicy.system.statsInboundUplinkでinboundの上り統計を有効にできます。ユーザーごとのカウントには、ユーザーレベルの設定と、プロトコルがユーザー識別情報を提供できるかどうかも関係します。名前の似たオプションを設定しても、クライアントのあらゆる画面に統計が表示されるとは限りません。
カウンターを読み取るには、統計に対応するコンポーネントが必要です。自動的に利用レポートが作られるわけではなく、遅延や到達性のテストでもありません。クライアントに統計画面がすでにある場合は、まず既存の機能で対象のカウントを確認してください。ログを見るだけなら、管理用の待ち受けを別途開く必要はありません。カウントがゼロの場合は、モジュールが有効か、対象に必要なタグや識別情報があるか、現在のプロセスの値を見ているか、テストリクエストが実際にその対象を通ったかの順に確認します。
ポリシーの値を調整する前に、変更していない基準設定と再実行できるリクエストを保存してください。比較時は開始時刻、最後の通信、接続が終了した理由を記録し、ウェブページが開いたかどうかだけで判断しないでください。クライアントが設定ファイルを再生成した後、変更内容が実際に読み込まれた設定に反映されていることも確認します。実行中のファイルにポリシーがなければ、テスト結果から値の有効性は判断できません。同じ変化を安定して観察できた場合にだけ、設定を確定してください。
設定の検証と段階的なトラブル対処
ファイル確認からプロキシリクエストまで
検証は3段階です。ファイルを解析できること、プロセスが正常に起動すること、実際のリクエストが想定した経路を通ることです。どれか1段階を確認しても、次の段階の確認にはなりません。ファイルを比較するときは、まず起動コマンドが指しているパスを確認します。画面から再起動した場合も、現在の設定元と稼働中のカーネルを確認してください。テスト用ディレクトリとクライアントの作業ディレクトリがある環境では、どちらもファイル名がconfig.jsonというだけでは、実際に起動中のファイルだとは証明できません。
カーネルを手動で実行する場合は、カーネルの種類に応じて以下の設定チェックコマンドを使います。設定ファイルのあるディレクトリで実行するか、ファイルの引数を実際のパスに変更してください。起動ツールが異なるコマンドライン引数を使う場合は、使用中のカーネルのヘルプを確認します。設定チェックが成功しても、カーネルが設定を受け付けたことしか分かりません。実際に待ち受けを開始できることや、起動後にリモートへ接続できることは保証されません。チェック後にプロセスを起動し、起動ログを確認してください。
xray run -test -config config.json
v2ray test -c config.json
まず「JSON構造の概要」にある最小設定を起動し、SOCKS5に対応したアプリから明示的なプロキシリクエストを1回送信します。以下のコマンドは、curlがインストールされた環境で使えます。socks5hを指定すると、宛先のドメイン名をプロキシリクエストに含めて送信します。組み込みDNSで名前解決されるとは限りませんが、テストツールが送信前にドメイン名をIPアドレスへ変換していないことを確認できます。外部の接続先に到達できない場合は、アクセスする権限があり、直接接続できることが分かっているテストサイトに変更してください。
curl --verbose --max-time 12 --noproxy "" --proxy socks5h://127.0.0.1:10808 https://example.com/
最初からシステムプロキシや仮想ネットワークアダプターを同時に有効にする必要はありません。プロキシを明示したリクエストなら、アプリがシステム設定に従うかどうかの問題を切り分けられます。まず直接接続outboundで一往復を確認し、拒否outboundとroutingルールを追加してタグの変化を確認します。動作確認済みのリモートを使うのは最後です。基本の経路ですでに失敗している場合、ルールリソース、名前解決ポリシー、複数ノードを追加すると、調べる範囲が広がるだけです。
最初に失敗した箇所から特定
| 症状 | 最初に確認すること | 比較テスト |
|---|---|---|
| 設定チェックでエラー | JSON構造、フィールド値、ルールリソース | 最初に出たエラーから確認します。起動できる基準設定に戻してから、設定を一つずつ追加してください。 |
| inboundへの接続に失敗 | 実行中のインスタンス、バインドアドレス、ポート | リスナーを一つだけ残し、アプリにプロキシを明示してテストします。 |
| 選択された出口が想定と違う | リクエストの宛先、inboundタグ、ルール順 | 一致するはずの新しいリクエストと、一致しないはずの新しいリクエストをそれぞれ送信します。 |
| 出口は正しいが接続に失敗 | 名前解決、接続、転送、ハンドシェイク | 同じinboundから直接接続と指定したリモートを比較し、失敗した段階を確認します。 |
| しばらく使うと切断される | 最後の通信時刻と終了した通信方向 | アプリと接続経路を固定し、アイドル時と片方向通信の終了時を分けて確認します。 |
ログは1回のリクエストに関係する時間帯を絞り、連続した記録を優先して収集します。起動時の警告はリクエストの失敗と関係ないことがあり、その後の再試行が最初の重要な情報を覆い隠す場合もあります。まず今回のリクエストに関係する最初の失敗を探し、その前にinboundとoutboundが確認されているかを調べてください。必要な段階を確認できるまで一時的にログレベルを上げ、確認後は元に戻します。アクセス先や実行情報が必要以上に長期間記録されるのを防げます。
画面に「実行中」と表示されても、クライアントが起動処理を開始したと認識しているだけで、アプリが正しいinboundに接続したとは限りません。テストリクエストがログに出てこない場合は、まずアプリに指定したプロトコルとアドレスを確認し、システムのデフォルト経路だけを通っていないか調べます。リクエストはログに出ているのに想定したoutboundが選ばれない場合は、現在読み込まれている設定と照合順序を確認してください。リモートのハンドシェイクエラーがログに出ている場合は、設定したoutboundがサーバーと一致しているか確認します。routing全体をすぐに置き換えないでください。
最小構成で再現し、段階的に戻す
設定を戻すときは、最後に動作確認できたファイルに復元し、対応するインスタンスを再起動します。同じプロキシポートと宛先を使って、新しいリクエストを送信してください。基準設定が動作することを確認したら、変更を一つずつ追加し、各段階で想定したタグと実際の結果を記録します。基準設定も動かなくなった場合は、環境の変化を優先して確認してください。プロセスが動いているか、別のアプリがポートを使っていないか、システムルートが変わっていないか、元の宛先にまだ到達できるかを調べます。この段階では、未検証の変更をさらに積み重ねないでください。
問い合わせる際は、OS、クライアント名とカーネル名、失敗した段階、最小化した設定ファイル、同じリクエストに関係するログを共有してください。サブスクリプションURL、認証情報、内部ドメイン、無関係な接続記録は削除し、エラーの種類とフィールド間の参照関係を残します。エラーメッセージから調査箇所を探す場合は実行ログを使った原因の特定方法を参照してください。サブスクリプションのインポートやシステムプロキシの切り替えで起きた問題は、よくある質問も確認し、まずクライアント側を調べてからカーネルのフィールドを確認します。