V2Ray設定ファイルのJSON構造を解説|inbounds・outbounds・routingの読み方

V2Ray設定ファイルのlog、inbounds、outbounds、routing、dnsを順に解説。tagの関連付けやルールの適用順、代表的なフィールドをサンプル付きで紹介します。

この記事の概要

クライアントが生成したJSONを確認するときは、まずリクエストを受け取る箇所、経路を選ぶ箇所、接続を確立する箇所を把握しましょう。この記事では、ローカルのSOCKS・HTTPインバウンドを例に、タグとルールのつながりを解説します。また、ルーティング時の名前解決、アウトバウンド時の名前解決、アプリ側での名前解決の違いも整理します。ポート番号は説明用で、クライアントの初期値ではありません。

log:ログと設定の基本構造

最上位はJSONオブジェクトです。この記事では、log、routing、dnsはオブジェクト、inboundsとoutboundsは配列です。要素が1つでも角括弧は省略しません。最上位のキーの順序でリクエストの経路は変わりませんが、配列内の順序は重要な場合があります。ルールは記述順に評価され、該当するルールがない場合、通常は最初のアウトバウンドが使われます。

アプリからのリクエストローカルインバウンドルール照合アウトバウンド選択宛先への接続
{
  "log": {
    "loglevel": "warning"
  }
}

これはログ設定の一部です。トラブルシューティングでは、一時的にloglevelをinfoに変更し、設定を再読み込みして同じアプリで問題を再現してください。必要な記録が取れたらwarningに戻します。accessとerrorでは、それぞれのログの出力先ファイルを指定できます。ただし、設定を読み込めてもログ保存先に書き込めるとは限りません。起動時に問題が発生する場合は、アクセスログを待つだけでなく、クライアントや起動プロセスのメッセージを確認してください。ログを共有する前に、サブスクリプションURL、認証情報、公開に適さない接続記録を伏せてください。

inbounds:リッスンアドレス・ローカルポート・タグ

インバウンドのlistenとportで、待ち受けるアドレスとポートを指定します。protocolはアプリが使用するプロキシプロトコルを決め、settingsはそのプロトコルに応じて解釈されます。アプリのHTTPプロキシにSOCKSのポートを指定すると、ポートが待ち受け中でも、期待するプロトコルのハンドシェイクは完了しません。以下の2つはどちらもローカルのループバックアドレスのみで待ち受け、LANには公開しません。

10808
SOCKSの待ち受けポート(例)
10809
HTTPの待ち受けポート(例)

SOCKSインバウンド

listen
127.0.0.1
port
10808
protocol
socks
tag
local-socks

アプリのSOCKSプロキシ設定にこのポートを入力します。

HTTPインバウンド

listen
127.0.0.1
port
10809
protocol
http
tag
local-http

アプリのHTTPプロキシ設定にこのポートを入力します。

ルーティングを変える前に待ち受けを確認

ローカルポートへの接続が拒否される場合は、まずコアが起動しているか、ポートが他のプロセスに使用されていないか、アプリに設定したアドレスが実際の待ち受けアドレスと一致しているかを確認してください。リクエストがまだコアに届いていないため、ルーティングルールの優先順位を上げても効果はありません。

outbounds:プロトコルとデフォルト経路

アウトバウンドのprotocolで、受け取った宛先への接続をどのように処理するかを指定します。freedomは直接接続、blackholeは通信の遮断に使います。tagは設定内で参照するための名前であり、プロトコル名ではありません。タグをdirectにしても自動的に直接接続になるわけではなく、動作を決めるのは同じ項目内のprotocolです。

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

routing:タグの関連付けとルールの適用順

