• config.json
  • Xray · V2Fly

V2Ray 設定ファイル
項目リファレンス

接続の流れに沿って、まず待ち受けを確認し、ルールが選んだoutbound、最後に名前解決とタイムアウトを確認します。クライアントのメニューに慣れていない場合は、まず入門に沿ってインポートと接続を済ませてください。設定がどこに反映されたか確認したい場合は、このページで項目を照合できます。

config.json
  1. inboundsローカル接続の入口
  2. routing適用されるルール
  3. outbounds選択された出口の接続方法

DNSはルーティング判定やoutbound接続時に名前解決に使われることがあります。policyは接続に適用されたユーザーレベルに応じて動作します。トップレベル項目の記述順は処理順を示すものではありません。

JSONの構造と設定の配置

トップレベルのオブジェクトと配列

単体のコアが読み込む設定は、通常トップレベルのオブジェクトです。inboundsとoutboundsは配列で、1つのプロセスに複数の待ち受けや出口を設定できます。routingはオブジェクトで、その中のルールは配列で表します。DNS、policy、logもそれぞれ独立したオブジェクトです。クライアントが書き出したサブスクリプション情報、単一ノードの共有テキスト、アプリ自体の設定を、この設定ファイルと混同しないでください。ポートやプロトコルの項目が含まれていても、読み込むプログラムや項目の階層が異なります。

{
  "log": { "loglevel": "warning" },
  "inbounds": [],
  "outbounds": [{ "protocol": "freedom", "tag": "direct" }],
  "routing": { "rules": [] }
}

この完全なJSONは項目の階層を確認するためのもので、アプリで利用できる待ち受け設定ではありません。最上位キーの順序は意味に影響しませんが、配列は順不同ではありません。outbounds配列の先頭要素は通常、どのルールにも一致しない場合のデフォルト出口です。ルール配列は先頭から順に判定されます。エディターの整形機能でインデントを調整しても、この2つの配列の順序は変更しないでください。キーと値がまったく同じ2つのファイルでも、ルールやoutboundの順番を入れ替えると実際の動作が変わることがあります。

トップレベル項目データ型優先して確認する項目
inbounds配列待ち受けアドレス、ポート、アプリが使用するプロトコル。
outbounds配列デフォルト出口、タグ、出口自体の設定。
routingオブジェクトルールの順序、マッチ条件、宛先タグ。
dnsオブジェクト組み込みDNSが使うサーバーと呼び出されるタイミング。
policyオブジェクトレベルの割り当て、接続タイムアウト、統計の有効化。

厳密なJSONでは、キーと文字列を二重引用符で囲み、数値や真偽値には引用符を付けません。最後の要素の後にカンマは付けず、同じオブジェクト内でキーを重複させないでください。編集ツールによってはコメントや重複キーを受け入れますが、ローダーによってはエラーになったり、後の値だけが残ったりするため、再現性が損なわれます。ポートが反映されない場合は、数値だけでなく、現在のオブジェクトにある唯一の該当項目を変更したか、同名キーや別のinboundの項目を編集していないかも確認してください。

クライアントの画面設定とコアの設定ファイル

デスクトップ版では、まずダウンロードページからv2rayNを選び、「パラメータ設定」でローカル待ち受けの項目を、「ルーティング設定」でルールを確認します。クライアントは、ノードの切り替えや設定の適用、再起動時にコアの設定ファイルを再生成することがあります。GUIで管理される接続は、まず画面から変更してログを確認してください。自分で管理する設定は別ファイルに保存し、読み込み方法を明確にします。実行時に使われる一時ファイルを編集して、永続設定にしないでください。

Android版のv2rayNGとv2flyNGは、それぞれ独自のアプリ設定と異なるコアを使用します。デスクトップの設定ファイルにあるローカル待ち受け、システムプロキシの動作、データファイルのパスを、そのままモバイル版に当てはめることはできません。移行前に、ノード接続情報、ルーティングルール、アプリの接続方法のどれを移すのか明確にしてください。ノードをインポートできても、デスクトップの待ち受けや名前解決まで移行されるとは限りません。ログに同じプロトコル名があっても、すべての設定が反映されたとは限りません。

症状から該当する設定層を特定する

エラーを「設定ファイルの読み込み」「待ち受けの作成」「リクエストの処理」の3つに分けます。読み込み時のエラーなら構文や項目の階層を確認します。起動後もローカル待ち受けが見えない場合は、ポートの競合やアドレスのバインドを確認してください。アプリが接続できてもアクセス結果が異なる場合に、routing、outbound、名前解決を調べます。最初に失敗した段階から確認すれば、すべての問題をノードのせいにせずに済みます。再起動後も結果が変わらない場合は、旧プロセスがポートを使い続けていないか確認し、旧プロセスの応答を新しい設定の成功と取り違えないでください。

