Shadowrocket .conf 設定檔結構詳解:General、Rule、Host、URL Rewrite 各段用途

逐段解析 .conf 設定檔:General 管理全域行為,Rule 負責流量分流,Host 設定本機對應,URL Rewrite 改寫網址,並說明各段寫法與生效順序。

本文重點速覽

Shadowrocket(小火箭)的 .conf 檔不是節點清單,也不是逐行執行的指令稿。本文適合已有自用服務資訊、需要閱讀或修改設定的使用者:先釐清四個設定段的職責,再透過規則範例、模式比較與驗證步驟,判斷修改應放在哪裡,以及儲存後可能未生效的原因。

一、.conf 的段落結構與讀取範圍

設定檔以方括號標示段名,例如 [General]。從段名開始,到下一個段名之前的內容都屬於同一段。各段語法並不相同:General 常見的是鍵值對,Rule 是以逗號分隔的比對規則,Host 是主機名稱與位址對應,URL Rewrite 則使用比對運算式與處理動作。不能將某一段的寫法直接移到另一段。

以下是用來理解結構的最小範例,不包含代理伺服器參數,也不保證適用於目前的網路環境。兩個文件範例網域僅用於說明比對行為,不應拿來測試實際服務連線。以 # 開頭的獨立行是註解;註解不會建立連線,也不會改變策略。

# 結構範例:使用前請先備份目前設定
[General]
dns-server = system

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

[Host]
example.com = 192.0.2.10

[URL Rewrite]
^http://example\.org/(.*)$ https://example.org/$1 302
4 個段落
General / Rule / Host / URL Rewrite,各自負責不同工作
3 種策略
本文規則使用 PROXY / DIRECT / REJECT
1 條最終規則
範例中的 FINAL 位於 Rule 最後一行

段落排列順序不等於請求處理順序。將 Host 寫在 Rule 後面,不代表一定先分流再查詢 Host;把 URL Rewrite 移到檔案開頭,也不會讓所有網路連線先執行改寫。各段由對應功能讀取,只有 Rule 內部的規則順序具有此處所說的「由上而下,符合即停止」分流意義。

二、General:全域選項不是分流規則

[General] 用來設定整份設定檔的通用行為,例如 DNS 相關選項。範例中的 dns-server = system 表示使用系統 DNS 設定。這不代表「所有連線都直連」,也不代表「所有網域都走代理」;連線策略仍須依據 Global Routing、Rule 與目前可用的代理設定判斷。

編輯這一段時,應保留選項名稱原文,並確認值的型別。布林值、位址清單與文字參數不能互換。不要為了套用其他檔案而一次替換整段:既有設定中的網路例外、DNS 行為或其他通用選項可能因此改變,最後造成部分功能異常,卻不一定會出現明顯的語法錯誤。

General 閱讀重點

段名
[General]
鍵名範例
dns-server
指定值範例
dns-server = system
檢查項目
目前選取設定檔中的通用選項

先確認各鍵的用途,再決定是否修改;不要依段落位置推測優先順序。

套用設定的範圍

分流模式
Home → Global Routing
選擇設定檔
Config → 目前使用的設定檔
自動連線
Settings → On Demand
代理參數
Home → 使用者已有的伺服器項目

On Demand 決定連線的觸發條件,不是 Rule 的替代方案,也不是設定段的執行開關。

常見的混淆情況是修改 General 後,又到 Settings → On Demand 調整自動連線條件,之後便無法判斷是哪項設定改變了結果。驗證設定時,先固定連線狀態與網路環境;自動連線行為應另外測試。本文以 Home、Config、Settings 介面的路徑為例,不同平台的按鈕配置可能不同。

三、Rule:依序比對,FINAL 放在最後

[Rule] 決定符合條件的請求採用哪種策略。一般規則由類型、比對值與策略組成;FINAL 不需要比對值。PROXY 會將請求交由代理路徑處理,DIRECT 使用直連路徑,REJECT 則拒絕請求。PROXY 本身不會建立可用伺服器,仍須有使用者已有且可連線的服務資訊。

