本文適合已經有服務資訊,準備閱讀或修改 Shadowrocket 設定檔的使用者。先辨認四個設定區段,再透過可檢查的規則與對應範例了解比對方式,最後依序備份、編輯、啟用並驗證。範例用來說明語法,並非可直接取代現有設定的完整設定檔。
先確認平台,再區分服務資訊與設定檔
Shadowrocket(小火箭)的取得方式請見全平台下載頁:iPhone / iPad 版在 App Store 一次性付費 $2.99,開發者為 Shadow Launch Technology Limited,系統需求請以 App Store 頁面標示為準;Mac(Apple 晶片 / Intel)、Windows、Android、Linux 版免費。下文以 Home、Config、Settings 等介面用語說明操作,實際控制項位置依各平台目前介面為準。
服務資訊說明「要連線到哪台伺服器、使用哪種協定與驗證參數」,設定檔則說明「流量要如何處理」。既有訂閱中的伺服器項目,與 Config 中啟用的 .conf 並非同一個項目。更新訂閱不代表已切換設定檔;選取設定檔也不代表已新增可用伺服器。本文以使用者已有自己的服務商與訂閱為前提,不提供、販售或推薦節點或訂閱。
.conf 基本結構:區段名稱、鍵值與規則列
.conf 是文字設定檔。方括號中的名稱用來宣告設定區段,後續各列都屬於該區段,直到遇到下一個區段名稱。不同區段採用不同語法:[General] 和 [Host] 常見鍵值格式,[Rule] 使用逗號分隔欄位,[URL Rewrite] 則以比對運算式、目標和動作組成內容。不能將某個區段的語句直接移到另一個區段使用。
[General]
dns-server = system
[Rule]
DOMAIN,example.com,DIRECT
FINAL,PROXY
[Host]
example.com = 192.0.2.10
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
閱讀檔案時,先找出區段名稱,再確認每列參數的分隔符號。規則中的逗號須使用英文半形字元;正規表示式中的反斜線也不能被編輯器替換。排查問題時,建議用獨立的註解列記錄修改原因,不要假設所有列尾都能任意加上註解。副檔名相同,也不代表其他格式的設定檔可以原樣匯入。
[General]:全域選項不等於逐站分流
[General] 用來設定影響整體運作的選項,例如 DNS 解析相關設定。範例中的 dns-server = system 表示指定使用系統 DNS;這是明確的設定選擇,不代表應用程式目前的預設行為,也不保證適用於所有網路環境。如果系統網路本身無法完成解析,單純選用系統 DNS 並不能修復上游故障。
- 先判斷問題層級:網域無法解析出 IP 位址時,檢查 DNS;已取得 IP 位址但連線逾時,則繼續檢查路由、伺服器連接埠與傳輸條件。
- 只修改相關選項:不要為了解決單一網域策略錯誤,同時更改 DNS、IPv6 和多條規則,否則難以確認是哪項修改造成影響。
- 確認生效中的設定:Config 中儲存的文字必須屬於目前啟用的設定檔。編輯另一份同名檔案,不會自動變更正在使用的設定檔。
- 不要猜測設定值:遇到不熟悉的鍵,先到設定詳解確認用途與適用條件;不要只根據鍵名猜測布林值,也不要照搬其他格式的設定。
Settings 中的運作選項也需要另外檢查。例如 Settings → On Demand 涉及依條件觸發連線,而非定義 example.com 應符合哪條 Rule。排查時若連線在手動中斷後又重新建立,應檢查 On Demand 是否啟用及其條件,不要先刪除規則區段。
[Rule]:依序比對,再套用目標策略
[Rule] 的核心是「比對條件 + 處理目標」。一般規則會由上而下檢查,符合條件後便採用對應目標,因此較具體的例外通常應排在範圍較廣的規則之前。DIRECT 表示直連,REJECT 表示拒絕;PROXY 用於代理策略。若使用自訂策略名稱,必須確認目前設定檔中確實有對應定義,不可任意填入名稱。
| 關鍵字 | 範例 | 比對說明 |
|---|---|---|
DOMAIN | DOMAIN,example.com,DIRECT | 比對完整網域 example.com,不包含其子網域。 |
DOMAIN-SUFFIX | DOMAIN-SUFFIX,example.com,PROXY | 比對 example.com 及其子網域,並非比對任何以該字串結尾的內容。 |
DOMAIN-KEYWORD | DOMAIN-KEYWORD,example,REJECT | 比對網域中含有 example 的請求,涵蓋範圍可能比預期更廣。 |
IP-CIDR | IP-CIDR,192.0.2.0/24,DIRECT | 依目標 IPv4 位址網段比對;此處使用文件範例網段。 |
GEOIP | GEOIP,CN,DIRECT | 依 IP 地理資料庫識別的區域比對,與網頁內容無關。 |
FINAL | FINAL,PROXY | 處理前面未符合任何規則的流量,通常放在規則末尾。 |
例如要讓 example.com 直連,但其餘子網域使用代理,可以先寫 DOMAIN,example.com,DIRECT,再寫 DOMAIN-SUFFIX,example.com,PROXY。若順序相反,根網域會先符合後綴規則,後面的精確規則便無法處理這次請求。
[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,PROXY
網域規則與 IP 規則的比對依據不同。IP 類規則可能涉及解析,實際行為也會受到相關選項影響。不要把「IP 位址被歸類到某個區域」理解成「網域註冊於該區域」,也不要在待驗證規則之前放置 FINAL。確認效果時應查看實際命中資訊,而不只是根據網頁能否開啟來推斷。
Global Routing:確認目前是否依 Config 分流
設定檔語法正確,但規則未呈現預期效果時,先到 Home → Global Routing 檢查目前模式。選擇 Config 才是驗證該設定檔 Rule 分流的直接起點;Proxy 和 Direct 用來切換整體流量處理方式,不能取代逐條規則測試。
Config
建議依目前啟用設定檔中的規則分流。符合規則後的目標可能是 PROXY、DIRECT、REJECT 或已定義的策略。
適用情境:驗證本文的 Rule 範例與規則順序。
Proxy
以代理方式處理流量,不會依照同一組網域規則選擇代理或直連;仍須有可用的代理連線。
適用情境:對照檢查問題是否與 Config 分流有關。
Direct
以直連方式處理流量。能透過直連開啟某個網站,不代表代理參數正確,也不代表 Rule 已命中。
適用情境:檢查本機網路直接連線至目標時的狀況。
Scene
依場景條件套用相應設定。判斷結果前還需確認目前命中的場景及其設定,不能只查看曾編輯過的檔案。
適用情境:已建立場景條件,且需要隨環境切換設定。
[Host]:指定解析位址,不負責連接埠與驗證
[Host] 用於本機網域對應。example.com = 192.0.2.10 表示將該名稱對應至指定位址,不是將網站改為使用代理,也不是將服務連接埠改成某個值。此處的範例位址不能用於真實服務;正式對應必須來自你有權使用的服務或受管理的網路。
區分 Host 對應與 Rule 分流
Host 處理名稱與位址
- 指定網域應對應至哪個位址。
- 對應內容不包含 URL 路徑或登入憑證。
- 位址變更後,應檢查舊的對應是否仍有效。
Rule 處理流量策略
- 指定請求應直連、代理或拒絕。
- DOMAIN-SUFFIX 可涵蓋子網域。
- 規則順序決定哪個條件會先處理。
若需要同時變更位址與策略,請分別檢查 Host 和 Rule;新增 Host 不能取代分流規則。
HTTPS 也會驗證憑證所對應的網域。將網域對應到任意位址,不會讓該位址上的憑證自動變成有效。若新增對應後出現憑證名稱不符、連到錯誤網站或持續逾時,應先移除對應並確認服務位址,而不是忽略憑證錯誤來掩蓋問題。使用自有解析機制的應用程式,也不一定會遵循此處的對應設定。
[URL Rewrite]:比對請求網址並執行改寫動作
[URL Rewrite] 處理的是 URL,而非選擇伺服器協定。以下列規則使用正規表示式比對以 http://example.com/ 開頭的網址,將路徑保留並導向 HTTPS 目標,採用 302 重新導向動作。運算式中的 \. 表示字面上的句點,(.*) 擷取其餘路徑,$1 則引用第一個擷取群組。
[URL Rewrite]
^http://example\.com/(.*)$ https://example.com/$1 302
- 確認比對範圍:開頭的
^限定比對起點;此範例不會比對其他子網域,也不會比對原本已使用 HTTPS 的 URL。 - 了解重新導向:
302表示暫時重新導向。用戶端會依重新導向網址發出後續請求,並非在背景中悄悄更換目標 IP。 - 不要與 DNS 混淆:Host 變更名稱所對應的位址;URL Rewrite 變更請求網址的處理方式,兩者是在不同階段生效的設定。
- 留意可見內容:讀取並改寫加密 HTTPS 請求的完整路徑,通常需要額外設定 HTTPS 解密條件;只新增一條規則,不會自動取得加密內容。
修改與驗證:每次只處理一個變數
首次修改前,先保留可還原的副本。完整設定檔可能還包含其他區段或遠端引用,不能因為本文只介紹四個區段,就刪除其餘所有內容。以下流程以目前已可連線的設定檔為基礎,目的是縮小修改範圍,而非重新建立整套服務。
-
備份設定檔
進入 Config,找到目前啟用的設定檔,使用該項目的匯出或分享功能儲存副本;並記下檔名與目前的 Global Routing 模式。
-
編輯單一項目
在 Config 開啟對應設定檔的編輯入口,只修改一個區段中的一項設定。測試 Rule 時,先新增一條精確的 DOMAIN 規則,不要同時修改 DNS 和 Host。
-
確認已啟用
儲存後返回 Config,確認選取的是修改後的檔案,再前往 Home → Global Routing 選擇 Config,避免在 Proxy 或 Direct 模式下判斷規則效果。
-
發出新請求
結束目標應用程式既有的連線,再發出一次新請求,並搭配可用的連線紀錄檢查目標網域與實際策略。已建立的長連線可能仍沿用原本的處理結果。
-
記錄並還原
記錄修改列、命中結果與錯誤現象。若結果異常,請還原備份並重做相同測試,不要繼續累加未經驗證的設定。
若還需要更新既有訂閱,請將其視為另一項獨立操作:確認訂閱更新成功,且 Home 中選取的伺服器仍可使用,再測試設定檔。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的連線參數屬於各自協定與伺服器設定範圍;新增 FINAL,PROXY 無法修正錯誤的密碼、連接埠或驗證資訊。
常見狀況與檢查項目
設定檔已儲存,為什麼 example.com 還是沒有套用新規則?
依序確認 Config 中啟用的檔案、Home → Global Routing 是否選擇 Config、目標之前是否已有涵蓋範圍更廣的規則,以及請求是否沿用舊連線。若實際請求是某個子網域,只有 DOMAIN,example.com,DIRECT 不會符合;應依需求選用精確網域或 DOMAIN-SUFFIX。
新增 Host 後,延遲正常但網頁無法開啟,怎麼辦?
先移除新增的對應,再對同一個目標發出新請求。伺服器延遲測試與目標網站的網域解析並非同一項測試:延遲正常不能證明 Host 位址正確、目標服務正在監聽或憑證相符。本文中的 192.0.2.10 僅供說明,若保留此位址,相關連線就會導向範例位址。
更新遠端設定後,為什麼本機修改不見了?
遠端內容更新可能會取代本機檔案,實際情況取決於匯入與維護方式。若要保留修改,應先另存副本並記錄差異,更新後逐項核對。不要假設本機新增的 Rule 會自動與遠端內容合併,也不要公開包含驗證資訊的完整設定檔或訂閱連結。
四個區段都必須寫嗎?
不必為了形式完整而新增空區段或不相關設定。沒有固定對應需求時,不需要照抄 Host;不需要改寫時,也不必新增 URL Rewrite。請依照具體目的保留必要內容,並根據目前生效的設定檔判斷預設行為,不要把本文片段當成通用預設設定。