先在 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
修改策略前,先確認是否命中規則
若要讓某個子網域直連,先確認請求的主機名稱,再將它的 DOMAIN 規則移到可涵蓋該網域的 DOMAIN-SUFFIX 規則之前。不要先改 FINAL:已被前面的規則選中的請求不會再套用到最後一條規則。
DIRECT:此請求直接連線至目標,不經由所選代理轉送。PROXY:此請求經由代理轉送;測試前請在 Home 確認目前選取的代理。命中這條規則不代表代理可用,也不代表目標已回應。REJECT:拒絕符合條件的請求。這不是將請求交由代理處理,也不是連線失敗後改用的路徑。
網域比對:DOMAIN、DOMAIN-SUFFIX 和 DOMAIN-KEYWORD
只處理特定主機名稱時,選用 DOMAIN;要涵蓋根網域及其子網域時,選用 DOMAIN-SUFFIX;只有確實需要比對多個網域中的相同字串時,才使用 DOMAIN-KEYWORD。後綴比對會依據網域標籤邊界判斷;關鍵字比對則不要求字串剛好佔據一個標籤。
| 條件 | 符合範例 | 不符合範例 |
|---|---|---|
DOMAIN,docs.example.com | docs.example.com | cdn.docs.example.com、example.com |
DOMAIN-SUFFIX,example.com | example.com、api.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,example-test | cdn-example-test.example.net | exampletest.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。例如,目標 IP192.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 中驗證第一條命中的規則
修改規則前,先列出每個測試目標預期採用的策略。需要模擬特定例外時,請選擇自己確認能正常連線的目標;不要將文件專用保留網段當成可連線的服務。編輯前先保留原設定,避免同時變更規則順序和連線狀態這兩個因素。
確認設定檔
進入 Config,確認目前使用的設定檔。若要測試
PROXY,也請在 Home 確認已選取自己持有且可用的代理。儲存規則
在目前設定檔的
[Rule]區段加入一條精確例外,並將它排在可能涵蓋該目標的後綴、關鍵字或位址規則之前;FINAL則保留在最後。切換至 Config
在 Home → Global Routing 選擇 Config。不要將 Proxy 或 Direct 模式下的結果當成規則驗證;如果原本使用 Scene,請先明確切換至 Config,排除場景選擇的影響。
發出新請求
分別對精確例外、同一後綴下的另一個主機,以及不符合前面任何條件的目標發出請求。依本文範例,預期結果分別是
DIRECT、PROXY,以及由FINAL指定的PROXY。若第三個目標先命中GEOIP,請改用其他目標測試兜底規則。比對結果
查看新請求對應的連線記錄,確認實際主機名稱、策略及可見的比對資訊。如果頁面是從快取顯示,或沿用了舊連線,就無法據此判斷新規則是否生效;請結束舊連線後再測試。
規則未生效:區分策略、DNS 與連線錯誤
如果同一主機採用錯誤的策略,請先檢查目前啟用的設定檔、Global Routing 和規則順序;如果策略正確但請求失敗,再檢查 DNS 或連線。以下是 Chromium 瀏覽器可能顯示的錯誤原文,並非 Shadowrocket 的規則驗證提示。僅憑瀏覽器錯誤訊息,無法判定是哪一條規則造成問題。
錯誤:ERR_NAME_NOT_RESOLVED
原因:瀏覽器無法取得該請求網域的有效解析結果。解決方法:先確認請求中的主機名稱是否拼錯,再檢查目前的解析設定;不要先將 FINAL 改成其他策略來驗證拼字或 DNS。
錯誤:ERR_CONNECTION_TIMED_OUT
原因:連線未能在等待時間內建立,目標或目前的轉送路徑可能沒有回應。解決方法:先確認新請求是否採用預期策略,再以相同策略測試已知可連線的目標,以判斷是單一目標逾時,還是整條路徑無法使用。
如果兩個目標最後都採用 PROXY,光看策略名稱無法分辨是命中後綴規則,還是由 FINAL 兜底。請優先查看記錄中的比對資訊;若目前記錄沒有顯示具體規則,可在測試用副本中只調整待驗證的規則,對可自行控制的測試目標發出新請求,比較調整前後的策略,再還原原設定。