Shadowrocket 設定檔教學:.conf 的 General、Rule、Host、URL Rewrite 寫法

逐段解析 Shadowrocket .conf 設定檔,說明 [General] 常用參數、[Rule] 比對順序與 FINAL,以及 [Host] 和 [URL Rewrite] 的基本寫法。

本文重點

修改 .conf 前,先在 Config 備份目前的檔案,再分別檢查一般參數、路由規則、網域對應與 URL 重寫;若要依規則分流,請將 Home → Global Routing 設為 Config。本文適合已有自己的服務商與訂閱、想了解設定語法的使用者,提供可分步驗證的範例與復原方式;設定檔不是連線憑證。

一、.conf 的分段結構與生效條件

Shadowrocket(小火箭)的 .conf 是文字設定檔。方括號內是分段名稱,各段再依其語法填入參數或規則。[General] 通常使用 鍵 = 值,[Rule] 則以逗號分隔規則列;這兩種語法不可混用。儲存成功不代表設定已啟用,還要到 Config 確認目前選取的檔案。

4 段
本文範圍:General、Rule、Host、URL Rewrite
32 位元
IPv4 的 /32 前綴代表單一位址
302
本文重寫範例使用的暫時重新導向狀態碼

以下是用來說明結構的最精簡範例,不能直接取代現有設定作為完整連線方案。PROXY 會使用目前選取的代理;可用的伺服器與驗證資訊須事先設定。範例網域與文件位址僅用於解說語法,並非可供連線的服務。

[General]
dns-server = system

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

[Host]
lab.example.com = 192.0.2.10

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

Home 主要用來選取伺服器與連線,Config 用來管理設定檔,Settings 則提供應用程式設定。Subscribe 匯入及更新的是訂閱中的連線項目,不能因此推斷本機 .conf 也會同步更新。反過來說,修改 .conf 中的規則,也不會修正伺服器位址、密碼或訂閱授權。排解問題時,應分開記錄這兩部分。

備份檔案 逐段編輯 選取設定 檢查路由 發出新請求

二、[General]:先了解 DNS 與 IPv6,再調整一般參數

[General] 會影響設定的基本行為。建議優先檢查 DNS 來源:dns-server = system 表示使用系統提供的 DNS,並非指定固定的公用解析器。切換 Wi-Fi 與行動網路後,系統提供的解析環境可能有所不同。若網域解析失敗,應先釐清是系統網路本身異常,還是目前設定改變了解析方式。

[General]
dns-server = system
ipv6 = false

ipv6 = false 可用於排查 IPv6 相關問題,但不應視為適用所有網路的固定最佳化設定。關閉 IPv6 支援會改變可用的 IP 位址類型;部分網路仰賴 IPv6,直接照抄可能減少可連線的路徑。若原設定運作正常,請先保留原值,只有在症狀明確時才逐項比對,並於測試後決定是否還原。

檢查 General 參數

dns-server
system:使用系統提供的 DNS。
ipv6
false:關閉此設定的 IPv6 支援,用於針對性排查。
修改方式
一次只改一項,儲存後以新連線驗證。

不要把同時修改多項參數後的結果歸因於其中某一項。

檢查 Rule 語法

DOMAIN-SUFFIX
example.com,PROXY:依網域後綴比對。
IP-CIDR
192.0.2.10/32,DIRECT,no-resolve:比對單一 IPv4 位址。
FINAL
DIRECT:作為未符合前面規則時的最終策略。

規則列使用英文逗號;FINAL 不填網域或網段。

設定檔中的 DNS 設定與裝置目前網路的 DNS,未必是在觀察同一層面的結果。若瀏覽器仍使用既有連線或快取,修改後立即重新整理不一定看得出差異。測試時先儲存檔案並確認已啟用,再重新建立連線;必要時關閉目標 App 後重新開啟,避免以舊連線判斷新參數。

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

[Rule] 的重點是由上而下比對,第一條符合的有效規則會決定該請求採用的策略。範圍較窄的例外通常要排在較廣泛的規則前面。例如,若要讓 status.example.com 直連,而其他 example.com 網域走代理,精確網域規則就應排在網域後綴規則之前。

[Rule]
DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
規則關鍵字比對對象檢查重點
DOMAIN單一完整網域不含協定、連接埠與路徑。
DOMAIN-SUFFIX網域本身及其子網域example.com 可涵蓋 api.example.com,不是比對任意包含該字串的內容。
IP-CIDR目標 IPv4 位址範圍/24 代表網段;no-resolve 可避免只為比對此規則而觸發網域解析。
GEOIP位址資料庫中的地區歸屬CN 是位址資料庫的地區代碼,比對結果以該資料庫的記錄為準。
FINAL未符合前面規則的請求放在最後,並明確選擇 DIRECT 或 PROXY。

no-resolve 不會關閉整個 App 的 DNS,也不是「禁止解析這個網域」。它限制的是相應 IP 規則的比對流程。網域請求到達該規則時,若沒有可用於比對的目標 IP,就不能假設一定會符合規則。若要精確控制特定網域,優先使用 DOMAIN 或 DOMAIN-SUFFIX,不要只依賴位址歸屬。

結論:先驗證精確規則,再驗證兜底規則

