Shadowrocket 設定檔詳解:.conf 中 General、Rule、Host、URL Rewrite 各區段的用途

認識 Shadowrocket .conf 設定檔的區段結構,了解 [General]、[Rule]、[Host]、[URL Rewrite] 的用途,以及規則由上而下的比對順序。

本文重點

本文適合正在閱讀或修改 Shadowrocket 本機設定的使用者。先確認目前啟用的檔案與 Global Routing,再依照狀況查看對應區段:連線走錯路徑,檢查 [Rule];網域解析到錯誤位址,檢查 [Host] 和 [General];需要依 URL 路徑重新導向,則查看 [URL Rewrite]。

.conf 區段與語法

方括號中的區段名稱,會決定後續各行採用的語法,直到遇到下一個區段名稱為止。[General] 和 [Host] 都可能出現等號,但等號左側代表的意義不同:前者是設定項目,後者是主機名稱。[Rule] 通常以英文逗號分隔類型、比對值與策略;[URL Rewrite] 的重新導向項目則以空白分隔比對運算式、目標 URL 和動作。

4 個區段
本文涉及的設定區段
3 個欄位
DOMAIN 規則範例:類型、網域、策略
2 個欄位
FINAL 規則:關鍵字、策略

要在現有檔案中新增規則,先找到原有的 [Rule] 區段,再決定插入位置。不要把整段範例直接加到檔案末尾:末尾可能屬於其他區段,即使新的一行看起來像規則,也不會在讀取規則的位置生效。

在 Config 中編輯並啟用檔案

在設定檔清單中看到某個檔案,不代表目前連線正在使用它。以下以 iPhone / iPad 的介面用語為例。第一次修改時只調整一行,並保留修改前的檔案副本,方便在相同測試條件下還原驗證。

  1. 確認檔案

    開啟 Config,確認要編輯的檔名,並先另存一份未修改的副本。若遠端設定檔會更新,測試時請使用本機副本,避免重新整理後變更遭到覆蓋。

  2. 編輯原始內容

    在 Config 點選檔名,選擇 Edit Plain Text。找到目標區段,只新增或調整一項設定,保留原有的英文標點和分隔符號,然後儲存。

  3. 啟用設定檔

    返回 Config,點選編輯後的檔名並選擇 Use Config。確認啟用的是編輯後的檔案,而非用於還原的副本。

  4. 重新發出請求

    前往 Home → Global Routing → Config。以相同目標重新建立連線;若應用程式沿用舊連線,請先結束原有連線再測試。

Config 既是設定頁面的名稱,也是 Global Routing 下的一種模式。前者用來選擇檔案,後者則決定是否依該檔案的規則分流。排查 [Rule] 時,這兩個位置都要確認。

Config

建議

依照所選設定檔中的規則決定連線策略。例外項目、網域後綴項目和 FINAL 的順序都會影響結果。

適用情況:確認已啟用設定檔中的規則是否命中。

Direct

使用直連模式。直連成功只能表示目前網路可以直接連上目標,無法證明設定檔中的某條 DIRECT 規則已命中。

適用情況:使用相同目標,單獨檢查直連是否可用。

Proxy

讓用戶端處理的連線使用代理模式。測試前確認 Home 已選取自己的服務,再以相同目標建立新連線。

適用情況:不依賴分流規則,單獨檢查代理連線路徑。

[General] 與 [Host]:解析設定和單一網域對應

[General] 存放設定檔層級的設定,例如 dns-server = system 代表使用系統 DNS。[Host] 則可為特定主機名稱指定位址。前者決定一般使用哪種解析設定;後者指定 Shadowrocket 處理解析時,該名稱是否有個別對應。兩者都不能取代 [Rule] 的連線策略選擇。

[General]
dns-server = system

[Host]
docs.example.com = 192.0.2.10

