本文適合已在 Shadowrocket(小火箭)匯入自有服務資訊,並準備編輯分流規則的使用者。請先確認目前使用的設定檔與 Global Routing,再區分網域條件、IP 條件和兜底條件;讀完即可判斷規則會涵蓋哪些請求、應放在哪個位置,以及修改後要檢查哪筆連線記錄。
一、先確認裝置取得方式與規則入口
尚未安裝的話,請先前往全平台下載頁選擇裝置:iPhone / iPad 版從 App Store 取得,售價 $2.99,單次付費;開發者為 Shadow Launch Technology Limited,系統需求請以 App Store 頁面標示為準。Mac(Apple 晶片 / Intel)、Windows、Android、Linux 版免費。本文僅介紹用戶端規則,不提供、販售或推薦節點或訂閱;以下操作均以使用者已有自己的服務商與訂閱為前提。
分流規則位於設定檔的 [Rule] 區段。Home 中選取的連線負責提供可用的代理出口,Config 中啟用的設定檔則負責編排分流條件;兩者並非同一項選擇。匯入服務資訊,不代表已啟用某份規則設定檔,也不代表目前請求一定會經過代理。
-
備份設定檔
進入 Config,確認目前啟用的設定檔,並先保留一份副本。接下來只修改副本中的
[Rule],保留原有連線參數與其他設定區段,方便還原。 -
確認出口
返回 Home,確認已匯入自己的服務資訊,且所需的代理出口可用。規則中的
PROXY是處理策略,不會自動建立服務位址、連接埠或驗證資訊。 -
選擇分流方式
在 Home → Global Routing → Config 選擇依設定檔處理。如果目前選的是 Proxy 或 Direct,不應只憑存取結果判斷
[Rule]中某一行是否生效。 -
編輯並驗證
返回 Config,開啟該設定檔的編輯入口,修改並儲存規則,確認啟用的仍是這份設定檔。接著送出新的請求,在連線記錄中核對目標、命中的規則與處理策略。
二、規則格式:條件在前,處理策略在後
常見規則的欄位以英文半形逗號分隔。大多數條件規則的格式為 類型,比對值,策略;FINAL 沒有比對值,直接填寫策略即可。網域比對值不填 https://、網頁路徑、查詢參數或連接埠。存取 https://example.com:8443/docs 時,網域條件仍填寫 example.com,而非整段網址。
[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
DOMAIN-KEYWORD,example,REJECT
GEOIP,CN,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY
以上範例用來展示六種格式,不建議整段直接套用為實際設定:同一個請求可能符合多項條件,前面的規則會優先於後面的規則。192.0.2.0/24 是文件示例網段,不是可用的服務位址;example.com 及其子網域僅用於說明語法。
判斷順序:先找命中規則,再檢查出口
修改規則後,先確認新請求命中了哪一行;若策略正確,再檢查該策略對應的連線能力。不要用「網頁能不能開」取代規則命中檢查。
三、DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 的適用範圍
這三類規則都依賴可供比對的目標網域,但涵蓋範圍各不相同。DOMAIN 比對完整網域;DOMAIN-SUFFIX 涵蓋指定網域及其下層子網域;DOMAIN-KEYWORD 則比對網域中的字串,不受網域層級限制。需求越明確,越應優先採用範圍清楚的寫法。
| 規則範例 | 比對範圍 | 範圍說明 |
|---|---|---|
DOMAIN,example.com,PROXY |
example.com |
不包含 api.example.com,需要另加一條規則。 |
DOMAIN-SUFFIX,example.com,DIRECT |
example.com、api.example.com、img.api.example.com |
依網域層級比對,不是任意字串結尾比對。 |
DOMAIN-KEYWORD,api,REJECT |
api.example.com、myapi.example.com |
只要網域任意位置出現該關鍵字,就會比對成功,可能涵蓋不相關的請求。 |
如果只想讓一個 API 網域走代理,使用 DOMAIN,api.example.com,PROXY 比關鍵字規則更容易檢查。如果同一網域下的所有子網域都應直連,可以使用 DOMAIN-SUFFIX,example.com,DIRECT。只有在確實需要跨網域層級比對相同字串時,才適合使用關鍵字;不能只憑短字串命中,就判斷服務歸屬。
四、GEOIP 與 IP-CIDR:依目標 IP 判斷
GEOIP,CN,DIRECT 表示依目標 IP 的地理資料庫結果進行比對,其中 CN 是地區代碼。它判斷的不是網頁內容、網域後綴、帳號地區,也不是目前裝置所在位置。CDN、不同的 DNS 解析結果及資料庫差異,都可能讓同一個網域對應到不同的 IP 判斷結果。
IP-CIDR 則比對明確的 IPv4 網段。192.0.2.0/24 的前 24 位是網路前綴,涵蓋 192.0.2.0 到 192.0.2.255 的位址範圍;若只指定一個 IPv4 位址,可以使用 /32。遮罩數字越大,比對範圍通常越小。不要把某次解析取得的單一 IP,當成網站永久不變的所有位址。
- 直接使用 IP 存取:請求目標本身就是 IP 時,不必經過網域解析,即可判斷它是否屬於相應網段。
- 透過網域存取:IP 類規則可能需要先取得解析結果,才能判斷目標位址是否符合條件;這與前述網域規則屬於不同階段的條件。
no-resolve:加在支援此參數的 IP 類規則後,表示不會為比對該規則而主動觸發網域解析;已有目標 IP 時仍可進行判斷。這不等於「關閉所有 DNS」。- IPv6:本文的
IP-CIDR範例採用 IPv4 格式,不能直接換成 IPv6 位址照抄;處理 IPv6 時,應使用對應的規則類型與位址前綴。
IP-CIDR,192.0.2.8/32,DIRECT,no-resolve
IP-CIDR,192.0.2.0/24,PROXY,no-resolve
GEOIP,CN,DIRECT
在這組獨立範例中,目標為 192.0.2.8 時會先命中單一位址規則;目標為 192.0.2.20 時,才會符合下方的網段規則。若將 /24 放在第一行,單一位址例外就不會生效。是否使用 no-resolve 應依分流設計決定,不要把它當成通用的加速開關。
五、FINAL 與規則順序:先例外,再範圍,最後兜底
規則通常由上而下檢查,第一條命中的規則會決定後續處理,不會彙整所有命中結果後再挑選「最精確」的一條。因此,「精確規則優先」指的是撰寫順序,不是系統會自動替使用者排序。FINAL 接手處理前面未命中的請求,應放在規則清單末尾。
[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
這段範例呈現的是「個別網域例外 → 網域範圍 → IP 條件 → 兜底」的編排方式,並非所有環境都必須採用的固定範本。實際使用前,應確認是否確實需要依地區直連,以及未命中的流量是否適合交由 PROXY 處理。若原設定使用策略組名稱,必須保留並確認該組的定義,不可任意改成不存在的名稱。
blocked.example.com在第一行被REJECT拒絕,不會再檢查後面的網域後綴規則。api.example.com在第二行交由PROXY處理,不會因為同屬example.com而改為直連。www.example.com命中第三行,透過DIRECT使用目前網路直接連線。- 其他未符合網域或 IP 條件的請求,最後交由
FINAL,PROXY處理。
DIRECT 不代表一定能連線,只表示不使用所選的代理出口。PROXY 不代表一定能連上目標,仍取決於目前的代理與遠端服務。REJECT 則會主動拒絕符合條件的請求;若瀏覽器因此顯示連線失敗,請先確認這是否正是規則預期的行為,而非立刻修改協定參數。
六、規則未如預期生效時的檢查順序
驗證時一次只修改一項條件,並建立新連線。瀏覽器既有的長連線可能繼續使用連線建立時決定的路徑;儲存規則後只重新整理頁面,不一定會觸發全新的連線判斷。記錄測試目標、目前的 Global Routing、啟用中的設定檔、命中行與最終策略,才能區分語法問題與連線問題。
寫了 DOMAIN,為什麼子網域沒有走代理?
確認請求目標是否為 api.example.com,而規則是否只寫了 example.com。若要涵蓋整個網域及其子網域,請改用 DOMAIN-SUFFIX;若只需涵蓋單一子網域,則新增對應的 DOMAIN,並放在較廣泛的規則之前。
已新增規則,為什麼所有請求還是直連?
先檢查 Home → Global Routing,確認選的是 Config 而非 Direct;再到 Config 確認實際啟用的檔案。修改未啟用的副本,不會改變目前連線的分流方式。
訂閱更新後,本機規則怎麼恢復原狀了?
先區分 Home 中的服務訂閱更新與 Config 中的遠端設定檔更新。前者主要維護服務項目,後者則可能取代設定檔內容。若要長期保留本機規則,請先另存獨立副本,並比較更新前後的 [Rule];不要只在唯一的副本上反覆嘗試修改。
開啟 On Demand,就會自動套用規則嗎?
Settings → On Demand 管理依條件觸發連線的行為,不會取代 Global Routing 的分流選擇。連線觸發後,仍應檢查目前使用的模式與設定檔;不能把「已連線」視為「已依某條規則處理」。
如果記錄已顯示命中預期規則,下一步才檢查傳輸層。以下是連線診斷中可能出現的原始錯誤文字,並非 [Rule] 語法錯誤的固定提示;不同系統顯示的措辭可能不同,應搭配錯誤發生於直連目標或代理出口來判斷。
錯誤:Connection refused
原因:目標主機或中間設備明確拒絕連線,可能是連接埠沒有在監聽。解決方式:先確認命中的策略,再核對自己的服務位址、連接埠與服務狀態;若命中 DIRECT,請檢查直連目標,而非只修改代理參數。
錯誤:Operation timed out
原因:連線或讀寫作業未能在等待期限內完成,僅憑這一行無法判定是規則、DNS 還是網路路徑問題。解決方式:記錄目標與命中策略,分別測試網域解析和所選出口,再核對服務連接埠;不要同時修改多條規則與協定設定。
七、儲存設定檔前的基本檢查清單
規則檔案不是越多越容易維護。重複的網域後綴、過短的關鍵字,以及太早出現的兜底規則,都會讓後續例外難以驗證。修改完成後,至少選取「精確例外、相同後綴的其他子網域、未命中的網域」三類目標檢查策略;涉及 IP 規則時,還要另外檢查目標位址與解析結果。
- 檢查
[Rule]區段與英文半形逗號,確認FINAL,PROXY這類兜底規則沒有多填比對值。 - 確認網域欄位沒有協定前綴、路徑、連接埠或多餘的前後空白。
- 將需要保留的精確例外放在
DOMAIN-SUFFIX、關鍵字與網段範圍規則之前。 - 確認
REJECT的適用範圍夠明確,避免用常見的短字串涵蓋大量不相關網域。 - 保留原始設定檔與修改後的副本,記錄每次變更的目的;向他人求助前,請移除驗證資訊與完整訂閱連結。
- 確認 Config 中啟用的是修改後的檔案,並在 Home → Global Routing 選擇 Config,再透過新連線複核結果。
記憶時可分成三組:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 用來判斷「網域是否符合條件」;GEOIP、IP-CIDR 用來判斷「目標 IP 是否符合條件」;FINAL 則決定「其餘請求如何處理」。先掌握這三組的用途和由上而下的順序,再擴充複雜策略,排查時就能定位到具體規則。