V2Ray設定JSONの構造を解説|inbounds・outbounds・routingの役割

V2Rayの設定JSONを項目ごとに解説。log、ローカル待ち受けのinbounds、freedom・blackholeなどのoutbounds、routingのルール適用順をサンプル付きで紹介します。

この記事の概要

v2rayNにサブスクリプションを読み込み、コアの設定を確認し始めた方向けの記事です。ローカルの入口と2つのoutboundsだけを使ったJSONで、ポートの設定場所、ルールからoutboundを参照する方法、ルールに一致しない場合の通信経路を解説します。サンプルにリモートノードは不要です。普段使いの設定にそのまま上書きしないでください。

トップレベルの構造:リクエストの入口から出口まで

アプリからのリクエストローカルのinboundルール判定outboundの選択

設定を読むときは、サブスクリプション内のサーバーアドレスではなく、まずアプリが実際に接続するアドレスとポートを確認します。アプリからリクエストを受け取った後、コアはリクエストに含まれる宛先情報を使ってルーティングを判定します。ルールでoutboundが選ばれ、そのoutboundが宛先への直接接続、リモートプロキシ経由の転送、またはリクエストの終了を決めます。

最小構成のJSON:2つのローカル入口と2つのoutbounds

以下はV2Ray v4形式のJSONフィールドを使った例です。SOCKSとHTTPの入口を分け、アプリごとに動作を確認しやすくしています。ポート番号は説明用の値で、v2rayNのデフォルト設定ではありません。ポートが使用中の場合は、設定とアプリ側の両方でポート番号を変更してください。

10808
SOCKSの待ち受けポート(例)
10809
HTTPの待ち受けポート(例)
2
outboundの数(例)
{
  "log": { "loglevel": "warning" },
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "tag": "local-socks",
      "settings": { "auth": "noauth", "udp": false }
    },
    {
      "listen": "127.0.0.1",
      "port": 10809,
      "protocol": "http",
      "tag": "local-http",
      "settings": {}
    }
  ],
  "outbounds": [
    { "protocol": "freedom", "tag": "direct", "settings": {} },
    { "protocol": "blackhole", "tag": "block", "settings": {} }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.org"],
        "outboundTag": "block"
      }
    ]
  }
}

この設定に含まれるルールは1つだけです。コアが受け取った宛先ドメインがexample.orgと完全一致した場合はblockを選び、それ以外のリクエストは先頭のoutboundであるdirectに送られます。DNSの振り分け、リモートノード、トラフィックのスニッフィングは含まれていません。JSONとして保存する際は、配列の最後の要素に末尾のカンマを付けず、コード内に説明用コメントを挿入しないでください。

inboundsとlog:アプリがコアに接続できているか確認する

listenは、コアが接続を受け付けるローカルアドレスを指定します。ここではループバックアドレス127.0.0.1を使用しており、このPC上のアプリからのみ接続できます。接続できないからといって、安易に0.0.0.0へ変更しないでください。待ち受け範囲が広がりますが、この例ではプロキシ認証を設定していません。

  1. 入口のプロトコルを確認します。 アプリでHTTPプロキシを選択した場合は127.0.0.1:10809、SOCKS5を選択した場合は127.0.0.1:10808を指定します。ローカル入口にHTTPを使っても、HTTPサイトにしかアクセスできないわけではありません。CONNECTに対応するアプリなら、この入口経由でHTTPSの宛先にもアクセスできます。この例ではSOCKS入口のUDPを無効にしています。
  2. テストに使うアプリがプロキシ設定に従っているか確認します。 システムプロキシは、その設定に対応したアプリに入口を提供するだけで、すべての通信がコアを通ることを保証するものではありません。検証には、プロキシを個別に指定できるアプリを使い、プロキシを経由しなかった通信結果をルーティングの結果と取り違えないようにしてください。
  3. コアのログを確認します。 warningは、警告以上の問題を記録する日常向けのログレベルです。問題の調査時は一時的にdebugへ変更し、設定を再読み込みして一度だけ再試行した後、元のレベルに戻してください。ポートのバインドに失敗した場合は、まず待ち受けポートの競合を解消します。ログにリクエストが記録されない場合も、それだけでinboundの失敗とは判断できません。ログレベルとアプリの設定も確認してください。

