Shadowrocket(小火箭)會依照設定順序檢查規則,第一條符合的規則決定處理策略,FINAL 則處理其餘連線。本文適合已有自己的服務商與訂閱、需要編輯 Config 的使用者;以 iPhone / iPad 介面為操作參考,說明規則語法、順序、儲存啟用及驗證方式。Mac、Windows、Android、Linux 使用者也可參考相同的規則概念,實際編輯位置請以各平台介面為準。
1. 先確認 Global Routing 設為 Config
自訂規則儲存後,不一定會套用於連線處理。先在 Home 確認 Global Routing:若要依照設定中的規則分流,請選擇 Config。Proxy 是全域代理模式,Direct 是全域直連模式,不能用這兩種模式下的連線結果判斷 Config 規則是否命中。Scene 用於切換情境,也不等同於個別規則的策略。
Home 中選取的伺服器與 Config 中啟用的設定用途不同:前者提供代理連線所需的參數,後者則決定流量如何分配。將規則設為 PROXY 不會建立可用伺服器,也不會補上位址、連接埠或密碼。訂閱連結請向你的服務商索取。
2. 了解由上而下比對與命中即停止
規則清單不會先合併所有符合項目再挑選,也不會自動把「較具體」的規則排在前面。對於需要進行規則判斷的連線,應用程式會由上而下逐條檢查;一旦符合某條規則,就採用該規則指定的策略,後續規則不會覆蓋結果。請將例外規則放在較廣泛的規則之前,並把 FINAL 放在最後。
[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
依照此順序,api.example.com 先符合 DOMAIN 規則,因此採用 DIRECT;www.example.com 不符合第一條,但符合第二條,因此採用 PROXY。若將 DOMAIN-SUFFIX 移到第一行,api.example.com 也會先符合後綴規則,底下的精確例外便不會生效。
DOMAIN:比對指定的完整網域名稱,適合設定單一主機的例外。DOMAIN-SUFFIX:比對指定網域及其子網域;example.com 和 static.example.com 都符合,notexample.com 則不符合。FINAL:沒有比對目標欄位,用來處理先前所有規則都未命中的連線。
3. 規則欄位與 PROXY / DIRECT / REJECT
文字設定中的規則寫在 [Rule] 區段。常見格式為「規則類型,比對目標,處理策略」,欄位之間使用英文逗號。FINAL 是例外,格式為 FINAL,PROXY,不要寫成多出一個空白目標欄位的三段式。圖形編輯介面會分開顯示這些欄位,不必將整行文字都貼進網域欄位。
網域與末尾規則
- DOMAIN
- api.example.com,DIRECT
- DOMAIN-SUFFIX
- example.com,PROXY
- FINAL
- PROXY
精確例外在前、廣泛後綴在後,FINAL 放在最後。
三種處理策略
- PROXY
- 透過代理伺服器連線
- DIRECT
- 直接連線至目標,不經代理伺服器轉送
- REJECT
- 拒絕符合規則的連線
策略代表處理方式,不是協定名稱,也不能取代伺服器參數。
PROXY 的實際連線方式還需配合目前選用的伺服器與設定中的策略設定;若使用自訂策略群組,群組名稱必須與設定中的定義一致。DIRECT 不代表關閉系統 VPN,只表示該連線採用直連方式。REJECT 適合明確需要封鎖的目標,但不要一開始就用來涵蓋範圍過大的網域後綴,否則登入、圖片或驗證請求可能一併失敗。
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY
這組規則會先拒絕 blocked.example.com,即使後面有允許相同後綴使用 PROXY 的規則,結果也不會改變。範例網域僅用於說明語法,不代表可用線路或測試服務。
4. IP-CIDR、GEOIP 與 DNS 判斷範圍
網域規則判斷名稱,IP-CIDR 判斷目標位址是否位於指定網段,GEOIP 則依據 IP 地理位置資料庫分類。三者不能互相取代。透過網域存取時,後續的 IP 類規則可能涉及 DNS 解析;若用戶端沒有可用的網域資訊,網域規則也無法只憑目標 IP 還原所有原始主機名稱。
| 規則範例 | 判斷依據 | 注意事項 |
|---|---|---|
DOMAIN-SUFFIX,example.com,PROXY | 目標網域後綴 | 不需填寫 https:// 或 URL 路徑。 |
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve | IPv4 網段 | 涵蓋 192.168.0.0 至 192.168.255.255。 |
GEOIP,CN,DIRECT | 目標 IP 的資料庫分類 | 僅依據目標 IP 的資料庫記錄,不依據網域文字或帳號地區。 |
FINAL,PROXY | 先前規則皆未命中 | 放在規則區段末尾。 |
no-resolve 表示不會為了比對這條 IP 規則而主動觸發網域解析,不代表整個應用程式停用 DNS,也不保證規則一定會命中。若連線目標直接使用 192.168.1.20,可以判斷是否符合上述網段條件;若網域連線尚無可用 IP,就不能把這條含 no-resolve 的規則視為必定生效的網域規則。
- 若要固定網域的處理方式,優先設定明確的 DOMAIN 或 DOMAIN-SUFFIX 例外。
- 若要存取區域網路,請依實際位址範圍設定 IP-CIDR,不要將所有位址一律設為 DIRECT。
- GEOIP 分類可能因資料庫及目標解析位址而異,不能將單次命中結果視為網站的永久歸屬。
- IPv6 目標應使用相應的 IPv6 規則,例如 IP-CIDR6;IPv4 網段不會涵蓋 IPv6 位址。
5. 在 Config 儲存、啟用並驗證規則
修改前請先保留目前設定的副本,尤其是透過遠端位址取得的設定。伺服器訂閱更新與遠端 Config 更新並非同一件事:前者主要更新伺服器資料,後者可能會取代規則內容。不要只因為顯示「更新成功」就認定手動修改仍然保留,請重新開啟目前生效的設定確認。
- 確認設定。進入 Config,找到目前使用的設定並保留副本;不要直接清除原檔案中的其他設定區段。
- 開啟編輯。進入該設定的編輯畫面,在規則清單中新增項目,或於文字編輯器中找到
[Rule]區段。只貼上需要的規則,避免重複加入多個同名設定區段。 - 檢查順序。將精確網域例外及明確的區域網路規則放在相關的廣泛規則之前;並確認是否已有更前面的規則涵蓋目標。
- 儲存並啟用。儲存編輯內容,並在 Config 確認已選取該設定;返回 Home,將 Global Routing 設為 Config,並確認連線已開啟。
- 重新建立連線測試。關閉目標頁面後重新開啟,必要時重新建立連線;既有的長連線無法代表新規則的判斷結果。
- 檢查記錄。查看應用程式內連線記錄中的目標網域、IP、命中規則與策略資訊;若測試異常,先還原副本,再縮小修改範圍。
6. FINAL 應選 PROXY 還是 DIRECT
FINAL 沒有適用於所有設定的標準答案。FINAL,PROXY 表示其餘未分類的連線交由代理處理;FINAL,DIRECT 則表示其餘連線直連,只有明確命中的目標會使用其他策略。這兩種設定都會放大前面規則遺漏的影響,選擇前應先確認「未列出的目標」要如何處理。
- 最後使用 PROXY:將明確要直連的目標放在前面;代理連線無法使用時,未分類的連線也可能失敗,不能因此直接判定 FINAL 語法錯誤。
- 最後使用 DIRECT:需要代理的目標必須由前面的規則涵蓋;若網頁主網域與資源子網域不同,應分別確認實際請求。
- 避免太早設定 FINAL:它會接手所有先前未命中的連線,寫在它後面的普通規則將無法再判斷這些連線。
初次排查時,不建議將 FINAL,REJECT 當作通用範本,因為所有遺漏的目標都會遭到拒絕。較穩妥的做法是保留已知可用的兜底,只對明確的單一目標新增 REJECT,再透過連線記錄確認影響範圍。
7. 自訂規則常見問題
規則已設定,為什麼流量仍全部走代理?
先在 Home 確認 Global Routing 是否設為 Proxy;若要依規則分流,請切換至 Config。接著確認 Config 啟用的是剛才編輯的檔案,重新建立目標連線,再檢查是否先命中了更前面的廣泛規則。
DOMAIN-SUFFIX 要加網址前綴或連接埠嗎?
不用。目標欄位填寫 example.com,不要加網址前綴、路徑或 :443。DOMAIN-SUFFIX 比對網域後綴,不區分相同網域的 80 與 443 連接埠,也無法依網頁路徑分流。
改成 DIRECT 後頁面能開,是否代表規則正確?
這只能表示這次存取有成功。還需確認連線記錄中的命中規則與策略,並重新測試該頁面的資源請求。快取、既有連線及不同子網域都會影響觀察結果,不能只看頁面是否顯示。
更新後自訂規則不見了,該怎麼辦?
先在 Config 檢查目前使用的檔案與保留副本,確認是否更新了遠端設定或切換了檔案。還原副本並重新啟用後,再決定是否在本機副本中維護自訂規則;不要反覆重新整理遠端檔案,試圖還原手動編輯內容。
PROXY 已命中但連線逾時,還需要修改規則嗎?
先保留已驗證的規則,返回 Home 檢查選用的伺服器與 Connectivity Test,再確認服務商提供的位址、連接埠和協定參數。規則只決定連線去向,無法修復伺服器無法連線、驗證錯誤或傳輸參數不一致等問題。