本文適合已在 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] 是設定檔中的規則區段。如果目前檔案已有這個區段,請將規則加入原有區段,不要在檔案末尾反覆新增同名區段。以上是規則片段,不包含完整設定檔中的其他設定,也不會自動建立代理連線。
DIRECT:直接連線至目標,不經代理連出。PROXY:透過代理連出,Home 中必須已有可用連線並選取相應項目。REJECT:拒絕符合條件的連線,僅用於確定需要封鎖的目標。- 自訂策略名稱:必須與目前設定檔中已定義的策略或策略組名稱一致,不能只在規則末尾任意填入新名稱。
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
192.168.0.0/16表示 192.168.0.0 至 192.168.255.255,常見於區域網路。這不代表所有私有位址範圍。10.0.0.0/8表示 10.0.0.0 至 10.255.255.255。若實際網路使用其他網段,請依實際位址補上規則,不要假設這兩行已涵蓋所有內網。GEOIP,CN,DIRECT表示對資料庫判定為 CN 歸屬的目標 IP 使用 DIRECT。資料庫中的地區歸屬與實際連線能力是兩回事。no-resolve表示不為了匹配這條 IP 規則而額外觸發網域解析;它不是關閉 DNS,也不會禁止已有 IP 參與匹配。
目標是網域,而目前沒有可供判斷的 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 | 第一條 DOMAIN | PROXY;不再檢查後面的 example.com 後綴規則。 |
| www.example.com | 第二條 DOMAIN-SUFFIX | DIRECT;不必等到 GEOIP 決定策略。 |
| blocked.example.net | 第三條 DOMAIN-SUFFIX | REJECT;此時拒絕連線符合規則預期。 |
| 192.168.1.20 | 第四條 IP-CIDR | DIRECT;目標本身就是該網段內的 IP。 |
| 前面規則都未匹配的目標 | FINAL | PROXY;不代表前面的規則有誤。 |
FINAL 應放在規則清單末尾。若將它放在前面,後續規則就沒有正常參與匹配的機會。修改現有設定檔時,先找到已有的 FINAL,將新增規則插在它前面即可;不必為每一類規則再加一條 FINAL。
6. 以最小幅度修改驗證規則是否生效
不要同時修改 DNS、連線參數、策略組和大量規則,否則出問題時很難判斷原因。先保留原設定檔的副本,再只加入一條容易辨識的網域規則。規則決定連出策略;Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定的連線參數仍由既有服務設定決定,不能靠修改規則補上缺少的參數。
-
備份目前設定檔
進入 Config,先保留目前設定檔的副本或匯出備份,再編輯正在使用的檔案。不要用只有 [Rule] 的範例片段覆蓋完整設定檔。
-
加入單一規則
在 [Rule] 中、現有 FINAL 之前加入目標規則。例如要測試單一主機時使用 DOMAIN,條件只填主機名稱;也要檢查它前面是否已有涵蓋相同網域的規則。
-
確認目前路由模式
儲存後,在 Config 確認該檔案已啟用,再前往 Home → Global Routing → Config。若原本使用 Scene,先排除 Scene 自動切換的影響,再進行單次驗證。
-
重新建立連線
關閉目標頁面或 App 後重新造訪,必要時中斷並重新連線 VPN。既有的長連線可能繼續沿用建立時的策略,因此不能只靠重新整理同一頁面,判斷所有規則都已重新匹配。
-
檢查連線記錄
搭配連線記錄核對目標主機、目標 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。