修改 .conf 前,先在 Config 備份目前的檔案,再分別檢查一般參數、路由規則、網域對應與 URL 重寫;若要依規則分流,請將 Home → Global Routing 設為 Config。本文適合已有自己的服務商與訂閱、想了解設定語法的使用者,提供可分步驗證的範例與復原方式;設定檔不是連線憑證。
一、.conf 的分段結構與生效條件
Shadowrocket(小火箭)的 .conf 是文字設定檔。方括號內是分段名稱,各段再依其語法填入參數或規則。[General] 通常使用 鍵 = 值,[Rule] 則以逗號分隔規則列;這兩種語法不可混用。儲存成功不代表設定已啟用,還要到 Config 確認目前選取的檔案。
以下是用來說明結構的最精簡範例,不能直接取代現有設定作為完整連線方案。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
- 適用情境:由使用者管理的測試網域需要暫時指向特定伺服器,且已確認該伺服器會接受該網域的請求。
- 不會改變的內容:此對應不會自動更改瀏覽器網址列中的網域,也不會替目標伺服器產生相符的 TLS 憑證。
- 常見錯誤:將
lab.example.com:443當成左側值,或在右側值填入完整網頁路徑。 - 還原方式:刪除或註解相應對應,儲存並重新建立連線,再確認目前使用的 Config。
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
^用來限定從 URL 開頭開始比對,避免運算式在其他位置誤符合。example\.com中的句點以反斜線跳脫,代表一般句點,而非正規表示式中的任意字元。(.*)用來擷取後續內容,目標中的$1則引用第一組擷取結果。302代表暫時重新導向。用戶端會依重新導向結果發出後續請求,而不是直接替換伺服器回應本文。
這條規則的來源網址明確使用 HTTP。不能只把運算式中的 http 改成 https,就認為能讀取所有加密請求的完整 URL;一般通道轉送不代表能取得 TLS 內部的路徑與內容。有些瀏覽器會因 HSTS 或 HTTPS 優先策略,在送出請求前就升級網址,因此 HTTP 範例可能沒有比對機會。
URL 重寫與 Rule 處理的是不同問題:前者改變符合條件的請求 URL 行為,後者決定連線採用的路由策略。即使重新導向規則生效,後續目標是否可連線,仍取決於 DNS、路由與伺服器狀態。若最後仍無法開啟頁面,應先確認問題發生在初始請求、重新導向過程,還是新目標的連線。
六、儲存、啟用與還原:一次驗證一項變更
編輯前,請在 Config 備份目前可用的檔案並記下檔名。不同平台的編輯選單可能不同,請以目前 App 提供的編輯、複製或匯出功能為準。不要直接覆寫唯一一份工作設定;遠端設定也應保留本機副本,避免後續更新後難以追蹤手動修改。
- 在 Config 開啟準備修改的檔案,只修改一個分段中的一項設定,並使用英文標點儲存。
- 確認該檔案是目前使用的設定,再前往 Home → Global Routing 選擇 Config。
- 確認目前選取的代理可用;規則正確不代表伺服器驗證資訊有效。
- 重新建立連線,造訪與該規則直接相關的測試目標,並檢查 App 提供的連線記錄或日誌。
- 記錄目標網域、預期策略、實際結果與修改項目;若失敗,切回備份檔,再以相同請求進行比對。
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 則以空格分隔欄位。撤回剛新增的內容,確認原始檔案可正常使用後,再逐行恢復。