本文重點

修改前,先在 Config 確認目前使用的設定檔,再到 Home 檢查 Global Routing。本文以 iPhone / iPad 介面為例,適合已能建立連線,並需要調整分流或排查規則未命中的讀者。逐段修改並保留原設定,即可分別檢查出站策略、網域解析與 URL 重新導向。

先確認 .conf 檔案與路由模式

.conf 是依段落編排的設定檔。方括號中的名稱會指定後續條目由哪個段落讀取:[General] 和 [Host] 的範例以等號指定值,[Rule] 使用逗號分隔欄位,[URL Rewrite] 的重新導向範例則以空格分隔欄位。移動任何一行前,都要先確認新段落所使用的語法。

目前設定檔路由模式目標比對出站策略連線記錄

在 Config 確認選取的是準備測試的檔案,而不只是開啟了某個檔案的編輯畫面。儲存副本後,返回 Home,將 Global Routing 設為 Config 再測試分流。Proxy 和 Direct 是不同的全域路由選項,不適合用來判斷某條 [Rule] 是否命中。Settings 中的 On Demand 用來設定自動建立連線的時機,也不能取代這個步驟。

4 段
本文逐一檢查 General、Rule、Host、URL Rewrite
2 個逗號
基本 DOMAIN-SUFFIX 規則的欄位分別是類型、網域與策略
302
本文 URL Rewrite 範例使用的 HTTP 重新導向狀態碼

先確認命中結果,再判斷連線路徑

同一個頁面能開啟,不代表流量確實走了預期的出站路徑。先連線至已知目標,並在應用程式的連線記錄中確認策略;若策略正確但請求仍失敗,再檢查解析結果或相應的出站是否可用。

General:設定全域 DNS 參數

[General] 用來設定整份設定檔共用的參數。以 dns-server 為例,將值設為 system 表示使用系統 DNS,而不是在這一行指定固定的 DNS 伺服器。切換 Wi-Fi 或行動網路後,系統提供的解析環境可能不同;比較修改前後的結果時,應先維持相同的網路連線。

[General]
dns-server = system
  • 請在現有的 [General] 段落中修改對應的鍵值,不要只為測試一個參數就新增同名段落,也不要同時保留兩條互相衝突的 dns-server。
  • 修改前後請使用同一個原本可正常連線的網域進行比較,並確認測試請求確實建立了新連線。若沿用舊連線或讀取快取,重新整理頁面不一定會再次執行解析。
  • 請分開判斷解析結果與出站狀況。成功取得目標地址,不代表目前的策略能連上該地址;反過來說,既有連線仍能傳輸,也不表示新的 DNS 查詢一定成功。

Rule:從具體規則到 FINAL 預設規則

[Rule] 依書寫順序比對,由第一條命中的規則決定策略。請將單一網域的例外規則放在涵蓋它的後綴規則之前,並將 FINAL 放在最後。以下的文件網域與地址僅用於說明比對方式,不代表實際服務;在自己的設定中使用 PROXY 前,請先在 Home 確認已有可用的代理伺服器。

