V2Rayのカスタムルーティング設定|domain・ip・geositeの書き方とルールの優先順位

domain、full、regexp、geosite、ip、geoipの書き方を解説。ルールの上から順に判定される仕組みと、domainStrategyによる違いも説明します。

この記事の概要

v2rayNでルーティングを調整している方や、V2Ray・Xrayの設定を直接管理している方向けです。まずドメイン条件とIP条件を整理し、具体的なルールで判定順を確認します。最後に、原因がマッチ範囲、DNS解決、設定の未読み込みのどれかを切り分けます。

ドメインルール:ホスト単位・ドメイン配下・カテゴリ

V2RayやXrayのフィールドルールでは、ドメイン条件をdomain配列に記述します。配列名と各項目のプレフィックスには、どちらもdomainを使えますが、意味は異なります。前者は条件の種類、後者はマッチ方法を指定します。URL全体を貼り付けないでください。ルーティング対象の名前にhttps://、ポート、ページのパスは含まれません。

domain:ドメインとそのサブドメイン

おすすめ

domain:example.comはexample.comとimg.example.comにマッチしますが、notexample.comにはマッチしません。プレフィックスを省略してexample.comと書くと部分一致になり、後者も対象になる可能性があります。

用途:特定のサイトとそのサブドメインをまとめて振り分ける場合。

full:完全一致のホスト名

full:api.example.comはこのホスト名だけにマッチし、ルートドメインやv2.api.example.comにはマッチしません。広いルールから特定のホストだけを例外として切り分ける場合に便利です。

用途:個別のAPI、テスト環境、特定のホスト。

regexp:ホスト名のパターンでマッチ

JSON配列の項目"regexp:^img[0-9]+\\.example\\.com$"は、img12.example.comのようなホスト名にマッチします。先頭と末尾のアンカーで文字列全体を対象にします。JSONでは正規表現のバックスラッシュ1つを2つで表し、ドットが任意の1文字として解釈されるのを防ぎます。

用途:番号などの規則は明確でも、対象ホストが多い場合。

geosite:ドメインカテゴリを参照

geosite:cnは、現在のドメインデータファイルにあるcnカテゴリを参照します。末尾が.cnの名前すべてにマッチするわけではありません。カテゴリの有無や収録項目は、実際に読み込まれているデータによって決まります。

用途:既存のデータセットを使って複数のサイトを管理する場合。

1つのdomain配列内の項目は、いずれかにマッチする条件であり、順に実行される出力アクションではありません。同じサイトの2つのホストを別々の出力先に振り分ける場合は、1つの配列にまとめず、ルールを分けてください。

IPルール:単一アドレス・CIDR・GeoIPカテゴリ

ip配列は宛先IPにマッチします。接続先が最初からIPアドレスなら、事前のドメイン解決は不要です。接続先がホスト名の場合、解決結果を使ってIPマッチングできるかはルーティングポリシーによります。以下の数値はサンプルネットワークのプレフィックス長であり、速度測定の結果ではありません。

/32
IPv4の単一アドレス用プレフィックス
/24
IPv4のサンプルネットワーク用プレフィックス
/128
IPv6の単一アドレス用プレフィックス

ポイント:まず分類の問題を1つのルールで切り分ける

カテゴリの更新後に特定サイトの出力先が変わった場合は、full:でホスト名を照合するか、単一アドレス用プレフィックスで実際の宛先IPを照合します。一度に検証する条件は1つだけにしてください。一時ルールでマッチすることを確認してから、カテゴリファイルとカテゴリの内容を調べればよく、最初にルール全体の順序を変える必要はありません。

ルールの優先順位:最初にマッチしたルールを適用

ルーティングはrules配列を上から順に確認し、最初にマッチしたルールを適用します。full:はdomain:より具体的だからといって、自動的に前へ移動するわけではありません。1つのフィールドルールにdomainとipの両方を指定した場合、両方の条件を満たす必要があります。「ドメインまたはIPのどちらかにマッチしたら同じ出力先にする」には、ルールを2つに分けます。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:api.example.com"],
        "outboundTag": "proxy"
      },
      {
        "type": "field",
        "domain": ["domain:example.com"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["192.0.2.0/24"],
        "outboundTag": "direct"
      }
    ]
  }
}

