本文重點

本文適合已經有服務資訊,準備閱讀或修改 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 並非同一個項目。更新訂閱不代表已切換設定檔;選取設定檔也不代表已新增可用伺服器。本文以使用者已有自己的服務商與訂閱為前提,不提供、販售或推薦節點或訂閱。

4 個區段
本文說明 General、Rule、Host、URL Rewrite
6 種規則
下文列出常用比對關鍵字與 FINAL
2 種取得方式
iPhone / iPad 版付費;Mac / Windows / Android / Linux 版免費

.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 並不能修復上游故障。

Settings 中的運作選項也需要另外檢查。例如 Settings → On Demand 涉及依條件觸發連線,而非定義 example.com 應符合哪條 Rule。排查時若連線在手動中斷後又重新建立,應檢查 On Demand 是否啟用及其條件,不要先刪除規則區段。

[Rule]:依序比對,再套用目標策略

[Rule] 的核心是「比對條件 + 處理目標」。一般規則會由上而下檢查,符合條件後便採用對應目標,因此較具體的例外通常應排在範圍較廣的規則之前。DIRECT 表示直連,REJECT 表示拒絕;PROXY 用於代理策略。若使用自訂策略名稱,必須確認目前設定檔中確實有對應定義,不可任意填入名稱。

關鍵字範例比對說明
DOMAINDOMAIN,example.com,DIRECT比對完整網域 example.com,不包含其子網域。
DOMAIN-SUFFIXDOMAIN-SUFFIX,example.com,PROXY比對 example.com 及其子網域,並非比對任何以該字串結尾的內容。
DOMAIN-KEYWORDDOMAIN-KEYWORD,example,REJECT比對網域中含有 example 的請求,涵蓋範圍可能比預期更廣。
IP-CIDRIP-CIDR,192.0.2.0/24,DIRECT依目標 IPv4 位址網段比對;此處使用文件範例網段。
GEOIPGEOIP,CN,DIRECT依 IP 地理資料庫識別的區域比對,與網頁內容無關。
FINALFINAL,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

修改與驗證:每次只處理一個變數

首次修改前,先保留可還原的副本。完整設定檔可能還包含其他區段或遠端引用,不能因為本文只介紹四個區段,就刪除其餘所有內容。以下流程以目前已可連線的設定檔為基礎,目的是縮小修改範圍,而非重新建立整套服務。

  1. 備份設定檔

    進入 Config,找到目前啟用的設定檔,使用該項目的匯出或分享功能儲存副本;並記下檔名與目前的 Global Routing 模式。

  2. 編輯單一項目

    在 Config 開啟對應設定檔的編輯入口,只修改一個區段中的一項設定。測試 Rule 時,先新增一條精確的 DOMAIN 規則,不要同時修改 DNS 和 Host。

  3. 確認已啟用

    儲存後返回 Config,確認選取的是修改後的檔案,再前往 Home → Global Routing 選擇 Config,避免在 Proxy 或 Direct 模式下判斷規則效果。

  4. 發出新請求

    結束目標應用程式既有的連線,再發出一次新請求,並搭配可用的連線紀錄檢查目標網域與實際策略。已建立的長連線可能仍沿用原本的處理結果。

  5. 記錄並還原

    記錄修改列、命中結果與錯誤現象。若結果異常,請還原備份並重做相同測試,不要繼續累加未經驗證的設定。

若還需要更新既有訂閱,請將其視為另一項獨立操作:確認訂閱更新成功,且 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。請依照具體目的保留必要內容,並根據目前生效的設定檔判斷預設行為,不要把本文片段當成通用預設設定。

取得 Shadowrocket 與入門教學

iPhone / iPad 版在 App Store 一次性付費 $2.99,Mac(Apple 晶片 / Intel)/ Windows / Android / Linux 版免費。先在下載頁選擇裝置,再依教學匯入自己已有的服務資訊;設定檔用來整理設定與流量分流,不包含連線方案。