Shadowrocket 規則設定教學:DOMAIN-SUFFIX、GEOIP、FINAL 等關鍵字比對邏輯

整理 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 的比對方式與順序,並說明 PROXY、DIRECT、REJECT 的寫法。

本文重點

Shadowrocket(小火箭)的規則應依「具體例外優先、寬泛條件其次、FINAL 收尾」的順序排列,並在 Global Routing 選擇 Config 後進行驗證。本文適合已有自己的服務供應商與訂閱,準備修改設定檔的使用者:先辨識規則欄位與策略,再用網域和 IP 範例確認比對結果,最後釐清規則未命中、DNS 失敗與連線出站失敗的差異。

一、先啟用 Config,再確認規則是否生效

規則寫對,不代表目前正在使用這些規則。先在 Config 確認已選取的設定檔,再回到 Home 查看 Global Routing。若要依設定檔分流,請選擇 Config;若仍是 Proxy 或 Direct,就不能以連線結果判斷特定設定規則是否正確。

6 種
本文涵蓋:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL
4 項
Global Routing:Proxy / Direct / Config / Scene
1 條
建議在設定檔末尾保留一條 FINAL 作為備援規則

Settings → On Demand 可依條件控制自動連線,並不會取代規則比對。若中斷後又自動連線,應先檢查 On Demand,而不是刪除 FINAL。測試期間固定網路、設定檔與路由模式,每次只調整一個條件,才能更容易重現問題。

二、規則語法:分開看比對條件與處理策略

一般規則通常由「類型、比對值、策略」組成,各欄位以英文逗號分隔。FINAL 不需要比對值,只包含類型與策略。規則請寫在設定檔的 [Rule] 區段,不要加到 [General] 或代理項目所在的區段。

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
策略寫法處理方式檢查項目
DIRECT直接連線至目標,不經由代理出站。目前的網路是否能直接連線至目標。
REJECT拒絕符合條件的連線。比對範圍是否太廣,以及是否誤擋頁面所需的網域。
PROXY交由名為 PROXY 的策略處理。是否存在同名策略,以及策略群組目前選用的出站是否可用。

規則名稱和代理協定是不同概念。即使現有出站使用 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard,也不會改變 DOMAIN-SUFFIX 的比對方式;協定負責建立連線,規則則決定將連線交由哪個策略處理。匯入與更新訂閱時,也應區分「出站清單更新」與「設定規則更新」,兩者並非同一件事。

三、DOMAIN 系列:精確網域、網域後綴與關鍵字

網域規則不包含 https://、網頁路徑或連接埠。若要處理 https://api.example.com:8443/account,DOMAIN 的比對值應為 api.example.com,而非整段網址。路徑 /account 和連接埠 8443 都不屬於網域欄位。

規則會比對不會比對
DOMAIN,example.com,DIRECTexample.comwww.example.com
DOMAIN-SUFFIX,example.com,DIRECTexample.com、api.example.comnotexample.com、example.com.other.test
DOMAIN-KEYWORD,example,PROXYexample.com、myexample.net網域中不含 example 的請求,即使網頁路徑包含這個字詞也不會比對。

DOMAIN-SUFFIX 會依網域層級比對,不是比對任意字串結尾。因此 example.com 可涵蓋其子網域,但不會涵蓋 notexample.com。若只想讓單一登入介面使用代理,優先採用 DOMAIN;確認整個網域及其子網域都需要相同策略時,再使用 DOMAIN-SUFFIX。

[Rule]
DOMAIN,login.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY

依這段規則的順序,登入網域會先符合第一條,其他同網域的子網域才會符合第二條。若將網域後綴規則移到最前面,登入網域也會先被 DIRECT 接手。DOMAIN-KEYWORD 的範圍通常較難掌握,加入前應先列出可能含有相同字串的無關網域,避免直接將常見關鍵字設為 REJECT。

四、IP-CIDR 與 GEOIP:依 IP 位址與網段比對

IP-CIDR 用來判斷目標 IPv4 位址是否位於指定網段。192.168.0.0/16 涵蓋從 192.168.0.0 到 192.168.255.255 的位址,而 192.168.1.10/32 只會比對單一位址。IPv6 網段應使用相應的 IP-CIDR6 規則,不要直接套用 IPv4 範例。

[Rule]
IP-CIDR,192.168.1.10/32,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

網域請求若要參與位址類規則的判斷,通常需要有可用的目標 IP 資訊。DNS 故障可能導致後續 IP 判斷無法如預期完成,因此不能將所有未命中都歸因於 GEOIP 資料不準。同一網域使用 CDN、DNS 回應不同,或採用不同位址家族時,實際目標 IP 也可能不同。

五、由上而下比對:FINAL 必須放在最後

