V2Ray 自訂路由規則設定:domain、ip、geosite 語法與匹配順序

整理 domain、full、regexp、geosite、ip 與 geoip 的寫法差異,說明規則由上而下匹配的優先順序,以及 domainStrategy 的影響。

本文重點

適合使用 v2rayN 調整分流,或直接維護 V2Ray、Xray 設定檔的讀者。先釐清網域條件與 IP 條件,再用一組可逐步推演的規則確認順序,最後判斷問題出在匹配範圍、DNS 解析,還是目前載入的設定。

網域規則:單一主機、網域樹與分類清單

在 V2Ray、Xray 的欄位規則中,網域條件寫在 domain 陣列裡。陣列名稱和項目前綴都可能是 domain,但代表的意思不同:前者指定條件類型,後者指定匹配方式。不要貼上完整網址;路由匹配的目標名稱不包含 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 中要用兩個反斜線表示正規表示式中的一個反斜線,避免將句點誤寫成可匹配任意字元。

適用情境:主機名稱較多,但有明確編號等規則。

geosite:引用網域分類

geosite:cn 會引用目前網域資料檔中的 cn 分類,並非匹配所有以 .cn 結尾的名稱。分類是否存在及包含哪些項目,取決於實際載入的資料。

適用情境:依現有資料集管理一批網站。

同一個 domain 陣列中的項目是擇一匹配,不是依序執行的出站動作。若要讓同一網站的兩個主機走不同出站,必須分別建立規則,而不是把它們放在同一個陣列中,期待依序生效。

IP 規則:單一位址、CIDR 與 GeoIP 分類

ip 陣列會匹配目標 IP。若連線目標本身就是 IP,不需要先解析網域;若連線目標是名稱,能否使用解析結果進行 IP 匹配,則取決於路由策略。以下數字是範例網段的前綴長度,不是測速結果。

/32
IPv4 單一位址前綴
/24
IPv4 範例網段前綴
/128
IPv6 單一位址前綴

結論:先將分類問題縮小為一條規則

分類更新後,若某個網站改走其他出站,先用 full: 比對該主機名稱,或用單一位址前綴比對實際目標 IP,每次只驗證一種條件。確認暫時加入的規則能匹配後,再檢查分類檔案和類別,不必先重新排列整份規則清單。

生效順序:先匹配到哪條,就採用哪條

路由會依 rules 陣列由上而下檢查,採用第一條匹配的規則。full: 不會因為比 domain: 更精確,就自動排到前面。同一條欄位規則若同時填入 domain 和 ip,兩項條件都必須符合;若要表達「網域或 IP 匹配時走同一出站」,應拆成兩條規則。

{
  "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 常見的中文介面為例;不同小版本的選單位置可能略有差異。內建路由方案會由用戶端產生核心設定;完整的自訂設定則應以實際載入的檔案為準。修改前請先保留一份原方案,方便逐項比對。

  1. 確認核心

    前往「設定」→「參數設定」查看核心相關選項,再確認目前伺服器項目及啟動記錄中實際使用的核心。預設核心選項不能取代這項確認;伺服器項目指定的核心或自訂設定可能不同。本文的 JSON 採用 V2Ray、Xray 格式,不能直接套用於使用其他設定格式的核心。

  2. 編輯目前方案

    前往「設定」→「路由設定」確認目前啟用的方案,並在對應的規則清單中檢查順序與出站。先用一條精確的主機規則進行驗證,暫時不要同時修改 DNS、分類資料和預設出站,否則結果改變時很難判斷是哪個設定造成的。

  3. 確認設定已載入

    儲存並套用規則,必要時重新啟動核心。先查看是否出現設定解析錯誤、分類缺漏或出站標籤不一致等提示。使用自訂設定時,尤其要確認編輯的是目前項目載入的檔案,而非舊的匯出副本。

  4. 建立新連線進行驗證

    中斷舊連線後重新發送請求,查看記錄中可取得的目標與出站資訊。應用程式可能會重用連線,也可能先自行解析,再將 IP 傳給入站端;這種情況下,網域規則未匹配不代表規則順序錯誤。請先確認流量確實進入核心,再確認路由看到的是名稱還是位址。

需要核對完整欄位時,可參閱路由設定參考與DNS 設定參考。若只有部分應用程式的表現不同,先比較它們的連線方式與目標位址形式,再決定是否調整網域策略。

下載v2rayN查看平台與安裝套件