[Rule]
DOMAIN,api.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT,no-resolve
FINAL,PROXY
規則類型範例說明檢查重點
DOMAIN只比對完整網域 api.example.com。不包含其他子網域。
DOMAIN-SUFFIX比對 example.com 及其子網域。更明確的例外規則應放在它前面。
IP-CIDR比對 192.0.2.0/24 位址範圍。no-resolve 可避免僅為此規則觸發網域解析。
GEOIP依位址歸屬資料庫判斷是否屬於 CN。依據 IP 資料判斷,不看網頁語言或網域後綴。
FINAL前面的規則都未符合時,採用 PROXY。放在最後,避免提前攔截後續規則。

依照上述排列,api.example.com 會先符合 DOMAIN,因此採用 DIRECT;www.example.com 不符合第一行,接著符合 DOMAIN-SUFFIX,因此採用 PROXY。這是依規則推導出的預期結果,並非對範例網域進行網路實測的紀錄。如果將後綴規則放在最前面,完整網域的例外規則就不會執行。

no-resolve 不代表關閉整個應用程式的 DNS。它限制的是相應 IP 類規則是否主動觸發解析;若請求本身已有 IP,仍可能符合規則。使用此選項時要留意一個限制:尚未取得目標位址的網域請求,可能繼續套用後續規則或 FINAL,不能假設所有位址歸屬都已判斷完成。

四、Host:位址對應不等於連線策略

[Host] 用於設定本機靜態主機名稱對應。以下一行會將 example.com 對應至 192.0.2.10。此位址屬於文件範例專用位址範圍,並非本文提供的服務位址。實際使用時,必須改成使用者有權使用且確認正確的目標位址。

[Host]
example.com = 192.0.2.10

區分「連到哪裡」與「透過哪種路徑連線」

Host:位址對應
  • 為指定主機名稱設定本機位址對應。
  • 不會自動將頁面位址改成另一個網域。
  • 不會自動選擇 DIRECT 或 PROXY。
Rule:路徑選擇
  • 依網域或位址等條件選擇策略。
  • 可用 DOMAIN 明確指定網域策略。
  • 不會單獨替換網站的目標主機名稱。

若需要固定位址並指定連線路徑,請分別設定 Host 與 Rule,再各自驗證對應結果與策略命中情況。

Host 也不能修復憑證。使用 HTTPS 時,即使連線位址來自靜態對應,網站仍須提供與存取主機名稱相符的憑證。若對應到錯誤的伺服器,可能出現憑證不符、連線中斷或網站內容錯誤;此時應先檢查位址對應,不應放寬憑證驗證來掩蓋目標錯誤。

若應用程式直接連線至 IP,或使用自身的解析方式,觀察到的行為可能與一般網域請求不同。排查時應記錄實際請求的主機名稱與目標位址,不能只看瀏覽器網址列就判定 Host 已參與解析。舊連線也可能繼續沿用原位址,修改後應建立新連線進行驗證。

五、URL Rewrite:比對請求網址並指定動作

[URL Rewrite] 負責比對與改寫 URL,不負責網路路由。以下範例使用正規表示式比對指定網域的明文 HTTP 網址,再以 302 重新導向至 HTTPS 網址。範例以 http:// 開頭,是為了說明明文請求可見的情況,並不代表所有 HTTPS 請求內容都能直接讀取。

[URL Rewrite]
^http://example\.org/(.*)$ https://example.org/$1 302

依照運算式,http://example.org/docs 對應的目標網址是 https://example.org/docs。新的請求仍須進行解析、比對連線策略並建立連線,因此 Rewrite 不是「略過 Rule」的捷徑,也不會讓原本無法連線的目標憑空變得可達。

若發生循環轉址,先確認替換後的網址是否又符合相同或其他改寫運算式。若路徑遺失,檢查擷取群組是否與 $1 對應。若完全沒有觸發,先確認瀏覽器實際送出的請求是否已自動升級為 HTTPS,不要立刻修改分流策略。

六、Config 與 Global Routing:選好檔案後還要選對模式

