JSONの構造とリクエストの流れ
最小構成の設定ファイルから始める
設定ファイルは1つのトップレベルオブジェクトで構成されます。inboundsとoutboundsが配列なのは、コアが複数の入口から同時に通信を受け付け、複数の送信経路を管理できるためです。ルーティング、名前解決、ポリシーは通常、それぞれ独立したオブジェクトです。ファイル内の記述順に処理されるわけではなく、リクエストの処理中に個別に参照されます。設定に項目があっても、すべてのリクエストで使われるとは限りません。
次の完全なサンプルでは、ローカルのSOCKS入口を1つだけ開き、出口には直接接続を使います。アプリからコアへリクエストを渡し、コアが接続先へ接続できるかを確認するための設定です。リモートサーバーやアカウントは不要で、クライアントのインストール後のデフォルト設定を示すものでもありません。コア設定のインポートに対応した画面で読み込む前に、ローカルポートが他の設定で使用されていないことを確認してください。アプリ側ではSOCKS5を選び、この入口をHTTPプロキシとして設定しないでください。
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"tag": "app-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom" }
]
}
リクエストはまずinboundに到達します。inboundは自身のプロトコルに従って通信を解釈し、アプリがアクセスしようとしている接続先を取り出します。ルーティングルールがないこの設定では、リクエストは一覧の先頭にあるoutboundへ渡されます。直接接続のoutboundは、現在のデバイスから接続を開始します。接続先に到達できるかどうかは、OSのネットワーク環境にも左右されます。接続先へアクセスできても、確認できたのはローカル経路だけです。別のリモートoutboundも使えるとは限りません。
項目の型、タグ、設定例
項目名と文字列はダブルクォーテーションで囲みます。サンプルのポート番号は数値、オン・オフの値は真偽値です。オブジェクトと配列では括弧の種類が異なり、最後の要素の後ろにカンマは付けません。同じオブジェクト内で同名の項目を重複させないでください。パーサーによっては後の値を採用し、先に加えた設定が反映されないことがあります。保存時は標準的なJSON形式を使いましょう。コアが独自の拡張構文に対応していても、クライアント間で設定を移行する際は依存しないほうが安全です。
| 項目 | 型 | 役割 |
|---|---|---|
inbounds | 配列 | アプリからのリクエストを受け付ける |
outbounds | 配列 | リクエストを送信または拒否する |
routing | オブジェクト | 条件に応じてoutboundを選択する |
dns | オブジェクト | コア内蔵の名前解決を設定する |
policy | オブジェクト | 接続動作と統計の設定を行う |
タグは設定内部で使う名前であり、ウィンドウ上の表示名ではありません。ルーティングに接続先タグが指定されている場合、コアは文字列でoutboundを検索します。inboundとoutboundには役割がわかる重複しないタグを付けると、名前の変更時に誤った箇所を修正せずに済みます。たとえば直接接続のoutbound名を変更した場合、新しい名前が一覧にあるかだけでなく、ルーティングに古い名前の参照が残っていないかも確認してください。
以降の短い設定例は、完全な設定ファイルにマージするための断片です。元のオブジェクトの後ろに、2つ目のトップレベルオブジェクトを追加しないでください。配列を置き換えるときは、元の配列にあるinboundがアプリで使われていないかを先に確認します。インターフェースや統計情報のためにクライアントが生成した専用項目が設定に含まれる場合もあります。特にGUIから引き続きサーバーを切り替える場合は、設定全体をサンプルで上書きせず、専用項目を残すほうが安全です。
サブスクリプションの内容、クライアントに保存された設定、コアが最終的に読み込むファイルを区別してください。サブスクリプションには通常サーバー情報が含まれ、クライアントはローカルポートやルーティング設定に応じて実行用の設定を生成します。エクスポートしたコピーを編集しても、実行中のコアには自動反映されません。一時的な実行ファイルを編集すると、次回の切り替え時に上書きされることがあります。まずどの層の設定を編集しているかを確認し、GUIから保存するか、カスタム設定として読み込むかを決めましょう。
学習時は、明確な基準となる設定を2つ用意すると便利です。変更していないローカル設定と、この章で扱う項目だけを追加したコピーです。実行前に設定の読み込み元と待ち受けポートを記録し、実行後に想定どおりか確認します。こうすれば、新しい項目がリクエストの動作を変えたのか、クライアントが古いファイルを読み込んでいるのかを区別できます。大量のルールを一度に読み込むより、項目を1つずつ検証するほうが再現しやすくなります。
inboundsの設定
待ち受け範囲、ポート、プロトコル
inboundは、ローカルアプリがどこから接続するかを決めます。listenは待ち受けアドレス、portはポート番号、protocolは受信したリクエストの解釈方法を指定します。この3項目は、アプリ側に入力するプロキシ設定と一致させてください。アプリでプロキシの種類を間違えると、同じポートに接続できても、コアが接続先アドレスを正しく読み取れません。
現在のデバイスだけで使う場合、サンプルではIPv4のループバックアドレスを明示して待ち受けます。アプリにローカルホスト名を入力すると、システムがIPv6のループバックアドレスに解決することがあります。IPv4のみで待ち受けるinboundでは、そのリクエストを受け付けられない可能性があります。トラブル対処では、まず設定に書かれたアドレスをそのまま入力し、両方を一致させてください。ループバックアドレスの不一致を解決するために、待ち受け範囲をLAN全体へ広げないでください。
{
"inbounds": [
{
"tag": "app-socks",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "auth": "noauth", "udp": false }
},
{
"tag": "app-http",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
]
}
この設定は、最小構成ファイルのinbounds配列を置き換えます。2種類の入口に別々のポートを割り当てることで、アプリがどちらに接続しているかを確認しやすくなります。アプリのHTTPプロキシ設定はHTTP inboundを指定し、SOCKS5をテストするときは対応するポートに切り替えてください。クライアントによっては混合待ち受けを生成できますが、ここでは有効にしていません。独立した2つの入口に、混合入口の使い方を当てはめないでください。
プロキシのポートと接続先のポートを混同しないでください。前者はアプリがコアに接続するときに使うローカルポート、後者はアプリのリクエストに含まれる、最終的な接続先サービスのポートです。Webページを閲覧するとき、アプリはローカルのHTTP inboundを通じて接続先のHTTPSサービスへのトンネルを要求する場合があります。接続先はWebサービス側のポートをそのまま使い、ローカルプロキシのポートを変更する必要はありません。HTTP inboundという名称はプロキシのハンドシェイク方式を表すもので、接続先を平文のWebリクエストに限定するものではありません。
プロトコルの機能とローカルでの確認
この例では、一般的なTCPリクエストを先に確認できるよう、SOCKSのUDP機能を無効にしています。この設定を有効にしても、システム上のすべてのUDP通信がコアに入るわけではありません。アプリが対応した方法でリクエストを送信し、選択されたoutboundもその通信を処理できる必要があります。Webページは開けるのに他の機能が不安定な場合は、まずその機能が実際に使うネットワークプロトコルを確認してください。すべてを一括してポートの不具合と判断しないようにしましょう。
認証なしのローカルinboundは、ループバックアドレスで待ち受けてください。ローカルに限定していても、そのポートへ接続できる他のローカルプログラムからリクエストが送信される可能性があります。デバイスを複数人で共有している場合やコンテナ環境では、どのプロセスを接続するのか、アプリとコアが同じネットワーク環境にあるのかを確認してください。コンテナ内のループバックアドレスは通常、そのコンテナを指します。ホスト側の同じアドレスへ接続することはできません。
待ち受けに失敗した場合は、別のインスタンスや設定が同じアドレスとポートを使用していないかを確認します。ポートを変更したら、ブラウザーの手動プロキシ、システムプロキシ、端末の設定に入力済みのアドレスもすべて更新してください。コア側だけ変更すると、古い入口が引き続き参照されます。ポートの競合を特定して解消する手順は、ローカルポートの競合を調べる方法をご覧ください。
動作確認では、テスト用アプリの他のプロキシ設定を無効にし、明確な入口を1つだけ使います。まずコアが正常に設定を読み込むかを確認し、到達可能とわかっている接続先で再テストします。その後、outboundをすぐに変更せず、別のアプリから同じアドレスを試してください。これにより、問題が特定アプリのプロキシ設定にあるのか、ローカルの待ち受けにあるのかを切り分けられます。片方の入口だけが動作する場合は、2つのポートを個別に確認し、一方の結果をもう一方の判断に使わないでください。
inboundには、接続先を識別するための設定が含まれることがあります。対応する通信からルーティング用の情報を取得できますが、すべての接続で元のドメイン名を特定できるとは限りません。まずアプリがドメイン名を保持した場合のマッチ結果を確認し、追加の識別機能が本当に必要か判断してください。設定名が同じでもデフォルトの動作が同じとは限りません。特にクライアントが自動生成した入口では注意が必要です。
outboundsの設定
直接接続と拒否のoutbound
outboundは、リクエストがコアを出た後にどう処理されるかを決めます。接続先へ直接接続する、リモートプロトコルに従って転送する、通信を拒否する、といった処理ができます。outboundは一覧にあるだけで順番にリクエストを引き継ぐわけではありません。ルーティングで指定されたoutboundがリクエストを受け取り、ルールに一致しない場合は通常、一覧の先頭が使われます。順序を変えると、未マッチの通信すべての接続先が変わることがあります。
{
"outbounds": [
{ "tag": "direct", "protocol": "freedom" },
{ "tag": "reject", "protocol": "blackhole" }
]
}
この設定で最小構成のoutbounds配列を置き換えられます。直接接続のoutboundは先頭に置きます。拒否のoutboundは、現時点ではどのルールからも参照されていないため、リクエストを拒否しません。次の章では、テスト用ドメインに対する明示的な拒否ルールを追加します。この順序ならデフォルトの動作を予測しやすく、失敗時にルールのマッチと接続先自体の到達性を切り分けられます。
直接接続とは、コアを実行しているデバイスから接続先へアクセスすることです。アプリがローカルコアを経由しないという意味ではありません。比較テストでは、アプリから直接接続する場合と、ローカルinboundおよび直接接続outboundを経由する場合に分けて確認します。結果が異なる場合は、まずコアに渡された接続先の形式と名前解決方法を比べてください。どちらも失敗する場合は、リモートノードを疑う前に、デバイスのネットワークと接続先サービスを確認します。
拒否outboundはルールの動作を指定するためのもので、リモートサーバーの状態確認には使いません。アプリには接続切断として表示される場合も、アクセス失敗として表示される場合もあります。画面のエラーメッセージだけでルールにマッチしたか判断しないでください。確認方法の一つとして、管理できるテスト先に対するルールを一時的に変更し、変更前後の結果を比べます。コアのログでinboundとoutboundのタグも確認してください。
リモート接続とトランスポートの設定
リモートoutboundでは、通常2種類の設定を正しく合わせる必要があります。1つ目は、サーバーアドレス、ポート、サービス提供元から発行された認証情報などのプロトコル設定です。2つ目は、トランスポート方式やパス、想定するサーバー名など、リクエストを運ぶための設定です。1つ目が正しくても、2つ目も正しいとは限りません。リモートとの基礎的な接続は確立できるのに正常にアクセスできない場合は、サービス提供元の設定全体と項目ごとに照合してください。
settingsの内容はプロトコルによって異なります。別のプロトコルの項目構成をそのまま流用しないでください。streamSettingsはoutboundのトランスポート方式と関連するセキュリティ設定を定義するもので、システムプロキシの設定とは異なります。サブスクリプションからoutboundを生成した場合は、クライアント画面で各項目がすでに設定されているか確認してください。エラーを消すために証明書関連の設定をまとめて置き換えると、実際の原因であるサーバー名や時刻の問題を見落とすおそれがあります。
ローカルinboundのアドレスとリモートサーバーのアドレスは、接続方向の異なる設定です。リモートサーバーのポートをローカルプロキシのポートに入力しても、コアが自動的にサーバーへ接続することはありません。逆に、リモートoutboundにローカルのループバックアドレスを入力しても、実際のサービスには接続できません。入力時は、どのプロセスがその値を使うのかを確認し、接続先が何かを把握してください。サービス提供元のドメイン名が、最終的なアクセス先のドメイン名と同じとは限りません。
直接接続を比較用に残す場合は、手動で追加するリモートoutboundにわかりやすいタグを付け、範囲を限定したテストルールから1つだけ参照してください。ルールに一致しないリクエストが従来どおりの経路を使うことも確認します。後でリモートoutboundを差し替える場合は、タグを維持するか、参照先も合わせて変更してください。変更の影響を確認するときは、デフォルトoutboundの位置も同時に変えないでください。
outboundの問題を共有するときは、通常、プロトコル、トランスポート方式、エラーが発生した段階、伏せ字にした項目の構成があれば十分です。実際の認証情報はスクリーンショットや公開可能な設定ファイルに含めないでください。ローカルinboundとリモートoutboundを分けて説明すると、どのログを確認すべきかも伝わりやすくなります。利用可能なサーバーから接続先を選ぶ方法は、ノードの遅延、倍率、プロトコルの比較をご覧ください。
ルーティングルール
ルールの順序でoutboundを選択する
ルーティングが処理するのは、すでにコアに到達したリクエストです。システムプロキシは、その設定に従うアプリからリクエストを受け付けるためのものです。ルーティングは、受け付けたリクエストの送信先を決めます。互いに代用することはできません。ルーティングモードを切り替えても、システムプロキシを使わない端末上のプロセスが自動的に接続されるわけではありません。GUIのモードとスイッチの関係は、システムプロキシとルーティングモードの違いをご覧ください。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["app-socks"],
"domain": ["full:example.com"],
"outboundTag": "reject"
},
{
"type": "field",
"inboundTag": ["app-socks"],
"outboundTag": "direct"
}
]
}
}
対応するinboundと2つのoutboundがある設定に、このルールを追加します。1つ目のルールは、指定したinboundからのリクエストであり、接続先が完全一致するドメインであることを条件にします。同じドメインのサブドメインは拒否しません。2つ目は、そのinboundからの残りの通信に適用されます。他のinboundからの通信はマッチせず、デフォルトoutboundに進みます。1つ目のルールをテストするときは、アプリからドメイン名をSOCKS inboundに渡してください。アプリ側で先に名前解決してアドレスだけ送信すると、この条件では元のドメイン名にマッチできません。
ルールは配列の順に評価され、最初に一致したルールで接続先が決まります。範囲の広い2つ目のルールを先に置くと、1つ目のルールが正しくても適用されません。実際のルールを作るときは、まず例外を指定し、次に適用範囲の広い分類を書き、最後にフォールバックを置きます。1つのルールに複数の条件項目がある場合は、すべてを同時に満たす必要があります。各条件を個別の候補として扱わないでください。
同じドメイン条件の配列には、複数の候補を指定できます。単一のホストだけをテストするなら完全一致が適しています。ドメインとそのサブドメインを対象にする場合は、domain:プレフィックスを使えます。URL全体をドメイン条件に入れないでください。リンクのパス、クエリパラメーター、フラグメントはホスト名に含まれません。Webページの読み込み時に別のドメインへアクセスする場合は、それぞれの接続を個別に確認してください。ページのメインアドレスだけから、すべてのリソースに同じルールが適用されるとは判断できません。
ドメインポリシーとIPアドレスのルール
アプリからドメイン名が渡された場合、AsIsではルーティングのIPアドレス条件を判定するためにドメイン名を自動で解決しません。リクエスト全体の名前解決を禁止するという意味ではなく、直接接続outboundでは最終的にドメイン名の解決が必要になることがあります。ポリシーをIPIfNonMatchにすると、元の接続先でマッチしなかったときに、コアがIPアドレスのルール用に追加で名前解決できます。必ずマッチするルールを末尾に置くと、このフォールバック判定が行われないことがあります。
IPOnDemandは、IPアドレスが必要なルールを判定するときに、必要に応じて名前解決を行います。このポリシーを選ぶ前に、どのルールが解決結果を必要としているかを確認してください。ドメイン名から複数のアドレスが返ることがあり、結果もネットワークによって変わります。IPアドレスに基づくルールはWebサイトの識別情報に基づくものではありません。同じアドレスを共有する別のドメインにも、同じ処理が適用されることがあります。アプリからすでにアドレスが渡されている場合は、ドメイン名による判定に使える情報が残っているかを先に確認してください。
地域別リストを使う前に、現在のコアが対応するデータファイルを読み込めることと、ルールで参照する分類が存在することを確認します。ルールだけをコピーして、クライアントが用意していたデータが含まれていないと、起動時にエラーになることがあります。まず外部分類を使わないルールでルーティングの動作を確認し、その後で分類リストを追加してください。項目の使い方とデータ不足の問題を切り分けられます。
設定を変更するたびに、ルールに一致するはずの接続先と、一致してはいけない接続先を少なくとも1つずつ確認し、アプリが実際に使ったinboundを記録してください。変更後は新しい接続を作成し、古いルールで確立した接続の再利用を避けます。特定のブラウザーだけ結果が異なる場合は、ブラウザー独自の名前解決やプロキシルールも確認してください。設定上のルール順が正しくても、入力条件の確認は必要です。
DNSの設定
まず名前解決を行う層を確認する
アプリが接続先を自分で解決してから、アドレスをプロキシに渡す場合があります。ドメイン名をローカルinboundに渡す場合もあります。コアがルーティングの判定や直接接続outboundのために名前解決することもあります。リモートプロトコルがドメイン名を転送できる場合は、接続先へのアクセスに必要な名前解決をリモート側で行うこともあります。トップレベルのdns設定は、主にコア内蔵の名前解決機能を管理するもので、他の層ですでに開始または完了した問い合わせを自動的に制御するものではありません。
次の例では、予備の名前解決にローカルのシステム設定を使い、確認用の静的マッピングを追加しています。テスト用の名前には予約済みドメインを使います。マッピング先はローカルアドレスで、同じデバイス上で管理されたテストサービスを動かす場合に適しています。このマッピングが適用されるのは、コア内蔵の名前解決を使う問い合わせだけです。想定したポートで接続を受け付けるには、利用者がテストサービスを明示的に起動する必要があります。接続拒否が返っても、名前解決設定の誤りとは限りません。
{
"dns": {
"hosts": { "v2ray-test.invalid": "127.0.0.1" },
"servers": ["localhost"]
},
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": { "domainStrategy": "UseIP" }
}
]
}
この設定を最小構成に追加すると、outbounds配列が置き換わります。直接接続outboundのUseIPは、ドメイン名の接続先を処理するときにコア内蔵の名前解決を使い、IPアドレスで接続します。ルーティングの章で拒否outboundを追加済みの場合は、該当する項目を残すか、不要になった参照を削除してください。この静的マッピングを確認するには、事前に解決したアドレスではなくドメイン名をSOCKS inboundに渡します。
アプリがコアに接続する前にドメイン名の解決エラーを出す場合は、まずアプリのSOCKS設定でホスト名をプロキシに渡せるか確認します。アプリで発生した名前解決エラーと、コアのログに記録されたエラーは別の問題です。システムの独立したDNS問い合わせツールは、コアを実行していても、ここで設定した静的レコードを参照しません。異なる問い合わせ経路で結果が違う場合は、まず経路の違いを確認してください。すぐにシステム設定を上書きする必要はありません。
アドレスファミリー、上流DNS、キャッシュ
IPv4またはIPv6のみを問い合わせる設定では、返されたレコードとデバイスの実際の接続性を区別してください。IPv6アドレスが返されても、デバイスに使えるIPv6経路があるとは限りません。IPv4のみに制限すると、IPv6アドレスしか公開していない接続先にアクセスできなくなることもあります。確認時は、まずデフォルトの動作を維持し、単一のアドレスファミリーで比較します。トラブル対処のために一時的に追加した制限を、理由を記録せず普段の設定に残さないでください。
上流DNSを変更する場合は、まず1か所だけ変更してください。DNSサーバー自体にも、現在のネットワークから接続できる必要があります。上流DNSがドメイン名で指定されている場合は、コアがどの経路でそのアドレスを解決するかも確認してください。暗号化DNSを使う場合は、現在のコアが対応しているアドレス形式で指定します。意味を確認せず別のコアの記述方法をコピーすると、通信経路や問い合わせ先が想定と異なることがあります。
問い合わせに失敗しても、一覧内の次の上流DNSがすぐに試されるとは限りません。ドメイン別の指定、失敗時のフォールバック、アドレスのフィルタリングなどが選択結果に影響します。まず上流DNSを1つ、接続先を1つにしてテストし、成功してから制限を追加してください。上流DNSに接続できないのか、返された結果がフィルタリングされているのかを切り分けられます。DNSのタイムアウトでアプリの接続待ち時間が長くなり、接続先のタイムアウトと同じように見える場合もあります。
設定を変更しても、アプリ、システム、コアのいずれかに古い結果が残っていることがあります。以前のテスト接続を終了して設定を再読み込みし、新しいリクエストで比較してください。特定のアプリだけが古いアドレスを取得する場合は、そのアプリのキャッシュや専用の名前解決設定を確認します。すぐにデバイス全体のネットワークをリセットする必要はありません。テスト時刻と実際に使った名前解決経路を記録すると、アドレスだけを記録するより結果の変化を説明しやすくなります。
設定のメモには、静的レコードを追加した理由と、削除するタイミングを記録してください。テスト用のローカルマッピングを、日常使用する本番設定に混ぜないようにします。テスト項目を削除した後は、通常どおり名前解決できる接続先でルーティングと直接接続outboundを確認してください。ローカルのサンプルでDNS設定が機能しても、リモート側で名前解決する通信でも同じ結果になるとは限りません。
接続ポリシー
レベルとタイムアウトの対象
ポリシーでは、接続の待ち方や終了方法、特定の統計を収集するかどうかを設定します。ドメイン名ごとにoutboundを選ぶ機能ではなく、アプリ独自の再試行やタイムアウトの代わりにもなりません。実際に使われたinboundとoutboundを確認してから、接続ポリシーを調べてください。複数のタイムアウトを先に延ばすと、すぐに再現できた問題が長時間のハングに変わり、観察しにくくなることがあります。
レベル別のポリシーはlevelsに記述し、レベル番号はオブジェクトの文字列キーとして指定します。この例ではレベル0を設定し、そのレベルを使う接続を確認します。プロトコルやユーザー設定によっては、別のレベルが指定される場合があります。ポリシーが存在するだけで、すべてのプロトコルや接続に適用されるとは限りません。対象のプロトコルがどのレベルを選択するかを確認してから、レベル0を変更するか、特定用途向けの値を別途設定するか決めてください。
{
"policy": {
"levels": {
"0": {
"handshake": 8,
"connIdle": 300,
"uplinkOnly": 2,
"downlinkOnly": 5
}
}
}
}
各値の単位は秒です。動作の確認方法を示すための例であり、すべての環境に推奨する値ではありません。handshakeは対象となる接続のハンドシェイク待ち時間を制限しますが、Webページ全体の読み込み時間とは異なります。connIdleはデータ転送がない状態での待ち時間を扱います。リクエストが遅くてもデータを転送し続けている状態と、接続が長時間まったくアイドルになっている状態は異なるため、同じ現象として判断しないでください。
uplinkOnlyとdownlinkOnlyは、片方向だけが通信を続けている場合の待ち時間に関係します。一方が送信を終えても、もう一方がレスポンスをすべて送信済みとは限りません。片方向の待機を早く終了しすぎると、冒頭は正常でもデータの末尾を受信できないことがあります。この問題を調べるときは、どちらの方向が先に終了したか、特定のアプリや接続先だけで起きるかを記録してください。
ポリシーの項目は1つずつ変更する
まず元の設定で問題を再現し、症状に最も関係する項目を選びます。接続開始前に繰り返し失敗する場合は、接続開始からエラーまでの時間を記録してください。接続後、一定時間アイドルになってから切断される場合は、切断前に最後にデータを送受信した時刻を記録します。項目を1つだけ変更し、新しい接続で再テストしてください。効果がなければ元に戻し、すべてのタイムアウトを延ばす必要はありません。
ブラウザー、端末、リモートサービス、中継機器のいずれも接続を終了させることがあります。アプリがすでに待機をやめている場合、コアのアイドル時間を延ばしても、そのリクエストを復旧できません。異なる種類の接続が同じような時間で切断される場合は、ローカルの直接接続設定と比較してください。特定のリモートoutboundだけで起きる場合は、ローカルポリシーのせいと決めつけず、リモートサービスの設定や経路を確認します。
ポリシーの一部のスイッチは、特定の対象についてカウンターを収集するかどうかだけを決めます。統計モジュールの有無、接続を識別できるユーザー情報があるか、GUIでどのようにデータを読み取るかは、それぞれ別の問題です。GUIに表示される通信量の累計が、必ずしもコアの同じカウンターを元にしているとは限りません。接続障害を一度確認するために、統計機能をすべて有効にしたり、詳細ログを長期間保存したりする必要はありません。
日常利用の設定値を決めるときは、アイドル接続の整理と、ときどきデータを送受信するセッションの維持を両立させてください。アイドル時間が短すぎるとアプリが頻繁に再接続し、長すぎると不要になった接続が残り続けることがあります。長時間応答がない場合は、データ転送中の接続を誤ってアイドルと判断せず、アプリが結果を待っている状態かを確認します。再テストには問題が起きたものと同じアプリを使い、短いリクエスト1回だけで長時間のセッションが復旧したと判断しないでください。
変更理由、確認条件、元の値をメモしておきます。コアをアップグレードしたりクライアントを変更したりした後は、設定値の比較だけでなく、レベルが実際に適用されているかを再確認してください。ポリシーを変更しても違いが見えない場合は、読み込まれている設定の出所と、接続が使用するレベルを確認します。これらが明確になって初めて、変更前後のテストを比較できます。
クライアント設定とコアの違い
適切な設定箇所を選ぶ
デスクトップでは、まずv2rayNをお使いください。Windows、macOS、Linuxには、それぞれ対応するインストーラーがあります。AndroidではXrayコアを使うv2rayNGを確認してください。V2Flyコアを使う場合はv2flyNGを選べます。3つのクライアントはダウンロードページから入手できます。初めて使う場合は、OSとデバイスのアーキテクチャに合ったパッケージを選ぶだけでよく、最初からコア設定を手作業で作成する必要はありません。
| クライアント | プラットフォーム | 優先して確認する項目 |
|---|---|---|
| v2rayN | Windows、macOS、Linux | 実行中のコア、ローカル待ち受け、システムプロキシ |
| v2rayNG | Android | 接続の許可、アプリの対象範囲、Xrayの項目 |
| v2flyNG | Android | 接続の許可、アプリの対象範囲、V2Flyの項目 |
GUIクライアントでは、サーバー情報、サブスクリプションURL、ローカルポート、ルーティング設定が別々のデータとして保存されることがよくあります。サーバーを選んで起動すると、クライアントがそれらを元にコア用の設定を生成します。そのため、サーバー情報をインポートしても、コア設定全体をインポートしたことにはなりません。ノード一覧のバックアップにローカルルーティングが保存されるわけでもありません。変更する前に、サーバー情報、接続入口、実行設定全体のどれを変えたいのか確認してください。
デスクトップでアプリの接続方法を調整する場合は、通常、ローカル待ち受けとシステムプロキシの設定から確認します。システムプロキシを自動設定すると、システム設定を使うアプリに接続入口を提供できますが、すべての通信が対象になるわけではありません。デスクトップOSによってプロキシ設定の場所が異なり、同じアプリでも独自のプロキシ設定を使うことがあります。動作確認の前に、アプリがシステム設定を参照しているのか、手動入力したアドレスを使っているのか記録してください。
Androidでは、クライアントがシステムの接続機能を通じてアプリの通信を受け付けることがよくあります。接続を開始できるかどうかは、許可とアプリの対象範囲に関係します。デスクトップのサンプルで使う、ソフトウェアからループバックポートへ手動接続する方法を、そのままモバイル端末の接続手順に当てはめないでください。特定のアプリだけが常に成功または失敗する場合は、現在のクライアントの処理対象に含まれているかを確認してから、コアのルーティング結果を比べます。
設定を移行するときはクライアント生成の項目を残す
コアの系統が異なっても共通の基本項目は多くありますが、プロトコルの設定、トランスポート名、拡張機能の動作が完全に一致するとは限りません。移行前にクライアント名やファイル拡張子だけで判断せず、新しい環境で実際に使うコアを確認してください。移行先のクライアントが生成した設定を基準にし、必要な項目だけを移します。コピー時は、クライアントが管理する接続設定、インターフェース、その他の内部設定を元ファイルに残し、別のデバイスからそのまま流用しないでください。
次の断片は、ログレベルを日常的に使いやすい設定へ変更する例です。すでにログオブジェクトがある場合は、レベルの項目だけをマージし、他の設定を削除する必要はありません。GUIが実行設定を自動生成する場合は、GUIのログ設定を使ってください。カスタム設定で起動する場合に限り、該当ファイルに設定します。こうすれば、再起動やサブスクリプション更新後も設定の出所を確認できます。
{
"log": {
"loglevel": "warning"
}
}
デバイスを切り替える前に、アプリ単位で接続するか、ローカル待ち受けが必要か、どの接続先に特定のoutboundを使うかなど、維持する動作を一覧にします。新しい環境で基本接続を確認してから、ルーティングや名前解決の設定を1つずつ戻してください。サブスクリプション更新後に一覧が変わった場合は、サブスクリプショングループとサーバーフィルターの説明で接続元を確認し、別のグループにある同名の項目を現在のサーバーと取り違えないようにします。
エクスポートした設定には、サブスクリプションURLや認証情報が含まれる場合があります。自分の作業環境内だけで保管してください。他の人に協力を頼む場合は、関連項目だけを記載した別資料を作り、公開可能な問題をローカルの直接接続例で再現します。個人の接続情報を公開せず、相手が調べる範囲も絞れます。問題を記録するときは、「インポートに失敗」とだけ書くのではなく、クライアント名、OS、使用中のコアを明記してください。
移行後は、クライアント再起動後の動作も少なくとも1回確認してください。現在のセッションで正常に動作していても、次回の設定生成に使われる保存元に反映されていないことがあります。再起動後に動作が変わった場合は、実際に有効なサーバー項目、サブスクリプショングループ、選択中のカスタムファイルを確認してください。設定の選択先が切り替わっていないことを確かめてから、同じ項目でもコアによって処理が異なる可能性を調べます。
設定の検証とトラブル対処
読み込みの進行状況から原因を絞り込む
まずコアが正常に起動したかを確認します。ファイルの構文エラーは読み込み直後に発生し、待ち受けの競合はローカル入口を開く段階で発生します。どちらもクライアントが使えないように見えますが、対処する箇所は異なります。今回の起動で最初に出た明確なエラーを読み、その後のメッセージを確認してください。初期化の失敗に続いて発生した一連のエラーは、互いに無関係な複数の問題として個別に修正する必要がないことがよくあります。
構文エラーが発生したら、表示された位置から前に向かって括弧、カンマ、引用符を確認します。次の行がエラー位置として示されても、実際に記号が不足しているのは前の行かもしれません。構文が正しいのに読み込めない場合は、項目の型、プロトコル名、参照先、データファイルを確認してください。正しいJSONであることからわかるのは、テキスト構造を読み取れることだけです。現在のコアがすべての項目を認識することや、outboundが実際に接続できることまでは保証されません。
コアが動作していることを確認したら、アプリが接続できるかを調べます。指定したプロキシの種類とアドレスを使うアプリを1つ選び、システムプロキシとアプリ独自のプロキシを同時に有効にしないでください。アプリに接続拒否と表示される場合は、ローカルアドレスと待ち受けポートを確認します。リクエストがコアに届いても接続先にアクセスできない場合は、マッチしたoutboundと名前解決結果を確認してください。ブラウザーでは動作して端末では失敗する場合は、ブラウザーと端末を分けて確認する方法で設定の参照元を調べます。
ログの確認とロールバックの手順
必要に応じて、次の断片で診断情報を一時的に増やせます。変更するのはログレベルだけで、新しい待ち受けは作らず、デフォルトoutboundも変更しません。再現テスト後はログレベルを元に戻してください。ログにはアクセス先やネットワーク情報が記録されることがあります。ログを確認するときはテスト時刻の範囲を基準にし、決まったメッセージだけに頼らないでください。クライアントやコアによって表示形式が異なる場合があります。
{
"log": {
"loglevel": "info"
}
}
リクエストがコアに届いているのにoutboundが想定と異なる場合は、ルールの順序、inboundタグ、接続先の形式、outboundタグを順番に確認します。アドレスだけのテストでは、ドメインルールが機能することを証明できません。選択されたoutboundが正しいのに接続がタイムアウトする場合は、まず直接接続の基準と比較してローカル経路を確認し、その後、現在のoutboundのトランスポート、名前解決、リモート設定を調べます。テストごとに置き換える変数は1つだけにし、inboundとoutboundを同時に変更しないでください。
ドメイン名では失敗する一方、アドレスを直接指定すると接続できる場合は、DNSを切り分けて確認します。誰が名前解決しているか、リクエストがコアに届いた時点でドメイン名が残っているかをテスト条件に記録してください。サーバー名を必要とするサービスでは、アドレスを直接指定すると証明書の名前が一致しないことがあります。その結果を一括してネットワーク障害と判断しないでください。アイドル状態の後にだけ接続が失敗する場合は、アイドル時間を別途比較してから接続ポリシーを確認します。
ロールバック時は、まず問題の設定の読み込みを停止し、動作確認済みのコピーを復元します。その後、アプリが使うプロキシアドレスも元に戻してください。コアだけ元に戻して新しいシステムプロキシのポートを残すと、問題が続くことがあります。元の経路が復旧したことを確認してから、inbounds、outbounds、ルーティング、名前解決、ポリシーの順に変更を1つずつ戻します。最初に再び問題が起きた項目を、次の調査対象にします。
繰り返し発生する問題は、操作、使用したinbound、比較経路、変更した項目、結果、ロールバック方法を短く記録しておきます。まず再現し、その後で原因を特定してください。1回の接続に成功してもすべてのアプリが同じ方法で接続しているとは限らず、1回の失敗で設定全体が無効とも限りません。問題を再現できる最小構成を手元に残しておくと、次回のクライアント更新やサブスクリプション変更後にも同じ条件で確認できます。