以下の各章の短い設定例は、トップレベルオブジェクトのメンバーを示しています。同じトップレベルキーにすでに設定がある場合は、該当するオブジェクトや配列に統合し、同名のトップレベルキーを追加しないでください。項目の動作だけを確認する場合は、後述の完全な設定例を独立したファイルで使えます。元の値、変更後の値、再現可能なリクエストを記録してください。設定全体を置き換えてからどの行が反映されたか調べるより、変更前後のログを比較するほうが原因を特定しやすくなります。基準となる設定全体がなければ、問題が今回の変更で起きたのか、以前からあったのか判断しにくくなります。

inbounds ローカル待ち受け

アドレス・ポート・プロトコルをまとめて確認

inboundsは、どのアプリがリクエストをコアに渡せるかを決めます。トラブル対処では、待ち受けアドレス、ポート番号、プロキシプロトコルをセットで確認してください。アプリに入力するのはプロキシの接続先であり、サブスクリプションURLやノードのリモートポートではありません。ローカルブラウザーからローカルのSOCKS待ち受けに接続して確認できるのは、そのアプリの接続経路だけです。システムプロキシが有効か、ほかのアプリがシステム設定を参照しているかは、別々に確認してください。プロキシポートが開いていても、すべての通信がそこを通るわけではありません。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": { "auth": "noauth", "udp": false },
      "sniffing": { "enabled": false }
    }
  ]
}

この待ち受けは、ローカルのIPv4ループバックアドレスだけにバインドされます。アプリ側にも同じアドレスを入力してください。アドレスをホスト名に置き換えると、アプリが先にIPv6のループバックを試し、同じように見えるのに接続できないことがあります。接続拒否が発生した場合は、現在のプロセスが該当するアドレスとポートに実際にバインドされているか、別のクライアントが同じ待ち受けを使用していないかを確認してください。リクエストはまだroutingに入っていないため、まずリモートサーバーのアドレスを変更しないでください。

プロキシの種類と待ち受けプロトコルを一致させてください。同じポート番号を使っていても、HTTPプロキシのリクエストとSOCKSのハンドシェイクは別物です。設定を間違えると、ポートには接続できても、ネゴシエーション中に切断されることがあります。2つの待ち受けを使う場合は、タグとポートを別々に設定し、アプリのプロキシ設定に合わせてそれぞれ検証してください。システムプロキシを参照するアプリだけが使える場合は、すべての待ち受けを同じプロトコルに変えるのではなく、システム設定が指すポートとプロトコルを確認してください。

この例では、まず基本的なTCPリクエストを確認するためUDPを無効にしています。udpを有効にすると、このSOCKS待ち受けで該当するUDP転送リクエストを処理できるようになりますが、アプリが必要なネゴシエーションに対応し、選択されたoutboundが転送でき、中間の経路で遮断されないことが条件です。Webページを開けても、音声、ゲームなどのデータグラム通信が使えるとは限りません。1つの接続結果から、あらゆる種類の通信が同じ経路を通ると判断しないでください。

inboundタグとスニッフィングの範囲

inboundタグはルールから参照する名前で、画面に表示するノードのメモではありません。入口ごとに異なるタグを付けると、inboundTagでブラウザー、ツール、プロキシ中継などからの接続を区別できます。名前を変更する場合は、inboundだけでなくrouting内の参照も変更してください。2つのアプリが同じinboundを使っている場合、この条件だけでは区別できません。ルールを重ねて増やすのではなく、アプリが別々の入口に接続できるかを確認してから分けるか判断してください。

アプリがローカルでドメインをIPアドレスに解決してから接続すると、inboundにはIPアドレスしか届かないことがあります。スニッフィングは一部のプロトコルやリクエスト形式からホスト情報を識別できますが、すべての接続で元のドメインを取得できるわけではありません。対応するコアでは、routeOnlyを設定すると、識別した情報をルーティングのみに使い、元の宛先は置き換えません。ドメインルールを確認する際は、アプリから渡されたドメインとアドレスの結果を比較してください。スニッフィングを有効にすれば、マッチしないリクエストがすべて直るとは限りません。

共有する場合は、まずホスト側のデバイスで入口を検証し、次に別のデバイスからホストのLANアドレスに接続し、最後にファイアウォールルールを変更します。接続側のデバイスで自分自身のループバックアドレスを入力すると、そのデバイス自身にアクセスします。同じデバイスからしか接続できない場合は、バインドアドレス、ネットワーク環境、アクセスルールを個別に確認してください。信頼できるネットワークを離れたら共有を無効にし、ループバックの入口が元どおり動作するか確認して、一時的な変更を日常の設定として残さないようにしましょう。

設定を引き継ぐ際は、入口のアドレス、プロトコル、用途をまとめて記載してください。1台のデバイスでも、システムプロキシ、アプリ内プロキシ、拡張機能のプロキシなど、設定箇所が複数あることがあります。まずプロキシを明示的に指定したリクエストで基準を作り、ほかの入口も確認してください。画面上では有効なのに通信が見えない場合は、システムプロキシの設定手順を見て、アプリがシステム設定を反映しているか確認します。特定の入口に問題があるか調べるには、同じアプリで一時的に動作確認済みの入口へ切り替え、ハンドシェイク結果を比較してください。アプリの動作とローカル待ち受けの問題を切り分けられます。

