Shadowrocket 自訂規則設定:由上而下比對、FINAL 預設策略與 PROXY/DIRECT/REJECT

了解 Shadowrocket 自訂規則的格式與比對順序,掌握 FINAL 的位置,以及 PROXY、DIRECT、REJECT 三種策略的用途。

本文重點

自訂規則會由上而下逐條檢查,命中第一條符合條件的規則後,就採用該條策略,不會繼續尋找「更精確」的規則。本文適合已完成連線設定,並需要處理網域例外與區域網路存取的使用者。請先確認 Global Routing 設為 Config,再將例外規則放在較寬泛的規則之前,並將 FINAL 留在最後。以下語法範例可用來理解各平台的設定方式,實際操作請以目前裝置上的 Home、Config、Settings 介面為準。

先確認規則生效條件

Shadowrocket(小火箭)連線成功與規則生效是兩回事。Home 中選取的連線決定可用的代理出口,Config 中啟用的設定檔決定規則內容;Global Routing 則決定目前的請求是否依設定檔分流。若遇到「規則寫了卻沒變化」,請先檢查這三處,不要急著繼續新增規則。

本文以 Global Routing → Config 為前提。Proxy 代表整體使用代理,Direct 代表整體直連;這兩種模式都無法用來驗證設定檔中的逐條分流結果。使用 Scene 時,也請確認場景實際套用的設定,避免切換網路後測試條件已改變。Global Routing 中的 Proxy 與規則列中的 PROXY 並非同一層級:前者是全域模式,後者是單條規則的策略。

  1. 在 Home 確認目前連線可用;規則中的 PROXY 仍需要有效的代理出口。
  2. 開啟 Config,確認選取的是準備修改的設定檔,而非名稱相近的其他檔案。
  3. 將 Global Routing 設為 Config,再開始新增及驗證規則。
  4. 測試期間請維持網路環境不變;若已啟用 Settings → On Demand,請留意自動連線行為,但不要將它當成規則優先順序的切換開關。

以下只討論設定檔中的規則判斷,不會修改協定參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等出口協定的連線設定,應與 DOMAIN-SUFFIX 等分流條件分開檢查。

規則列的基本寫法

設定檔中的規則寫在 [Rule] 區段。一條常見規則由規則類型、比對值及策略三部分組成,並以英文逗號分隔;FINAL 不需要比對值,因此只包含類型與策略。請保留關鍵字原文,不要將英文逗號換成中文逗號,也不要在網域後加上路徑,寫成完整網址。

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

此處的 example.com 是說明用的示例網域,不代表服務入口。請勿直接以示例網域的連線結果判斷線路品質。若現有檔案已包含 [Rule] 區段,請在該區段內編輯對應項目,不要重複新增區段名稱,也不要將規則貼到 [General] 中。

網域條件

DOMAIN
login.example.com,DIRECT
DOMAIN-SUFFIX
example.com,PROXY
比對值
填寫網域,不含 https://、連接埠或路徑

DOMAIN 精確比對;DOMAIN-SUFFIX 涵蓋指定網域及其子網域。

IP 位址與預設規則

IP-CIDR
192.168.0.0/16,DIRECT,no-resolve
GEOIP
CN,DIRECT
FINAL
PROXY

IP 條件用來處理目標位址;FINAL 則處理先前未命中的請求。

no-resolve 是 IP 類規則可使用的附加選項,可避免僅為比對該規則而觸發網域解析。它並非「關閉所有 DNS」,也不保證尚未取得目標 IP、只有網域名稱的請求會命中該網段。網域條件與 IP 條件依賴的資訊不同,測試時請分開判斷。

優先順序取決於規則位置

規則清單不會先替網域、網段及地理位置各自評分,再選出最精確的條件。基本邏輯是由上而下檢查:第一條符合條件的規則就會決定採用的策略。若將精確網域規則放在寬泛的後綴規則之後,精確規則可能永遠沒有執行機會。

收到新請求 讀取第一條規則 逐條檢查條件 命中第一條後停止 執行對應策略

以上一節的清單為例,請求 login.example.com 時會先命中 DOMAIN,因此採用 DIRECT;請求 static.example.com 時會略過第一條,再命中 DOMAIN-SUFFIX,因此採用 PROXY。若將兩行對調,login.example.com 符合 example.com 的後綴條件,會先被送往 PROXY,後面的 DOMAIN 不會再將策略改為 DIRECT。

請求目標第一個命中項目採用策略判斷依據
login.example.comDOMAINDIRECT精確例外位於後綴規則之前
static.example.comDOMAIN-SUFFIXPROXY屬於 example.com 的子網域
192.168.1.20IP-CIDRDIRECT目標位址位於 192.168.0.0/16
其他目標GEOIP 或 FINAL依第一個命中項目決定先檢查位址歸屬,未命中時再套用預設規則

結論:先移動例外規則,再新增規則

已有精確規則卻仍採用錯誤策略時,先檢查它上方是否有涵蓋相同目標的寬泛條件;將例外移到該條件之前,再建立新連線驗證。不要在清單末尾重複新增同一條規則。

將 FINAL 放在規則清單末尾

FINAL 不會再檢查特定網域或網段,而是接手處理執行到此處的其餘請求,因此必須放在所有需要參與判斷的規則之後。即使在 FINAL 下方寫了網域例外,語法看起來完整,該例外也不會有機會執行。

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,PROXY

