Shadowrocket 自訂規則寫法與比對優先順序:由上而下比對與 FINAL 預設規則

說明規則如何由上而下逐條比對、命中後停止,PROXY、DIRECT、REJECT 三種策略有何不同,以及 FINAL 為何應放在最後。

本文重點

本文適合已匯入自己的服務資訊,並準備在 Shadowrocket(小火箭)中調整分流的使用者。請先確認 Home → Global Routing 使用 Config,再了解規則順序、網域與 IP 條件及 FINAL 的位置,最後用單一請求確認實際命中的規則。範例網域與位址僅用於說明語法,不能當作可用的服務資訊。

先確認是否啟用 Config 分流

將規則寫入檔案,不代表規則已套用到目前的連線。Home 管理連線與服務選擇,Config 管理設定檔,Settings 管理 App 設定。排查前,請分別確認「目前啟用哪個設定檔」和「目前使用哪種 Global Routing 模式」,不要只看檔案中是否有剛新增的規則。

Global Routing 中的 Proxy、Direct、Config、Scene 是連線採用的運作模式;規則列中的大寫 PROXY、DIRECT、REJECT 則是比對成功後採用的策略。兩組詞代表不同層級。本文討論 Config 模式下,目前生效設定檔中 Rule 清單的順序。

Global Routing檢查重點與本文規則的關聯
Config確認 Config 中目前啟用的檔案依設定檔中的規則進行分流,是本文驗證時使用的模式。
Proxy確認目前選取的代理服務可用以代理模式處理連線,無法用來驗證完整的 Config 分流順序。
Direct確認裝置目前的網路是否能直接連線至目標以直連模式處理連線,不能用來驗證規則中的 PROXY 是否命中。
Scene檢查目前生效的場景及其設定先確認場景實際採用的行為,再分析設定規則;不能只看 Scene 名稱就推斷結果。

Settings → On Demand 負責處理隨選連線條件,不會將某條網域規則移到另一條規則之前。測試期間應維持連線狀態穩定,避免網路切換觸發連線變化,導致誤以為規則未生效。

比對優先順序:命中第一條規則後即停止

Rule 清單並非依照「網域一定優先於 IP」或「規則越長就自動優先」排序。對於能判斷比對條件的請求,Shadowrocket 會由上而下檢查規則,命中第一條後便採用該列策略,後續的一般規則不會再覆蓋結果。因此,特定例外通常要放在範圍較廣的條件之前。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

請求網域為 api.example.com 時,第一條網域規則已命中,結果為 DIRECT。存取 www.example.com 時,第一條不符合,第二條後綴規則命中,結果為 PROXY。存取 example.net 且前面的規則都未命中時,才會套用 FINAL。

3 種策略
本文說明 PROXY、DIRECT、REJECT
4 類關鍵字
重點檢查 DOMAIN-SUFFIX、GEOIP、IP-CIDR、FINAL
最後 1 條
精簡設定保留一條 FINAL 作為預設規則

如果將範例中的第二行移到第一行之前,api.example.com 也會先命中後綴規則,後面的精確網域規則就不會生效。這是「規則已存在卻沒有作用」的常見原因:不是語法錯誤,而是請求已被上方條件攔截。

規則寫法:網域、位址範圍與地區條件

一般規則通常依「類型、比對內容、策略」的順序撰寫,以英文逗號分隔,每行一條。請勿使用全形逗號,也不要在同一個比對欄位中以空格塞入多個網域。FINAL 是例外,不含網域或位址條件,後面直接接策略。

網域與預設規則

DOMAIN
api.example.com,DIRECT
DOMAIN-SUFFIX
example.com,PROXY
FINAL
PROXY

以上說明關鍵字與後續欄位的對應方式;寫入檔案時請以英文逗號分隔。

IP 條件與解析

IP-CIDR
192.0.2.0/24,DIRECT,no-resolve
GEOIP
CN,DIRECT
no-resolve
不主動為這條 IP 規則觸發網域解析

192.0.2.0/24 是文件中的範例位址範圍,不代表實際應直連的服務網路。

網域規則需要比對時,必須取得相應的網域資訊;IP 規則則需要可供判斷的目標位址。對網域請求而言,是否觸發解析也與規則選項及 DNS 設定有關。加入 no-resolve 可避免該條 IP 規則主動要求解析,但不能因此推斷所有網域請求都會命中該位址範圍。不同存取方式的結果不一致時,請先確認記錄中的實際目標是網域還是 IP。

PROXY、DIRECT、REJECT 與 FINAL 的組合

PROXY 代表交由代理策略處理,實際出口取決於目前選取的服務,或設定中引用的策略設定;DIRECT 代表直接連線至目標;REJECT 代表拒絕請求。這些策略都不是「自動修復連線」的按鈕:PROXY 無法修正錯誤的服務參數,DIRECT 也不保證目前網路能連線至所有目標。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,blocked.example.net,REJECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

