Shadowrocket 規則語法入門:DOMAIN-SUFFIX、GEOIP、IP-CIDR 與 FINAL 匹配順序

逐一說明 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、GEOIP、IP-CIDR、FINAL 的匹配範圍與順序,並提供可直接套用的規則範例。

本文重點

本文適合已在 Shadowrocket(小火箭)匯入自有服務,準備編輯 Config 的使用者。先分清 Global Routing 與規則策略,再了解網域、IP 和最終兜底規則,最後用最精簡的規則片段驗證匹配結果。重點在於「請求符合哪一行條件、該行指定哪個策略」,而不是依目標網站名稱猜測連線路徑。

1. 先確認 Global Routing 是否使用 Config

規則文字存在,不代表目前連線正使用這些規則。Home 管理既有連線和訂閱,Config 管理設定檔,Settings 管理 App 設定。開始排查前,請在 Home 開啟 Global Routing,確認目前使用 Config,並在 Config 確認已啟用的檔案。以下步驟以 iPhone/iPad 介面為例。

Global Routing 選項檢查重點
Proxy以全域代理模式處理流量,不適合用來驗證 Config 中逐條規則的分流結果。
Direct以全域直連模式處理流量;修改規則不能取代切換回 Config。
Config依目前設定檔中的規則決定連線策略,這是本文進行規則測試的前提。
Scene依已設定的 Scene 切換路由行為;排查問題時,先確認目前 Scene 實際採用的設定。

Settings → On Demand 控制依條件建立 VPN 連線,並非決定特定網域使用 DIRECT 或 PROXY 的規則。測試前請先確認連線已建立,再判斷規則是否匹配;否則可能把「隧道未連線」誤認為「FINAL 未生效」。

請求進入隧道 擷取目標資訊 依序檢查規則 選擇匹配策略 建立目標連線

2. 一條規則由類型、條件與策略組成

常見規則以英文逗號分隔。前三項通常依序為規則類型、匹配條件和執行策略,部分規則也接受附加參數。FINAL 是例外:它沒有獨立的匹配條件,後面直接填寫策略。請勿使用中文逗號,也不要將瀏覽器網址列中的完整 URL 當成網域條件照抄。

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

這裡的 [Rule] 是設定檔中的規則區段。如果目前檔案已有這個區段,請將規則加入原有區段,不要在檔案末尾反覆新增同名區段。以上是規則片段,不包含完整設定檔中的其他設定,也不會自動建立代理連線。

3. DOMAIN、DOMAIN-SUFFIX 與 DOMAIN-KEYWORD 的適用範圍

網域規則檢查目標主機名稱,不檢查 URL 路徑或查詢參數。例如造訪 https://api.example.com:443/v1/status 時,網域條件應填 api.example.com,不包含 https://、連接埠 443 或 /v1/status。連接埠不是這三種網域規則的匹配欄位。

規則範例匹配範圍範圍說明
DOMAIN,api.example.com,PROXY只匹配完整主機名稱 api.example.com。不匹配 www.example.com,也不匹配 x.api.example.com。
DOMAIN-SUFFIX,example.com,PROXY匹配 example.com 本身及其子網域。匹配 api.example.com;不匹配 notexample.com。
DOMAIN-KEYWORD,example,PROXY檢查主機名稱是否包含 example 這段字串。可能匹配 notexample.com;匹配範圍比後綴規則廣。

若要匹配「主網域及其所有子網域」,通常選用 DOMAIN-SUFFIX,不必寫 *.example.com。星號並非表示子網域範圍的必要語法。若只要針對單一 API 主機設定例外,先寫 DOMAIN,再寫涵蓋範圍較廣的 DOMAIN-SUFFIX。

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

依照這個順序,api.example.com 會先匹配第一行並使用 PROXY;www.example.com 不符合第一行,接著匹配第二行並使用 DIRECT。如果將第二行移到最前面,api.example.com 也會先匹配到 DIRECT,後面的精確規則便無法再變更其策略。

4. IP-CIDR、GEOIP 與 no-resolve 的用途

IP-CIDR 依 IP 位址所屬網段匹配,GEOIP 則依 IP 地理資料庫中的地區歸屬匹配。兩者處理的是 IP 資訊,不是網頁語言、帳號地區或網域註冊地。單一網域可能解析出多個位址,也可能使用跨地區的內容傳遞節點,因此 GEOIP 結果不能直接等同於網站所屬地區。

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

目標是網域,而目前沒有可供判斷的 IP 時,帶有 no-resolve 的 IP 規則不會為了自身匹配而額外要求解析。因此,「網域最後解析到內網位址」與「這條帶 no-resolve 的規則一定會先匹配」並非同一回事。若要穩定處理已知的內部網域,可在 IP 規則之前加入明確的 DOMAIN 或 DOMAIN-SUFFIX 條件。

5. 由上往下首次匹配,FINAL 放在最後

在 Config 的一般規則處理中,規則會依序檢查,第一條符合的規則決定策略。不要以為「越精確的規則會自動優先」:DOMAIN 不會因為比 DOMAIN-SUFFIX 精確,就跳過排在前面的後綴規則。規則順序必須由設定檔編輯者明確安排。

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