此片段展示「特定拒絕、網域例外、網域通則、私有網段、最終策略」的順序,但並非適用於所有環境的通用設定。若 example.com 的子網域實際解析到私有位址,仍可能先命中上方的網域規則;若要讓私有位址優先直連,則需配合 DNS 與目標位址的可見性重新安排順序。

1 條
由第一個命中項目決定本次規則比對結果
3 種
本文使用 PROXY / DIRECT / REJECT 三種策略
末尾
FINAL 放在所有待檢查條件之後

FINAL,PROXY 表示未命中上述條件的請求使用代理;FINAL,DIRECT 則表示其餘請求直接連線。兩者沒有普遍適用的優劣,請依預設出口需求選擇。需要變更預設策略時,請替換原有的 FINAL,不要保留多條互相衝突的 FINAL。

區分三種執行策略

規則類型決定「哪些請求符合條件」,策略則決定「符合後如何處理」。修改策略不會改變比對範圍。例如將 DOMAIN-SUFFIX 的 PROXY 改成 REJECT,影響的是該後綴涵蓋的所有目標,而不只是某個網頁中的特定資源。

策略作用驗證重點
PROXY透過設定檔使用的代理出口傳送請求確認出口可用,不要只看規則是否命中
DIRECT透過本機網路直接連線至目標確認目前網路可連線至目標及其位址
REJECT拒絕符合條件的請求對應請求失敗通常是預期結果,並非代理延遲變高

DIRECT 不代表關閉 Shadowrocket 的連線開關,也不等於在 Global Routing 中切換為 Direct。連線保持啟用時,不同請求仍可分別命中 DIRECT、PROXY 或 REJECT。REJECT 也不是用來隱藏網頁元素的規則;若頁面所需的指令碼、登入介面或圖片網域遭到拒絕,頁面可能無法完整載入。

儲存與驗證順序

編輯前先保留原始設定檔,優先在副本上驗證。遠端設定檔更新可能會覆蓋本機修改;服務商提供的連線訂閱更新,也與規則設定檔更新不同。訂閱連結請向你的服務商取得,不要只為調整一條網域規則就重新匯入所有連線。

  1. 記錄測試條件。記下目標網域、目前網路、Global Routing 模式及正在使用的設定檔,避免同時變更多個條件。
  2. 編輯生效中的檔案。在 Config 找到目前使用的設定檔,透過檔案的編輯入口檢查 [Rule];將例外插入涵蓋該例外的規則之前。
  3. 檢查語法。確認英文逗號、規則關鍵字、網域及網段正確;FINAL 只填寫策略,不要加入空白的比對欄位。
  4. 儲存並確認已啟用。儲存後再次確認 Config 中選取的檔案。若修改後舊連線仍維持不變,可先中斷再重新連線,以排除舊工作階段的影響。
  5. 重新發出請求。關閉目標頁面的舊連線後重新瀏覽,並在目前平台提供的連線記錄或日誌中確認目標、命中規則及出口策略。
  6. 每次只修改一個條件再測試。若結果不符,先調整規則位置,再檢查 DNS 與出口,避免同時更換協定、網路及整份設定檔。

請以新連線進行驗證。瀏覽器重複使用連線、頁面快取及應用程式在背景維持的長連線,都可能導致儲存後的規則未立即反映在畫面上。同一頁面也可能連線至多個網域:主文件直連,不代表圖片、介面及影片連線也採用相同策略。

常見規則問題

已設定 DIRECT,為什麼仍使用 PROXY?

先到 Home 確認 Global Routing 是否設為 Config,再到 Config 確認目前啟用的檔案。接著檢查 DIRECT 上方是否有 DOMAIN-SUFFIX、GEOIP 或 FINAL 先行命中;將必要的精確例外移到前面,儲存後以新連線重新測試。

DOMAIN-SUFFIX 需要加星號嗎?

若要比對 example.com 及其子網域,寫成 DOMAIN-SUFFIX,example.com,PROXY 即可,不必寫 *.example.com,也不要加上網址路徑。若只比對 login.example.com,請改用 DOMAIN,並將規則放在寬泛的後綴規則之前。

新增私有網段規則後,為什麼仍無法開啟區域網路網域?

先區分「直接存取 192.168.1.20」與「存取解析至該位址的網域」。檢查區域網路 DNS 是否能解析該網域,以及上方的網域規則是否已先行命中。帶有 no-resolve 的 IP-CIDR 不會為了比對而自行觸發解析;必要時,請為已知的區域網路網域新增位置更前面的 DOMAIN 例外。

更新設定檔後,自訂規則為什麼不見了?

確認更新的是遠端規則設定檔,還是 Home 中的連線訂閱。若遠端設定檔覆蓋了本機檔案,請還原事先保留的副本,再確認新增的規則;不要假設手動修改會自動合併至遠端來源。長期使用前,請先確認自己的設定檔儲存與更新方式。

如需查詢更多條件與設定格式,請接著閱讀規則參考;若不確定 Config、Global Routing 或 DNS 的含義,請先查閱術語手冊。先確認少量規則的命中結果,再逐步擴充清單,會更容易找出規則覆蓋與順序問題。

下載 Shadowrocket