在 Global Routing 選擇 Config 時,會依序比對規則,並以第一條符合的規則決定目前連線使用的策略。本文適合初次編輯規則,或遇到新增規則未生效的情況。讀完後,你可以分辨網域、IP 位址與預設規則,判斷連線會符合哪一行,並在修改後確認結果。
規則順序:從第一條比對到 FINAL
先看規則在檔案中的位置,再看規則寫得有多精確。Shadowrocket 會依目前設定檔中的順序逐條比對,符合一行後就採用該行指定的策略。使用 DOMAIN 不會讓規則自動排在 DOMAIN-SUFFIX 前面。若要為單一主機設定例外,請將例外規則放在涵蓋該主機的廣泛規則之前。
PROXY:將連線交由代理伺服器連出。選用的代理伺服器是否可用,會影響符合規則後能否建立代理連線。DIRECT:透過裝置目前使用的網路直接連線。符合DIRECT不代表一定能連上目標位址。REJECT:拒絕符合條件的連線。應用程式可能只顯示連線失敗,不一定會指出是哪一行規則造成。FINAL:處理前面規則都未符合的連線。寫法為FINAL,DIRECT或FINAL,PROXY,不填網域或位址;應放在[Rule]區段的最後。
規則只會為目前連線選擇策略,不會替整個應用程式設定固定標籤。同一次載入頁面時,可能分別連線到頁面主機、靜態資源主機及登入主機,而這些連線可能符合不同規則。排查時,請找出失敗請求對應的主機名稱,不要只看網址列中的主機名稱。
網域規則:完整主機名稱、網域後綴與關鍵字
網域規則的匹配值只填主機名稱或關鍵字。以 https://www.example.com:443/docs 為例,主機名稱是 www.example.com;https://、連接埠 443 與路徑 /docs 都不應填入規則值。以下結果皆以連線能取得目標主機名稱為前提。
| 規則與匹配值 | 符合範例 | 不符合範例 |
|---|---|---|
DOMAIN,example.com | example.com | www.example.com |
DOMAIN-SUFFIX,example.com | example.com、www.example.com | notexample.com、example.com.example.net |
DOMAIN-KEYWORD,example | example.net、notexample.com | www.test.invalid |
只想調整單一主機時,使用 DOMAIN;需要涵蓋根網域及各層子網域時,使用 DOMAIN-SUFFIX。後綴匹配會辨識網域標籤邊界,並非單純判斷字串是否以 example.com 結尾。DOMAIN-KEYWORD 則會搜尋主機名稱中是否包含指定字串,不要求整個標籤完全相同;若目標只是某個已知網域,使用關鍵字可能會連帶匹配其他網域。
位址規則:IP-CIDR 網段與 GEOIP 地區
IP-CIDR 用來判斷目標 IPv4 位址是否位於指定網段;GEOIP 則根據目標 IP 在地理位置資料庫中的歸屬進行判斷。地區代碼不代表網域後綴、網站註冊地或裝置所在地。
- 在
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve中,/24表示前 24 位固定。192.0.2.7符合,192.0.3.7則不符合。若只要匹配單一 IPv4 位址192.0.2.7,可寫成192.0.2.7/32。此處使用的是文件保留網段,僅供規則示範,不適合用來測試公網連線。 GEOIP,CN,DIRECT表示目標 IP 在位址資料庫中被歸類為CN時,使用直連。網域以.cn結尾不代表一定符合,也不能依造訪者所在地推斷結果。同一網域在不同網路環境下可能解析至不同 IP,因此地區匹配結果也可能不同。no-resolve表示此規則不會主動將網域解析成 IP;若當下已有可供匹配的目標 IP,仍可依網段進行判斷。這不代表停用整份設定的 DNS,也不保證後續規則不會使用解析結果。
若要讓某個主機固定使用同一策略,請勿以該主機某次解析出的 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
api.example.com同時符合前三行的網域條件,但會先符合第一行,因此結果是REJECT。若將後綴規則移至第一行,結果就會變成PROXY。www.example.com不符合第一行,符合第二行的後綴規則,因此結果是PROXY。即使其目標 IP 被歸類為CN,後續的GEOIP也不會覆蓋已符合規則所決定的策略。example.net不符合前兩行的網域條件,會在第三行符合關鍵字規則並使用DIRECT。若誤將關鍵字規則放在後綴規則之前,www.example.com也會先使用DIRECT。- 目的位址直接設定為
192.0.2.7時,便可能符合第四行。只有前五行都未符合的連線,才會使用FINAL,DIRECT。這幾行都可能使用DIRECT,因此只看策略名稱無法判斷符合的是哪一行。
套用規則並確認結果
先確認測試使用的設定檔與分流模式,再建立一條新連線。以下操作步驟以 iPhone / iPad 介面為例。儲存規則不代表測試已完成:目前選取的設定檔、仍在使用中的連線,以及代理伺服器狀態,都會影響觀察結果。
確認設定檔
點選底部的
Config,確認目前選取的設定檔。編輯前先保留可還原的副本,避免為了單次測試修改多組既有規則。儲存變更
將要驗證的規則放在同一份設定檔的
[Rule]區段。檢查欄位之間是否使用英文逗號、例外規則是否排在適用範圍較廣的規則之前,然後儲存設定。確認分流模式
返回
Home,開啟Global Routing並選擇Config。若先前選擇的是Proxy、Direct或情境中的Scene,請先切換至Config,再依本文說明的規則順序進行驗證。測試新連線
在
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。