これはルーティング部分の例であり、実行可能な完全設定ではありません。proxyとdirectは、現在のoutboundsにあるタグと一致させる必要があります。タグを記述しても、プロキシや直接接続の出力先が自動作成されるわけではありません。サンプルのドメインとネットワークはマッチ判定の説明用であり、サービスの稼働確認には使えません。

domainStrategy:ドメインをIPマッチングに使うタイミング

routing.domainStrategyは、ルーティング時にマッチングのために宛先名を解決するかどうかを制御します。直接接続時の発信方法や、アプリ自体のDNS設定とは別のものです。DNSリクエストが見えても、それだけでIPルールにマッチしたとは判断できません。

戦略名前解決のタイミングルールの優先順位への影響
AsIsマッチングのために宛先名を積極的に解決しません。ドメインは名前で判定し、最初からIPアドレスで指定された宛先はIP条件にマッチします。
IPIfNonMatch最初の判定でマッチしなかった場合、ドメインを解決してから再度マッチングします。最初の判定でドメイン条件や汎用フォールバックにマッチした場合、その後IPマッチングのために再判定は行われません。
IPOnDemand宛先IPが必要な条件に遭遇した場合に、必要に応じて名前解決します。上位にあるIPルールは、名前解決の結果を使って下位のドメインルールより先にマッチすることがあります。

たとえば、ドメインで明確に分類できないリクエストをIPカテゴリで振り分ける場合、IPIfNonMatchでは、テスト対象の通信すべてを拾うルールが末尾にないか特に確認してください。最初の判定でフォールバックにマッチすると、IPルールをその前に移動しただけでは再判定されません。要件に応じて必要時に解決する方式へ変更するか、最初の判定でフォールバックがマッチングを終了させないようにし、既定の出力先も確認してください。

v2rayNの確認手順:現在の設定から新しい接続まで

以下では、v2rayN 7.xでよく使われる日本語UIを例にします。マイナーバージョンによって項目の場所が異なる場合があります。内蔵ルーティング設定ではクライアントがコア設定を生成します。完全なカスタム設定を使う場合は、実際に読み込まれているファイルを確認してください。変更前に現在の設定を保存しておくと、条件を1つずつ変えて比較できます。

  1. コアを確認

    「設定」→「パラメータ設定」からコア関連の項目を確認し、現在のサーバー設定と起動ログに表示される実際のコアも確認します。既定のコア設定を確認するだけでは不十分です。サーバー設定で指定されたコアやカスタム設定では、異なる場合があります。この記事のJSONはV2Ray・Xray形式です。設定形式が異なるコアには、そのまま適用できません。

  2. 現在の設定を編集

    「設定」→「ルーティング設定」で有効な設定を確認し、該当するルール一覧で順序と出力先をチェックします。まずはホストを正確に指定するルールを1つ使って検証してください。DNS、カテゴリデータ、既定の出力先を同時に変更すると、結果が変わったときに原因を特定しにくくなります。

  3. 設定の読み込みを確認

    ルールを保存して適用し、必要に応じてコアを再起動します。設定の解析エラー、カテゴリの不足、出力先タグの不一致に関する警告がないか確認してください。カスタム設定では特に、古いエクスポートのコピーではなく、現在の設定項目が読み込んでいるファイルを編集したか確認します。

  4. 新しい接続で検証

    既存の接続を切断してからリクエストを再送し、ログで確認できる宛先と出力先を確認します。アプリが接続を再利用したり、先に独自で名前解決してIPをインバウンドに渡したりする場合があります。その場合、ドメインルールにマッチしなくても、ルールの順序が誤っているとは限りません。まず通信が確実にコアへ届いていることを確認し、次にルーティングが認識している宛先が名前かアドレスかを調べます。

設定項目をまとめて確認する場合は、ルーティング設定リファレンスとDNS設定リファレンスをご覧ください。一部のアプリだけ動作が異なる場合は、まず接続方法と宛先アドレスの形式を比較してから、ドメイン戦略を変更するか検討してください。

v2rayNをダウンロード対応環境とインストーラーを確認