在一般規則鏈中,請求會由上而下檢查,遇到第一條符合的規則就採用其策略,不會繼續尋找後續「更精確」的規則。精確規則之所以優先,是因為使用者將它排在前面,而不是軟體會自動依精確度重新排序。

收到請求 讀取設定 依序比對 採用策略 建立連線
  1. 先放置需要優先處理的精確網域、單一 IP 與明確拒絕項目。
  2. 接著放網域後綴、評估過的關鍵字及目標網段。
  3. 再放 GEOIP 等涵蓋範圍較廣的條件;與其他規則的先後順序仍應依實際需求決定。
  4. 最後放一條 FINAL,明確指定其餘請求的處理方式。

FINAL 不會再檢查網域或 IP,因此若將 FINAL,PROXY 放在開頭,後續一般規則就沒有比對機會。它不是「發生錯誤後重新嘗試」的規則:前面的規則已命中但連線失敗時,不會自動改用 FINAL 切換到其他路徑。

[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,tracking,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

依照此範例,api.example.com 使用 PROXY,www.example.com 使用 DIRECT,其他包含 tracking 的網域則會被 REJECT。網域規則已命中的請求,不會因為目標 IP 也符合 GEOIP 而改用其他策略。最後仍未符合任何規則的請求,才會交由 FINAL 處理。

六、規則未生效:從設定、命中與出站逐步排查

修改前先儲存目前設定檔的副本。修改後,在 Config 確認選取的檔案,再回到 Home 確認 Global Routing 設為 Config,然後重新建立測試連線。既有的長連線可能仍沿用原本的連線狀態,不要只重新整理仍維持連線的頁面,就判定規則未生效。

  1. 確認檔案:確認修改的是目前使用的設定檔,而不是同名備份;更新遠端設定檔後,再檢查手動修改的內容是否仍保留。
  2. 確認語法:檢查英文逗號、規則區段與策略名稱,尤其確認目前設定檔中確實存在 PROXY。
  3. 確認目標:查看請求記錄中的實際網域或 IP。頁面可能同時連線至登入、圖片與 API 網域,瀏覽器網址列只會顯示其中一個。
  4. 確認命中規則:對照記錄中的策略與規則資訊,檢查是否有更前面的 DOMAIN-SUFFIX、GEOIP 或 FINAL 提前命中。
  5. 確認出站:若已命中預期策略仍無法連線,再檢查 DNS、目標連接埠及現有服務的連線參數,不要繼續擴大網域規則範圍。

錯誤:Connection refused

原因與處理方式:目標或中間設備可能主動拒絕連線,這不代表規則語法錯誤。先從記錄確認實際採用的策略,再檢查目標位址、監聽連接埠與現有出站設定;區域網路服務還需確認該連接埠上的服務已啟動。

錯誤:Connection timed out

原因與處理方式:連線未能在期限內完成,可能與網路路徑、目標無法連線或出站故障有關。先確認命中的策略,再於相同網路下檢查現有服務是否可連線,避免直接將逾時歸因於 DOMAIN-SUFFIX 設定錯誤。

以上是連線層可能出現的錯誤訊息,並非每次連線失敗都會顯示的固定提示。若命中 REJECT 後請求遭到阻擋,應先確認這是否符合原本的拒絕目的;若是誤擋,請新增範圍更精確的例外,並將它排在拒絕規則之前,而不是將所有流量改為 DIRECT。

七、常見問題與修改後檢查項目

新增 DOMAIN-SUFFIX 後,為什麼某個子網域還是走代理?

先在 Home 確認 Global Routing 設為 Config,再到 Config 確認目前使用的設定檔。接著檢查該子網域是否已符合排在前面的 DOMAIN 或其他規則,並確認記錄中的實際請求網域確實屬於該後綴。

FINAL 應該設為 DIRECT 還是 PROXY?

取決於未分類流量預期的處理方式。若希望其餘流量使用現有代理策略,可用 FINAL,PROXY;若希望直連,則用 FINAL,DIRECT。使用前者時,請確認 PROXY 存在且可用;兩者都應放在規則末尾。

更新訂閱後,手動撰寫的規則會消失嗎?

先確認更新的是哪一項。出站訂閱更新與遠端設定檔更新並不相同;若重新取得整份遠端設定檔,本機修改可能會被覆寫。更新前先儲存副本,更新後在 Config 重新檢查規則區段與策略名稱。

可以只讓同一網域的 443 連接埠走代理嗎?

DOMAIN 與 DOMAIN-SUFFIX 本身不會依連接埠區分,在網域後方加上 :443 並非正確寫法。本文範例依網域或位址分流;若要設定連接埠條件,應另外確認相應規則的支援能力與語法,不能只修改網域欄位。

下載 Shadowrocket