outbounds:プロトコルが動作を定義し、tagでルールから参照する

freedomは、コアから宛先へ直接接続します。接続はローカルネットワークや名前解決の結果にも左右されます。アプリがローカルプロキシを迂回するという意味ではありません。アプリからコアに渡されたリクエストを、コアがリモートプロキシへ転送せずに処理します。blackholeは、一致した通信を終了させます。アプリには接続の切断やリクエストの失敗が表示される場合があり、明確なブロック画面が表示されるとは限りません。

protocol
outboundの動作を決めます。サブスクリプションから生成されたリモートプロキシのoutboundでは、VMessが使われる場合があります。リモートアドレスとプロトコルのパラメーターはoutboundに属し、ローカルの待ち受け設定ではありません。プロトコル固有のsettingsをfreedomからそのまま流用することはできません。
tag
設定内で参照する名前です。directとblockはプロトコルのキーワードではありません。blockの名前を変更する場合は、それを参照するoutboundTagも合わせて変更し、outboundのtagが重複しないようにしてください。
配列の順序
どのルールにも一致しない場合は、先頭のoutboundがリクエストを受け取ります。この例でblackholeを先頭に移すと、本来は直接接続するはずの未一致リクエストも終了します。

routing:ルールの順番で判定し、精度の高い順には並べない

コアはrouting.rulesを上から順に確認し、条件を満たす最初のルールを適用します。同じルールにinboundTagとdomainの両方が設定されている場合は、両方に一致する必要があります。たとえば、サンプルのルールに"inboundTag": ["local-http"]を追加すると、同じドメイン宛てでもSOCKS入口からのリクエストはこのルールに一致しません。

コアが受け取った宛先一致するかサンプルのoutbound
example.orgドメイン全体に一致block
www.example.org不一致。サブドメインは完全一致しないdirect
example.com不一致direct
IPアドレス(文字列)不一致。サンプルでは宛先ドメインを復元しないdirect

ポイント:コアが受け取ったのがドメインかIPかを確認する

SOCKSでドメインルールをテストする場合は、宛先ドメインをSOCKS5プロキシに渡せるクライアント設定を選んでください。アプリがローカルで名前解決し、IPアドレスだけを渡している場合は、ルールを変更する前にテスト用の入口設定を見直します。AsIsはルーティング判定のためにドメインを能動的に名前解決せず、IPアドレスから元のドメインを逆引きする機能もありません。

ルートドメインとサブドメインの両方を対象にするには、domain:example.orgを使います。対象ドメインとすべてのサブドメインを直接接続に送る広いルールが先にある場合、後続のfull:example.orgによるブロックルールは実行されません。この例外を有効にするには、完全一致のドメインルールを広いルールより前に置いてください。

v2rayNの設定でよくある質問

JSONを手動編集したのに、ノードを切り替えると元に戻るのはなぜ?

まず、編集したのが独立した設定ファイルか、v2rayNが生成した実行用ファイルかを確認してください。生成ファイルは、ノードの切り替えやコアの再起動時に作り直される場合があります。通常のノードでルーティングを継続的に変更するには、クライアントのルーティング設定を使います。JSON全体を個別に検証する場合は、別ファイルに保存し、対応するコアで読み込んでください。

このJSONをサブスクリプションURLに直接入力できますか?

できません。サブスクリプションURLはノード一覧を取得するためのもので、この例はコアが読み込む設定オブジェクトです。使用中のノードの種類とコアを確認し、v2rayNでルーティングを調整するか、設定ファイルを個別に読み込むかを決めてください。異なるコアのフィールド名を同じものとして扱わないでください。

変更後、テスト用のドメインが2つとも開けません。まず何を確認すればよいですか?

まず、コアが設定を正常に読み込めているか確認します。次に、同じアプリと同じプロキシ入口を使ってexample.comをテストしてください。この宛先はdirectが選択されるはずですが、ローカルで名前解決でき、宛先へ接続できる必要があります。この比較用リクエストを確認してからexample.orgをテストします。2つのページがどちらも開けないというだけでは、ブロックが機能したとは判断できません。

v2rayN をダウンロード