Shadowrocket 規則教學:DOMAIN-SUFFIX、GEOIP、IP-CIDR 與 FINAL 的比對方式

瞭解 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR 與 FINAL 的比對方式、設定範例和規則順序。

本文重點

在 Home → Global Routing 選擇 Config 後,Shadowrocket 會依目前設定檔中的規則由上而下比對,命中第一條規則後即決定使用的策略。網域規則比對主機名稱,位址規則比對目標 IP,FINAL 則處理前面都未命中的連線。適合正在整理分流設定,或想確認連線為何使用 DIRECT 或 PROXY 的讀者。

規則比對順序:先確認 Config,再找第一個命中項目

在 Home → Global Routing 選擇 Config,再前往 Config 頁面確認目前使用的設定檔。前者的 Config 是路由模式,後者則是管理設定檔的頁面;如果編輯的是另一份檔案,目前的連線不會套用其中的新規則。Proxy 和 Direct 也不是用來驗證這份分流順序的模式。

連線請求目標資訊逐條比對選擇策略連線送出

規則通常寫成「類型、比對值、策略」,例如 DOMAIN,api.example.com,DIRECT。DIRECT 表示直接連線,PROXY 表示透過代理連線。設定不會自動挑選較精確的規則:即使某條 DOMAIN 比 DOMAIN-SUFFIX 更精確,只要前面的後綴規則已經命中,就不會再比對這條精確規則。

3 種
本文介紹的網域規則:精確、後綴、關鍵字
256 個
IPv4 的 /24 網段包含的位址數
2 個欄位
FINAL 只需填寫規則類型和策略

網域規則:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD

這三種規則都比對主機名稱,不比對完整 URL。以 https://api.example.com:443/v1/status 為例,網域欄位填寫 api.example.com,不包含 https://、連接埠 443 或路徑 /v1/status。如果同一主機的兩個路徑需要不同處理方式,單靠這三種規則無法區分。

規則類型比對值命中範例未命中範例
DOMAINapi.example.comapi.example.comimg.api.example.com
DOMAIN-SUFFIXexample.comexample.com、api.example.comnotexample.com
DOMAIN-KEYWORDexamplenotexample.netapi.example.net 以外的其他主機,例如 api.demo.test

只想為單一主機設定例外時,使用 DOMAIN。若要涵蓋根網域及其子網域,使用 DOMAIN-SUFFIX,比對值不必寫成 *.example.com。DOMAIN-KEYWORD 則會比對子字串,不要求關鍵字位於兩個句點之間。上表的 notexample.net 也包含 example,因此會命中;即使該網域屬於完全不同的網站,比對結果仍然相同。已知目標網域時,使用精確或後綴規則較容易控制範圍。

位址規則:IP-CIDR 比對網段,GEOIP 比對 IP 所屬地區

連線提供的是網域名稱時,位址類規則必須取得目標 IP 才能進行比對。以 IP-CIDR,192.0.2.0/24,DIRECT,no-resolve 為例,no-resolve 表示不為比對這條規則而額外發出 DNS 查詢,並非關閉整份設定的 DNS。已有目標 IP 時,仍可判斷是否落在該網段;若只有主機名稱而沒有可用位址,就不能期待這條規則會先解析主機名稱再命中。

同一個主機名稱可能會回傳不同位址。網域後綴規則的比對條件不會隨位址改變,而 GEOIP 的結果取決於用來比對的目標 IP 及其資料庫歸屬。若要讓特定主機一律使用相同策略,請將對應的網域規則放在地區規則之前。

FINAL 預設規則與順序範例

FINAL 不需填寫網域、網段或地區代碼,例如 FINAL,PROXY 會讓前面未命中的連線透過代理連線。請將它放在 [Rule] 區段末尾。以下是用來說明規則順序的片段,並非完整設定;測試 PROXY 路徑時,請使用自己已設定且可正常使用的代理。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,demo-example,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
  1. 目標主機名稱為 api.example.com 時,第一行已選定 DIRECT。若對調前兩條規則,同一主機名稱會先命中後綴規則,改用 PROXY。
  2. 目標主機名稱為 demo-example.example.com 時,後綴和關鍵字規則都符合,但後綴規則排在前面,因此會使用 PROXY。關鍵字比對不會覆蓋已選定的策略。
  3. 目標直接以 192.0.2.18 提供時,前三條網域條件都不會命中,網段規則會選擇 DIRECT。換成 192.0.3.18 只能表示沒有命中該網段,仍須檢查後面的 GEOIP,不能直接判定會使用 FINAL。
  4. 網域、網段和地區條件都未命中時,才會使用最後一行的 PROXY。如果這條出站連線失敗,FINAL 不會再提供其他策略;它處理的是「未命中」,不是「連線失敗」。

排查規則未生效或連線失敗

先確認是選錯策略,還是選對策略後連線失敗。使用明確的目標主機重新測試,例如為自己能連線的測試主機新增一條 DOMAIN 規則,並將它放在範圍較廣的規則之前;儲存後重新發起連線。網頁通常也會向其他主機請求圖片和指令碼,不能只根據整個頁面是否載入來判斷所有請求使用的策略。

瀏覽器錯誤訊息

以下是瀏覽器可能顯示的錯誤原文,並非 Shadowrocket 的規則比對結果。

錯誤:ERR_NAME_NOT_RESOLVED

原因:瀏覽器無法將請求的主機名稱解析為位址。解決方式:先確認主機名稱拼寫及 DNS 解析,再判斷是否需要調整依賴目標 IP 的規則。

錯誤:ERR_CONNECTION_TIMED_OUT

原因:連線未能在指定時間內建立,錯誤本身無法指出命中了哪條規則。解決方式:依目前設定的順序確認預期策略;若預期使用 PROXY,再到 Home 對目前使用的代理執行 Connectivity Test。

常見問題

為什麼新增 DOMAIN 規則後仍然使用代理?

先確認 Home → Global Routing 選擇的是 Config,並確認編輯的是目前使用的檔案。接著檢查前面是否已有命中的 DOMAIN-SUFFIX 或 DOMAIN-KEYWORD;如果有,請將精確例外移到它們前面,然後重新發起連線。

為什麼連線到同一網域時,GEOIP 的結果會改變?

先比較兩次連線實際使用的目標 IP。網域相同,不代表兩次連線使用相同位址。若要依網域固定策略,請使用一條排在前面的 DOMAIN 規則,而非依賴後面的 GEOIP。

修改 FINAL 前,應檢查哪些規則?

先使用一個不會命中已知網域規則的測試目標,接著確認是否命中任何 IP-CIDR 或 GEOIP 規則。只有前面的條件都不成立,修改 FINAL 才會影響該連線。測試時一次只修改一項,方便比較結果。

下載 Shadowrocket 與快速入門

iPhone / iPad 版可從 App Store 取得,價格為 $2.99 一次性付費;系統需求請以 App Store 頁面標示為準。Mac(Apple 晶片及 Intel)、Windows、Android、Linux 版免費,可從本站下載頁取得。

下載 Shadowrocket