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-resolve | IPv4 位址所屬網段 | no-resolve 可避免只為比對此規則而主動解析網域 |
FINAL,DIRECT | 其他規則皆未符合 | 放在最後一列,明確指定其餘請求的處理方式 |
表格中的項目分別說明語法,不代表都要加入同一份設定檔。192.0.2.0/24 是文件中的示範網段,不是真實服務位址。若要加入 GEOIP 這類涵蓋範圍較廣的規則,應放在較具體的網站例外之後、FINAL 之前;否則寬泛條件可能先行比對,讓原本應由後續規則處理的請求被提前攔截。
- 只讓指定網站使用代理:先寫明確的 DOMAIN-SUFFIX,最後使用 FINAL,DIRECT。
- 要改變其餘流量的處理方式:修改 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
^用來固定比對開頭,$用來固定比對結尾,避免比對到額外路徑或查詢參數。\.表示字面上的句點;未跳脫的.在正規表示式中可以比對其他字元。- 第二部分是重新導向目標,第三部分是操作類型;請勿將 Rule 的逗號分隔格式套用來改寫這一列。
- 瀏覽器可能會自行將 HTTP 升級為 HTTPS,或沿用既有的重新導向快取;看到 HTTPS 網址不代表這條規則一定有命中。
一般 HTTPS 請求的完整路徑受到加密保護,不能假設加入 URL Rewrite 就能比對其中的路徑。若要處理 HTTPS 內容,還需符合解密範圍與憑證信任等前提;本文的基本設定驗證不需要啟用這些功能。請勿為了測試一條重新導向規則,就擴大處理所有網域的範圍。
6. 編輯後如何啟用:儲存、選取並重新建立連線
儲存檔案只是第一步,還要確認 Config 中選取的正是剛才編輯的設定檔,並在 Home → Global Routing 中選擇 Config。以下以 iPhone/iPad 的 Home、Config、Settings 操作介面說明;其他平台請依對應功能確認,不要假設所有平台的介面位置完全相同。
-
備份原始檔
進入 Config,開啟目前設定檔的操作選單,匯出原始設定檔並另存副本。記下目前設定檔名稱,以及 Home → Global Routing 的原本模式。
-
單項編輯
在 Config 中開啟目標設定檔的文字編輯功能,每次只修改一個區段。先檢查區段名稱、半形標點與 FINAL 的位置,再儲存。
-
選取設定檔
返回 Config 清單,確認目標檔案已選取。若編輯的是副本,請明確切換至該副本,不要繼續使用原始檔測試。
-
切換模式
進入 Home → Global Routing,選擇 Config。若 Settings → On Demand 已啟用,請先記下相關設定,測試期間避免自動連線影響手動切換。
-
重新建立連線並驗證
先中斷連線,再重新連線並發出新的測試請求。檢查連線記錄中的網域、命中規則與策略;若失敗,請切回備份設定檔,再以相同請求重新測試。
既有連線可能沿用建立時的狀態,瀏覽器也可能保留連線或快取。修改設定後只重新整理一次舊頁面,不足以證明新設定已生效。測試時請關閉相關舊連線,改用新請求,並保持網路與連線項目不變;必要時分別測試網域解析與目標服務連線。
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 模式、測試網域、實際命中的策略。比較前後結果時,一次只變更一個變數。這樣才能區分語法錯誤、規則覆蓋、解析差異與服務無法連線,而不是不斷疊加設定。