先以 status.example.com 對應的實際測試目標檢查精確例外,再檢查後綴規則,最後測試一個不在前述範圍內、由自己管理的目標。若將 FINAL 移到前面,後續的例外規則就無法如預期參與比對;應先調整順序,而不是繼續增加重複規則。

規則是否參與路由,也取決於 Home → Global Routing。Config 用來依目前設定分流;Proxy 與 Direct 分別用於選擇全域代理或全域直連,不適合用來驗證完整的規則分流結果。Scene 會依已設定的情境條件選擇路由行為,不能視為 Config 的同義詞。排查本文範例時,請先明確選擇 Config。

四、[Host]:只填網域對應,不要填入 URL

[Host] 用來指定網域與位址的本機對應。左側填網域,右側填目標 IP;不要填入 https://、路徑或 :443。連接埠屬於連線目標資訊,不屬於這類網域對應。以下使用保留供文件示範的位址說明格式,無法用來驗證真實網站是否連線。

[Host]
lab.example.com = 192.0.2.10
status.example.com = 192.0.2.20

Host 網域對應不等於強制直連。請求最後採用的策略,還要依據 Global Routing 與規則判斷。也不要以為替網域指定 IP 後,就會略過所有網域規則。測試自有 HTTPS 服務時,應分別確認位址對應、路由比對、憑證網域與伺服器回應;這四項不能互相取代。

五、[URL Rewrite]:從 HTTP 重新導向範例了解寫法

[URL Rewrite] 用來比對並改寫 URL,不負責修復伺服器驗證,也不等同於 DNS 對應。常見的重新導向規則由比對運算式、目標 URL 與狀態碼組成,各欄位以空格分隔。以下範例會將示範網站的 HTTP 請求重新導向至 HTTPS,並保留路徑。

[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
  1. ^ 用來限定從 URL 開頭開始比對,避免運算式在其他位置誤符合。
  2. example\.com 中的句點以反斜線跳脫,代表一般句點,而非正規表示式中的任意字元。
  3. (.*) 用來擷取後續內容,目標中的 $1 則引用第一組擷取結果。
  4. 302 代表暫時重新導向。用戶端會依重新導向結果發出後續請求,而不是直接替換伺服器回應本文。

這條規則的來源網址明確使用 HTTP。不能只把運算式中的 http 改成 https,就認為能讀取所有加密請求的完整 URL;一般通道轉送不代表能取得 TLS 內部的路徑與內容。有些瀏覽器會因 HSTS 或 HTTPS 優先策略,在送出請求前就升級網址,因此 HTTP 範例可能沒有比對機會。

URL 重寫與 Rule 處理的是不同問題:前者改變符合條件的請求 URL 行為,後者決定連線採用的路由策略。即使重新導向規則生效,後續目標是否可連線,仍取決於 DNS、路由與伺服器狀態。若最後仍無法開啟頁面,應先確認問題發生在初始請求、重新導向過程,還是新目標的連線。

六、儲存、啟用與還原:一次驗證一項變更

編輯前,請在 Config 備份目前可用的檔案並記下檔名。不同平台的編輯選單可能不同,請以目前 App 提供的編輯、複製或匯出功能為準。不要直接覆寫唯一一份工作設定;遠端設定也應保留本機副本,避免後續更新後難以追蹤手動修改。

  1. 在 Config 開啟準備修改的檔案,只修改一個分段中的一項設定,並使用英文標點儲存。
  2. 確認該檔案是目前使用的設定,再前往 Home → Global Routing 選擇 Config。
  3. 確認目前選取的代理可用;規則正確不代表伺服器驗證資訊有效。
  4. 重新建立連線,造訪與該規則直接相關的測試目標,並檢查 App 提供的連線記錄或日誌。
  5. 記錄目標網域、預期策略、實際結果與修改項目;若失敗,切回備份檔,再以相同請求進行比對。

Settings → On Demand 負責依條件觸發連線,與 Rule 的比對順序是不同問題。若手動中斷後連線又恢復,應檢查 On Demand 條件,而不是刪除 FINAL。為減少排錯變因,可在測試期間暫時關閉 On Demand,驗證完成後再恢復原設定。

修改了 Rule,為什麼所有網站仍走同一個出口?

先確認 Home → Global Routing 是否設為 Config,再檢查 Config 中目前選取的檔案。接著確認 FINAL 前是否有涵蓋範圍過大的規則,並以新連線重新測試,不要只重新整理原本的長連線頁面。

訂閱更新了,為什麼本機規則沒有變化?

伺服器訂閱與本機 .conf 是不同的設定項目。請回到 Config 檢查目前檔案內容;若要更新遠端設定,應更新相應設定並確認結果,不能以 Subscribe 的更新時間作為判斷依據。

新增 Host 後,HTTPS 為什麼顯示憑證不相符?

確認對應位址是否提供該網域的服務,以及伺服器憑證是否包含該網域。Host 只會改變位址對應,不會修復憑證。先移除該筆對應並測試原本的連線方式,再請伺服器管理者檢查憑證與網站設定。

儲存後出現解析錯誤,該先檢查哪裡?

先依提示的行號檢查分段名稱與英文標點:Rule 使用英文逗號,General 與 Host 使用等號,URL Rewrite 則以空格分隔欄位。撤回剛新增的內容,確認原始檔案可正常使用後,再逐行恢復。

下載 Shadowrocket