本文適合已能在 Home 建立連線,並準備在 Config 閱讀或修改 .conf 檔的使用者。先分清連線資料與設定檔,再檢查 General、Rule、Host、URL Rewrite 四段的語法與生效條件,最後透過單項修改和還原步驟找出問題。範例使用保留網域與文件專用位址,並非可用的連線設定。
先分清 .conf、連線資料與 Global Routing
Shadowrocket(小火箭)的 .conf 是文字設定檔,用來描述全域參數、分流規則及其他請求處理設定。它不等於伺服器訂閱:Home 中的連線資料決定如何連線至伺服器,Config 中目前啟用的檔案則決定依哪些條件處理流量。已有的訂閱請向你的服務商索取;本站不提供、不販售也不推薦節點或訂閱。
排查「修改規則卻沒有變化」時,先檢查 Home → Global Routing。Proxy、Direct、Config、Scene 是不同的路由模式;測試本文的 Rule 範例時,請明確選擇 Config,並確認 Config 啟用的檔案就是剛才編輯的檔案。Proxy 不適合用來檢驗逐條分流規則,Direct 也不是驗證代理策略的合適模式;若使用 Scene,還要確認該場景實際採用的設定。
設定檔檢查流程可拆成以下五個步驟。這是故障排查順序,不代表用戶端內所有處理模組固定依此順序執行;尤其不能據此推論 URL Rewrite、DNS 與規則匹配之間,對所有請求都適用同一條簡單流程。
.conf 基本結構:段名、等號與英文分隔符號
段名放在英文方括號中,例如 [General]。General 和 Host 常用 鍵 = 值;Rule 以英文逗號分隔規則類型、匹配內容與策略;URL Rewrite 則使用該規則專屬的空格分隔格式。不同段落的寫法不能直接混用。
以下是用來了解結構的最小範例。它將 example.com 指定為 PROXY,其餘請求則交由 DIRECT,並在 Host 加入一筆文件用位址對應。使用 PROXY 仍須先有可用的連線資料;192.0.2.10 是文件專用位址,不能用來確認一般網站是否可連線。正式使用前,請移除這筆 Host 示範記錄。
# Structure example; documentation addresses only.
[General]
dns-server = system
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
[Host]
demo.example.com = 192.0.2.10
[URL Rewrite]
# Add rewrite rules only when needed.
- 使用純文字編輯器儲存
.conf,避免檔案實際變成.conf.txt,也不要混入豐富文字格式。 - 保留英文的
[ ]、=、,,不要換成中文標點。段名URL Rewrite中間有空格。 - 建議註解獨立一行,並以
#開頭。不要假設任何欄位末尾都能加上說明文字。 - 同一段內容盡量集中撰寫,避免重複段名或鍵名造成維護上的混淆;不確定覆寫行為時,先合併再測試。
General:全域參數不是伺服器參數
[General] 用來設定全域行為,例如 DNS 解析相關設定。範例中的 dns-server = system 表示使用系統 DNS 設定,並未指定代理伺服器,也不保證 DNS 查詢會經由特定代理連線。實際解析路徑也會受到連線方式、其他 DNS 選項,以及請求是否由應用程式自行解析等因素影響。
先保留少量已理解的參數,再依故障狀況增加設定。若將一整段陌生的 General 參數直接覆蓋到現有檔案,可能同時改變解析、IPv6 和流量排除行為,讓原本單一的問題更難重現。伺服器密碼、WireGuard 金鑰或 TLS 連線參數,也不應只因為名稱中有「全域」就填入此段。
General 閱讀卡
- 段名
[General]- 欄位格式
鍵 = 值- DNS 範例
dns-server = system- 檢查重點
- 欄位拼寫、重複鍵、既有 DNS 設定
每次只修改一個全域選項,並記下修改前的值。
Rule 閱讀卡
- 段名
[Rule]- 網域規則
DOMAIN-SUFFIX,example.com,PROXY- 預設規則
FINAL,DIRECT- 檢查重點
- 由上而下的順序與末尾策略
規則類型決定匹配條件,末尾策略決定處理方式。
也要分清連線觸發與請求分流:Settings → On Demand 用來設定按需連線條件,並不等於 General 中的一條分流規則。若出現「手動中斷後又重新連線」的情況,應檢查 On Demand 條件與系統 VPN 狀態,而不是反覆修改 FINAL。
Rule:由上而下匹配,FINAL 放在最後
[Rule] 是最常修改的部分。規則會由上而下依序檢查,匹配後便採用對應策略,不會為了尋找「更精確」的項目而繼續往下比對。因此,具體網域與明確的位址規則通常要放在較廣泛的規則之前,並將 FINAL 作為預設規則放在最後。
| 關鍵字 | 範例 | 匹配含義 |
|---|---|---|
DOMAIN-SUFFIX | DOMAIN-SUFFIX,example.com,PROXY | 匹配 example.com 及其子網域,不會匹配只是包含這段字串的任意網域。 |
IP-CIDR | IP-CIDR,192.0.2.0/24,DIRECT,no-resolve | 匹配指定的 IPv4 網段;no-resolve 表示不為這項匹配主動進行網域解析。 |
GEOIP | GEOIP,CN,DIRECT | 依據位址資料庫判斷目標 IP 所在地區,不會參考網頁語言或網域文字。 |
FINAL | FINAL,PROXY | 前面的規則都未匹配時,採用 PROXY 策略。 |
例如,以下將特定網域排在位址與地區規則之前。DIRECT 表示直接連線,PROXY 表示使用相應的代理選擇;它們不是 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 或 WireGuard 等協定名稱。不要直接把協定名稱當成通用策略填入。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
no-resolve 並非「關閉所有 DNS」。它只限制相關 IP 規則在匹配時是否主動解析網域;若請求本身就是 IP 位址,或目標位址已可取得,仍可能匹配位址規則。反過來說,若用戶端只取得目標 IP,沒有網域資訊,就不能期待所有 DOMAIN-SUFFIX 都依照瀏覽器網址列中的文字匹配。
- 先在 Config 確認啟用的檔案,再到 Home → Global Routing 選擇 Config。
- 將要驗證的精確條件放在較廣泛的條件之前,並確保只有一條 FINAL,且位於最後。
- 重新送出目標請求,查看請求記錄中的目標、匹配規則與實際策略;不要只確認連線開關是否開啟。
- 若網域規則未匹配,先確認實際請求網域,包括重新導向後的網域,再檢查規則順序與解析資訊。
Host:本機解析對應不等於請求改寫
[Host] 可將指定主機名稱對應至指定 IP。常見格式為左側網域、右側位址,例如 demo.example.com = 192.0.2.10。此處不要填入 https://、URL 路徑或 :443;這裡描述的是主機名稱與位址的對應關係,不是完整的存取 URL。
[Host]
demo.example.com = 192.0.2.10
api.example.com = 198.51.100.20
以上兩個位址都僅供文件示範。實際設定時,請填入你有權使用且確實提供目標服務的位址。Host 不會將瀏覽器網址列中的網域替換成 IP,也不會自動變更 HTTP Host 或 TLS SNI;若對應的伺服器沒有該網域的憑證,HTTPS 仍可能出現憑證錯誤。
- 位址與連接埠分開:HTTPS 常用連接埠為
443,HTTP 常用連接埠為80,但 Host 對應本身不會將 443 改成其他連接埠。 - 對應與路由分開:Host 決定解析結果,Rule 決定連線策略;新增對應不代表指定 DIRECT。
- 快取與新連線分開:修改後請重新送出請求;必要時先關閉目標應用程式再重新開啟,避免舊連線繼續使用先前的位址。
- 解析入口分開:若應用程式自行使用加密 DNS 或固定 IP,未必會採用這裡的本機對應;不能只因頁面沒有變化,就判定語法有誤。
URL Rewrite:匹配 URL 後執行改寫動作
[URL Rewrite] 處理的是請求 URL,不是網域到 IP 的對應。以下範例使用正規表示式匹配一個 HTTP 位址,並將以 /old/ 開頭的路徑重新導向至 /new/。每行依序包含匹配表示式、目標位址與 302,欄位之間以空格分隔。
[URL Rewrite]
^http://example\.com/old/(.*)$ http://example.com/new/$1 302
在表示式中,^ 限定開頭,$ 限定結尾,\. 表示網域中的字面句點,(.*) 擷取後續內容,目標中的 $1 則引用第一組擷取結果。依照這條規則,http://example.com/old/help 的目標位址應為 http://example.com/new/help。這只是語法推演,並不代表該示範網站提供相應頁面。
重新導向也可能改變後續請求行為。涉及登入、付款、上傳或 API 請求時,不能將 302 視為適用於所有請求方法的透明替換。請先在自己控制的測試位址驗證匹配範圍、目標 URL、查詢參數與請求方法,再考慮用於實際情境。
- 不要漏掉網域中的跳脫句點,否則正規表示式中的句點會匹配任意單一字元。
- 未限定主機名稱時,不要只匹配通用路徑,以免影響其他網域。
- 不要讓目標位址再次符合同一條規則,以免形成循環重新導向。
- 不要把 Rule 的
DOMAIN-SUFFIX語法寫進 URL Rewrite,也不要用 Host 對應取代路徑改寫。
在 Config 中安全修改:備份、啟用、重新測試
遠端設定、連線訂閱與本機副本應分開管理。更新連線訂閱通常是更新 Home 中的連線資料;更新遠端 .conf 則可能替換設定檔內容。不要假設手動寫入遠端檔案的規則,下次更新後仍會保留。
- 保留基準版本:在 Config 找到目前啟用的檔案,先保留一份完整副本,並記下目前的 Global Routing 模式。備份檔可能包含敏感參數,請勿公開上傳。
- 找到正確段落:透過該檔案的編輯入口開啟文字編輯,確認修改的是 General、Rule、Host 或 URL Rewrite 中正確的一段。
- 單項修改:每次只新增一條規則或修改一個鍵。先以較小的匹配範圍驗證,不要同時變更 DNS、路由與改寫設定。
- 儲存並啟用:回到 Config 確認已選取該檔案;若介面提示重新載入或重新連線,請依照提示操作,再到 Home 確認 Global Routing。
- 重新測試與還原:重新建立目標請求,記錄匹配規則、錯誤類型與目標位址。若出現異常,切換回備份檔並以相同請求重新測試。
測試記錄應描述具體情況,例如「目標為 api.example.com,預期匹配 DOMAIN-SUFFIX,實際套用 FINAL」,而不是只寫「網路不通」。若所有目標都無法連線,先檢查 Home 中選取的連線與服務商提供的資料;若只有一類網域異常,再檢查 Rule、DNS 與 Host;若只有特定路徑發生跳轉,則優先檢查 URL Rewrite。
常見問題:檔案已儲存,結果為何不如預期?
已修改 Rule,為什麼流量還是全部採用同一種策略?
先到 Home → Global Routing 確認目前是否選擇 Config,再返回 Config 確認啟用的檔案。接著檢查 Rule 中是否有 FINAL 過早出現,或較廣泛的規則排在目標規則之前。儲存檔案不代表已切換至該檔案。
Host 已填入位址,為什麼 HTTPS 顯示憑證不符?
請確認對應位址上的伺服器是否為原網域提供有效憑證。Host 不會變更 TLS 驗證使用的網域,也不負責設定伺服器憑證。先移除該筆對應並重新連線,確認異常是否隨之消失。
URL Rewrite 沒有作用,是不是少加了一條代理規則?
先確認實際 URL 的協定、主機名稱、路徑與查詢參數是否符合表示式。HTTPS 路徑也會受到加密內容可見性與 MITM 條件影響,新增 PROXY 規則無法取代這些條件。請先使用可控的 HTTP 測試位址驗證表示式。
更新後,自訂規則為什麼不見了?
先確認更新的是 Home 中的連線訂閱,還是 Config 中的遠端檔案。若遠端設定已整份替換,請從備份還原至本機副本,再重新套用必要修改;下次更新前先比較差異,不要直接覆蓋已驗證的本機檔案。
閱讀 .conf 的關鍵在於分清各段職責:General 設定全域行為,Rule 依序選擇策略,Host 提供本機對應,URL Rewrite 處理符合條件的 URL。將修改範圍縮小至一段、一個欄位與一筆請求,才能判斷結果是由哪項設定造成,而非反覆匯入整份設定檔碰運氣。
Shadowrocket 下載與設定教學
iPhone / iPad 版請從 App Store 取得,售價 $2.99,單次付費;Mac(Apple 晶片 / Intel)、Windows、Android、Linux 版免費。iPhone / iPad 的系統需求以 App Store 頁面標示為準。用戶端取得方式與連線服務分開處理,訂閱請向你的服務商索取。