官方手冊 · 功能與設定

Shadowrocket
代理模式與常用設定

先選擇 Global Routing 的運作模式，再確認伺服器與設定檔。連線開關、分流規則和按需連線各自控制不同環節，設定時應分開驗證。

• Home
• Config
• Data
• Settings

---

02 · 檢查比對依據

規則類型與策略

規則說明「比對什麼」，策略說明「符合後如何處理」。在 Config 中開啟目前的設定檔，查看或編輯其中的 Rule 區段。通常會依檔案中的順序判斷，先符合的規則先決定結果，因此各規則應放在適當位置，並將 FINAL 作為最後的預設規則。

PROXY、DIRECT、REJECT 的差異

PROXY 表示透過代理處理，DIRECT 表示直接連線，REJECT 表示拒絕要求。這些大寫關鍵字屬於設定語法，與 Global Routing 中的 Proxy、Direct 介面選項並非同一層級：前者是單條規則的處理結果，後者是全域運作模式。使用自訂策略名稱時，也要確認該名稱確實存在於設定檔中。

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,ads,REJECT
GEOIP,CN,DIRECT
FINAL,PROXY

以上僅示範語法，並非適用於所有網路的完整設定。第一條規則只比對 example.com，第二條涵蓋 example.org 及其子網域；關鍵字規則的範圍較廣，複製前請先了解它會影響哪些要求。請勿為了增加規則數量而重複新增相同內容，也不要將 FINAL 放在仍需生效的規則之前。

修改前請備份原設定檔，每次只調整少量規則，並以目標網域檢查實際套用的策略。若要逐項了解 General、Rule、Host 和 URL Rewrite 的結構，請繼續閱讀規則與設定完整參考 →

04 · 自動連線條件

On Demand 按需連線

On Demand 依設定條件要求系統建立連線，不會取代分流規則。在 Settings 中開啟 On Demand，查看 App 提供的條件與開關。實際可選條件以目前 App 介面為準；請先確認手動連線正常，再啟用按需連線，才能區分問題出在連線本身或觸發條件。

設定與驗證方式

1. 在 Home 選取伺服器與 Global Routing 模式，手動連線後開啟要測試的目標。
2. 進入 On Demand，閱讀目前條件的作用，再啟用所需選項。若條件涉及網路名稱，請確認名稱與裝置目前連線的網路一致。
3. 切換至目標網路或重新符合觸發條件，觀察系統連線狀態，同時確認實際要求是否成功。
4. 若結果不如預期，先暫時關閉 On Demand，再回到手動連線進行驗證；不要同時修改規則與伺服器參數。

On Demand 可與 Config 一起使用：前者控制何時建立連線，後者控制連線建立後要求採用的策略。看到系統連線圖示，不代表所有要求都會經過代理，因為 Config 中仍可能有 DIRECT 或 REJECT 規則。

若手動中斷後連線又重新出現，請檢查是否仍有 On Demand 條件生效，而非反覆刪除設定檔。首次建立連線時，系統會要求授權 VPN 設定，這屬於系統流程；允許後仍須驗證 App 內的設定。裝置網路變化、系統排程與條件比對都會影響觀察結果，不應將按需連線視為逐一控制各 App 要求的開關。

06 · 常用選項

Settings 設定說明

Settings 集中管理測試方式、輔助入口、同步與診斷等選項。部分網路行為也由目前設定檔的 General 區段控制。遇到問題時，先確認設定位於何處，再修改相應項目；不要只因設定名稱相近，就認定它們會影響同一條要求路徑。以下項目是否顯示及實際入口，請以目前 App 介面為準。

DNS：先確認解析路徑

DNS 會將網域名稱轉換為連線所需的位址。相關選項須搭配 Settings 中的 DNS 設定及目前 Config 的 General 內容檢查，重點是使用哪個解析器、要求經由哪條路徑，以及設定檔是否另有指定。先記下原值，再依現有網路與設定檔需求調整；儲存並重新連線後，以同一網域比較結果。

不要只因 Connectivity Test 顯示數值，就認定 DNS 正常：部分測試只確認伺服器端點是否可連線，與網頁網域解析並非同一流程。若只有網域存取失敗，先排查解析；若網域解析成功但仍無法連線，再檢查目標策略、伺服器連線及 TLS 等環節。隨意疊加多個不熟悉的 DNS 選項，會增加排查難度。

Test Method：確認測試對象

Test Method 用來選擇 Connectivity Test 的測試方式。在 Settings 找到該項目，依介面提供的方式與說明選擇，再回到 Home 測試既有伺服器。比較不同記錄時，應盡量使用相同的測試方式、目標與網路環境，否則數值便不具可比性。

測試結果反映當時條件下的可連線狀態或回應情況，不等於頻寬，也不保證所有網站都能存取。若測試有數值但網頁無法開啟，請繼續檢查網頁使用的網域、規則與 DNS；若測試失敗，也要先分辨是測試目標無法連線，還是實際代理連線失敗，避免直接刪除可能仍可用的記錄。

Today Widget：輔助操作入口

Today Widget 提供系統支援的元件入口相關設定，可在 Settings 中確認選項。能否加入元件、可顯示哪些操作，以及元件入口的位置，取決於目前系統與 App 的支援情況；請依裝置上的實際元件列表操作。先確認 App 內連線正常，再嘗試使用元件操作。

元件只是輔助入口，不會取代伺服器參數、Global Routing 或系統 VPN 授權。若元件顯示與實際存取結果不同，請回到 Home 確認目前連線與模式，不要只憑元件外觀判斷流量去向。

iCloud：分別確認同步與本機儲存

iCloud 相關功能可在 App 支援範圍內儲存或同步資料。在 Settings 查看 iCloud 選項，並確認裝置已登入自己的 Apple 帳號，且系統允許 App 使用 iCloud。啟用前請先備份重要設定檔，操作後再確認 App 實際顯示的同步項目與結果。

不要假設啟用後，所有伺服器、驗證資料、設定檔、統計與暫存狀態都會完整同步。跨裝置使用時請逐項核對內容，尤其是目前啟用的設定檔與伺服器選擇。App 購買記錄、iCloud 同步資料與自己的服務提供者帳號是不同事項；同步完成也不能取代重新驗證連線。

Diagnostics：先蒐集線索再修改

Diagnostics 用於查看或蒐集與執行問題相關的診斷資訊。進入 Settings 中相應的項目，依介面提示執行檢查；先記下問題發生時的網路環境、Global Routing 模式、目標與操作步驟，再查看診斷輸出，才能較容易將記錄與實際故障對應。

不要直接將單一警告視為全部原因。診斷內容應與 Connectivity Test、DNS 和規則結果交叉檢查。對外提供資訊前，請移除訂閱網址、伺服器驗證資料、個人網域及其他敏感內容；修改設定前先記下原值，以便確認修改是否有效。