修改出站策略請看 [Rule],修改網域解析結果請看 [Host],修改請求網址請看 [URL Rewrite],修改 DNS 等全域參數請看 [General]。本文適合已在 Shadowrocket 使用設定檔,並準備檢查或修改條目的使用者;操作介面以 iPhone / iPad 為例,其他平台可依設定段名稱對照。
先確認生效中的檔案,再判斷要修改哪個設定段
.conf 會以方括號標題區分設定段。從一個段落標題到下一個段落標題之間的條目,都屬於同一段。這四個設定段並非固定的請求處理順序:將 [Host] 移到 [Rule] 前面,不代表解析條目會有較高的分流優先順序。真正需要留意排列順序的是 [Rule] 段內的規則。
先確認 Home → Global Routing
在 Config 確認選取的檔案,接著前往 Home → Global Routing,選擇 Config 再驗證分流。如果目前選的是 Proxy 或 Direct,先別根據連線結果調整規則順序。
以下流程僅說明在 Config 模式下如何選出分流策略,不代表 DNS 查詢和 URL 改寫總是在同一時間執行。Scene 可依使用情境選擇路由方式;排查單一規則時,可先切換至 Config,減少切換情境造成的干擾。
- 先保留原始設定檔,再修改副本。如果原檔是透過遠端網址更新,請另外儲存本機修改,避免下次更新時遭到覆蓋。
- 每次只修改一處,並在相同裝置、網路和目標下重新測試。先記錄修改前的狀況,避免將網路切換或快取變化誤判為設定生效。
General:設定 DNS 等全域參數
[General] 使用 鍵 = 值 格式。這裡的設定不是針對個別網域指定出站策略。以下兩行分別設定系統 DNS 和 IPv6;實際修改時,不必為了測試 DNS 同時變更 IPv6。
[General]
dns-server = system
ipv6 = false
dns-server = system:使用系統設定的 DNS。如果同一網域只在某個 Wi-Fi 網路下解析異常,先確認該網路中的系統解析是否正常,再與行動網路或另一個已知正常的網路比較。不同網路使用的系統 DNS 不一定相同。ipv6 = false:關閉設定檔中的 IPv6 支援,用來排除 IPv6 路徑造成的影響;這不是系統層級的開關,也不保證目標一定有 IPv4 位址。測試結束後,先還原原始設定,再決定是否保留修改。
如果只有一個網域解析到錯誤位址,先檢查 [Host] 是否已有同名條目,別先更換全域 DNS。如果網域解析正常,但出站策略錯誤,再檢查 [Rule]。其他參數請參閱設定欄位說明。
Rule:逐行比對,由首個符合條件的規則決定策略
[Rule] 常見格式為 類型,比對值,策略,FINAL 不需要比對值。以下範例將精確網域例外規則放在網域後綴規則之前;不符合前面條件的請求則由 FINAL 處理。PROXY 使用目前選取的代理,DIRECT 表示直接連線,REJECT 表示拒絕該請求。範例中的網域和網段僅用於說明比對方式,不代表可用的服務位址。
[Rule]
DOMAIN,lab.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,REJECT,no-resolve
FINAL,DIRECT
網域比對
DOMAIN- 精確比對
lab.example.com,不包含其子網域。 DOMAIN-SUFFIX- 比對
example.com及其子網域。 FINAL- 前面的規則都未符合時,使用
DIRECT。
如果將網域後綴規則移到精確規則之前,兩個條件都符合時會先選用 PROXY。
IP 比對
IP-CIDR- 比對指定的 IP 網段;例如,字面 IP
192.0.2.10位於192.0.2.0/24網段內。 no-resolve- 不要為了測試這條 IP 規則而主動解析網域。
GEOIP- 依目標 IP 的地理分類比對,例如
GEOIP,CN,DIRECT,而非依網域後綴判斷。
將 GEOIP 加入設定檔時,請放在 FINAL 之前,並確認上方是否已有規則先行符合。
確認規則順序時,請區分「規則選中了某個策略」和「目標服務可以連線」。例如,請求目標識別為 lab.example.com 時,第一行符合 DIRECT;即使服務本身無法連線,也不會因此改用第二行的 PROXY。排查時應先確認比對結果,再檢查服務是否可連線。
Host:指定網域的解析結果
[Host] 可在設定檔中將網域對應至指定位址。以下使用文件保留位址 192.0.2.10 示範語法。實際驗證時,請換成自己管理的測試網域,以及目前網路可連線的位址,並確認該連線確實使用受設定檔影響的解析路徑。
[Host]
lab.example.com = 192.0.2.10
- 先使用原始設定檔連線至測試網域,記錄是否連線成功,以及伺服器端從何處收到請求。啟用含有網域對應設定的副本後,再以同一網域建立新連線,避免舊連線或 DNS 快取影響判斷。
- 如果每次仍連到原本的位址,請確認是否選取了副本,以及目標應用程式是否沿用舊連線或使用自己的 DNS。系統解析工具顯示的結果,不一定等同於該應用程式透過 Shadowrocket 連線時使用的解析結果。
- 如果已連線至指定位址,卻出現 HTTPS 憑證錯誤,請確認目標服務是否已為原網域設定有效憑證。
[Host]修改的是解析位址,不會取代 URL 中的網域,也不會讓不相符的憑證變成有效。
如果需求是「連線至同一個網域,但由另一台伺服器回應」,請檢查 [Host];如果需求是「造訪某個路徑後轉到另一個路徑」,請檢查 [URL Rewrite]。只更換 IP 不會讓瀏覽器網址列從 /old 變成 /new。
URL Rewrite:依 URL 模式傳回重新導向
以下 [URL Rewrite] 範例依序填入比對運算式、目標 URL 和動作碼 302,欄位之間以空格分隔。此規則只會比對完整的 HTTP 網址 http://lab.example.com/old。網域中的句點以反斜線跳脫,^ 和 $ 用來限定比對範圍,因此 /old/ 或帶有查詢參數的網址都不會符合這個運算式。
[URL Rewrite]
^http://lab\.example\.com/old$ http://lab.example.com/new 302
- 測試時請改用自己管理且允許明文 HTTP 的測試網域,不要傳送帳號或其他敏感資訊。確認請求仍使用
http://:如果瀏覽器先將網址升級為 HTTPS,就不符合範例中的比對條件。 - 預期結果是原始請求收到
302,回應中的Location指向以/new結尾的完整 URL;會跟隨重新導向的用戶端接著會送出新請求。如果網址列已變成/new,但頁面顯示找不到,請先確認伺服器上確實存在目標路徑。 - HTTPS 的路徑和查詢參數都包含在加密內容中。如果 Shadowrocket 無法讀取請求中的完整 URL,只把運算式裡的
http改成https,並不能讓路徑比對生效。請先用可控的 HTTP 範例驗證運算式,不要將 HTTPS 未符合規則直接歸因於[Rule]。
常見問題:修改設定後如何排查
明明新增了網域規則,為什麼仍使用原本的策略?
先在 Config 確認檔案名稱,再確認 Home → Global Routing 已設為 Config。接著由上而下檢查 [Rule],特別留意較早出現的 DOMAIN-SUFFIX。只有在確認例外適用範圍後,才將精確比對規則移到對應的廣泛規則之前。
為什麼直接輸入 IP 和輸入網域,結果不同?
先分別記錄兩次請求的目標。輸入網域時可能先符合網域規則,直接輸入 IP 則沒有相同的網域可供比對。即使兩次連線都到達相同位址,伺服器仍可能依網域選擇網站;直接使用 IP 連線也可能遇到憑證不相符的問題。
改寫後一直重新導向,應先刪除哪一行?
先在副本中移除這次新增的改寫規則,再重新測試。如果重新導向循環消失,請檢查目標 URL 是否也符合原始運算式,或目標頁面是否又重新導向至原網址。將運算式範圍縮小至確切的來源路徑,並分別測試來源網址和目標網址。
更新設定後,找不到本機新增的條目怎麼辦?
先在 Config 確認目前使用的是遠端設定檔還是本機副本。如果遠端內容已覆蓋本機修改,請從保留的副本找回條目,依設定段合併到新的副本中;合併後檢查規則順序和重複的網域對應,再逐項重新測試。