Shadowrocket .conf 設定檔結構詳解:General、Rule、Host、URL Rewrite 各區段功能

逐段解析 Shadowrocket .conf 設定檔,說明 [General]、[Rule]、[Host]、[URL Rewrite] 的用途,以及修改後如何生效。

本文重點

Shadowrocket(小火箭)的 .conf 是文字設定檔,不是訂閱網址,也不能取代連線憑證。本文適合已備妥自有服務資訊的使用者,依設定區段說明執行參數、分流規則、網域對應與 URL 重新導向的差異,並整理備份、編輯、啟用與還原步驟。建議先用最精簡的規則測試,再逐項還原其他設定,避免排查時混淆 DNS、規則順序與連線故障。

1. .conf 區段結構與設定範圍

設定檔以方括號標示區段,例如 [General]。區段名稱下方的內容會依該區段的語法解讀,直到遇到下一個區段名稱。[General] 常見格式為 鍵 = 值,而 [Rule] 使用以逗號分隔的規則列;不能將同一種寫法套用到所有區段。編輯時請使用英文半形方括號、逗號與等號,避免輸入法自動替換符號。

區段負責項目不負責項目
[General]DNS 等基本執行參數不取代逐條網站分流規則
[Rule]依條件選擇 DIRECT、PROXY 等策略不會修改請求 URL
[Host]為特定網域指定解析結果不會單獨決定是否使用代理
[URL Rewrite]以正規表示式處理符合條件的 URL不等同 DNS 對應或路由規則

不一定要包含這四個區段。若只設定網站分流,可以先保留必要的基本參數與 [Rule],暫不加入 Host 或 URL Rewrite。設定檔也可能包含其他支援的區段,不能因為本文未說明就直接刪除。請勿只將其他格式的設定檔副檔名改成 .conf 後使用。

2. [General]:先確認 DNS 基準,再調整其他參數

[General] 適合從少量且明確支援的設定開始。以下範例使用 dns-server = system,表示以系統 DNS 作為此處的解析來源;這不保證所有網路都能成功解析,實際結果仍會受到目前網路、快取及其他 DNS 設定影響。

[General]
dns-server = system

若原設定檔已有 DNS 參數,請先記下原值,再進行對照測試。更換解析來源可能改變網域取得的 IP,進而影響 GEOIP 或 IP-CIDR 的比對結果。因此,排查網站問題時,不要同時更換 DNS、調整規則順序及切換連線項目,否則無法判斷是哪項變更影響結果。

基本參數檢查

區段
[General]
範例鍵名
dns-server
範例值
system
書寫格式
鍵 = 值

先保留可正常運作的基準設定,不要只憑名稱猜測並新增未知參數。

解析問題檢查

測試項目
同一個完整網域名稱
固定條件
同一個網路、同一個連線項目
記錄內容
解析結果、命中規則、連線錯誤
還原方式
還原原值並重新建立連線

網域解析成功不代表目標連接埠可連線,兩者需要分別檢查。

3. [Rule]:比對順序、策略與 FINAL 兜底規則

[Rule] 的關鍵在於由上而下比對,第一條符合的規則會決定這次請求採用的策略。以下範例示範「example.com 及其子網域使用 PROXY,其餘使用 DIRECT」的邏輯。這段內容僅用來說明分流,不含可用的連線資訊;使用 PROXY 前,請先在 Home 準備並選取自己的可用連線項目。

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

DOMAIN-SUFFIX,example.com,PROXY 會比對 example.com 和 www.example.com,而不是搜尋 URL 路徑中的字串。請勿加入 https://、連接埠或 /path。FINAL 是前面條件都未符合時的兜底規則,應放在規則末尾;若放在前面,後續規則就沒有比對機會。

規則範例判斷依據檢查重點
DOMAIN-SUFFIX,example.com,PROXY網域後綴適合明確指定一組相關網域
GEOIP,CN,DIRECT目標 IP 在地理位置資料庫中的歸屬結果不是依網頁語言或網域後綴判斷
IP-CIDR,192.0.2.0/24,DIRECT,no-resolveIPv4 位址所屬網段no-resolve 可避免只為比對此規則而主動解析網域
FINAL,DIRECT其他規則皆未符合放在最後一列,明確指定其餘請求的處理方式

表格中的項目分別說明語法,不代表都要加入同一份設定檔。192.0.2.0/24 是文件中的示範網段,不是真實服務位址。若要加入 GEOIP 這類涵蓋範圍較廣的規則,應放在較具體的網站例外之後、FINAL 之前;否則寬泛條件可能先行比對,讓原本應由後續規則處理的請求被提前攔截。

4. [Host]:網域對應不等於流量直連

[Host] 可為特定網域設定靜態解析結果。以下範例將保留測試網域對應至文件示範位址,僅用來說明格式,不代表真實服務。左側為網域,不含通訊協定與路徑;右側為指定位址。

[Host]
lab.example.test = 192.0.2.10

Host 用來設定「網域指向哪個位址」,Rule 則決定「請求採用哪種策略」。即使設定了 Host,也不能因此判定請求會使用 DIRECT。仍需檢查命中的規則、目前的 Global Routing 模式,以及連線記錄中實際使用的目標與策略。

依問題選擇修改位置

需要固定目標位址
  • 在 Host 中設定明確的網域與位址對應。
  • 檢查目標伺服器是否仍接受該網域的請求。
  • HTTPS 仍須使用符合原網域的有效憑證。
