本文摘要

本文適合已在 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 中啟用的設定檔則負責編排分流條件;兩者並非同一項選擇。匯入服務資訊,不代表已啟用某份規則設定檔,也不代表目前請求一定會經過代理。

  1. 備份設定檔

    進入 Config,確認目前啟用的設定檔,並先保留一份副本。接下來只修改副本中的 [Rule],保留原有連線參數與其他設定區段,方便還原。

  2. 確認出口

    返回 Home,確認已匯入自己的服務資訊,且所需的代理出口可用。規則中的 PROXY 是處理策略,不會自動建立服務位址、連接埠或驗證資訊。

  3. 選擇分流方式

    在 Home → Global Routing → Config 選擇依設定檔處理。如果目前選的是 Proxy 或 Direct,不應只憑存取結果判斷 [Rule] 中某一行是否生效。

  4. 編輯並驗證

    返回 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 及其子網域僅用於說明語法。

6 類
本文介紹的常用比對關鍵字
3 種
範例策略:PROXY / DIRECT / REJECT
最後一行
FINAL 接手處理前面未命中的請求

判斷順序:先找命中規則,再檢查出口

修改規則後,先確認新請求命中了哪一行;若策略正確,再檢查該策略對應的連線能力。不要用「網頁能不能開」取代規則命中檢查。

三、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-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 處理。若原設定使用策略組名稱,必須保留並確認該組的定義,不可任意改成不存在的名稱。

  1. blocked.example.com 在第一行被 REJECT 拒絕,不會再檢查後面的網域後綴規則。
  2. api.example.com 在第二行交由 PROXY 處理,不會因為同屬 example.com 而改為直連。
  3. www.example.com 命中第三行,透過 DIRECT 使用目前網路直接連線。
  4. 其他未符合網域或 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 規則時,還要另外檢查目標位址與解析結果。

記憶時可分成三組:DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 用來判斷「網域是否符合條件」;GEOIP、IP-CIDR 用來判斷「目標 IP 是否符合條件」;FINAL 則決定「其餘請求如何處理」。先掌握這三組的用途和由上而下的順序,再擴充複雜策略,排查時就能定位到具體規則。