Config 頁面用來管理設定檔,Home → Global Routing 則用來選擇目前的分流模式。兩者名稱相近,作用卻不同:設定檔出現在 Config 清單中,不代表已選取使用;即使已選取檔案,也不代表目前採用依該檔案規則分流的模式。

Config

建議

依目前設定檔中的規則選擇連線策略;未符合規則的請求如何處理,取決於最後一條規則。FINAL 可以設為 DIRECT,也可以設為 PROXY,不能一概視為「其他流量直連」。

適用情境:驗證 Rule 順序與特定網域的分流結果。

Proxy

採用全域代理模式,不依照 Rule 中的一般分流安排選擇路徑。仍可能受到系統流量範圍、網路例外與協定可用性影響。

適用情境:短時間確認代理路徑是否可用;不能據此證明 Rule 已生效。

Direct

採用直連模式,用來觀察本機網路路徑。這不會將設定檔中的每一條 PROXY 文字改成 DIRECT。

適用情境:比較同一目標在直連環境下的表現。

Scene

依已設定的場景條件切換相應行為。結果取決於場景定義;使用前應確認目前網路符合哪個場景。

適用情境:已有明確場景設定的環境;排查固定規則時,先減少這項變數。

測試規則時選擇 Config,比較容易將請求結果對應至特定 Rule。切換到 Proxy 後可以連線,回到 Config 卻失敗,只能表示兩種路徑或策略選擇可能不同;仍須檢查實際命中的規則、目標解析結果與可用伺服器,不能直接判定「設定檔損毀」。

七、儲存、啟用與排查:一次只變更一個因素

編輯前先保留原始檔案,尤其是透過遠端網址取得的設定。遠端更新可能覆蓋本機修改;伺服器訂閱更新與設定檔更新也不是同一件事。前者通常更新伺服器項目,後者可能變更 General、Rule 等內容;不能因為訂閱更新成功,就認定 Rule 已重新載入。

  1. 保留備份

    在 Config 確認目前使用的檔案,先保留一份可還原的原始副本,再開啟該檔案的編輯入口。不要直接覆蓋唯一可用的設定檔。

  2. 一次只改一處

    例如只調整 Rule 中一條 DOMAIN 規則的位置。保持 General、Host、URL Rewrite 不變,並記錄修改前後的完整行內容。

  3. 確認已啟用

    儲存後返回 Config,確認選取的是剛才修改的檔案;接著前往 Home → Global Routing 選擇 Config,並確認連線已啟用。

  4. 建立新請求

    在相同網路環境下重新發出目標請求,並查看請求紀錄中可取得的網域、目標 IP 與策略資訊。必要時重新建立連線,避免舊工作階段影響判斷。

  5. 還原比對

    若結果不如預期,還原原本的那一行再測試。需要檢查自動連線行為時,再另外前往 Settings → On Demand,避免同時調整多項設定。

觀察現象優先檢查下一步處理
儲存規則後,策略沒有改變目前選取的檔案與 Global Routing 模式。確認使用 Config,再檢查前面是否已有範圍更廣、先行命中的規則。
特定網域出現憑證錯誤Host 是否對應到錯誤位址。移除該筆對應並建立新連線,比對憑證與目標主機名稱。
URL Rewrite 沒有觸發請求的協定、網域與路徑是否符合運算式。先驗證明文 HTTP 範例的邏輯,再檢查實際請求是否可見。
更新後自訂規則消失更新的是遠端設定檔,還是伺服器訂閱。依備份還原修改,並確認後續維護的檔案來源。
命中 PROXY,仍無法連線既有伺服器的協定參數與連線狀態。分開排查規則是否命中,以及代理連線是否成功;不要反覆調整 Rule 順序。

最後應拆成四個問題判斷:是否選取了設定檔、請求是否符合預期規則、解析出的位址是否正確,以及所選路徑能否連線。General、Rule、Host、URL Rewrite 分別說明其中不同環節,不能只調整其中一段來取代完整排查。介面設定可參閱設定說明,協定欄位可參閱協定參考。

下載 Shadowrocket