需要變更請求策略
  • 在 Rule 中加入網域或 IP 條件。
  • 確認例外規則排在寬泛規則之前。
  • 使用 Config 模式驗證實際命中的策略。

位址對應與路由選擇應分開驗證;固定 IP 無法修正憑證不相符,也不能保證服務長期可用。

5. [URL Rewrite]:比對 URL,不取代 Rule

[URL Rewrite] 會依 URL 的正規表示式執行相應操作。以下範例將 HTTP 根網址重新導向至 HTTPS 根網址,結尾的 302 代表暫時重新導向。範例只涵蓋根路徑,不包含該網域下的所有頁面,方便縮小測試範圍。

[URL Rewrite]
^http://example\.com/$ https://example.com/ 302

一般 HTTPS 請求的完整路徑受到加密保護,不能假設加入 URL Rewrite 就能比對其中的路徑。若要處理 HTTPS 內容,還需符合解密範圍與憑證信任等前提;本文的基本設定驗證不需要啟用這些功能。請勿為了測試一條重新導向規則,就擴大處理所有網域的範圍。

6. 編輯後如何啟用:儲存、選取並重新建立連線

儲存檔案只是第一步,還要確認 Config 中選取的正是剛才編輯的設定檔,並在 Home → Global Routing 中選擇 Config。以下以 iPhone/iPad 的 Home、Config、Settings 操作介面說明;其他平台請依對應功能確認,不要假設所有平台的介面位置完全相同。

  1. 備份原始檔

    進入 Config,開啟目前設定檔的操作選單,匯出原始設定檔並另存副本。記下目前設定檔名稱,以及 Home → Global Routing 的原本模式。

  2. 單項編輯

    在 Config 中開啟目標設定檔的文字編輯功能,每次只修改一個區段。先檢查區段名稱、半形標點與 FINAL 的位置,再儲存。

  3. 選取設定檔

    返回 Config 清單,確認目標檔案已選取。若編輯的是副本,請明確切換至該副本,不要繼續使用原始檔測試。

  4. 切換模式

    進入 Home → Global Routing,選擇 Config。若 Settings → On Demand 已啟用,請先記下相關設定,測試期間避免自動連線影響手動切換。

  5. 重新建立連線並驗證

    先中斷連線,再重新連線並發出新的測試請求。檢查連線記錄中的網域、命中規則與策略;若失敗,請切回備份設定檔,再以相同請求重新測試。

既有連線可能沿用建立時的狀態,瀏覽器也可能保留連線或快取。修改設定後只重新整理一次舊頁面,不足以證明新設定已生效。測試時請關閉相關舊連線,改用新請求,並保持網路與連線項目不變;必要時分別測試網域解析與目標服務連線。

7. Global Routing 模式如何影響設定驗證

遇到「規則寫了卻沒反應」,應先檢查 Global Routing,而不是立刻繼續修改檔案。Config 會依目前設定檔執行分流;Proxy 與 Direct 可用來縮小問題範圍,但不能以其測試結果取代規則命中驗證。

Config

建議使用

依目前設定檔中的規則決定請求策略。驗證 DOMAIN-SUFFIX 與 FINAL 時,應在此模式下查看實際命中結果。

適用情境:日常規則分流、驗收設定變更。

Proxy

以代理方式處理流量,用來確認目前連線是否可用。即使網頁能開啟,也不能據此認定某條 Rule 已命中。

適用情境:區分連線項目故障與規則選擇問題。

Direct

以直連方式處理流量,可與代理路徑進行比較。若維持此模式,不應期待新增的 PROXY 分流規則會依 Config 模式運作。

適用情境:確認目前網路能否連線至目標。

Scene

依已設定的場景決定執行方式。排查問題時,請先查看場景條件與動作,避免場景切換改變測試條件。

適用情境:已設定明確場景的網路環境切換。

8. 常見設定故障與還原檢查

已儲存 .conf,為什麼仍採用原本的策略?

依序檢查 Config 中選取的檔案、Home → Global Routing → Config,以及目標規則是否排在 FINAL 之前。接著重新建立連線並發出新請求。若檔案內容正確,但編輯的不是目前使用的設定檔,應優先排除這種情況。

加入 Host 後,為什麼 HTTPS 顯示憑證錯誤?

Host 只會變更位址對應,不會改變請求網域與憑證驗證要求。請先移除新增的對應後重新測試,再確認指定伺服器是否確實為該網域提供服務。不要以忽略憑證錯誤取代位址與憑證設定的修正。

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

連線項目訂閱與遠端設定檔是不同項目。請先確認更新的是 Home 中的服務資訊,還是 Config 中的遠端設定檔。更新前先保留本機副本;重新取得遠端設定檔後,也要確認自行編輯的規則是否遭到覆蓋。

修改後無法連線,需要重新匯入所有內容嗎?

先切回已備份的設定檔,保持原連線項目不變,再重新連線。若恢復正常,請逐項比對最近修改的區段;若仍無法連線,再檢查服務位址、連接埠與驗證資訊。不要直接刪除所有設定與訂閱,以免失去比對基準。

驗收時至少記錄四項:目前選取的設定檔、Global Routing 模式、測試網域、實際命中的策略。比較前後結果時,一次只變更一個變數。這樣才能區分語法錯誤、規則覆蓋、解析差異與服務無法連線,而不是不斷疊加設定。

Shadowrocket 官方下載