在 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 更精確,只要前面的後綴規則已經命中,就不會再比對這條精確規則。
網域規則:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD
這三種規則都比對主機名稱,不比對完整 URL。以 https://api.example.com:443/v1/status 為例,網域欄位填寫 api.example.com,不包含 https://、連接埠 443 或路徑 /v1/status。如果同一主機的兩個路徑需要不同處理方式,單靠這三種規則無法區分。
| 規則類型 | 比對值 | 命中範例 | 未命中範例 |
|---|---|---|---|
DOMAIN | api.example.com | api.example.com | img.api.example.com |
DOMAIN-SUFFIX | example.com | example.com、api.example.com | notexample.com |
DOMAIN-KEYWORD | example | notexample.net | api.example.net 以外的其他主機,例如 api.demo.test |
只想為單一主機設定例外時,使用 DOMAIN。若要涵蓋根網域及其子網域,使用 DOMAIN-SUFFIX,比對值不必寫成 *.example.com。DOMAIN-KEYWORD 則會比對子字串,不要求關鍵字位於兩個句點之間。上表的 notexample.net 也包含 example,因此會命中;即使該網域屬於完全不同的網站,比對結果仍然相同。已知目標網域時,使用精確或後綴規則較容易控制範圍。
位址規則:IP-CIDR 比對網段,GEOIP 比對 IP 所屬地區
IP-CIDR:依 IPv4 網段比對。例如192.0.2.0/24涵蓋192.0.2.0至192.0.2.255;192.0.2.18位於範圍內,192.0.3.18則不在其中。只指定一個 IPv4 位址時,使用/32,例如192.0.2.18/32。本文使用文件中的示範位址,不適用於連線測試。GEOIP:依目標 IP 在地理資料庫中的歸屬,比對國家或地區代碼。例如GEOIP,CN,DIRECT會比對資料庫中歸類為CN的目標位址。它不會檢查網域是否以.cn結尾,也不會讀取裝置語言或網站頁面上的地區選項。
連線提供的是網域名稱時,位址類規則必須取得目標 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
- 目標主機名稱為
api.example.com時,第一行已選定DIRECT。若對調前兩條規則,同一主機名稱會先命中後綴規則,改用PROXY。 - 目標主機名稱為
demo-example.example.com時,後綴和關鍵字規則都符合,但後綴規則排在前面,因此會使用PROXY。關鍵字比對不會覆蓋已選定的策略。 - 目標直接以
192.0.2.18提供時,前三條網域條件都不會命中,網段規則會選擇DIRECT。換成192.0.3.18只能表示沒有命中該網段,仍須檢查後面的GEOIP,不能直接判定會使用FINAL。 - 網域、網段和地區條件都未命中時,才會使用最後一行的
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 版免費,可從本站下載頁取得。