Shadowrocket設定檔語法攻略:掌握分流規則與實用配置技巧

不想再照抄別人的小火箭設定?從 .conf 檔案分段、規則匹配順序到遠端規則集引用,本文以實際配置範例說明如何建立並維護自己的代理分流。另附驗證思路,協助排查規則未命中的原因,並提醒 MitM 憑證及外部腳本的使用風險。

本文重點

本文適合想自行閱讀或修改 Shadowrocket(小火箭)設定檔的使用者。從常見區段與行格式開始,逐步理解 [Rule] 的比對順序、策略名稱與遠端規則集的角色,再透過單一變更驗證設定是否生效。範例中的網域、IP 與網址僅供說明語法,不是可直接使用的服務或規則清單;修改前請先備份,並特別留意外部設定來源、腳本與 MitM 憑證的安全風險。

一、先看懂 .conf 設定檔的基本結構

Shadowrocket 的設定檔是由多個區段組成的文字檔。區段名稱通常以方括號標示,例如 [General]、[Proxy]、[Proxy Group]、[Rule] 與 [Host]。每個區段負責不同工作:一般參數放在 [General],伺服器與策略組定義分別由相應區段管理,流量比對條件則放在 [Rule]。修改時要先確認內容屬於哪個區段,不要把規則行貼到一般參數區。

常見設定行有兩種形式:參數行以等號指定值,例如 key = value;規則行則以逗號分隔欄位,通常包含規則類型、比對值與策略。逗號前後是否有空格、策略名稱是否完全一致,都可能影響可讀性或匹配結果。建議沿用目前設定檔的排版方式,不要把整個檔案貼進單一行,也不要在不確定支援情況時自行加入額外欄位。

[General]
一般參數的區段;不要放入 [Rule] 規則行
[Proxy]
伺服器定義所在區段之一
[Proxy Group]
策略組定義所在區段之一
[Rule]
網域、IP 與兜底策略的規則區段

設定檔可能包含伺服器位址、驗證資料、訂閱網址或其他敏感內容。對外詢問時,請只貼已遮蔽資訊的最小片段,並刪除帳戶識別資料與網址中的 token。用戶端買斷不等於線路套餐;本文假設你已有自己的訂閱,訂閱連結應從你的服務商處取得。

二、用一段規則理解欄位與匹配順序

以下片段示範常見網域規則、IP 規則與兜底規則的排列。它只適合用來閱讀欄位,不是完整設定檔,也不應直接覆蓋現有的 [Rule]。實際使用時,請保留原檔案所需的策略名稱與規則,確認每條規則引用的策略確實存在。

[Rule]
DOMAIN,login.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
規則行 比對範圍 修改前檢查
DOMAIN 精確比對指定網域,例如 login.example.com。 網域欄位不寫 https://、路徑或查詢參數。
DOMAIN-SUFFIX 比對指定網域及其子網域;範例會涵蓋 example.com 的子網域。 範圍較廣,先確認不會意外涵蓋不想改變策略的服務。
IP-CIDR 比對指定 IPv4 網段;192.0.2.0/24 是文件示例範圍。 no-resolve 避免為這條規則額外觸發網域解析,不代表可以忽略實際比對條件。
GEOIP 與 FINAL GEOIP 依目標 IP 判斷;FINAL 用於前面規則都未命中的情況。 確認 GeoIP 判斷及兜底策略符合預期;不要把 FINAL 移到一般規則之前。

規則通常依序比對,先命中的規則決定該連線採用的策略。因此,上例中精確的 DOMAIN,login.example.com,DIRECT 放在較廣的 DOMAIN-SUFFIX,example.com,PROXY 之前,目的是讓該網域先符合 DIRECT。若將兩行對調,該網域可能先符合較廣的規則。請注意,這是示範規則順序,不表示特定網站應使用哪種策略。

最後一欄既可以是 DIRECT、PROXY 等策略,也可能是設定檔中定義的策略組名稱。若規則指向一個不存在或拼字不同的名稱,即使比對條件正確,結果也可能不是預期的路由。修改前先搜尋整份設定,確認策略定義與引用名稱一致;此外,Global Routing 必須採用 Config,相關規則才會按目前設定檔參與分流。

三、遠端規則集:引用來源不等於規則已驗證

遠端規則集可讓設定引用外部維護的規則內容,減少把大量規則逐行複製到本機設定檔的需要。常見概念是以 RULE-SET 指向規則來源並指定策略;不過,具體可用格式、更新方式及來源格式,應以目前 Shadowrocket 版本與該規則集的說明為準。不要假設所有其他工具的語法都能直接套用,也不要只因網址可開啟,就認定內容已成功載入並參與比對。

[Rule]
RULE-SET,https://rules.example.com/sample.list,PROXY
FINAL,DIRECT