outbounds 出口とタグ

出口の動作はプロトコルで決まり、routingはタグで選択する

outboundsは、コアがリクエストを実際に転送する方法を定義します。direct出口ではコアを実行するデバイスから宛先へ接続し、block出口では一致したリクエストを終了します。リモートプロキシ出口では、対応するプロトコルでサーバーとネゴシエーションします。タグは単なる名前で、「direct」と付けてもプロトコルの動作は変わりません。ログに選択されたタグが表示されたら、同名のoutboundオブジェクトを探し、そのプロトコルと設定を確認してください。タグ名から接続経路を推測するのは避けましょう。

{
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" },
    {
      "tag": "blocked",
      "protocol": "blackhole",
      "settings": { "response": { "type": "none" } }
    }
  ]
}

この例ではdirectを先頭に置いています。ルールに一致しない場合は、通常、タグ名から代替経路を自動で探すのではなく、最初のoutboundを使用します。blockを先頭に移すと、ルールに一致しないリクエストも失敗します。逆に、特定のリクエストを指定した出口だけに通す設計でdirectをデフォルトにすると、書き忘れたルールがdirectに流れる可能性があります。配列の順序を変更する前に、どのルールにも一致しない宛先で変更前のデフォルト動作を確認し、同じ宛先で変更後もテストしてください。

routingで出口が選ばれた後、そのoutboundへの接続に失敗しても、通常はルール判定に戻って次のルールを試すことはありません。同じ条件で出口の異なるルールを2つ並べても、フェイルオーバーにはなりません。このような問題は、指定したoutboundが自身の接続とプロトコルネゴシエーションを完了できるかを先に確認してください。デフォルト出口が使えて指定した出口でエラーになる場合、入口と一部の経路が正常だとはいえますが、もう一方の出口の設定が有効だとは確認できません。

リモート側の設定とトランスポート設定の違い

リモートプロキシのoutboundには、そのプロトコルで必要なサーバーアドレス、サーバーポート、ユーザー情報を設定します。これらは、アクセス先サイトのドメインやポート、アプリが接続するローカルポートとは異なる段階の設定です。GUIクライアントでノードを編集する際は、まずサービス提供元の設定情報と照合し、次にプロトコルごとの項目を確認してください。通信方式を変更するとき、別のプロトコルからユーザー情報をコピーして不足項目を補わないでください。同じ名前の設定でも、プロトコルによって指定できる値が異なることがあります。

対応するoutboundでは、streamSettingsでリモート接続時のトランスポートとセキュリティを設定します。最終的に開くWebサイトの暗号化方式を切り替える設定ではありません。アクセス先サイトとのセキュリティ接続と、クライアントからリモートサーバーへのセキュリティ接続は分けて考えてください。ログにプロキシサーバーへの接続段階でエラーが出ている場合は、アドレス、ポート、トランスポートの種類、サーバーと合意した名前を確認します。セキュリティネゴシエーションのエラーを避けるために証明書検証を無効にせず、まずどの層で失敗したかを特定してください。

プロトコル項目が構文チェックを通っても、現在のコアが必要なトランスポートとセキュリティの組み合わせに対応しているとは限りません。デスクトップクライアントは複数のコアを管理でき、モバイルクライアントが動作中のデスクトップ版と同じ機能を備えているとも限りません。ノードを別のデバイスにコピーする際は、移行先のクライアントが実際にどのコアを使うかを確認し、必要な設定項目に対応しているか調べてください。画面に該当項目がなければ、インポートしたテキストだけで機能が有効になるとは考えないでください。プロトコル用語は入門のプロトコル解説を参照してください。

トラブル対処では、サーバーのドメインとリクエスト先のドメインを区別してください。アプリが宛先アドレスを送っても、プロキシサーバー自体の名前解決や接続が先に必要な場合があります。サーバーに接続できても、リモート側のルールやネットワーク環境によって宛先への接続が失敗することもあります。入口のネゴシエーション、プロキシへの接続、宛先からの応答のどの段階で失敗したか記録し、その段階の設定を確認してください。比較時はできるだけ出口だけを変更し、リクエスト先、アプリ、入口は同じにします。

outboundの一覧を作る際は、用途、対象コア、サーバー名の名前解決への依存、選択するルールを各項目に記載すると管理しやすくなります。ローカルのdirect、リモートプロキシ、テスト用のblockは分けて記述し、ログやスクリーンショットにノードの認証情報を載せないでください。outboundを停止する前に参照先を変更し、デフォルト出口をテストして、古いタグを選ぶルールがないことを確認してから削除します。一度にまとめて削除して修正するより、小さく段階的に変更するほうが見落としを見つけやすく、設定のレビューでも各ルールの実際の宛先を追跡できます。

routing ルールの順序とマッチ条件

先に一致したルールを適用