routing.rulesは上から順に評価され、最初に一致したルールで接続先が決まります。ルール内のinboundTagはインバウンドタグの配列、outboundTagはアウトバウンドタグを示す文字列です。複数の条件フィールドを指定した場合、リクエストはすべての条件を満たす必要があります。以下の1つ目のルールは、SOCKSインバウンドから入り、宛先ドメインが正確にexample.orgと一致するリクエストだけを遮断します。2つ目のルールでは、残りのSOCKSリクエストを直接接続します。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "blocked"
      },
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "outboundTag": "direct"
      }
    ]
  }
}
接続方法コアが受け取った宛先想定されるアウトバウンド
SOCKSexample.org1つ目のルール:blocked
SOCKSwww.example.org2つ目のルール:direct
HTTPexample.org一致するルールがない場合:最初のアウトバウンドdirect

2つのルールを入れ替えると、もとの2つ目のルールがすべてのSOCKSリクエストに先に一致し、ドメインを指定したルールは適用されません。アウトバウンドを入れ替えてもルールの順序を維持すれば、タグを明示したリクエストの経路は変わりません。ただし、ルールに一致しないHTTPリクエストは、新たに先頭になったアウトバウンドを使います。意図しない振り分けを調べる際は、2つの配列の順序をそれぞれ確認してください。デフォルトのアウトバウンドと最後のルーティングルールを混同しないようにしましょう。

dns:ルーティング時とアプリ側の名前解決

最上位のdnsはコア内蔵DNSの設定であり、OS全体のDNS設定ではありません。dns.serversを追加しただけでは、すべてのアプリのDNS問い合わせが自動的にコア経由になるわけではありません。アプリが先にドメインを名前解決し、宛先IPだけをプロキシに渡す場合、ルーティング側でそのIPから元のドメインを特定することはできません。ほかにドメイン情報がなければ、上記のドメイン完全一致条件には一致しません。

{
  "dns": {
    "servers": ["localhost"]
  }
}

ここではlocalhostを使ってローカルの名前解決機能を呼び出し、システムに設定済みの名前解決方法を利用します。ローカルポートでDNSサーバーを起動するという意味ではなく、最終的にどのアウトバウンドを使うかを決めるものでもありません。ドメインルールを確認する場合は、テストリクエストがドメイン名のままインバウンドに渡されているのか、アプリ側ですでにIPアドレスに変換されているのかを確認してください。

設定のトラブルシューティング:起動・インバウンド・ルーティング・アウトバウンドの順に確認

  1. 実際に読み込まれているファイルを確認します。 厳密なJSONではキーと文字列を二重引用符で囲み、最後の要素に末尾のカンマを付けません。上のコード例はそれぞれ異なる最上位フィールドを示しており、複数のルートオブジェクトをそのまま連結することはできません。エラーが特定のフィールドを示している場合は、JSONとして正しくても、そのフィールドの型とコアの対応状況を確認してください。
  2. コアとクライアントの設定範囲を確認します。 v2rayNのデスクトップ版では、「設定」→「パラメータ設定」からローカルの待ち受け設定を確認できます。項目の分類はバージョンによって異なります。Android版v2rayNGはXrayコア、v2flyNGはV2Flyコアを使用します。基本フィールドが似ていても、拡張フィールドを共通で使えるとは限りません。また、AndroidでVPN経由の通信制御が適用される範囲を、デスクトップOSのプロキシ設定から推測することはできません。
  3. 同じテストアプリで、一度に1項目だけ変更します。 まず正しいポートで通常のリクエストを確認し、次に遮断対象をテストします。アプリをHTTPプロキシに切り替えて結果が変わった場合は、インバウンドタグを確認してください。同じインバウンドでドメイン名とIPアドレスのリクエスト結果が異なる場合は、アプリからコアへどちらの形式の宛先が渡されているかを確認します。
  4. 最後にアウトバウンド接続を確認します。 想定したタグに一致しても、経路が選択されたことを示すだけで、宛先に接続できるとは限りません。直接接続に失敗する場合は、ローカルの名前解決と宛先への到達性を確認してください。リモートアウトバウンドに失敗する場合は、リモートポート、プロトコルの設定、通信方式を確認します。一度に1か所だけ変更し、設定を再読み込みして同じテストを繰り返すことで、どの変更が結果に影響したか特定できます。
クライアントをダウンロードプラットフォームに合わせて v2rayN / v2rayNG を選択