Shadowrocket 規則怎麼寫:DOMAIN-SUFFIX、GEOIP、IP-CIDR、FINAL 比對邏輯入門

認識 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 的比對方式、規則由上而下的命中順序,以及 PROXY、DIRECT、REJECT 的寫法。

本文速覽

先在 Home → Global Routing 選擇 Config,再檢查目前設定檔中的 [Rule]:規則會由上而下逐條檢查,命中第一條規則後即決定採用的策略。本文適合已有設定檔,想新增網域例外或排查分流結果的讀者。讀完後可依需求選擇規則類型、將範圍較窄的例外排在範圍較廣的規則之前,並以三組請求驗證分流結果。

規則語法:分開指定比對條件與策略

在 [Rule] 區段中,每行寫一條規則。一般規則依序填入類型、比對值和策略,欄位之間以英文逗號分隔;FINAL 不需要比對值,直接填入策略即可。網域規則只填主機名稱或比對片段,不要填 https://、連接埠或路徑。以下網域和位址僅示範寫法,不用來驗證連線是否可達。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example-test,REJECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
3 種
本文比較的網域比對類型
/24
保留 IPv4 位址的前 24 位元作為網段前綴
2 個欄位
FINAL 規則只填類型和策略

修改策略前,先確認是否命中規則

若要讓某個子網域直連,先確認請求的主機名稱,再將它的 DOMAIN 規則移到可涵蓋該網域的 DOMAIN-SUFFIX 規則之前。不要先改 FINAL:已被前面的規則選中的請求不會再套用到最後一條規則。

  • DIRECT:此請求直接連線至目標,不經由所選代理轉送。
  • PROXY:此請求經由代理轉送;測試前請在 Home 確認目前選取的代理。命中這條規則不代表代理可用,也不代表目標已回應。
  • REJECT:拒絕符合條件的請求。這不是將請求交由代理處理,也不是連線失敗後改用的路徑。

網域比對:DOMAIN、DOMAIN-SUFFIX 和 DOMAIN-KEYWORD

只處理特定主機名稱時,選用 DOMAIN;要涵蓋根網域及其子網域時,選用 DOMAIN-SUFFIX;只有確實需要比對多個網域中的相同字串時,才使用 DOMAIN-KEYWORD。後綴比對會依據網域標籤邊界判斷;關鍵字比對則不要求字串剛好佔據一個標籤。

條件符合範例不符合範例
DOMAIN,docs.example.comdocs.example.comcdn.docs.example.com、example.com
DOMAIN-SUFFIX,example.comexample.com、api.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,example-testcdn-example-test.example.netexampletest.example.net

表格僅判斷單一條件;實際採用的策略也取決於規則順序。範例中的 docs.example.com 同時符合前兩列條件,但精確規則先被檢查,因此採用 DIRECT。如果將後綴規則移到前面,同一主機就會採用 PROXY。Shadowrocket 不會先收集所有候選規則,再自動挑選最精確的一條。

位址比對:IP-CIDR、GEOIP 與 no-resolve

IP-CIDR 會依目標 IPv4 位址所屬的網段進行比對,適用於已知位址範圍的目標。GEOIP 則依據 IP 資料庫中的地區分類比對目標位址;GEOIP,CN,DIRECT 不是依網域是否以 .cn 結尾判斷,也不是依裝置所在的地區判斷。網域解析結果可能隨網路或時間而變動,因此若要固定特定服務的分流策略,建議優先使用已知的網域規則。

  • 192.0.2.0/24 的比對範圍是 192.0.2.0 至 192.0.2.255。例如,目標 IP 192.0.2.42 符合此網段,192.0.3.42 則不符合。若只要比對前一個位址,可寫成 192.0.2.42/32。
  • 網域請求遇到位址規則時,若尚未取得目標 IP,可能需要先解析網域。範例中的 no-resolve 表示不會為了判斷這條 IP-CIDR 規則而發起解析;若已取得目標 IP,仍可依該位址進行判斷。它不會禁止後續規則或實際連線所需的 DNS 解析。
  • IP-CIDR 中的這個 IPv4 網段無法涵蓋 IPv6。若同一主機在不同網路下的連線結果不同,請先確認連線實際使用的位址類型與目標 IP,再判斷是否因位址規則未命中。連接埠變更也不會影響這條網段規則的比對範圍。

將特定位址例外排在範圍較廣的 GEOIP 規則之前。若先寫 GEOIP,CN,DIRECT,屬於資料庫中 CN 分類的目標可能已採用 DIRECT,後面的網段例外便不會再檢查。末尾的 FINAL 只處理尚未命中規則的請求,不會在前面的連線逾時後重新分流。

在 Config 中驗證第一條命中的規則

修改規則前,先列出每個測試目標預期採用的策略。需要模擬特定例外時,請選擇自己確認能正常連線的目標;不要將文件專用保留網段當成可連線的服務。編輯前先保留原設定,避免同時變更規則順序和連線狀態這兩個因素。

  1. 確認設定檔

    進入 Config,確認目前使用的設定檔。若要測試 PROXY,也請在 Home 確認已選取自己持有且可用的代理。

  2. 儲存規則

    在目前設定檔的 [Rule] 區段加入一條精確例外,並將它排在可能涵蓋該目標的後綴、關鍵字或位址規則之前;FINAL 則保留在最後。

  3. 切換至 Config

    在 Home → Global Routing 選擇 Config。不要將 Proxy 或 Direct 模式下的結果當成規則驗證;如果原本使用 Scene,請先明確切換至 Config,排除場景選擇的影響。

  4. 發出新請求

    分別對精確例外、同一後綴下的另一個主機,以及不符合前面任何條件的目標發出請求。依本文範例,預期結果分別是 DIRECT、PROXY,以及由 FINAL 指定的 PROXY。若第三個目標先命中 GEOIP,請改用其他目標測試兜底規則。

  5. 比對結果

    查看新請求對應的連線記錄,確認實際主機名稱、策略及可見的比對資訊。如果頁面是從快取顯示,或沿用了舊連線,就無法據此判斷新規則是否生效;請結束舊連線後再測試。

規則未生效:區分策略、DNS 與連線錯誤

如果同一主機採用錯誤的策略,請先檢查目前啟用的設定檔、Global Routing 和規則順序;如果策略正確但請求失敗,再檢查 DNS 或連線。以下是 Chromium 瀏覽器可能顯示的錯誤原文,並非 Shadowrocket 的規則驗證提示。僅憑瀏覽器錯誤訊息,無法判定是哪一條規則造成問題。

錯誤:ERR_NAME_NOT_RESOLVED

原因:瀏覽器無法取得該請求網域的有效解析結果。解決方法:先確認請求中的主機名稱是否拼錯,再檢查目前的解析設定;不要先將 FINAL 改成其他策略來驗證拼字或 DNS。

錯誤:ERR_CONNECTION_TIMED_OUT

原因:連線未能在等待時間內建立,目標或目前的轉送路徑可能沒有回應。解決方法:先確認新請求是否採用預期策略,再以相同策略測試已知可連線的目標,以判斷是單一目標逾時,還是整條路徑無法使用。

如果兩個目標最後都採用 PROXY,光看策略名稱無法分辨是命中後綴規則,還是由 FINAL 兜底。請優先查看記錄中的比對資訊;若目前記錄沒有顯示具體規則,可在測試用副本中只調整待驗證的規則,對可自行控制的測試目標發出新請求,比較調整前後的策略,再還原原設定。

免費下載 Shadowrocket