ルール配列は上から順に判定されます。1つのルールに宛先ドメイン、ネットワーク種別、inboundタグを指定した場合、設定された条件をすべて満たす必要があります。同じマッチ項目のリストには複数の候補値を指定できます。「ドメインに一致、またはアドレスに一致」を表すには、通常、条件を同じルールに詰め込まず2つのルールに分けます。対象を限定するルールは、それを包含する広いルールより前に置いてください。そうしないと広いルールが先に出口を選び、後続の例外ルールは適用されません。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:blocked.example"],
        "outboundTag": "blocked"
      },
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["domain:example"],
        "outboundTag": "direct"
      }
    ]
  }
}

この設定例では、前の2章で紹介したタグを参照しています。最初のルールは、指定された入口から来た、完全一致のドメインblocked.exampleへのリクエストだけに適用されます。2つ目のルールはドメインのサフィックスに一致し、そのドメイン自体とサブドメインを対象にします。順序を入れ替えると、範囲の広いサフィックスルールが先に一致し、blockルールは機能しません。ここではマッチ方法を説明するための予約ドメインを使っており、実際にアクセスできるサービスを示すものではありません。blockのテストには、directなら本来アクセスできる宛先を選ぶのが適しています。完全な設定例も参照してください。

full:はホスト名の完全一致に、domain:はドメイン自体とそのサブドメインの一致に使います。ドメインのマッチ項目には、Webページのパス、クエリ文字列、URLの先頭部分を含めないでください。これらは宛先のホスト名ではありません。一部の文字列だけで一致させると、関係のないドメインまで対象になることがあります。特に名前が短いサービスでは注意してください。特定のサイトを調べる場合は、まず完全なホスト名で検証し、必要に応じて対象を広げます。Webページはほかのホストにも接続するため、トップページが開けただけで全リクエストが一致したとは限りません。

ポートを照合する場合、portはリクエスト先のポートを指し、inboundの待ち受けポートではありません。入口で区別するにはinboundTagを使用します。ネットワーク種別の条件は接続の種類を制限するもので、アプリ名を示すものではありません。ブラウザーのページを1つ開くだけでは、ポート、プロトコル、ドメインのどの条件が不一致なのか判断しにくくなります。まず条件を1つだけにして確認し、その後ほかの条件を1つずつ追加すると、どの条件を満たせていないか特定できます。

名前解決の方針とデータファイル

AsIsはroutingのための名前解決を行わないため、受信したドメインを、その名前解決後のIPアドレスに対するルールで照合することはできません。IPIfNonMatchはドメイン宛てのリクエストがルールに一致しない場合に名前解決し、後続のアドレス条件で照合します。先に広いルールが一致していれば、後続の名前解決が行われないことがあります。IPOnDemandは、IPアドレスを必要とするルールの判定時に名前解決を行います。これら3つはrouting段階の設定であり、ブラウザーがドメインを問い合わせる方法を決めるものではありません。

アドレス条件には単一のアドレスやネットワーク範囲を指定できるほか、コアのデータファイルがサポートする分類、たとえばgeoip:privateを参照できます。geosite:cnのようなドメイン分類は、対応ファイルの有無、分類に含まれる項目、コアが実際に読み込むパスに左右されます。分類を使う前に、明示的なドメインやネットワーク範囲を指定した単一ルールで構造を検証してから置き換えてください。そうしないと、ファイル読み込みとルール判定の問題を切り分けにくくなります。GeoIP・GeoSiteルールファイルの更新も参照してください。

分類を使っていてコアが「分類が存在しない」と報告した場合、すぐにルールの優先順位を変更しないでください。プロセスが実際に読み込んでいるデータファイルと分類名を確認し、作業ディレクトリの変更で別のデータが読み込まれていないか調べます。起動できても結果が想定と異なる場合は、一致するはずの宛先と一致しないはずの宛先を1つずつテストしてください。分類の更新で対象が変わることもあります。ファイルの更新日時だけを見るより、更新前の一致結果とデータファイルを一緒に保存しておくほうが、変更の影響を判断できます。

最後にデフォルト経路をテストします。すべての例外条件に一致しない宛先を用意し、同じ方法でリクエストして、想定したデフォルト出口に入ることを確認してください。結果がアプリからドメインが渡されるかどうかに左右される場合は、その点を記録し、別のデバイスでテストしたときに逆の結論にならないようにします。アプリがすでに名前解決していると、ルールから見えるのはIPアドレスだけの場合があります。コアがドメインのIPアドレスを調べられても、任意のアドレスからアプリが最初に入力したドメインを復元できるとは限りません。

dns 名前解決とroutingの連携

まず、どこが名前解決を行っているか確認

組み込みDNSモジュールはコアの機能に名前解決結果を提供しますが、dnsオブジェクトがあるだけでデバイス全体のDNSを自動的に処理するわけではありません。アプリはシステムのリゾルバーを使うことも、独自に暗号化DNSを使うことも、宛先名の解決をプロキシ側に任せることもあります。アプリが接続前に名前を解決してIPアドレスを渡している場合、コアのDNSサーバーを変更しても今回のリクエストには影響しないことがあります。ドメインにアクセスできたというだけでは、どのリゾルバーがアドレスを返したか判断できません。

