自訂路由規則完整解析:domain、ip、geosite 語法與比對優先順序

解析 domain、full、regexp、ip、geosite 與 geoip 的寫法,說明規則由上而下比對的順序及常見衝突的處理方式。

本文重點

本文適合需要在 v2rayN 調整分流,或直接閱讀 Xray、V2Fly 設定檔的讀者。先釐清網域、目的 IP 與資料集的差異,再透過可逐條檢視的設定,確認例外規則、出站標籤與 DNS 解析時機。即使測試網站無法開啟,也能先從記錄判斷請求實際使用了哪個出站。

domain、full、regexp:網域規則的比對範圍

在核心 JSON 中,domain 是規則欄位,domain: 則是該欄位的一種比對前綴。網域欄位比對的是主機名稱,不是完整網址。設定時請移除 https://、連接埠、路徑與查詢參數;同一主機上的不同頁面無法透過這類規則分流。

domain:網域及子網域

建議

domain:example.com 會比對 example.com 和 api.example.com,但不會比對 notexample.com。比對邊界依據網域標籤,而非任意字串後綴。

適用情境:整個網站及其子網域使用同一個出站

full:指定主機

full:api.example.com 只會比對這個主機名稱,不包含 example.com,也不包含 v2.api.example.com。若只需單獨處理一個主機,不必為此撰寫正規表示式。

適用情境:為登入、API 或靜態資源主機設定例外

regexp:主機名稱模式

正規表示式 ^img[0-9]+\.example\.com$ 會比對 img1.example.com,但不會比對 img.example.com;寫入 JSON 時,每個反斜線都要寫成兩個,例如 "regexp:^img[0-9]+\\.example\\.com$"。

適用情境:多個主機遵循固定編號模式,但不應涵蓋整個網域

核心 JSON 中的裸字串 example.com 會以子字串方式比對,因此也可能涵蓋 notexample.com。排查規則範圍過寬時,先確認是否漏了前綴,再檢查正規表示式是否缺少首尾錨點,或將句點誤當成萬用字元。使用用戶端編輯器時,也要確認匯出的核心設定與預期輸入一致。

ip、geosite、geoip:地址與資料集的差異

ip 比對請求的目的 IP,而非節點伺服器地址。若要依來源區分流量,不能重複使用這個欄位。geosite: 仍放在 domain 陣列中;只有 geoip: 放在 ip 陣列中。這兩種前綴都引用本機資料檔中的分類,不會發出線上查詢。

項目核心寫法比對依據
單一地址"ip": ["192.0.2.10"]只檢查一個目的地址,適合核對單筆地址規則。
CIDR 網段"ip": ["192.0.2.0/24", "2001:db8::/32"]這些前綴分別涵蓋 IPv4 與 IPv6 文件範例地址區段;實際策略應替換為對應網段。
網域集合"domain": ["geosite:cn"]依據 geosite.dat 中的項目比對,不等同於比對所有以 .cn 結尾的網域。
地址集合"ip": ["geoip:cn"]檢查目的 IP 是否落在 geoip.dat 對應分類的位址範圍內。

資料檔版本或來源不同,分類名稱與集合內容也可能不同。匯入規則後,若核心提示無法載入分類,請先確認實際載入的檔案與分類名稱,而不是調整規則順序。網域屬於某個網站集合,不代表它目前解析出的地址也屬於同名 IP 集合;CDN、雙協定堆疊與解析結果變動都可能造成差異。

比對優先順序:例外規則在前,廣泛規則在後

routing.rules 會由上而下檢查,符合第一條規則後便選定出站。full: 不會因為比 domain: 更精確就自動優先;同一條規則中的 domain、ip 等不同條件欄位必須同時符合。同一個 domain 陣列中的多個項目則符合任一項即可。若要表示「指定網域或指定 IP」,應拆成兩條指向同一出站的規則。

以下 Xray 設定使用本機 SOCKS 入站。direct、reject 是自訂出站標籤,分別對應 freedom 和 blackhole。這些標籤不是協定名稱,也不能直接以節點顯示名稱取代。範例使用保留網域與文件範例地址,不依賴訂閱或地區資料檔。

