本文摘要

如果已經有可用的 Shadowrocket 設定,先確認要拒絕的是整個網域範圍,還是同一網域上的特定 URL 路徑。前者在 [Rule] 中指定 REJECT,後者則用 [URL Rewrite] 比對可見的完整 URL。測試時,分別送出一次目標請求與對照請求,再核對比對結果,即可判斷規則是否生效、設定是否未啟用或是否誤攔。以下以 iPhone / iPad 的操作介面說明。

REJECT 在規則比對的哪個階段生效

REJECT 是比對成功後的處理策略,不是比對條件。在 DOMAIN-SUFFIX,telemetry.example.com,REJECT 中,第一個欄位指定規則類型,第二個欄位指定比對範圍,第三個欄位則設定命中後拒絕連線。請求必須先進入 Shadowrocket 的處理範圍,並取得比對條件所需的資訊,才有可能符合這條規則。

應用程式請求流量接管目標識別規則比對策略執行

在 Config 中確認目前實際啟用的設定,編輯前先留存副本。返回 Home,確認連線已開啟,並在 Global Routing 中選擇 Config。開啟連線不代表流量一定會依設定分流:Proxy 和 Direct 不適合作為規則測試的基準;使用 Scene 時,目前生效的模式也取決於場景設定。排查時先固定使用 Config,不要同時切換網路和模式。

3 個欄位
網域規則範例:類型、比對值、策略
80
HTTP 預設連接埠
443
HTTPS 預設連接埠;連接埠本身不包含 URL 路徑

DOMAIN-SUFFIX 寫法:拒絕特定網域範圍

如果目標主機專門接收不需要的請求,可以依網域拒絕,不必讀取請求路徑。DOMAIN-SUFFIX,telemetry.example.com,REJECT 會比對 telemetry.example.com 及 v2.telemetry.example.com 這類子網域,但不會因此比對 api.example.com。如果只要封鎖一個確切的主機名稱,請改用 DOMAIN。不要順手擴大到 example.com,否則同一網域下的登入、圖片和 API 也可能遭到拒絕。

[Rule]
DOMAIN-SUFFIX,telemetry.example.com,REJECT
FINAL,DIRECT

以上是獨立測試片段,範例網域請換成可供你驗證的目標。合併到目前使用的設定時,只需將新增項目放進既有的 [Rule],並保留原本的 FINAL;不要為了測試而把日常的預設規則改成 DIRECT。同一個請求若符合多條規則,會由優先比對到的項目決定策略;例如較寬泛的 DOMAIN-SUFFIX,example.com,PROXY 若排在前面,寫在後面的子網域拒絕規則就不會處理已比對到的請求。

拒絕網域及其子網域

設定區段
[Rule]
比對條件
DOMAIN-SUFFIX,telemetry.example.com
命中策略
REJECT
放置位置
放在涵蓋相同目標的寬泛規則之前

適用於整台主機都可以拒絕的情況,不區分個別路徑。

保留子網域例外

精確條件
DOMAIN,health.telemetry.example.com
例外策略
DIRECT(僅在確認應直連時使用)
放置位置
放在對應的 DOMAIN-SUFFIX 拒絕規則之前

先處理明確的例外,再處理範圍較廣的網域後綴;例外應沿用該主機原本需要的連線策略。

URL Rewrite 寫法:只拒絕特定路徑

同一台主機可能同時提供登入、同步和統計 API。若只想拒絕 /telemetry,但保留 /account,就不能先在 [Rule] 中拒絕整台主機,再期待 URL Rewrite 放行其中一條路徑。單獨驗證路徑封鎖時,請先確認沒有其他設定會拒絕整台測試主機。

[URL Rewrite]
^https:\/\/api\.example\.com\/telemetry(?:[/?]|$) - reject

HTTPS 的路徑和查詢參數位於加密內容中。能依網域分流,不代表也能依路徑比對。Shadowrocket 必須能處理並讀取對應的 HTTP 請求,路徑規則才有機會生效;HTTPS 通常需要適用的 MITM 設定及受信任的憑證。僅在有權檢查的測試網域上啟用,並將範圍限制在該主機。如果應用程式拒絕接受用於檢查的憑證,請停止這項測試,不要擴大解密範圍至其他網域。

驗證規則是否命中,並找出誤攔原因

  1. 先建立基準。 新增規則前,先透過可控且原本可正常存取的測試服務送出一次請求,記錄實際網域、路徑和預期結果。如果基準測試本身就逾時、解析失敗或回應錯誤,請先排除基準問題;頁面載入失敗本身不足以證明命中了 REJECT。
  2. 每次只修改一條規則。 儲存變更後,確認目前啟用的仍是這份設定,再確認 Home 中的 Global Routing 設為 Config。測試網域時,使用一台目標主機和一台不屬於目標後綴範圍的主機;測試路徑時,則在同一台主機上使用 /telemetry 與 /telemetry-status,確認只有前者遭到拒絕。
  3. 讓應用程式重新送出請求。 關閉後重新開啟待測應用程式,或使用測試服務提供的新請求驗證,避免將快取頁面或已建立的連線誤當成新請求。如果可以查看連線記錄,請核對時間、目標和比對策略;測試路徑時,也要確認應用程式實際送出的是預期 URL,而不是重新導向後的網址。
  4. 還原設定並重新測試。 如果正常 API 也無法使用,先撤銷這次新增的項目或還原副本,再次送出目標請求與對照請求。還原後恢復正常,優先縮小網域範圍或路徑表示式;還原後仍未恢復,再檢查 DNS、伺服器狀態和網路連線。

無法攔截哪些請求:常見問題

加入 REJECT 後,頁面上的內容為什麼還在?

先確認重新開啟頁面時是否產生了新連線。如果內容已儲存在本機快取,或是隨頁面的主要回應一併傳回,就沒有獨立的目標請求可供攔截。請用未快取的請求確認實際主機;不要只為了移除頁面中的某個元素,就直接拒絕承載整個頁面的網域。

主機名稱規則沒錯,為什麼連線記錄中只有 IP?

先確認應用程式是否直接連線到 IP。如果 Shadowrocket 沒有取得可供比對的網域,DOMAIN-SUFFIX 就無法憑空推斷主機名稱。只有在確認 IP 固定、歸屬明確,而且不會影響其他服務時,才考慮使用 IP-CIDR 比對;不宜用共用 IP 取代網域規則。

規則中的路徑明明一樣,為什麼還是沒有命中?

先核對實際 URL 的主機、連接埠寫法及重新導向結果,再確認目前設定的檢查範圍是否涵蓋該協定。若 HTTPS 沒有解析出路徑,繼續修改正規表示式也無濟於事;如果應用程式使用的連線方式無法依預期檢查,請改以網域層級判斷,並接受無法區分同一主機上的不同路徑。

為什麼在某個網路可以攔截,換了網路又出現?

先分別確認連線狀態,以及 Home 中的 Global Routing 設定。再檢查 Settings → On Demand 是否為不同網路設定了不同的連線條件。同一條規則無法讓未進入 Shadowrocket 處理範圍的流量自動接受檢查;請先在相同網路和設定下重現問題,再比較切換網路後的結果。

REJECT 能處理的是進入用戶端且符合條件的新請求,不會刪除已下載的內容,也不是裝置層級的存取控制。可驗證的結論應寫成「在這份設定下,目標請求遭到拒絕,對照請求仍可存取」,而不是「該應用程式或頁面上的所有同類內容都已封鎖」。