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

V2Rayの設定ファイルをサンプルで解説。log、inbounds、outbounds、routing、dnsの各項目を読み解き、クライアントが出力したJSON全体を理解できます。

この記事のポイント

v2rayNが出力した設定を開いたら、まずローカルの待ち受けポートを確認し、ルールのタグをたどって実際の出力先を特定しましょう。直接接続と拒否を含むサンプルを使い、デフォルトの出力先の読み方、DNSとルーティングの問題の見分け方、クライアント設定の変更とコアのログ確認の判断方法を解説します。

V2RayのJSON設定例:まず通信の流れを確認

設定は、接続がたどる経路として読むと分かりやすくなります。inboundsはコアが接続を受け付ける場所、routingは接続の振り分け先、outboundsは接続を引き受けた後の処理を定義します。logとdnsは補助設定であり、すべての接続が順番に通る経路ではありません。

アプリからのリクエストローカルの受け入れ口ルーティング判定出力先での処理

ここではV2Fly V2Rayの従来のJSON形式を使います。サンプルにリモートアカウントやルールデータファイルは必要ありません。この経路を使うには、アプリからローカルのSOCKSポートへ接続する必要があります。コアを起動しただけでシステムプロキシが変更されることはありません。ポート番号は説明用で、v2rayNのデフォルト設定を示すものではありません。

{
  "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"},
    {"tag": "reject", "protocol": "blackhole"}
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "domain": ["full:example.org"],
        "outboundTag": "reject"
      }
    ]
  },
  "dns": {
    "servers": ["localhost"]
  }
}
10808
SOCKSの待ち受けポート(例)
2
出力先:直接接続と拒否
1
明示的なルーティングルール

クライアントに保存されたアプリ設定、サブスクリプションの内容、コア起動時に読み込まれるJSONは、それぞれ異なる階層のデータです。v2rayNがアクティブな設定の切り替え後にコア用ファイルを再生成すると、手動で加えた変更が上書きされることがあります。実際に読み込まれている設定を確認し、ファイル名だけで有効なJSONを判断しないでください。

inboundsとoutbounds:待ち受けアドレスと出力プロトコルを確認

アプリが接続できない場合は、まず入口を確認します。このサンプルが待ち受けるのはIPv4のループバックアドレス127.0.0.1だけです。アプリではSOCKS5を選び、同じポートをHTTPプロキシとして設定しないでください。noauthはSOCKS認証を要求しない設定であり、LANに直接公開する用途には適しません。udp: falseのため、このサンプルではSOCKS UDP転送を検証できません。

アプリ側:SOCKSの受け入れ口

listen
127.0.0.1
port
10808
protocol
socks
tag
local-socks

アプリが接続するのは待ち受けアドレスとポートであり、inboundのタグではありません。

コア側:直接接続の出力先

protocol
freedom
tag
direct
配列内の位置
outboundsの先頭項目

タグは参照用の名前です。実際の処理方法を決めるのはプロトコルとその設定です。

実際に出力された設定にvmessやvlessのoutboundがある場合は、アプリが接続するローカルポートと、outboundに設定されたリモートサーバーのポートを分けて確認してください。settingsの内容はプロトコルによって異なり、streamSettingsは通信方式とセキュリティ設定を定義します。リモート接続では、これらの設定を接続先と一致させる必要があります。outboundのプロトコル項目だけを変更し、別のoutboundの設定構造をそのまま流用しないでください。V2FlyとXrayでは対応する項目や値が異なる場合もあるため、実際に使うコアとバージョンを確認しましょう。

routing:ルールを順に照合し、該当しなければデフォルトの出力先へ

このサンプルの通常のoutboundルールは、配列の順に評価され、最初に一致したルールで接続先が決まります。1つのルール内では、inboundTagとdomainの両方が条件になります。outboundTagは一致した場合の処理先です。full:example.orgはそのドメイン自体だけに一致し、サブドメインは含みません。

