設定ファイルリファレンス
V2Ray JSON設定ガイド
初回インストール、サブスクリプションの追加、接続確認を行う場合は、まず入門ガイドの手順に沿って進めてください。接続できていて、項目の意味を調べたり、通信経路を確認したり、ルールを変更したりする場合は、このガイドを参照します。例ではローカルループバックのinboundと通常の直接接続を基準にしています。用語を確認したい場合は用語クイックリファレンスもご覧ください。
JSON構造の概要
接続の流れに沿って設定を読む
アプリがローカルの待ち受けポートにリクエストを送ると、inboundがプロトコルに応じて宛先を読み取ります。続いてroutingが、取得できた宛先情報やinboundタグなどの条件をもとにoutboundを選択します。outboundは実際の接続を確立し、直接接続する場合もあれば、ノードの設定に従ってリモート側と通信する場合もあります。各項目の影響を判断するときは、まず接続経路のどの段階に属するかを確認しましょう。待ち受けアドレスを変更してもノードは変わりません。また、outboundの接続先を変更しても、もともとプロキシを使っていないアプリがinboundを通るようにはなりません。
トップレベルはオブジェクトであり、inbound、outbound、ルールを1つのリストに並べる構造ではありません。inboundsとoutboundsは複数の入口・出口を格納する配列です。一方、routing、dns、policyはそれぞれ内部構造を持つオブジェクトです。キー名は大文字と小文字を区別し、配列の順序が動作に影響することもあります。特に、outbound配列の先頭項目とroutingルール配列の先頭ルールは役割が異なります。前者はデフォルトの出口となり、後者は最初にマッチ判定されるルールです。
動作確認用の直接接続構成を作る
以下は単独で動作するネイティブ設定ファイルです。ローカルのループバックアドレスでSOCKS inboundを待ち受け、受け取った通信を直接接続するoutboundへ渡します。サブスクリプション、リモートアカウント、地域別ルールのデータは使いません。「アプリからリクエストがコアに届くか」を確認するための構成です。使用前にポートがほかのインスタンスに使われていないことを確認してください。ローカル環境からテスト先へ接続できない場合、直接接続の基準構成でも状況は変わりません。現在のネットワークから到達できることが分かっている宛先を選んでください。
{
"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": {} }
]
}
この構成ではoutboundが1つだけなので、どのルールにもマッチしないリクエストの行き先は明確です。そのためroutingは追加していません。また、初回テストでシステムの名前解決、コアのDNS、タイムアウトの影響が混ざらないよう、内蔵DNSや接続ポリシーも設定していません。起動後は、SOCKSに対応したアプリで例のアドレスを指定してテストしてください。トレイアイコンや画面表示だけでは確認できません。Webページを開く前に、ローカルでのみ提供され、現在のユーザーにアクセスが許可されているサービスへ接続し、ローカル経路を確かめる方法もあります。
設定例を正しい階層に追加する
以降にトップレベルの断片として示すコードは有効なJSONですが、単独で起動できるとは限りません。トップレベルに新しい項目を追加する場合は、対応するキーと値を基準構成と同じオブジェクトに追加します。既存項目を変更する場合は値を置き換えるか、配列にオブジェクトを追加してください。外側の波括弧を含むファイルを2つそのまま連結したり、同じオブジェクト内に同じキーを重複して記述したりしないでください。重複キーの扱いはパーサーによって異なり、読み込みに成功しても後に記述した値だけが採用される場合があります。
| トップレベル項目 | 構造 | 変更後にまず確認する項目 |
|---|---|---|
inbounds | オブジェクトの配列 | アプリで指定したプロトコル、アドレス、ポートが完全に一致しているか。 |
outbounds | オブジェクトの配列 | デフォルトoutboundの位置と、ルールから参照するタグが正しいか。 |
routing | オブジェクト | ルールが意図した順番で評価され、宛先が想定した最初のルールにマッチするか。 |
dns | オブジェクト | 名前解決を行うのがアプリ、ルーティング判定、outboundの接続処理のどこか。 |
policy | オブジェクト | テストする接続に適用されているレベルが、変更した項目に対応しているか。 |
基準構成と編集中のコピーを別々に保存し、同じリクエストで変更前後を比較しましょう。標準JSONではキーと文字列に二重引用符を使い、最後の項目にカンマを付けず、真偽値は文字列ではなく小文字のリテラルで記述します。構文チェックで分かるのはファイルを解析できるかどうかだけです。現在のコアがその項目をサポートしているか、参照先のタグが存在するかまでは確認できません。構文を確認したら、起動結果、次に個別接続の動作を確認してください。この3段階を分けておくと、問題の層を特定しやすくなります。
このガイドの最小構成は単独で実行するものです。クライアントが同じポートを使用中の場合は、古いインスタンスを停止するか、空いているポートに変更してください。プロセス間のポート競合を設定構文のエラーと混同しないようにしましょう。
inbounds(受信設定)
待ち受けアドレスとアプリのプロトコルをセットで確認する
各inboundで確認するのは、接続を受け付けるアドレス、待ち受けポート、データを読み取るプロトコルの3点です。listenはバインドするアドレスであり、クライアントが接続するWebサイトの宛先ではありません。portはローカルの入口で、リモートノードのポートではありません。protocolによって、アプリ側で選ぶプロキシの種類が決まります。HTTPプロキシのリクエストをSOCKSポートに送ったり、SOCKSリクエストを通常のHTTPサービスに送ったりすると、「ポートには接続できるが、リクエストは失敗する」ことがあります。
ローカルアプリで使う場合は、まず127.0.0.1を指定してください。待ち受けはローカルに限定されますが、同じ端末上のほかのプロセスからもアクセスできます。認証のない設定例を全インターフェースで待ち受けるように変更して、接続失敗を解決しようとしないでください。アプリとコアの両方でIPv4ループバックを使う場合は同じアドレスを指定しましょう。localhostがIPv6ループバックに優先解決され、コアがIPv4だけで待ち受けると接続できないことがあります。コンテナや仮想マシンのループバックはそれぞれのネットワーク環境に属するため、ホストのアドレスの代わりにはなりません。
SOCKSとHTTPを別々のinboundで使う
以下のトップレベル部分を、基準ファイルの既存のinboundsと置き換えます。SOCKSプロキシとHTTPプロキシを別のポートに設定し、それぞれに固有のタグを付けています。ブラウザーがどちらに対応しているか、ターミナルツールでどのオプションを使うかは、各ツールのプロキシ設定を確認してください。HTTP inboundはHTTPプロキシに対応したアプリからのリクエストを受け付け、CONNECTによる転送にも対応します。任意のブラウザーリクエストを受け取るWebサイトのサービスではありません。
{
"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": {}
}
]
}
タグは設定内でinboundを識別するためのものです。アプリで指定するのは種類、アドレス、ポートであり、タグがコアに送信されることはありません。routingではinboundTagを使ってこの識別子を参照できます。そのため、アプリAはSOCKS、アプリBはHTTPを固定で使う場合、それぞれ異なるinboundで経路を分けられます。両方のアプリが同じ入口を使うと、タグで区別することはできません。タグを変更したら、参照している箇所もすべて検索してください。inbound側だけを変更すると、古いルールがマッチしなくなることがあります。
UDPと宛先の識別は別の設定
この例ではSOCKSのUDP対応を無効にしています。基準構成では通常のWeb接続だけを確認するためです。SOCKS UDPに対応したアプリを検証する場合は、アプリが実際にUDP転送を行うこと、該当するSOCKS inboundでUDPが許可されていること、後続のoutboundがその通信を転送できることを確認してください。inboundの設定だけを有効にしても、残りの段階は補えません。TCPを使うことが明確なリクエストをテストする場合、UDP設定を変更しても診断には役立ちません。まず接続の種類を確認し、必要に応じてテストを追加しましょう。
アプリはドメイン名をそのままSOCKSに渡す場合もあれば、ローカルで先に名前解決し、IPアドレスだけをコアに渡す場合もあります。後者では、ドメイン名を条件にしたルーティングで元の名前を参照できないことがあります。一部のinboundは、対応する上位レイヤーの通信からsniffingで宛先情報を識別できますが、結果はプロトコル、取得可能なデータ、使用中のコアの実装によって異なります。明確なアプリ側のプロキシ設定の代わりにはなりません。トラブル対処では、まず追加の識別機能を無効にし、ドメイン名をプロキシに渡す場合とIPアドレスを渡す場合を比較してから、必要性を判断してください。
ローカルで待ち受けられない場合は、アドレスをバインドできないのか、ポートが使用中なのかを切り分けます。前者は指定したアドレスをこの端末で使えるか確認し、後者は使用中のプロセスを調べてから、古いインスタンスを停止するかポートを変更してください。ポートを変更したら、ブラウザー、ターミナル、システムプロキシなど、この入口を指す設定もすべて更新します。新しいインスタンスが正常でも、アプリが古いポートに接続していることがあります。ローカルポートの競合を調べる方法を参考にし、待ち受け中のプロセスを見つけただけで終了しないでください。
outbounds(送信設定)
先頭項目はデフォルトoutbound、タグは参照用の名前
outboundは、コアが宛先を受け取ったあとに接続をどう処理するかを定義します。freedomは宛先への直接接続に使い、blackholeはそのoutboundに送られた通信を破棄します。どちらもリモートアカウントを必要とせず、ルールの動作を比較する際に便利です。タグは用途に合わせて名前を付けられますが、directという名前を付けても自動的に直接接続になるわけではありません。実際の動作はprotocolなどの項目で決まります。ルールが参照するのはタグであり、プロトコル名やサブスクリプションに表示されるノード名ではありません。
どのルールにもマッチしない接続は、outbound配列の先頭項目に渡されます。したがって、「オブジェクトを追加する」ことと「オブジェクトを先頭に移動する」ことは別の操作です。先頭が直接接続の状態で、通信を破棄するoutboundを先頭に移動すると、どのルールにも処理されない通常のリクエストも破棄されます。反対に、リモートノードを使う想定の通信がルールに漏れても、先頭が直接接続ならそのまま直接接続されます。まずデフォルトの動作を決めてからoutboundの順序を調整し、画面上のノード表示順だけで決めないようにしてください。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} },
{ "tag": "blocked", "protocol": "blackhole", "settings": {} }
]
}
上記の部分で基準ファイルのoutboundsを置き換えても、ルールを追加するまではリクエストが自動的にblockedへ送られることはありません。この部分は次の章のrouting設定と組み合わせて使います。予備のoutboundには別のタグを付け、先頭項目はそのままにしておくと、通常のリクエスト全体に影響を与えずにルールの対象を絞れます。基準構成に戻すときは、削除予定のタグをルールが参照していないことを確認してから、予備の項目を削除してください。
プロトコル、トランスポート、セキュリティを個別に確認する
リモートノードを使う場合、outboundのプロトコル、ノードのアドレスとポート、認証情報、下位のトランスポート方式、セキュリティ設定をサーバー側と一致させる必要があります。プロトコル項目はセッションの構成方法を定義します。settingsには、そのプロトコルで必要となる宛先や認証情報を設定します。一般的なstreamSettingsには、リモートとの接続に使うトランスポートやセキュリティのパラメーターを指定します。プロキシリクエストが最終的にアクセスするWebサイトと、outboundが接続するリモートノードは別の宛先であり、それぞれで名前解決が発生する場合があります。
トラブル対処のために、すぐに設定全体を書き直す必要はありません。まず現在のノードのホスト名とポートを照合し、次にトランスポートの種類と関連項目、最後にセキュリティのネゴシエーションがサーバー側と一致しているか確認します。TCP接続が確立した後にネゴシエーションで失敗する場合、ローカルの待ち受けポートだけを変更しても通常は解決しません。ホスト名、証明書、時刻の問題を隠すためにセキュリティ検証を無効にしないでください。セキュリティ要件を維持したまま、ノード提供元の接続パラメーターと一致しているか確認しましょう。
クライアントのリストにあるサブスクリプションURL、表示名、ネイティブoutboundは、それぞれ異なる種類の情報です。サブスクリプションはノード項目を提供し、クライアントは選択したノードとコアに合わせて動作用のoutboundを生成します。リモートノードのアドレス欄にサブスクリプションURLを入力しても同じ結果にはなりません。また、画面上のメモをルールのoutboundTagにコピーしても、有効とは限りません。生成結果を確認するには、以前にエクスポートした例ではなく、現在のインスタンスが実際に読み込んだ設定を確認してください。サブスクリプション内のノードを比較する際はノード選びのポイントも参考になります。
比較用のリクエストで問題の範囲を絞る
同じテスト先に対し、通常の直接接続outboundと、検証したいリモートoutboundから新しいリクエストをそれぞれ送ります。直接接続は成功し、リモート接続が失敗する場合、今回のテストではアプリのプロキシ設定、待ち受け、直接接続経路が機能しています。次にリモートのパラメーターとハンドシェイク段階を確認しましょう。両方のoutboundで失敗する場合は、共通する入口、宛先への到達性、名前解決に戻って確認します。切り替え後は新しい接続を確立してください。ブラウザーが以前のセッションを再利用すると、古い経路が使われ、新しい設定の結果と誤認することがあります。
routing(ルーティングルール)
最初にマッチしたルールを適用し、該当なしならデフォルトoutboundへ
routing.rulesは先頭から順に判定され、ルールが1つマッチすると、同じリクエストに対して後続のルールでoutboundを再選択することはありません。1つのルールにドメイン条件とinbound条件を両方指定した場合、両方を満たしたときにマッチします。同じドメイン条件の配列に複数の候補を記述した場合は、通常はいずれか1つにマッチすれば条件を満たします。「特定のinboundから来た指定ドメイン」を表す場合は1つのルールにまとめ、「いずれかのinbound条件、または別の宛先条件」を表す場合は、通常ルールを分けます。
範囲の狭い例外ルールを、広い範囲のルールより先に置きます。たとえば、「ローカルSOCKSからの特定の完全一致ドメイン」を先に判定し、その後に「ローカルSOCKSからのすべてのリクエスト」を判定します。後者を先に置くと、前者がマッチする機会はありません。どのルールにもマッチしない場合、リストの最後のルールのoutboundが自動的に使われるわけではなく、outbound配列の先頭項目が使われます。そのため、ルールの一覧だけでなく、outboundの順序も確認してください。特にクライアントが生成した設定から一部のルールを抜き出す場合は注意が必要です。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.com"],
"outboundTag": "blocked"
},
{
"type": "field",
"inboundTag": ["local-socks"],
"outboundTag": "direct"
}
]
}
}
この部分を基準構成に追加し、前の章のblockedを含むoutbound配列と組み合わせると、2つのドメインを使って動作を比較できます。SOCKS経由でドメイン名をプロキシに渡すと、完全一致のexample.comは最初のルールにマッチし、それ以外のドメインは次のルールで判定されます。ローカルHTTP inboundからのリクエストは2つのルールのinbound条件を満たさないため、デフォルトoutboundが使われます。アプリが宛先を先に名前解決していると、最初のルールがマッチしない場合があります。その際はルールの順序を疑う前に、宛先の渡し方を確認してください。
ドメイン条件とアドレス条件をそれぞれ検証する
full:はドメイン名の完全一致を示します。ドメインとそのサブドメインを対象にする場合はdomain:形式を使います。プレフィックスのない通常の文字列は部分一致となるため、短すぎる文字列を指定すると関係のない名前まで含まれる可能性があります。同じ宛先条件をドメイン名またはIPアドレスで記述できますが、判定対象となる入力形式は異なります。複数のサイトが同じIPアドレスを共有している場合、IPルールではドメインごとに区別できないことがあります。アプリがすでに名前解決したアドレスを渡している場合、ドメインルールから元の名前を自動的に復元することもできません。
domainStrategyは、IPルールの判定にどのような場合に名前解決の結果を使うかを制御します。outboundが接続するときの名前解決方法を設定するものではありません。AsIsでは、ルーティング判定のためにドメイン名をIPアドレスへ積極的に変換しません。IPIfNonMatchでは、元の情報でマッチしない場合にドメイン名を解決して再判定します。IPOnDemandでは、IPアドレスを必要とするルールの判定時にドメイン名を解決できます。前の広範なルールが先にマッチすると後続ルールは判定されないため、DNSサーバーを追加してもこの動作は変わりません。
新しいルールにはマッチする例とマッチしない例を用意する
ルールを追加する際は、マッチするはずのリクエスト、名前が似ていてもマッチしないはずのリクエスト、関連のない宛先をそれぞれ用意します。inboundタグ、コアに渡す宛先の形式、実際に選ばれたoutboundを記録してください。geoip:やgeosite:を使う場合は、コアが対応データを読み込めることと、対象カテゴリが実際に存在することを確認します。ルールの記述が正しくても、必要なデータが端末にインストールされているとは限りません。マッチ順を手早く確認する場合は、データファイルに依存しない完全一致のドメイン名や明示的なアドレス範囲を使いましょう。
最後に、「通信がコアに入ったか」と「入った後にどう振り分けられたか」を区別してください。システムプロキシは、一部のアプリがリクエストをローカルの入口に渡す方法の1つです。routingルールが適用されるのは、すでにコアに入ったリクエストだけです。振り分けを変更しても、プロキシを使っていないターミナルの接続が自動的に取り込まれるわけではなく、システムプロキシの設定を代替するものでもありません。画面上のグローバル設定とルーティング設定を比較する場合は、まずシステムプロキシとルーティングモードの解説を確認し、実際に生成されたルールと照合してください。
DNS設定
まず名前解決を行う場所を確認する
トップレベルのdns設定はコアの名前解決機能を設定するもので、システム上のすべてのDNS問い合わせを置き換えるものではありません。アプリが接続前にシステムのリゾルバーを使う場合や、アプリ独自のDNSサービスを使う場合があります。アプリがIPアドレスだけをSOCKS inboundに渡す場合、コアがその宛先のドメイン名を解決する必要はありません。一方、ドメイン名がそのままinboundに渡されると、routingがアドレス条件を判定するために内蔵DNSを使い、outboundも接続先の名前を解決する場合があります。どの段階で名前解決が行われるかを確認してから、変更する層を決めてください。
以下の設定例では、端末のシステムリゾルバーをコアのDNSサーバーとして指定し、hostsに2つのテスト用予約ドメインを固定マッピングします。基準構成に追加しても、関連する名前解決時にコアがどのように問い合わせるかを定義するだけで、ローカルDNSポートで待ち受けるようにはなりません。テスト用アドレスには文書用の予約範囲を使っています。目的はマッチ処理の確認であり、実際にWebページを提供することではありません。アクセスに失敗したかどうかだけで、マッピングの成否を判断しないでください。
{
"dns": {
"hosts": {
"test.example": "192.0.2.10",
"control.example": "198.51.100.10"
},
"servers": ["localhost"]
}
}
アドレスルールでコアの名前解決を検証する
上記2つのマッピングを実際に区別するには、直接接続と破棄用の2つのoutboundを残し、routingを以下の設定に置き換えます。ドメイン名をプロキシに渡せるSOCKSアプリからリクエストしてください。ルーティングでIP条件を判定するときに名前解決が試みられるため、test.exampleに対応するアドレスは破棄用outboundへ送られます。control.exampleに対応するアドレスはルールの範囲外なので、デフォルトoutboundが使われます。現在のインスタンスで利用できるルーティングログやアクセスログで経路を確認してください。どちらの予約アドレスにもページがないことを根拠に、同じ結果だと判断しないでください。
{
"routing": {
"domainStrategy": "IPOnDemand",
"rules": [
{
"type": "field",
"ip": ["192.0.2.0/24"],
"outboundTag": "blocked"
}
]
}
}
ルーティング判定に使う名前解決結果と、実際の接続先は同じものとは限りません。直接接続outboundで内蔵DNSのアドレスを明示的に使う場合は、そのoutboundのドメイン戦略も確認してください。リモートプロキシoutboundでは、ローカルで解決するリモートノードのホスト名と、リモート側で処理するWebサイトの名前を区別します。どちらも同じログに表示される場合があります。routing.domainStrategyを変更しても、リモート側から見える宛先の形式が変わるとは限らず、ブラウザーがコアで名前解決するようになるわけでもありません。
DNSサーバーの選択、アドレス種別、キャッシュを切り分ける
dns.serversにはシンプルなサーバー項目のほか、ドメインの条件を含むサーバーオブジェクトも指定できます。ドメインごとに特定のDNSサービスを優先しても、システム全体がそのサーバーを使うよう強制されるわけではありません。フォールバックのルールや使用できる項目は、実行中のコアのドキュメントで確認してください。実際の設定では、まず到達可能なサーバーを1つ指定し、専用のリゾルバーを使うドメインと通常の名前解決を使うドメインを1つずつ記録します。ドメインごとの振り分けが必要になってからリストを増やし、サーバー、ドメイン条件、フォールバックを一度に変更しないようにしましょう。
一部の名前は解決できても接続の確立に時間がかかる場合は、返されたアドレスの種類と、そのアドレスへ端末から到達できるかを別々に確認します。IPv6アドレスが返っても、利用中のネットワークに有効なIPv6経路があるとは限りません。逆に、IPv6接続が1回失敗しただけで、そのアドレス種別を恒久的に無効にする必要もありません。まず条件をそろえて比較し、どの種類のアドレスで失敗するかを確認してから、問い合わせ方法やネットワーク環境を調整します。DNS問い合わせの失敗と、名前解決後の接続タイムアウトは別の問題です。ログの発生時刻が切り分けに役立ちます。
マッピングやリゾルバーを変更しても、古い結果がブラウザー、システム、コアのキャッシュに残っていることがあります。どれか1つを再起動しても、ほかの層の記録まで消えるとは限りません。既存の接続で再度名前解決が行われるとも限りません。テストには新しい接続を使い、必要に応じて、まだ検索していない自分で管理するテスト用ドメインを使ってください。通常のプログラムとSOCKS対応プログラムの結果が異なる場合は、その差を証拠として残し、すぐに両方の名前解決設定を同じに変更しないでください。
policy(接続ポリシー)
まず接続に適用されるレベルを確認する
policyでは、ハンドシェイクの待ち時間、アイドル時間、一部の統計設定など、コアの接続ポリシーを指定します。出口を選択したり、ルーティングルールを置き換えたりする機能ではありません。policy.levelsはオブジェクトで、キーにはユーザーレベルに対応する文字列(例:"0")を指定します。プロトコル側でレベルを指定する場合、通常は数値を使います。levelsにカスタムレベルの名前を追加しただけで、すべての接続に適用されるわけではありません。接続に使うプロトコルがどのようにレベルを指定するか確認してください。
基準構成のinboundではユーザーレベルを明示的に変更しないため、ここではレベル0を比較対象にします。以下は秒単位の設定例で、待ち時間の変更による影響を観察するためのものです。すべてのネットワークでそのまま使うことを推奨する値ではありません。基準構成に追加したら、対象の接続が引き続きこのinboundを使っていることを確認し、ポリシーの動作を検証してください。クライアントが別のinboundを生成している場合や、別のプロトコルで異なるユーザーレベルが指定されている場合、レベル0を変更してもその接続の動作は説明できません。
{
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 180,
"uplinkOnly": 10,
"downlinkOnly": 10
}
}
}
}
ハンドシェイク、アイドル、片方向の終了処理を区別する
handshakeは、プロキシプロトコルの該当するハンドシェイク段階での待ち時間です。Webページへのアクセス全体にかかる時間や、すべての下位接続のタイムアウトを一括で設定するものではありません。connIdleは、接続確立後にデータ転送がない状態が続く場合に適用されます。接続が確立した後、毎回ほぼ同じアイドル時間で切断される場合は優先して確認してください。接続自体を確立できない場合は、まず待ち受け、リモートアドレス、ノードとのネゴシエーション、ネットワークエラーを確認します。
uplinkOnlyとdownlinkOnlyは、接続が片方向の終了処理に入った後、残る方向の通信を待つ時間を管理します。アップロードやダウンロードの速度制限ではありません。たとえば、アプリが送信を終えても、サーバーから返される最後のデータを受信する間は、下り方向だけが残ります。その段階の待ち時間を短くしすぎると、応答が間に合わないことがあります。ファイルのアップロード完了後に結果が返ってこない場合は、処理側の遅延、中間機器による接続切断、コアが終了処理を先に終えたケースを区別してください。
| 項目 | 確認する段階 | 説明できない現象 |
|---|---|---|
handshake | 該当プロトコルがセッションを確立する段階 | ハンドシェイク後も長時間転送が遅い。 |
connIdle | 接続確立後にデータが流れない時間 | アプリがローカルポートに一度も接続できない。 |
uplinkOnly、downlinkOnly | 接続終了時に残る片方向の転送 | より前のroutingルールがドメインにマッチしている。 |
タイムアウトと統計の適用範囲を確認する
タイムアウトをテストする際は、安定して接続できることが分かっている接続を使い、開始時刻、最後に有効なデータが流れた時刻、切断時刻を記録します。毎回1つの項目だけ変更し、新しい接続を確立してください。アプリのリクエスト上限、システムや中間機器のアイドル制限、サーバー側の待ち時間がコアより先に切れる場合もあります。コアの値を変更しても切断時刻がアプリの待ち時間で固定されるなら、アプリ側またはリモート側を調べましょう。関係のないポリシー項目をさらに延長しても解決しません。
統計にも複数の階層があります。レベルごとのユーザー送受信量と、システム層でinboundやoutboundごとに集計する統計は、集計の基準が異なります。対応機能が有効で、使用中のプロトコルと接続から必要な統計情報を取得できる場合にのみ、データが表示されます。ポリシーの統計スイッチを有効にしても、クライアント画面にすぐ数値が出るとは限らず、通信量の上限を設定するわけでもありません。コアの初回起動時に、ルールのマッチを確認するため統計APIへ接続する必要はありません。1つの入口と1つの宛先で結果を確認するほうが確実です。
エラーをなくすために、タイムアウトを一律に大きく設定しないでください。待ち時間を延ばすと、失敗の表示が遅れ、完了できない接続がリソースを占有することがあります。まず制限が発生している層を特定し、その段階を担当する設定だけを変更しましょう。
診断のため一時的に待ち時間を延ばした場合は、原因を確認したら元の設定に戻すか、根拠のある変更だけを残してください。宛先、コア、inboundタグ、接続レベル、発生時刻を記録しておくと、次に同じエラーが起きた際に比較できます。こうした情報がなければ、「タイムアウト」と表示された画面だけでは、プロキシのハンドシェイクが終わらなかったのか、確立済みの接続がデータを待っていたのか判断できません。
クライアント設定とネイティブJSON
画面上の設定、生成ファイル、実行中のファイルを区別する
普段の利用では、まずクライアントの画面からプロキシを設定してください。デスクトップではv2rayN、Androidではコアの要件に応じてv2rayNGまたはv2flyNGがおすすめです。クライアントのダウンロードページでは、OSとアーキテクチャに応じたダウンロード先を案内しています。このガイドではコアが読み込む設定を解説します。クライアントがノード、サブスクリプション、ルーティング設定、プログラムの状態を保存していても、それらのデータがネイティブのコア設定として保存されているとは限りません。拡張子がJSONのファイルでも、そのままコアに読み込ませて実行できるとは限りません。
サブスクリプションの更新はノード一覧に影響し、GUIの設定は次回生成される実行設定に反映されます。コアで実際に有効なのは、現在のインスタンスが読み込んでいるファイルです。クライアントが一時生成したファイルを直接編集すると、ノードの切り替え、コアの再起動、設定の再適用時に上書きされることがあります。変更を継続して使う場合は、まずクライアントが用意する該当設定を使ってください。ネイティブファイルが必要な場合は、カスタム設定に対応したモードで独立したコピーを保存し、クライアントが管理する項目と自分で追跡する変更を明確に分けましょう。
| プラットフォーム | クライアント | 最初に確認する実行条件 |
|---|---|---|
| Windows | v2rayN | アプリが使うシステムプロキシとコアの待ち受け先を別々に確認する。 |
| macOS | v2rayN | システムプロキシの設定、アプリ独自のネットワーク設定、実際に起動中のコアを区別する。 |
| Android | v2rayNG、v2flyNG | システムVPNによる通信の取り込み状態、対象アプリ、コアのルーティング結果を区別する。 |
| Linux | v2rayN | デスクトップのネットワーク設定と、ターミナルのプロセスが引き継ぐプロキシ引数を区別する。 |
コアを切り替えるときは、設定全体をコピーせず有効な項目を比較する
XrayとV2Flyには共通する設定概念がありますが、特定のプロトコル、トランスポート、セキュリティオプション、独自項目が互換とは限りません。移行時は、まず独立したローカルinboundと直接接続outboundを残し、最小構成で起動できることを確認してから、元の設定のルール、DNS設定、リモートoutboundを少しずつ追加します。エラーが未知の項目、無効な値、リソースファイルの不足のどれを示しているか確認してください。あるクライアントで動作する設定でも、別のクライアントやコアでそのまま動くとは限りません。
以下のトップレベル部分には、ローカルループバックで待ち受けるHTTP inboundと、直接接続outboundだけを含めています。この2つの基本項目をコア間で比較する際に使えます。第1章のSOCKS基準構成とは別の入口設定であり、アプリ側でHTTPプロキシとこの例のポートを明示的に指定する必要があります。2つのコアを比較する場合は、同じファイルを順番に実行し、古いプロセスが終了していることを確認してください。同じポートを奪い合うように2つの設定を同時に起動すると、互換性ではなくポート競合の結果になります。
{
"inbounds": [
{
"tag": "local-http",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} }
]
}
ネイティブ設定ファイルが起動し、明示的なプロキシテストも成功するのに、クライアント起動時の動作が異なる場合は、ノード名だけでなく、実行中のファイルにあるoutboundの順序、inboundのポート、ルーティングタグ、DNSポリシーを比較してください。システムプロキシや仮想NICモードを有効にした場合だけ差が出るなら、通信の取り込み方式を確認します。入口での通信の取り込みはクライアントとシステム間の問題です。ネイティブJSONにoutboundを書いても、アプリがもともと使っていないプロキシ経路が有効になるわけではありません。
設定例を共有するときは再現に必要な情報だけ残す
他の人に調査を依頼する場合は、まず一時コピーを作り、サブスクリプションURL、リモート認証情報、実際のノードアドレス、個人用ディレクトリ、個人を特定できるアクセス記録を削除します。必要なキー、値の型、配列順序、タグ間の参照関係は残してください。片方のタグだけを置き換えると、元の設定にはなかったエラーが起きることがあります。リモート接続が必要な症状を共有する場合は、失敗した段階とエラーを説明し、実行中のファイル全体はアップロードしないでください。初回起動やノード追加の画面操作はv2rayNの初期設定で確認できます。
設定を恒久的に変更する前に、どのリクエストの動作を変えるのか、元に戻すにはどうするのかを記録してください。たとえば、ルーティングはルールの順序を元に戻し、システムプロキシはアプリやシステムの設定で元に戻します。それぞれ別に記録しておくと便利です。クライアントを終了した後もローカルの古いポートを指すプロキシ設定が残っていると、コアの設定とは無関係な接続失敗につながります。この場合は、まず元の通信の取り込み方法に戻してから、ファイルの差分を比較してください。
段階的な検証と切り戻し
まず設定を読み込めたか確認し、次にリクエストがコアに届くかを確かめる
トラブル対処を始める前に、使用中のクライアント、実際のコア、待ち受けアドレスとポート、デフォルトoutbound、テスト先を記録してください。動作する設定のコピーを保存してから、候補ファイルを編集します。コアが起動しない場合は、項目を明確に示す最初のエラーを確認してください。構文の誤り、型の不一致、プロトコルの非対応、ルール用データの不足、ポートの競合はそれぞれ異なる問題です。後続のエラーは最初の問題が原因の場合があります。まず最初の原因を修正して起動ログを読み直し、複数のモジュールを一度に変更しないでください。
起動後は、プロキシを明示的に指定したプログラムから短いリクエストを送ります。以下のコマンドは、基準構成ファイルを使い、curlがインストール済みで、例のサイトに直接アクセスできる環境向けです。同じ環境でプロキシを通さずに送ったリクエストと結果を比較してください。2つのSOCKSオプションの主な違いは、宛先のドメイン名をどちら側で処理するかです。ルーティングやDNSの比較に役立ちます。別の待ち受けポートを使う場合は、宛先と同時にプロキシのアドレスまで変えてしまわないよう、2つのコマンドで同じ値を使ってください。
curl --socks5 127.0.0.1:10808 --max-time 12 https://example.org/
curl --socks5-hostname 127.0.0.1:10808 --max-time 12 https://example.org/
コマンドでローカルポートに接続できないと表示されたら、まずコアが動作しているか、同じアドレスで待ち受けているかを確認します。ローカルポートには接続できるもののプロキシプロトコルの通信に失敗する場合は、アプリで選択したプロキシの種類を確認してください。明示的なプロキシ指定では成功するのに、普段のブラウザーやターミナルの操作では失敗する場合は、アプリの通信取り込み設定に戻って確認します。ブラウザー拡張、システムプロキシ、ターミナルの環境変数は、それぞれ適用範囲が異なる場合があります。システムプロキシのトラブル対処を参考に、ブラウザーとターミナルを別々に検証してください。
短時間のログで個別リクエストを追跡する
リクエストがコアに届いているのに経路が分からない場合は、一時的にログの詳細度を上げます。以下の設定はトップレベルのlogオブジェクト全体を置き換えるもので、基準構成のコピーで短時間の確認に使えます。ログを永続保存するパスは指定していません。コアの出力をクライアントが受け取り表示する方法は、実行方法によって異なります。ログレベルを上げても、すべてのルール判定が画面に表示されるとは限りません。リクエストの時刻、宛先、inboundからoutboundまでの記録、エラーが起きた段階を照らし合わせて経路を追跡してください。
{
"log": {
"loglevel": "info"
}
}
対象を明確にして1回だけ再現してください。宛先がIPアドレスとして表示されている場合は、ドメインのマッチ条件を先に変更しないでください。デフォルトoutboundへ入ったことがログに示されている場合は、ルールがマッチしたか、タグが存在するか、先頭項目が想定した出口かを確認します。出口が正しいのに接続できない場合は、DNSまたは接続処理を調べてください。ドメイン名の解決エラー、接続拒否、接続タイムアウトは別の問題です。それぞれ名前解決、宛先の待ち受け状態、待ち時間に関係するため、確認するモジュールも異なります。
新旧の設定をテストするときは、宛先、アプリ、inboundのプロトコル、ネットワーク、選択中のノードを変えず、テスト対象のファイルだけを入れ替えてください。毎回新しい接続を確立し、ブラウザーの接続プールやクライアント内の古いセッションが結果に混ざらないようにします。アイドル状態が続いた後にだけ発生する問題は、同じ時間待って比較してください。特定の種類の名前でだけ起こる問題は、正常に動作することが分かっている名前も比較対象として残します。安定して再現できない場合は、目的なくクライアントを再インストールするより、まず発生条件を記録するほうが調査に役立ちます。
設定の切り戻しと通信取り込みの復元を別々に行う
候補ファイルが起動や基本的な接続テストに失敗した場合は、候補のインスタンスを停止し、以前の設定コピーとアプリが参照するローカルポートを復元してから、動作確認済みの宛先でテストしてください。検証中にシステムプロキシや仮想NICモードを一時的に有効にした場合は、それも元の状態に戻します。JSONの差し替えとは別の操作です。アプリが元の経路に戻ったことを確認し、通常のログレベルに戻して、テストで追加した待ち受け、固定hostsマッピング、専用ルールを削除してください。
最後に、アプリが指定したinboundに入ったか、routingが想定したoutboundを選んだか、outboundから宛先へ接続できたかの3点を記録します。それぞれ観測できた事実だけを書いてください。記録を共有する前に、公開する必要のない宛先の詳細を削除しましょう。
切り戻し後も失敗する場合は、候補ファイルに変更を重ねないでください。基準構成でテストし、ローカルポート、通信の取り込み状態、ネットワーク環境が本当に元に戻っているか確認してから、新しいプロセスがポートを使用していないか、古いファイルを読み込んでいないか調べます。普段の利用環境を復旧したい場合は、入門ガイドに戻り、インポート、モード選択、接続確認を順に行ってください。基本の経路が復旧してから、このガイドの該当する章で個別の項目を確認しましょう。