192.0.2.10 是文件示範用位址,不可用於連線測試。上方的對應只設定了 docs.example.com,沒有設定 api.example.com。驗證對應時,仍須使用原本的主機名稱發出請求,不要把瀏覽器網址改成 IP;這會改變請求使用的主機名稱,也可能影響 HTTPS 憑證驗證條件。

依問題範圍選擇檢查項目

多個網域解析異常
  • 檢查 [General] 中的 dns-server,並確認問題是否只出現在特定網路。
  • 使用相同設定檔,在兩個網路分別發出新請求,確認狀況是否隨系統 DNS 所在的網路而改變。
只有單一主機名稱異常
  • 檢查 [Host] 是否設定了該完整主機名稱,特別留意 www 和其他子網域。
  • 在副本中移除該項對應,再以相同名稱重試,排除舊連線或快取造成的干擾。

先判斷是名稱解析錯誤,還是位址正確但連線失敗;兩種狀況需要檢查的項目不同。

[Rule]:由上而下比對,第一條命中規則生效

規則不會自動依精確程度排序。若要讓某個主機名稱成為網域後綴規則的例外,先寫該主機名稱的 DOMAIN,再寫涵蓋範圍較大的 DOMAIN-SUFFIX。未命中前面規則的連線,則交由末尾的 FINAL 處理。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

交換前兩條規則後,docs.example.com 會先命中 DOMAIN-SUFFIX,後面的精確規則就不會有機會生效。範例中的 FINAL,DIRECT 只是此設定檔的預設處理方式。修改現有檔案時,應先確認原本的預設策略;不要為了插入一條例外規則,連帶改變其他連線的處理方式。

IP-CIDR 依目標 IP 所屬的網段比對,例如 IP-CIDR,192.0.2.0/24,DIRECT;GEOIP 則依 IP 的地理歸屬資訊比對,不是依網域後綴判斷。排查網域請求時,先檢查上方是否已有網域規則命中,再確認 IP 類規則是否取得可供比對的目標位址。

[URL Rewrite]:依 URL 路徑重新導向

[Rule] 決定連線如何處理;[URL Rewrite] 則比對用戶端能處理的 HTTP 請求 URL。以下範例同時限定協定、主機名稱和路徑,並以 302 指向新位址。這只是語法示範,不依賴範例網域提供網頁。

[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302

HTTPS 請求的路徑位於加密內容中,只知道目標主機名稱不足以比對路徑。如果測試工具在送出前已將 HTTP 升級為 HTTPS,上方的運算式就不會照原樣命中。先確認實際送出的協定和 URL,再決定是否需要修改運算式。

儲存後未生效的常見原因

明明設定了 DIRECT,為什麼還是走代理?

先確認 Home → Global Routing 是否設為 Config,再檢查目前啟用檔案中的 [Rule]。若上方已有涵蓋該主機名稱的 DOMAIN-SUFFIX,請將精確的 DOMAIN 例外移到它前面,重新建立連線驗證。

可以把新規則直接貼在 FINAL 下面嗎?

不要把一般規則放在預設規則之後。若已有 FINAL,請將新規則插入其前方,再檢查更上方是否有涵蓋該目標的項目。儲存後,分別測試一個應命中新規則的目標,以及一個應交由預設規則處理的目標。

修改 Host 位址後,為什麼瀏覽器網址列沒有變?

[Host] 修改的是主機名稱對應的位址,因此網址列仍顯示原本的 URL 屬正常情況。要驗證對應,請使用自己管理的目標服務,確認新連線是否抵達預期位址;若要將 /old 改為 /new,應檢查重新導向,而不是主機對應。

切回原始檔案後,如何判斷是哪次修改出了問題?

在相同網路上,分別使用原始檔案和修改後的副本發出相同請求,並保持 Global Routing 與所選服務不變。若只有副本出現問題,就從最近修改的區段開始逐行還原,每次只改一處並重試,直到找出觸發問題的項目。

下載 Shadowrocket 全平台版本