此片段僅示範 Rule 區段,並非完整設定。若現有檔案已包含 [Rule],請將需要的規則合併至原有區段,不要直接再貼上一個同名區段。範例先列出精確網域,再列較廣的後綴條件,接著是位址與地區條件,最後保留 FINAL。實際順序應依照自己的存取需求安排,不要將範例視為通用策略。

FINAL 的兩種預設策略

FINAL,PROXY
  • 在前面明確列出需要 DIRECT 或 REJECT 的目標。
  • 其他未命中的請求交由代理策略處理。
  • 請確認目前選取的代理服務及協定參數可正常使用。
FINAL,DIRECT
  • 在前面明確列出需要 PROXY 或 REJECT 的目標。
  • 其他未命中的請求使用裝置目前的網路直連。
  • 新目標尚未加入規則時,不會自動套用代理策略。

兩種寫法的差異在於未命中規則的流量會前往何處;擇一使用,並將 FINAL 放在一般比對規則之後。

FINAL 本身沒有條件。如果它出現在清單中間,請求一旦到達這一行,策略就已確定,後面的普通規則不會再處理這些請求。如果檔案中有多條 FINAL,請先整理成一條明確的末尾預設規則,再繼續排查其他規則。

修改與驗證:每次只變更一項條件

以下操作以 Home、Config、Settings 的頁面結構為參考;不同平台的編輯控制項位置可能不同,請依目前頁面提供的檔案操作為準。驗證前請保留原始檔案副本,並記錄測試目標、預期策略與實際結果,避免一次變更多項條件而無法找出原因。

  1. 保留副本

    進入 Config,找到目前使用的設定檔,先透過檔案操作儲存副本或匯出備份。遠端設定宜另存一份獨立的本機測試副本,避免後續更新覆蓋測試內容。

  2. 編輯規則

    在 Config 開啟目標檔案的編輯功能,找到 [Rule]。將一條特定網域規則移至較廣的後綴規則之前,檢查英文逗號、策略拼字及末尾的 FINAL,然後儲存。

  3. 確認已啟用

    在 Config 確認剛儲存的檔案已啟用,再前往 Home → Global Routing 選擇 Config。只編輯副本但未啟用副本,不會改變目前使用的設定。

  4. 重新建立連線

    結束測試 App 與目標之間的舊連線;必要時關閉再重新開啟 Shadowrocket 的連線開關,然後重新發出請求。既有連線可能繼續沿用建立時的策略,因此不能只重新整理重複使用既有連線的頁面就下結論。

  5. 核對記錄

    查看 App 提供的連線記錄或日誌,依測試時間找到目標網域或 IP,核對實際策略與可查看的比對資訊。若請求發生重新導向,請分別檢查原始網域與重新導向後的網域。

驗證標準應是「指定目標的新連線是否採用預期策略」,而不是網頁是否剛好開啟。例如,新連線已顯示 PROXY 但交握失敗,應改為檢查自己已有服務的連線參數;新連線顯示 DIRECT 且命中上方的寬泛規則,則應先調整規則順序。兩種情況的排查方向不同。

規則未生效時的具體檢查項目

已加入 DIRECT,為什麼仍然是 PROXY?

先在 Home → Global Routing 確認選用 Config,再到 Config 核對啟用中的檔案。接著搜尋目標網域,檢查上方是否有範圍較廣的 DOMAIN-SUFFIX,或是否提早出現 FINAL。將特定例外移到寬泛規則之前,儲存後使用新連線再次測試。

同一個網站,為什麼有些請求採用不同策略?

查看連線記錄中的完整網域。主頁、圖片與登入介面可能使用不同網域;比對 example.com 的規則不會自動涵蓋獨立的 example.net。請依實際請求補上必要條件,不要只根據瀏覽器網址列判斷所有流量。

為什麼 IP-CIDR 沒有攔截網域請求?

檢查記錄中的目標位址是否屬於該網段、是否使用 IPv6,以及該規則是否帶有 no-resolve。網域解析可能回傳多個位址;不要用另一次解析取得的單一位址,推斷目前連線的情況。若目標穩定為網域,可先用精確的 DOMAIN 規則進行驗證。

更新後自訂規則為什麼不見了?

先確認更新的是 Home 中現有的服務訂閱,還是 Config 中的遠端設定。前者與 Rule 檔案是不同項目;後者可能會重新下載檔案內容。檢查目前檔案的來源及啟用狀態,還原本機備份後,再決定要繼續維護獨立設定檔,或採用該遠端設定提供的更新方式。

下載 Shadowrocket