2026-10-24 · 規則進階 · 約 8 分鐘

Shadowrocket 規則設定教學:DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 匹配方式

逐一了解 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 的匹配方式與順序,並學會搭配 PROXY、DIRECT、REJECT 撰寫第一條規則。

本文重點

適合已安裝 Shadowrocket,並想在現有 Config 中新增分流規則的讀者。先分清網域規則與目的 IP 規則,將例外規則放在範圍較廣的規則之前,再查看連線記錄確認命中規則與套用策略。文中的網域和位址僅用於說明語法,無須匯入訂閱即可閱讀與核對。

規則順序:由上往下,符合第一條即生效

在 Home 將 Global Routing 設為 Config 後,Shadowrocket 的連線才會依目前設定中的規則分流。設定文字中的 [Rule] 區段通常每行一條規則,格式為 類型,匹配值,策略。FINAL 是例外:不需填匹配值,直接寫成 FINAL,策略。

應用程式發起連線讀取目標資訊依序比對規則採用第一條符合的策略執行連線處理

系統不會自動將精確的 DOMAIN 規則排到前面。如果某條 DOMAIN-SUFFIX 已符合,寫在後面的精確網域例外就不會生效。同樣地,若將 FINAL 放在中間,符合到這裡的連線便會套用預設策略,後續規則也就沒有比對機會。

網域規則:完整網域、後綴與包含字串

網域規則比對的是主機名稱,不是完整 URL。以 https://docs.example.com:443/guide 為例,規則中填入 docs.example.com,不含 https://、連接埠 443 或路徑 /guide。若要讓同一主機上的不同網頁路徑採用不同策略,無法透過以下三種網域規則區分。

類型與匹配值符合範例不符合範例
DOMAIN,example.comexample.comdocs.example.com:不是相同的主機名稱。
DOMAIN-SUFFIX,example.comexample.com、docs.example.comnotexample.com:沒有標籤邊界。
DOMAIN-KEYWORD,exampleexample.com、notexample.netsample.net:不包含指定字串。

DOMAIN-SUFFIX 直接填入 example.com,不必寫 *.example.com。若只要調整單一主機,優先使用 DOMAIN;若主網域與子網域都採用相同策略,再使用 DOMAIN-SUFFIX。DOMAIN-KEYWORD 的匹配範圍最容易超出預期,尤其是較短的關鍵字:它不要求關鍵字完整對應一個網域標籤,也不要求出現在網域開頭。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,REJECT
FINAL,DIRECT

依照上方範例,docs.example.com 符合第一條規則,使用 DIRECT;www.example.com 符合後綴規則,使用 PROXY;notexample.net 則會被關鍵字規則拒絕。這條關鍵字規則僅用來示範誤匹配範圍,不建議直接套用於日常設定。若將前兩條規則對調,docs.example.com 會先符合後綴規則,這正是精確例外必須放在前面的原因。

IP 規則:IP-CIDR、GEOIP 與預設規則

網域規則未符合時,可以繼續依目的位址判斷連線策略。IP-CIDR 檢查目的 IPv4 位址是否落在指定網段;GEOIP 依目的 IP 在地理位置資料庫中的分類判斷,不看網域後綴,也不判斷手機所在位置。若特定網域需要例外處理,請將相應的網域規則放在範圍較廣的 IP 規則之前。

[Rule]
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

新增第一條規則並驗證

第一次修改時,只新增一條範圍明確的規則,不要同時調整 DNS、代理線路與預設策略。以下以 DOMAIN,example.com,DIRECT 說明操作;若目前網路無法直接連線至該網站,請改用已確認可直接連線的測試主機。

  1. 備份目前的設定

    在 Config 確認目前使用的檔案,並先保留一份副本。若檔案會從遠端更新,請在自用的本機副本上修改,以免下次更新時變更被覆蓋。

  2. 新增精確規則

    進入 Config,開啟要編輯的設定詳細資料,在 Rules 中新增 DOMAIN,匹配值填入 example.com,策略選擇 DIRECT。若以文字編輯,請將對應規則行寫入 [Rule]。

  3. 確認位置與模式

    將新規則放在可能覆蓋它的後綴規則、關鍵字規則及 FINAL 之前。儲存並確認正在使用修改後的檔案,接著在 Home → Global Routing 選擇 Config,然後開啟連線開關。

  4. 重新發起連線進行驗證

    關閉原本的測試頁面後重新發送請求,避免沿用瀏覽器既有連線。前往 Data 查看這次請求的記錄,依主機名稱與時間定位,確認策略是否為 DIRECT。若頁面有重新導向或載入其他主機的資源,請分別查看相關記錄。

驗證失敗:分辨 DNS、目標連接埠與規則匹配

頁面無法開啟,不代表規則沒有生效。先在 Data 核對失敗連線的目標與策略。若有匹配記錄但頁面仍無法載入,再查看瀏覽器錯誤訊息;以下錯誤是 Chromium 的提示,不是 Shadowrocket 的規則名稱。

錯誤:ERR_NAME_NOT_RESOLVED

原因:瀏覽器無法取得目標主機可用的解析結果,可能是主機名稱拼錯,或目前使用的 DNS 無法解析。解決方式:確認網址列中的實際主機名稱,再於相同網路測試已知可解析的網域;先確認解析正常,不要透過移動 FINAL 排查 DNS 問題。

錯誤:ERR_CONNECTION_REFUSED

原因:連線嘗試遭到拒絕,例如 HTTPS 目標未在預期的 TCP 443 連接埠接受連線。解決方式:先確認實際套用的策略是否為 REJECT,再檢查 URL 的協定與連接埠;若測試的是自行管理的服務,請確認服務正在對應的連接埠監聽。

常見問題:規則未匹配時,先檢查哪些項目

為什麼新增 DIRECT,記錄中仍顯示 PROXY?

先在 Home → Global Routing 確認已選擇 Config,再回到 Config 檢查啟用的檔案是否就是剛才修改的檔案。接著從 [Rule] 第一行往下檢查,確認是否有後綴或關鍵字規則更早匹配;找到後,再將精確例外移到該規則之前。

為什麼同一個網頁會出現多種策略?

網頁內容、圖片和指令碼可能來自不同主機,也可能經過重新導向。前往 Data 對照發起時間與各連線的目標主機,不要只看分頁標題。若要讓另一個資源主機使用相同策略,請先為該主機新增精確規則,不要直接擴大為關鍵字匹配。

Connectivity Test 已通過,為什麼網站還是無法開啟?

Connectivity Test 測試的是指定目標,不代表目前網頁符合預期策略,也不代表網頁的所有資源都能連線。重新開啟目標頁面,再前往 Data 查看該網站的記錄;若實際使用 DIRECT,先檢查本機網路是否能連上該網站;若使用 PROXY,再檢查所選線路。

Global Routing 中的 Scene 可以取代 Config 嗎?

驗證單條規則時,請先固定使用 Config。Proxy 和 Direct 是全域路由模式,不適合用來驗證逐條規則;Scene 會依場景設定選擇路由方式,場景變更可能影響結果。先在 Config 確認同一目標的匹配情況,再切回平常使用的 Scene 複查。

下載 Shadowrocket 與查看教學

iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片 / Intel)、Windows、Android、Linux 版免費,安裝檔請從本站下載頁取得。

下載 Shadowrocket