· 規則與分流 · 約 8 分鐘

Shadowrocket 規則語法入門:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 匹配範圍

認識六種常用規則關鍵字的匹配對象與順序,了解如何搭配 PROXY / DIRECT / REJECT,並附上 example.com 範例。

本文重點

在 Global Routing 選擇 Config 時,會依序比對規則,並以第一條符合的規則決定目前連線使用的策略。本文適合初次編輯規則,或遇到新增規則未生效的情況。讀完後,你可以分辨網域、IP 位址與預設規則,判斷連線會符合哪一行,並在修改後確認結果。

規則順序:從第一條比對到 FINAL

先看規則在檔案中的位置,再看規則寫得有多精確。Shadowrocket 會依目前設定檔中的順序逐條比對,符合一行後就採用該行指定的策略。使用 DOMAIN 不會讓規則自動排在 DOMAIN-SUFFIX 前面。若要為單一主機設定例外,請將例外規則放在涵蓋該主機的廣泛規則之前。

目標主機目前設定依序比對執行策略

規則只會為目前連線選擇策略,不會替整個應用程式設定固定標籤。同一次載入頁面時,可能分別連線到頁面主機、靜態資源主機及登入主機,而這些連線可能符合不同規則。排查時,請找出失敗請求對應的主機名稱,不要只看網址列中的主機名稱。

網域規則:完整主機名稱、網域後綴與關鍵字

網域規則的匹配值只填主機名稱或關鍵字。以 https://www.example.com:443/docs 為例,主機名稱是 www.example.com;https://、連接埠 443 與路徑 /docs 都不應填入規則值。以下結果皆以連線能取得目標主機名稱為前提。

規則與匹配值符合範例不符合範例
DOMAIN,example.comexample.comwww.example.com
DOMAIN-SUFFIX,example.comexample.com、www.example.comnotexample.com、example.com.example.net
DOMAIN-KEYWORD,exampleexample.net、notexample.comwww.test.invalid

只想調整單一主機時,使用 DOMAIN;需要涵蓋根網域及各層子網域時,使用 DOMAIN-SUFFIX。後綴匹配會辨識網域標籤邊界,並非單純判斷字串是否以 example.com 結尾。DOMAIN-KEYWORD 則會搜尋主機名稱中是否包含指定字串,不要求整個標籤完全相同;若目標只是某個已知網域,使用關鍵字可能會連帶匹配其他網域。

位址規則:IP-CIDR 網段與 GEOIP 地區

IP-CIDR 用來判斷目標 IPv4 位址是否位於指定網段;GEOIP 則根據目標 IP 在地理位置資料庫中的歸屬進行判斷。地區代碼不代表網域後綴、網站註冊地或裝置所在地。

若要讓某個主機固定使用同一策略,請勿以該主機某次解析出的 IP 取代網域規則。將明確的網域規則放在位址規則之前,主機名稱已知時便能先處理這項例外,不必等候位址規則判斷。

範例:讓單一主機例外優先匹配

以下片段用來理解及推演規則順序,並非完整設定檔。範例先拒絕指定主機,再代理同一網域下的其他請求,接著處理關鍵字與 IP 條件。加入現有設定時,只需將必要規則放進既有的 [Rule] 區段,並保留一條位於末尾的 FINAL。

[Rule]
DOMAIN,api.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,DIRECT
  1. api.example.com 同時符合前三行的網域條件,但會先符合第一行,因此結果是 REJECT。若將後綴規則移至第一行,結果就會變成 PROXY。
  2. www.example.com 不符合第一行,符合第二行的後綴規則,因此結果是 PROXY。即使其目標 IP 被歸類為 CN,後續的 GEOIP 也不會覆蓋已符合規則所決定的策略。
  3. example.net 不符合前兩行的網域條件,會在第三行符合關鍵字規則並使用 DIRECT。若誤將關鍵字規則放在後綴規則之前,www.example.com 也會先使用 DIRECT。
  4. 目的位址直接設定為 192.0.2.7 時,便可能符合第四行。只有前五行都未符合的連線,才會使用 FINAL,DIRECT。這幾行都可能使用 DIRECT,因此只看策略名稱無法判斷符合的是哪一行。