{
  "log": {"loglevel": "info"},
  "inbounds": [
    {
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {"auth": "noauth", "udp": true}
    }
  ],
  "outbounds": [
    {"tag": "direct", "protocol": "freedom"},
    {"tag": "reject", "protocol": "blackhole"}
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {"type": "field", "domain": ["full:api.example.com"], "outboundTag": "direct"},
      {"type": "field", "domain": ["domain:example.com"], "outboundTag": "reject"},
      {"type": "field", "ip": ["192.0.2.0/24"], "outboundTag": "reject"},
      {"type": "field", "network": "tcp,udp", "outboundTag": "direct"}
    ]
  }
}
10808
範例 SOCKS 入站連接埠
4 條
範例規則總數,包含最後的兜底規則
192.0.2.10
符合第三條的文件範例地址

結論:用兩個目標檢查規則是否被遮蔽

新增例外後,請同時測試例外主機與同網域的一般主機。確認兩者依預期使用不同出站後,再加入範圍較大的地區規則;若兩者使用同一個出站,先檢查上方是否已有涵蓋範圍更大的規則。

domainStrategy:網域何時參與 IP 比對

對字面 IP 請求,核心可以直接比對地址;對包含網域的請求,路由階段是否需要解析,取決於 routing.domainStrategy。這與選定出站後為建立連線而進行的 DNS 查詢是兩回事。修改路由策略不代表更換 DNS 伺服器,也不保證用戶端會將網域交給核心處理。

若要讓網域規則優先,並讓未符合的網域再嘗試地址規則,可使用 IPIfNonMatch,移除會提早符合的最後一條通用規則,並將預期的預設出站放在 outbounds 第一個。修改前後都要分別測試網域輸入與字面 IP 輸入;若應用程式在進入核心前就已解析網域,調整此項設定無法從 IP 還原原始主機名稱。

v2rayN 路由設定:儲存、切換與驗證

以下以桌面版 v2rayN 的 Xray 路由設定為例。不同版本的編輯視窗與啟用控制項可能有所差異;上文的完整 JSON 僅供獨立示範,請勿整段貼入單筆規則的網域欄位,也不要直接覆蓋既有訂閱產生的設定。

  1. 保留原有設定

    在主視窗進入「設定」→「路由設定」,先記下目前啟用的設定檔與原有規則順序。修改既有設定檔前,請保留原規則副本;測試失敗時先切回原設定檔,不必重新匯入訂閱。

  2. 分別填寫條件

    在待測設定檔的規則編輯畫面中,將 full:api.example.com 和 domain:example.com 分成兩條,放在網域欄位而非 IP 欄位。為兩條規則選擇不同出站,並將單一主機例外排在整個網域規則之前。

  3. 啟用待測設定檔

    儲存後,請確認目前啟用的是待測設定檔,而不只是開啟過編輯視窗。若規則由 v2rayN 產生,請使用介面提供的出站選項,不要照抄範例中的 reject 標籤;手動編輯設定時,則要確認 outboundTag 確實存在。

  4. 比對核心記錄

    使用本機實際的 SOCKS 連接埠發出兩次獨立請求。範例連接埠為 10808;若使用 curl,可執行 curl --proxy socks5h://127.0.0.1:10808 --max-time 5 https://api.example.com/,再將目標改為 img.example.com。請查看核心存取記錄中的目標與出站,不要以文件範例網域的網頁能否開啟,作為規則符合的判斷依據。

常見衝突:規則正確,出站卻不如預期

為什麼新增 full 規則後,仍然走整個網域的規則?

將單一主機規則移到整個網域規則上方,同時確認前面是否已有涵蓋該主機的 geosite: 規則。儲存並啟用正確的設定檔後,發起新連線,分別確認例外主機與同網域一般主機使用的出站。

直接輸入 IP 可以符合規則,換成網域就不行?

先查看記錄,確認核心收到的是網域還是 IP。若收到網域,請檢查 domainStrategy;若已使用 IPIfNonMatch,再確認第一輪是否被兜底規則或其他網域規則攔截。若收到 IP,請確認地址是否確實落在網段內,尤其不要拿 IPv6 地址與 IPv4 網段比較。

複製 geosite 規則後,核心為什麼無法啟動?

先查看啟動記錄,分辨是找不到資料檔,還是找不到集合名稱。請確認目前核心實際使用的 geosite.dat,不要檢查其他設定目錄中同名的檔案。也可以暫時將集合替換成用途相同的明確網域規則,以確認出站與規則順序是否正常。

為什麼瀏覽器與命令列的結果不同?

先確認兩者確實使用同一個本機入站。使用 socks5h 測試時,curl 會將網域交給 SOCKS 代理;瀏覽器可能採用不同的代理設定、直接連線,或重用既有連線。請建立新請求,並依記錄中的目標與時間核對,避免將舊連線誤認為新規則的測試結果。

下載v2rayN