{
  "dns": {
    "servers": [
      { "address": "1.1.1.1", "port": 53 }
    ]
  }
}

この例では、組み込みリゾルバーにIPアドレスで指定したサーバーを1つ設定し、ポートには一般的なDNSのポートを使います。システムから指定できるローカルDNS待ち受けを追加する設定ではなく、問い合わせの暗号化も保証しません。個人環境でテストする場合は、現在のネットワークからそのリゾルバーへ接続できるか確認してください。管理されたネットワークでは、管理者が指定するサーバーを使用します。まずサーバーを1つだけにすると、タイムアウトがサーバーの選択、ネットワーク経路、フォールバックのどれによるものか判断しやすくなります。

DNSサーバーのアドレスをドメイン名で指定する場合は、そのサーバー名を最初に誰が名前解決するのかも考慮してください。初期の名前解決が、まだ確立していない同じ入口に依存すると、待ち状態を繰り返すことがあります。リモートプロキシ自体のサーバー名にも同様の依存関係があります。トラブル対処では「宛先ドメインの名前解決」と「DNSやプロキシ接続に使うサーバー名の名前解決」を分けて記録してください。前者の失敗は宛先へのアクセス不能を意味するとは限りませんが、後者の失敗はそれに依存する宛先すべてをタイムアウトさせる可能性があります。

名前解決がroutingと接続のどちらで行われるか確認

routingでは、ドメイン宛てのリクエストに対して、前章の方針に従いアドレス条件の判定に必要な名前解決を行うことがあります。この結果はまずマッチ判定に使われ、最終的な接続にも同じアドレスが使われるとは限りません。directプロトコルでドメインをどう処理するかは、その設定やコアの実装にも左右されます。リモートプロキシが宛先ドメインを受け取って、独自に名前解決する場合もあります。routingの方針だけを変更してoutboundの動作を確認しないと、「一致する条件が変わった」ことを「宛先の接続先アドレスが変わった」と取り違えやすくなります。

ドメインごとに異なるDNSサーバーを使う場合、対応するコアではサーバー項目のdomainsで優先する範囲を指定できます。これはシステム全体のDNS漏えい防止設定ではありません。失敗後に別のサーバーへ問い合わせるかどうかは、対応するフォールバック設定とコアの動作にも左右されます。まず明確なテスト用ドメインが同じ経路を通る状態を再現してから、ほかのグループを追加してください。地理的な分類で対象範囲を指定する場合は、その分類をローカルのデータファイルから読み込めることも確認します。

名前解決結果を比較する際は、問い合わせ種別とサーバーを同時に変更しないでください。ネットワーク環境によってIPv4とIPv6の到達性が異なり、アドレスが返ってきてもデバイスから接続できるとは限りません。ブラウザー、OS、コアがそれぞれ結果をキャッシュすることもあります。比較テストでは、同じホスト名、プロキシ入口、ネットワーク環境を使い、想定するアドレスファミリーを確認してください。アプリがローカルで名前解決する設定かどうかも記録します。そうしないと、異なるアドレスが返っても原因を特定できません。

FakeDNSは、対応するコアと接続方式を組み合わせて使います。返されるのは後続で関連付けを復元するための合成アドレスであり、サイトの実際のサービスアドレスではありません。後続の接続が関連付けを識別できる経路に入らないと、名前解決には成功しても接続に失敗することがあります。基本的なDNSを調べる際は、まずこの仕組みを除外してください。通常の名前解決で問い合わせと接続を確認した後、合成アドレス方式を個別に導入し、名前解決、通信の捕捉、宛先の復元が同じ設定経路上で動作することを確認します。

トラブル対処の記録には、リクエストがドメインかアドレスか、実際にどのoutboundが選ばれたか、どちら側で名前解決されたか、タイムアウトしたのかエラー応答が返ったのかを含めてください。特定のアプリだけで起きる場合は、まずそのアプリのDNS設定を確認します。特定のDNSサーバーに依存するリクエストすべてで起きる場合は、そのサーバーを利用する場所から到達できるか確認してください。DNSサーバーをリストに追加し続けるだけでは解決になりません。各項目の用途、問い合わせの優先順位、失敗時の想定動作を説明できるようにしましょう。

もう1つよくある誤判定は、アプリのキャッシュからWebページが表示されているケースです。名前解決の経路を壊していても、以前のページが表示され続けることがあります。再発行したネットワークリクエストで判断し、テスト時刻と接続していたネットワークを記録してください。問い合わせが想定したDNSサーバーに届いていることを確認し、routingと接続結果を照合して初めて、名前解決の問題とほかの段階の問題を切り分けられます。

policy 接続ポリシーと統計

接続レベルはルーティングの優先順位ではない