コアが受け取った接続先サンプルでの結果判断の根拠
example.orgreject指定されたinboundから入り、ドメイン全体が一致します。
www.example.orgdirectサブドメインは完全一致の条件を満たさないため、先頭のoutboundに戻ります。
アプリが事前に名前解決した接続先IPアドレスdirectサンプルではスニッフィングを有効にしていないため、接続先IPアドレスだけではこのドメインルールに一致しません。

ルールが適用されない場合は、コアがドメイン名とIPアドレスのどちらを受け取ったか確認

ドメインルールをテストするときは、アプリからSOCKSリクエストをドメイン名で送信してください。アプリが先に名前解決し、コアにIPアドレスだけを渡している場合は、ルーティングルールを広げる前にテスト方法を見直しましょう。

複数のルールがある設定では、タグの綴りだけでなく、前にある大まかなルールがリクエストを先に拾っていないかも確認してください。たとえば、特定のinboundTagだけを条件とするルールが先にあると、その入口からの接続を先に処理し、後続のドメインルールが評価されないことがあります。どのルールにも一致しない場合、この例ではoutboundsの先頭項目が使われます。拒否用outboundを先頭に移すと、一致しなかった接続も拒否されます。

dns:ローカルの名前解決、ルーティング用の名前解決、outboundでの名前解決を区別する

dns.serversでは、コア内蔵のDNSモジュールが使う名前解決先を設定します。ここでのlocalhostは、ローカルのシステムの名前解決機能を使う指定です。ループバックアドレス上に別のDNSサーバーを起動するという意味ではなく、アプリのDNS通信を自動的に引き受けるものでもありません。このモジュールが使われるかどうかは、コアのルーティング設定とoutbound設定もあわせて確認してください。

問題を切り分ける際は、同じアプリ、同じ入口、同じテスト用ドメインを使ってください。失敗が名前解決の段階で起きているのか、outboundが選択された後なのかを確認します。ログにリクエストがrejectへ送られたと表示される場合は、DNSサーバーを変え続けるのではなく、ルーティングルールを見直してください。逆に、IPアドレスでアクセスできても、ドメイン名の名前解決が正常とは限らず、そのドメイン名でアクセスした際にTLS検証を通過するとも限りません。

logと設定のトラブル対処:起動エラーからルールの照合まで

サンプルではlog.loglevelをwarningに設定しています。警告やエラーを確認するのには適していますが、接続ごとのルーティングの詳細までは記録されません。さらに情報が必要な場合は、テスト用コピーで一時的にinfoへ変更し、再現後に元へ戻してください。コアのログには接続先ドメインやアドレス、接続時刻が含まれる場合があります。共有する前に機密情報を削除し、サブスクリプションのURLやアカウント情報も含めないでください。

  1. コアが起動しない:まず標準JSONの構文を確認します。オブジェクトのキーと文字列は二重引用符で囲み、最後の項目の後にカンマを付けないでください。次に、使用するプロトコル、通信方式、設定項目がコアでサポートされているか確認します。JSONとして読み込めても、コアが設定を適用できるとは限りません。
  2. 起動するが接続が拒否される:実際の待ち受けアドレス、ポート、プロキシの種類を確認してください。アドレスが使用中というログがある場合は、v2rayNの既存コアプロセスやほかのアプリがサンプルのポートを使用していないか確認します。ポートを変更するときは、コアとテスト用アプリの両方を変更してください。
  3. アプリの出力先が違う:アプリがこのSOCKS入口を実際に使っているか確認してから、rulesを1つずつ読み、inboundタグ、接続先の形式、outboundタグを照合してください。どのルールにも一致しない場合の出力先は、outbounds配列の先頭項目で確認できます。
  4. 保存した設定が元に戻る:変更したのがクライアントに保存される設定なのか、起動時に生成される一時ファイルなのかを確認してください。普段使うルーティングルールは、クライアントのルーティング設定で管理するのがおすすめです。テスト用JSONは別名で保存し、一度に1か所だけ変更してログで結果を確かめましょう。
v2rayN をダウンロードOSとインストーラーを選択