要調整出站策略,請編輯 [Rule];要變更網域對應的 IP,請編輯 [Host];要改寫 URL 路徑,請編輯 [URL Rewrite];要調整整份設定檔的解析等通用行為,請編輯 [General]。本文以 iPhone / iPad 的 Home 和 Config 示範檢查步驟;在 Mac、Windows、Android 或 Linux 上檢視設定檔時,可參照區段名稱與規則語法,不必照搬相同的點按路徑。
01. 確認目前的 Config 與 Global Routing
.conf 是分段的純文字設定檔。方括號中的標題會標示後續各行所屬的區段:例如,同一個網域若寫在 [Rule] 中,會作為比對條件;若寫在 [Host] 中,則是 IP 對應的鍵。以下各區段都是供參照的獨立片段,請勿用它們取代整份現用設定檔。
- 開啟 Config,記下目前選用的檔名並保留原始檔。另存副本後再進行編輯;若現有檔案已包含對應的區段名稱,請將新行加入該區段,不要為了貼上片段而重複新增區段標題。
- 在 Config 確認選用的是修改後的副本,再返回 Home,將 Global Routing 設為
Config。測試[Rule]時,請勿停在Proxy或Direct,否則無法透過目前的請求驗證逐條分流結果。 - 保持連線開啟,使用同一個測試目標比較修改前後的結果。每次只變更一個區段中的一項條件;若同時修改 DNS、規則和重寫,即使網頁恢復正常,也無法判斷是哪項修改生效。
02. [General]:全域參數與 DNS 基本設定
[General] 大多採用 鍵 = 值 的格式。此區段描述設定檔的通用行為,不是特定網站的出站選擇。排查解析問題時,先記錄原本的 dns-server 值,再決定是否調整;不要為了修復單一網域而順手替換整個區段。
[General]
dns-server = system
system 代表使用系統 DNS,而不是在這一行指定固定的解析器。切換 Wi-Fi 與行動網路後,系統使用的 DNS 環境可能不同;比較結果時,應先固定網路,再檢查同一個網域。網域成功解析出 IP,不代表目標連接埠一定可連線,也不代表伺服器一定會接受連線。
- 若修改
dns-server後多個網域同時發生解析異常,請先還原原值,並在同一個網路環境下重新檢查。 - 若只有一個自行管理的網域解析到舊 IP,請先檢查
[Host]是否仍保留該名稱的對應,不要只憑這個網域就判定全域 DNS 失效。 - 若網域能解析,但請求使用了錯誤的出站策略,請檢查
[Rule]和 Global Routing;更換解析器無法修正規則順序。
03. [Rule]:第一條符合規則、IP 條件與 FINAL
一般規則以半形逗號分隔比對類型、條件和策略。Shadowrocket 由上而下檢查,符合某條規則後就採用該條策略,不會繼續尋找更具體的規則。FINAL 沒有獨立的比對條件,用來處理前面規則都未符合的請求,應放在規則區段的最後。
[Rule]
DOMAIN,api.example.com,PROXY
DOMAIN-SUFFIX,example.com,DIRECT
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
FINAL,PROXY
逐行確認預期的出站策略
網域比對
DOMAINapi.example.com符合第一行的精確網域規則,採用PROXY。DOMAIN-SUFFIXwww.example.com符合網域後綴規則,採用DIRECT。- 規則順序變更
- 將後綴規則移到頂端後,
api.example.com也會先符合這一行,改走DIRECT。
同一後綴下若有例外網域,請將精確比對規則排在較廣泛的規則之前。
IP 比對與後備規則
IP-CIDR- 依可取得的目標 IP 網段進行比對;目標 IP 為
192.0.2.10的請求符合範例網段。 no-resolve- 不會為了比對這條規則而主動解析網域;這不代表全域 DNS 已關閉。
FINAL- 只有前面的規則都未符合時,才會採用
PROXY;實際驗證代理出站需要已有可用的服務。
範例網段是文件保留位址,只供推演比對結果,不可用來測試公網連線。
單一網域出站錯誤時,先找第一條符合的規則
從規則區段頂端開始,找出能涵蓋該網域的精確或後綴規則。若較廣泛的規則排在例外規則之前,只需將例外規則移到前面,再用原網域驗證;不要修改 FINAL,否則其他未符合規則的請求也會改變出站策略。
GEOIP 同樣依目標 IP 判斷,例如 GEOIP,CN,DIRECT 表示符合地理 IP 資料判定為 CN 的目標。它不會讀取網頁語言,也不會依網域後綴判斷。若要讓精確網域例外優先套用,請將例外規則放在可能涵蓋它的 IP 類規則之前。
04. [Host]:固定網域解析位址,不修改 URL
[Host] 可為指定名稱設定本機對應。以下使用文件保留位址示範語法:左側只有主機名稱,不包含通訊協定、連接埠或路徑;右側則是目標 IP。這不等於在 [Rule] 中為該網域指定 DIRECT。
[Host]
lab.example.com = 192.0.2.10
- 需要驗證時,請將範例網域與 IP 換成自行管理的測試名稱及可連線的伺服器位址。查看伺服器端的存取記錄,確認請求是否抵達預期伺服器,而不只是查看瀏覽器網址列;成功套用對應後,網址列仍可能顯示原網域。
- 若使用既有代理服務,也要區分目標名稱是在本機解析,還是交由遠端解析。排查本機對應時,請先使用自己可控制的直連測試目標,避免將遠端解析結果誤認為本機對應失效。
- 若伺服器已收到請求,但回傳憑證錯誤,請檢查憑證是否涵蓋 URL 中的原始主機名稱。變更解析位址不會改變 HTTPS 驗證的名稱,也不會將伺服器的其他連接埠改成 URL 指定的連接埠。
05. [URL Rewrite]:依 URL 比對並回傳重新導向
[URL Rewrite] 適用於客戶端可取得完整 URL 的請求。範例由左至右依序為正規表示式、目標 URL 和重新導向類型:將明文 HTTP 的 /old 請求暫時重新導向至相同主機的 /new。此區段不處理 DNS 對應,也不會使用 DIRECT 或 PROXY 作為重寫目標。
[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
\.比對字面上的句點,^和$用來限定整個 URL。/old/和/old?from=test都不符合;目標/new也不會再次符合這一行。- 驗證時請使用自己管理且可接收明文 HTTP 的測試網站。比較
/old與/old/的第一個回應;前者預期收到302,並帶有指向/new的Location,後者則不應由此規則重新導向。只看瀏覽器最後顯示的網址,容易把自動跟隨重新導向後的結果誤當成第一個回應。 - 若瀏覽器先將
http://升級為https://,請求便不符合範例的運算式。HTTPS 路徑位於加密請求中,僅憑網域資訊無法判斷路徑是否為/old;請勿用這個 HTTP 範例判定 HTTPS 路徑重寫是否可用。
06. 修改未生效時的檢查順序
已儲存副本,為什麼仍套用舊規則?
先在 Config 確認目前選取的檔名,再到 Home 檢查 Global Routing 是否設為 Config。對同一個目標發送新請求;若連線仍在重複使用,請先結束原請求再測試。若結果仍不如預期,請從規則區段頂端找出第一條涵蓋該目標的規則。
已修改 Host,為什麼網址列沒有變?
[Host] 修改的是解析位址,不是 URL。請到目標伺服器確認新請求是否抵達;若要將網址列中的 /old 改為 /new,應驗證重新導向,而不是把路徑加進 [Host] 的鍵名。
原本能開啟的網站修改後無法使用,應先還原哪一項?
在 Config 重新選用編輯前的原始檔,並維持相同網路和測試位址進行比對。若原始檔可用,請從副本撤回最後一項修改,再逐項驗證。若原始檔也無法使用,先檢查 Home 的連線狀態與目前網路,不要繼續修改 FINAL 或疊加 DNS 設定。