[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,DIRECT

假設應用程式取得了請求的網域,docs.example.com 會先命中第一行,而相同後綴下的 img.example.com 會命中第二行。若將前兩行對調,docs.example.com 就會先被後綴規則涵蓋。第三行比對指定的 IPv4 網段;使用 IP 位址直接發出請求時,不應預期會命中網域規則。未命中前述規則的請求才會套用 FINAL。

依網域比對

DOMAIN
比對完整網域,例如 docs.example.com。
DOMAIN-SUFFIX
比對 example.com 及其子網域,但不包含 notexample.com。
常見錯誤
網域欄位不要包含 https://、連接埠或路徑。

同一後綴中有例外網域時,請將完整網域規則放在後綴規則上方。

依地址比對與預設規則

IP-CIDR
依 IPv4 地址範圍比對,例如 192.0.2.0/24。
GEOIP
依目標 IP 的地理分類比對,例如 GEOIP,CN,DIRECT。
FINAL
指定未命中前面規則時採用的策略,例如 FINAL,DIRECT。

IP 類規則依據目標地址判斷,不會依網域後綴或裝置所在地區判斷。

不要只為了測試一條網域規則就替換現有的 FINAL。這會一併改變所有未命中規則的流量出站方式,讓結果難以判斷原因。請保留原有的預設規則,只新增一條明確的例外,再分別測試一個應命中的網域和一個不應命中的網域。

Host:將網域對應至指定 IP

[Host] 左側是要解析的網域,右側是對應地址。當 Shadowrocket 處理該網域的解析時,可透過此設定將請求指向指定地址。它不能取代 [Rule],不負責選擇 DIRECT 或 PROXY,也不會將網址列中的網域改成另一個網域。

[Host]
staging.example.com = 192.0.2.10

192.0.2.10 是文件範例地址,不適合用來驗證服務是否可連線。實際測試時,請改用自己管理的測試網域,以及目前網路可連線的服務地址。測試時仍應使用網域發出請求;直接輸入 IP 會略過這項網域對應,也可能使伺服器將請求交給另一個網站處理。

  1. 請先確認請求使用的是由 Shadowrocket 處理的解析路徑。應用程式快取、既有連線或由遠端執行解析,都可能讓本機對應暫時看不出效果。
  2. 請確認目標服務正在所用連接埠上監聽。http:// 預設使用 80,https:// 預設使用 443;對應規則不會修改連接埠。
  3. 使用 HTTPS 時,伺服器仍須提供符合原網域的憑證。對應至指定 IP 後若出現憑證錯誤,請先檢查伺服器憑證與網站設定,不要將憑證錯誤誤判為對應規則未命中。

URL Rewrite:依 URL 比對並回傳重新導向

[URL Rewrite] 中的 302 寫法適用於可識別的 HTTP 請求 URL。規則命中後會回傳重新導向回應,是否跟隨則由發出請求的用戶端決定。這不是 DNS 對應,也不會將目標 IP 改成規則右側的值。以下以未加密的 HTTP 示範,只比對一個完整的舊網址:

[URL Rewrite]
^http://docs\.example\.com/old$ http://docs.example.com/new 302
  • 第一個欄位是正規表示式。\. 代表字面上的句點,開頭的 ^ 與結尾的 $ 用來限制整個 URL,避免其他主機或相似路徑也符合規則。
  • 第二個欄位是重新導向目標。依照此範例,/old/ 或帶有查詢參數的 /old?ref=test 都不會命中;/new 也不符合原規則,因此不會由這一行再次跳轉。
  • 第三個欄位是動作 302。測試時請分別確認原始請求是否收到 302、Location 是否指向預期目標,以及新請求是否成功。新網址回傳錯誤,不代表原本的重新導向沒有發生。

請使用自己管理的測試網站進行驗證。如果用戶端在送出請求前就將 HTTP 升級為 HTTPS,這條以 http:// 開頭的正規表示式就不會命中。HTTPS 的路徑和查詢參數受到 TLS 保護,只知道主機名稱不足以進行路徑層級的改寫;請勿將修改正規表示式或新增 [Host] 當成解決方式。

設定未生效:逐項檢查檔案、策略與請求

我在 Config 中修改了設定,為什麼請求仍使用舊策略?

先確認變更已儲存,而且目前使用的就是該檔案;接著確認 Home 中的 Global Routing 是否設為 Config。請讓測試應用程式重新建立連線,再查看這次請求的出站策略,不要用修改前的記錄來判斷。

規則已設為 DIRECT,為什麼仍然走 PROXY?

往前檢查是否有更早出現的後綴規則,或其他涵蓋該目標的規則。請將針對完整網域的 DOMAIN 例外移到涵蓋它的規則之前,再分別測試例外網域及另一個相同後綴的網域。

Host 已指向測試主機,為什麼開啟的仍是原網站?

先確認請求仍以測試網域發出,再檢查測試服務是否收到新請求。若沒有收到,請排除舊連線、快取與遠端解析;若已收到請求但回傳原網站內容,則檢查測試主機是否已為該網域設定正確的網站。

新增 302 後,為什麼瀏覽器沒有跳轉?

請以實際送出的 URL 比對正規表示式,特別檢查通訊協定、結尾斜線與查詢參數。若已收到 302,請接著檢查 Location 和新請求,不要反覆修改原本的比對式。暫時移除這條規則後再測試一次,可用來區分是設定造成的重新導向,還是伺服器原有的跳轉。