套用規則並確認結果

先確認測試使用的設定檔與分流模式,再建立一條新連線。以下操作步驟以 iPhone / iPad 介面為例。儲存規則不代表測試已完成:目前選取的設定檔、仍在使用中的連線,以及代理伺服器狀態,都會影響觀察結果。

  1. 確認設定檔

    點選底部的 Config,確認目前選取的設定檔。編輯前先保留可還原的副本,避免為了單次測試修改多組既有規則。

  2. 儲存變更

    將要驗證的規則放在同一份設定檔的 [Rule] 區段。檢查欄位之間是否使用英文逗號、例外規則是否排在適用範圍較廣的規則之前,然後儲存設定。

  3. 確認分流模式

    返回 Home,開啟 Global Routing 並選擇 Config。若先前選擇的是 Proxy、Direct 或情境中的 Scene,請先切換至 Config,再依本文說明的規則順序進行驗證。

  4. 測試新連線

    在 Home 確認連線已啟用,結束測試應用程式目前使用的連線,再以已知可連線的主機發出新請求。在 Data 查看對應時段的連線記錄,核對目標主機、符合的規則及所用策略;不要只憑頁面能否開啟,就判定連線符合 PROXY。

連線失敗:先排除 DNS 與伺服器問題

瀏覽器錯誤只能指出連線在哪類環節失敗,無法單憑錯誤訊息證明符合了哪一條規則。先查看該次請求的記錄;若沒有對應記錄,請確認測試應用程式是否重新建立連線,以及 Shadowrocket 是否仍處於啟用狀態。

瀏覽器錯誤訊息與檢查方式

錯誤:ERR_NAME_NOT_RESOLVED

原因:瀏覽器無法取得目標主機名稱的有效解析結果。

處理方式:先確認主機名稱拼寫,再檢查 Config 中目前設定檔的 DNS 設定;不要以修改 FINAL 取代 DNS 問題排查。

錯誤:ERR_CONNECTION_RESET

原因:連線遭到重設,僅憑錯誤訊息無法判斷是連出路徑還是目標端中斷連線。

處理方式:先在 Data 確認使用的策略;若符合 PROXY,請返回 Home,對目前的伺服器執行 Connectivity Test,再測試同一主機。

常見問題:修改規則後為何沒有變化

依照問題現象排查

新增了 DOMAIN,為什麼仍使用原本的策略?

先在 Home → Global Routing 確認已選擇 Config。接著檢查目前規則區段中,新增規則之前是否已有符合的 DOMAIN-SUFFIX、DOMAIN-KEYWORD 或其他規則。將精確的例外規則移到該行之前,再建立新連線。

只想讓單一子網域直連,需要修改整條後綴規則嗎?

保留現有的後綴規則,並在它前面新增一行 DOMAIN,files.example.com,DIRECT。這只會處理 files.example.com;重新載入網頁時,頁面發出的其他主機請求仍會依各自符合的規則處理。

使用 IP 可以連線,為什麼不能用來驗證網域規則?

直接輸入 IP 時,測試目標已不是原本的主機名稱,因此無法用測試結果確認是否符合 DOMAIN。請改用原主機名稱進行測試並查看連線記錄;若瀏覽器顯示解析錯誤,先檢查 DNS,再重新驗證網域規則。

如何確認是 FINAL 生效,而不是前面某一行直連?

在 Data 查看該連線符合的規則,不要只看 DIRECT。若記錄顯示先前已符合網域或位址規則,請更換測試目標;只有前面的條件都不符合時,才會套用 FINAL。

下載 Shadowrocket