policyオブジェクトは、接続に関する設定をユーザーレベルに割り当てます。levelsのキーはJSON文字列ですが、レベルを参照する項目の値は通常数値です。個別にレベルを指定していない接続は、一般にレベル0を使います。プロトコルでユーザーやinboundにレベルを割り当てられるかどうかは、使用するコアとプロトコルの項目定義を確認してください。同じ項目を、すべてのプロトコルの同じ階層に設定できるとは限りません。レベルはroutingルールの順番を変更せず、プロキシ出口の選択にも使えません。

{
  "stats": {},
  "policy": {
    "levels": {
      "0": {
        "handshake": 8,
        "connIdle": 300,
        "uplinkOnly": 2,
        "downlinkOnly": 5
      }
    },
    "system": {
      "statsOutboundUplink": true,
      "statsOutboundDownlink": true
    }
  }
}

各タイムアウトの単位は秒です。この例は説明用で、すべてのデバイスに推奨する値ではありません。handshakeは該当する接続のハンドシェイク完了を待つ時間を制限し、connIdleは接続がアイドル状態かどうかを判定します。データを送り続けている接続に対するアイドル制限は、1回のリクエスト全体の制限時間とは異なります。ページの接続が開始されない場合は、入口のネゴシエーション、名前解決、outbound接続のどこで失敗したかを先に確認してください。すべての異常をアイドル時間が短すぎるせいにしないでください。

uplinkOnlyとdownlinkOnlyは、片方向だけが転送可能になった接続の待機時間を制御します。それぞれ上りだけ、下りだけが残った状態に対応します。帯域幅を制限する設定でも、アップロードやダウンロード1回ごとの最大時間でもありません。値を小さくすると、片側が先に閉じてもデータ転送を続けている接続が早く終了することがあります。このような異常を調べる場合は、半閉鎖後の通信状況を確認してください。短いWebページやすぐ完了するリクエストだけでは十分に判断できません。

policy項目確認できることこの項目だけでは判断できないこと
handshake接続のハンドシェイクで停止しているかアクセス先サイトの総応答時間
connIdle最後の通信から切断までの時間通信が続いている接続の寿命
uplinkOnly / downlinkOnly片方向が閉じた後に残る通信上り・下りの速度制限

一定間隔で切断される場合は、接続開始、最後のデータ、片方向の終了のどのイベントから時間を測ったか記録してください。同じ経過時間の原因は、アプリ、リモートサーバー、中間ネットワークにもあり、本機のpolicyとは限りません。特定の項目を大きくしても切断時間が変わらない場合は元の値に戻し、別の層に制限がないか調べます。複数箇所を同時に緩和すると、実際の原因を特定しにくくなり、アイドル接続が本機のリソースを長時間使う可能性もあります。

統計を有効にすることと、値を読み取ることは別

例にある項目に対応するコアでは、トップレベルのstatsで統計モジュールを有効にし、policy.systemのスイッチで記録するoutboundの方向を選びます。これだけでアクセス可能な統計ページが作成されるわけではありません。値を読み取るには、対応するクライアントまたはコアの管理インターフェースが必要です。この例ではリモートインターフェースを設定していません。一般的な接続の確認に、管理機能をほかのデバイスへ公開する必要はありません。

統計値は、特定の通信があるoutboundを通ったか確認するためのもので、アクセス先が受信したデータ量や速度測定の結果を示すものではありません。値が0の場合は、スイッチ、読み取り方法、outboundタグ、テスト中に実際に発生した通信をあわせて確認してください。クライアントの再読み込みやインスタンスの切り替え後は、新しいプロセスの値が表示されることもあります。比較時は同じ統計元であることを確認し、明確なリクエストを1つ実行してから、該当タグの値が変化したかを見てください。別のアプリの通信をテスト対象のものと取り違えないようにしましょう。

ユーザーレベルごとに統計を分けるには、プロトコルが統計用のユーザー識別子を提供しているか確認してください。画面に表示されるノードのメモを同じ種類の項目として扱うことはできません。タグ、ユーザー識別子、統計名はそれぞれ別のものです。出口が使われたかだけを知りたい場合は、まずoutbound方向の統計を確認します。ユーザーごとの確認が本当に必要で、現在の設定から適切な識別子を取得できる場合にのみ、レベル別の統計設定を追加してください。

日常的な運用では、policyを必要最小限に保つと管理しやすくなります。頻繁に変更する場合は、実際に使うレベルとタイムアウトだけを記載し、対象のクライアントまたは自分で管理する設定ファイルを明記してください。古い設定を引き継ぐ際は、各レベルを使う接続があるか確認し、参照されていない項目を機械的に移行しないでください。そのうえで同じ条件の短いリクエストと、アイドル後に再開するケースをテストし、値を明示するかコアのデフォルトに戻すか判断します。

ローカルで使う完全な設定と検証

実際に接続できる宛先で2つの出口を比較