上方的 example.com 網址只是佔位示例,不能用來實際匯入。實際設定時,先確認遠端文件確實是 Shadowrocket 可識別的規則格式,並核對第三欄策略名稱與設定檔相符。若規則集也包含策略或其他欄位,請以其正式說明為準,不要自行猜測參數。遠端來源更新後可能改變涵蓋範圍,所以應把來源、內容用途與更新責任一併納入維護紀錄。

兩種管理方式:本機規則與遠端規則集

本機規則
  • 適合少量、範圍明確的自訂條目
  • 可直接檢查規則順序與策略名稱
  • 更新前備份,避免覆寫個人修改
遠端規則集
  • 適合引用需要另行維護的較大規則集合
  • 需確認來源可信、格式相容且仍可取得
  • 更新後重新檢查命中範圍與策略結果

先以一條可辨識的測試條目確認引用方式,再擴大使用範圍;規則來源改變時,重新驗證而非只看更新成功提示。

外部規則來源會影響流量如何處理,應視為設定供應鏈的一部分。使用前檢查來源所有者、文件格式、更新紀錄與實際內容;不要匯入來源不明或要求提供帳戶密碼的檔案。訂閱網址與帶有存取 token 的規則連結也不宜公開。若無法確認來源或規則內容,先不要將它設為日常使用設定。

四、逐步修改並驗證規則是否生效

修改設定時,先記下目前使用的檔案、Global Routing 狀態與測試目標,再只改一項。如此才能分辨問題來自規則順序、策略引用、遠端來源,還是測試環境。Config 中編輯入口及選項名稱可能隨介面調整,請以目前版本顯示為準;如果找不到預期操作,不要以另一份完整設定覆蓋原檔。

  1. 備份設定

    前往 Config,確認目前使用的設定檔,先透過可用的匯出或分享方式保留副本。確認副本可讀取後,再開始編輯;不要把含敏感資料的備份貼到公開討論區。

  2. 確認路由模式

    前往 Home → Global Routing,確認目前採用 Config,而不是 Proxy 或 Direct。若正在使用 Scene,也要確認當下場景實際採用的路由設定,避免用錯測試前提。

  3. 只加一條規則

    在現有 [Rule] 中加入一條範圍明確的測試規則,並放在可能涵蓋同一目標的廣泛規則之前。保留原有 FINAL 與其他必要條目,不要為了測試重寫整段規則。

  4. 保存並重連

    保存設定後,依目前介面需要重新載入或重新連線,再以同一個網域和相同網路測試。不要在同一輪同時更換伺服器、DNS、訂閱或遠端規則來源。

  5. 核對命中結果

    查看 Shadowrocket 提供的請求或連線記錄,確認目標網域、實際採用的規則及策略。若結果仍不符,先檢查前面是否已有較廣規則、策略名稱是否存在,以及目前啟用的是否為剛才修改的 Config。

規則寫對了,為什麼看起來沒生效?

先確認 Home → Global Routing → Config,再檢查目前選取的設定檔、規則前後順序,以及是否有更早命中的廣泛規則。用相同網域重新發起請求,並查看連線記錄;既有連線不一定能代表修改後的新請求。

遠端規則更新成功就代表格式正確嗎?

不代表。確認遠端內容能被目前版本識別、引用策略存在,並用一個可辨識的目標檢查實際匹配結果。更新狀態只說明取得或處理來源的情況,不會替你驗證規則意圖。

修改後反而連不上,該怎麼還原?

停止追加其他變更,先在 Config 切回備份或移除剛新增的那一行,再重新載入並用原本條件測試。若問題仍在,核對是否誤改了策略組、FINAL 或其他共用規則。

五、MitM 憑證與外部腳本的使用界線

規則語法可以處理網域或 IP 等連線條件,但不等於檢視加密連線中的所有內容。MitM 會涉及憑證與 HTTPS 內容檢視,不能為了測試規則就隨意安裝根憑證或啟用廣泛解密。只有在明確了解用途、信任憑證來源且確有必要時,才評估相關設定;測試結束後應關閉不再需要的 MitM 範圍,並依系統與 Shadowrocket 的指示管理憑證。不要把憑證或私密金鑰傳給他人。

外部腳本可能在觸發條件下執行程式碼,影響請求、回應或應用行為;其風險與一般網域規則不同。匯入前應核對發布者、腳本內容、所需觸發條件及資料存取範圍,避免使用來源不明、內容混淆或要求不必要權限的腳本。腳本網址也可能在日後被替換或停止維護,因此不能只根據一次成功載入,就把它視為永久可信。

建立自己的設定,不是把規則越加越多,而是讓每一行都有清楚用途、可辨認範圍與可還原的修改紀錄。從本機的一條精確規則開始,確認命中後再考慮擴大範圍或引用遠端規則集;若變更後結果不一致,先回到備份並固定測試條件。取得 Shadowrocket 請使用 App Store,並以商店頁面的資訊確認購買與適用範圍。

前往下載
App Store 下載先確認正版資訊