這組片段依序表示精確例外、網域範圍、明確拒絕目標、區域網路位址、地區 IP,以及最後的兜底策略。這只是順序範例,並非適用所有網路的建議設定。若既有服務或本機資源需要不同策略,請保留原有條件,逐項檢查規則的涵蓋關係。

測試目標預期匹配規則結果說明
api.example.com第一條 DOMAINPROXY;不再檢查後面的 example.com 後綴規則。
www.example.com第二條 DOMAIN-SUFFIXDIRECT;不必等到 GEOIP 決定策略。
blocked.example.net第三條 DOMAIN-SUFFIXREJECT;此時拒絕連線符合規則預期。
192.168.1.20第四條 IP-CIDRDIRECT;目標本身就是該網段內的 IP。
前面規則都未匹配的目標FINALPROXY;不代表前面的規則有誤。

FINAL 應放在規則清單末尾。若將它放在前面,後續規則就沒有正常參與匹配的機會。修改現有設定檔時,先找到已有的 FINAL,將新增規則插在它前面即可;不必為每一類規則再加一條 FINAL。

6. 以最小幅度修改驗證規則是否生效

不要同時修改 DNS、連線參數、策略組和大量規則,否則出問題時很難判斷原因。先保留原設定檔的副本,再只加入一條容易辨識的網域規則。規則決定連出策略;Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定的連線參數仍由既有服務設定決定,不能靠修改規則補上缺少的參數。

  1. 備份目前設定檔

    進入 Config,先保留目前設定檔的副本或匯出備份,再編輯正在使用的檔案。不要用只有 [Rule] 的範例片段覆蓋完整設定檔。

  2. 加入單一規則

    在 [Rule] 中、現有 FINAL 之前加入目標規則。例如要測試單一主機時使用 DOMAIN,條件只填主機名稱;也要檢查它前面是否已有涵蓋相同網域的規則。

  3. 確認目前路由模式

    儲存後,在 Config 確認該檔案已啟用,再前往 Home → Global Routing → Config。若原本使用 Scene,先排除 Scene 自動切換的影響,再進行單次驗證。

  4. 重新建立連線

    關閉目標頁面或 App 後重新造訪,必要時中斷並重新連線 VPN。既有的長連線可能繼續沿用建立時的策略,因此不能只靠重新整理同一頁面,判斷所有規則都已重新匹配。

  5. 檢查連線記錄

    搭配連線記錄核對目標主機、目標 IP、匹配規則和最終策略。先確認是否匹配預期規則,再檢查所選連線能否連上目標;不要只憑網頁是否開啟來判斷。

在 Home 更新 Subscribe,主要是更新既有訂閱提供的連線資訊;這不會自動將目前 Config 的規則改成剛編輯的內容。反過來說,重新下載遠端設定檔可能會取代其中的文字。編輯前請先分清楚自己操作的是訂閱、遠端設定檔,還是本機設定檔副本。

7. 分辨連線錯誤與規則問題

以下是連線記錄中可能出現的網路錯誤原文,並非規則解析器固定顯示的訊息。先檢查記錄中的最終策略:匹配 REJECT、代理服務連線失敗,以及目標伺服器拒絕連線,處理方式各不相同。單憑錯誤訊息不足以證明 DOMAIN-SUFFIX 寫法有問題。

錯誤:Connection refused

原因與解決方式:對端拒絕連線,常見原因是該位址的連接埠沒有服務在監聽。先依記錄確認被拒絕的是代理伺服器還是目標伺服器,再核對自有服務的位址和連接埠;將網域規則改成 GEOIP 無法修正錯誤的連接埠。

錯誤:Operation timed out

原因與解決方式:連線未能在等候期限內完成,可能與所選連出方式、目標服務或目前網路有關。先確認匹配的策略,再在相同目標和網路條件下每次只切換一個變數測試;不要一次重新排列整份規則。

設定了 DOMAIN,為什麼子網域沒有一起匹配?

DOMAIN 只匹配完整主機名稱。若要同時涵蓋 example.com 和 api.example.com,請改用 DOMAIN-SUFFIX,example.com,PROXY;並檢查前面是否已有先匹配的規則。

規則放在最下面,為什麼一直沒有生效?

開啟目前 Config 的 [Rule],找到 FINAL。將需要參與匹配的規則移到 FINAL 之前,再檢查排在更前面的 DOMAIN-SUFFIX 或 DOMAIN-KEYWORD 是否已涵蓋同一目標。

切換到 Proxy 就能連線,是規則寫錯了嗎?

這只能說明兩種路由模式的連出結果不同。回到 Home → Global Routing → Config,查看目標是否匹配 DIRECT 或 REJECT;若匹配了不正確的條件,請調整該條件或順序,而非直接刪除所有直連規則。

更新訂閱後,規則為什麼沒有變?

先分清楚 Home 中的 Subscribe 與 Config 中的設定檔。回到 Config 檢查已啟用的檔案及其 [Rule] 內容;更新連線訂閱不等於更新規則檔,也不會自動將全域路由模式切換為 Config。

取得 Shadowrocket 與入門教學

iPhone/iPad 可在 App Store 以 $2.99 一次性購買,開發者為 Shadow Launch Technology Limited;系統需求以 App Store 頁面標示為準。Mac(Apple 晶片/Intel)、Windows、Android 和 Linux 版免費。下載頁依平台列出取得方式,入門教學則說明如何匯入既有服務並檢查連線。

Shadowrocket 全平台下載