この独立した設定は、ローカルでSOCKSリクエストを受け付けるものです。リモートアカウントは不要で、OSのプロキシ設定も変更しません。ルールは宛先ドメインに応じてblockを選び、それ以外はデフォルトのdirectを使います。ここでは3つの動作を確認します。アプリが正しい待ち受けに接続すること、コアがドメインに応じてルールを適用すること、ルールに一致しないときに先頭のoutboundが選ばれることです。既存クライアントをテストする場合は元の設定を残し、空いているポートを使うか、例で使うポートを占有しているプロセスを先に終了してください。

{
  "log": { "loglevel": "info" },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": { "auth": "noauth", "udp": false }
    }
  ],
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" },
    {
      "tag": "blocked",
      "protocol": "blackhole",
      "settings": { "response": { "type": "none" } }
    }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "blocked"
      }
    ]
  },
  "policy": {
    "levels": { "0": { "connIdle": 300 } }
  }
}

GUIクライアントが生成したファイルを上書きせず、識別しやすい場所に別名で保存してください。独立したXrayコアがあり、現在のターミナルから実行できる場合は、以下の2つのコマンドを個別に実行できます。1つ目は設定を読み込めるか調べるだけで、ポートをバインドできることは確認しません。2つ目でコアを起動します。GUIクライアントでカスタム設定を使う場合は、クライアントが提供する読み込み方法を使い、実際に起動したコアとログを確認してください。別の独立したプロセスを起動する必要はありません。

xray run -test -c config.json
xray run -c config.json

コマンドに指定するファイル名が、現在のディレクトリ内のファイルと一致しているか確認してください。チェック時にファイルを開けない場合は、設定項目を変更するのではなく、作業ディレクトリとファイル名を確認します。チェックは通るものの起動時にアドレスの競合が報告された場合は、そのポートを空けるか、未使用と確認できたポートに変更し、後続のリクエストも合わせて変更してください。コアの入口が起動しているのにシステムプロキシが無効と表示されるのは正常です。この設定は入口を用意するだけで、OSにアプリの通信をそこへ流すよう求めてはいません。

起動後、別のターミナルからローカルプロキシを明示的に通すリクエストを2つ送ります。socks5hを使うと、アプリが先にドメインを名前解決してマッチ条件に合わなくなるのを避け、ドメインをプロキシ側へ渡せます。--noproxy ""を指定して、環境に設定されたプロキシの例外によりテスト対象が入口を迂回するのを防ぎます。同名のコマンドエイリアスがある場合は、該当するOSでcurl.exeを実行するなど、実際のcurlプログラムを指定してください。

curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.com/
curl --noproxy "" --proxy socks5h://127.0.0.1:10808 --max-time 15 https://example.org/

現在のネットワークから例にあるサイトへ接続できる場合、1つ目のリクエストはdirectを通り、2つ目はルールでblockのoutboundが選ばれるため、接続確立前またはセキュリティネゴシエーション中に失敗する可能性があります。エラー文が特定の表現になることだけを判断材料にしないでください。ネットワーク自体から接続できない場合はdirectのリクエストも失敗します。まずアクセス可能と確認できる、機微な情報を含まない宛先に変更し、ルールとコマンドで使うホスト名を完全に一致させてください。

両方のリクエストが失敗する場合は、1つ目がinboundを通過できたか確認してください。ターミナルにプロキシへ接続できないと表示される場合は、ローカルアドレス、ポート、プロセスを確認します。プロキシには接続できても宛先を開けない場合は、ログを参照してoutboundへの接続を確認してください。両方とも成功した場合は、実際に読み込まれているファイル、リクエストがドメインとアドレスのどちらで渡されたか、inboundタグとルールの対応を確認します。想定した結果に合わせるためにblockを先頭へ移動すると、比較テストの意味がなくなります。

検証結果とクライアントの動作を切り分ける

blockルールを一時的に削除して再起動し、2つ目のリクエストだけを再試行する方法もあります。成功するようになれば、宛先に常にアクセスできなかったのではなく、元の失敗がルールに関係していたと分かります。このときポートやアプリも同時に変更しないでください。結果をルールだけに結び付けられなくなります。コマンド、一致したoutbound、結果を記録したら独立プロセスを停止し、テスト用ポートを解放して、以前使っていたクライアント設定に戻します。

この例では、UDP、システムプロキシの適用範囲、リモートプロトコルの設定、モバイル端末での通信捕捉は検証できません。GUIクライアントの検証は入門の接続テストを基本とし、特定の項目を確認するときに、この最小サンプルで再現してください。すでに動作する設定ファイルがある場合は、複製してからルールやpolicyを段階的に追加します。各項目を追加するたびに2つの比較リクエストを実行すれば、変化を引き起こした箇所を特定できます。

検証に成功したら、単に「開けた」と記録するのではなく、再現できる条件を記録してください。たとえば、どの入口からリクエストしたか、どのホストは正常にアクセスできるべきか、どのホストはblockされるべきか、一致しない場合にどのoutboundを使うかを明記します。クライアントの更新や設定変更後に、同じ条件で再テストできます。再テスト前に例で使うポートが別の用途に使われていると分かった場合は、別のポートを選んで記録し直してください。実際の通信に使う入口をblockのテストに流用しないでください。

段階的なトラブル対処と設定の復元

サブスクリプション、起動、単一リクエストを切り分ける

サブスクリプションの更新は、クライアントがノード情報を取得する処理であり、コアがその情報を使って接続を確立したことを意味しません。更新時にタイムアウトや証明書エラーが出た場合は、サブスクリプションの取得失敗と、既存ノードの接続不可を切り分け、更新に使うアクセス方法と本機の時刻を確認してください。既存ノードが使えるなら、すぐに設定を削除して再インポートする必要はありません。サブスクリプションの問題はサブスクリプション更新のトラブル対処を参照してください。この章では、設定を選択した後に発生する問題を段階的に調べます。

コアが起動しない場合は、直近の起動エラーにある最初の明確な原因から確認してください。構文や項目の型が違う場合は、括弧、カンマ、項目の階層を確認します。ルールの読み込みに問題がある場合は、参照するデータファイルと分類を確認します。アドレスのバインドに失敗した場合は、待ち受けの競合や、そのアドレスが本機のものかを確認してください。後続のエラーは最初の失敗によって起きていることがあります。ネットワークと設定を一度に変更するより、原因を1つずつ解消してください。

起動できてもアプリが接続できない場合は、まずプロキシを明示したリクエストで入口をテストします。それが使えて通常のブラウザーでは使えない場合は、ブラウザーがシステムプロキシを参照しているか、独自のプロキシ設定や例外がないか確認してください。明示的なリクエストも失敗する場合は、入口の状態とログを同じ時間帯で照合します。ログにリクエストが見えなくても、接続していないとは限りません。ログレベルによって該当イベントが記録されないことがあります。起動情報、リクエストのエラー、宛先の動作を合わせて判断してください。

{
  "log": {
    "loglevel": "info"
  }
}

特定の接続を調べる必要がある場合は、一時的にログの詳細度を上げられます。元のログ設定を置き換えず、既存のlogオブジェクトに統合してください。クライアントが設定を管理している場合は、クライアントのログ設定から変更します。問題を1度再現したら元のレベルに戻してください。ログには宛先ドメイン、アドレス、デバイスのパス、サーバー情報が含まれることがあります。共有する前に問題と無関係な記録を削除し、項目名、失敗した段階、必要な前後数行だけを残してください。

マッチングの異常、outboundの失敗、復元方法

接続できるのにルーティングが誤っていると思われる場合は、再現可能なリクエストを1つ使って調べます。どの入口から来たか、ドメインとアドレスのどちらが渡されたか、先に広いルールに一致していないか、実際に選択されたoutboundを記録してください。inboundタグが一致していない場合や、アプリが先にドメインを名前解決している場合は、ルール条件を満たさないことがあります。ログで正しいoutboundが選ばれたと確認できたら、マッチ条件の変更を続けず、出口のサーバー接続、プロトコル設定、宛先からの応答を調べてください。

特定のドメインだけ失敗する場合は、同じinboundからドメイン指定とアドレス指定のリクエストを比較できます。ただし、WebページのURLを単純にIPアドレスへ置き換えても、ホスト名や証明書の意味が変わるため、サイトが正常だとは判断できません。名前解決で想定したアドレスが返るか、現在の入力に基づいてルールが一致するか、正しいホスト名を維持したまま接続できるかをそれぞれ確認してください。ドメインの一群で異常が起きる場合は、サイトごとにルールを追加するのではなく、ドメイン分類のデータとDNSのグループ設定を確認します。

設定を戻すときは、エディターで最後に追加した行を削除するだけでなく、最後に実際の動作を確認できたファイルや画面設定に戻してください。ルールが外部データに依存する場合は、復元後の設定が現在のデータと互換性があるか確認します。クライアントのコアを変更した場合は、復元する項目を現在のコアが読み込めるかも確認してください。まず再起動してローカル待ち受けを検証し、元の比較リクエストを再試行してから、通常の利用方法に戻します。元の状態に戻らない場合は、以前と同じ設定元を使っているか確認してください。

PCでは正常でAndroidでは異常な場合、同じノードをインポートできたからといって、両方の端末で同じように動くとは限りません。使用中のコア、クライアントのルーティングモード、接続方法、それぞれのDNS設定を比べて、違いを1つずつ確認してください。同期ではまず接続情報を移し、移行先の端末でローカルの動作を設定し直します。操作方法は複数デバイス間の設定同期を参照し、移行の問題と個別のアクセス障害を分けて記録してください。

トラブル対処が終わったら、結果を説明できる変更だけを残します。一時的なテストルール、上げたログレベル、LAN待ち受けが元に戻っているか確認してください。デフォルトoutboundが想定どおりであることを確認し、最初に失敗したリクエストで再テストします。問題が解消しても原因を特定できていない場合は、故障の特定ではなく復旧した状態だと記録してください。再発時は記録した元の条件から再現します。再起動後に一度直ったからといって、再起動を繰り返すことを恒久的な対策にしないでください。