官方手冊 · 功能與設定
先確認 Global Routing，再檢查 Config 與伺服器。連線開關、請求採用的策略，以及最終能否存取，是三個需要分別驗證的環節。
以下以 iPhone / iPad 常見介面作為操作參考；不同平台的入口位置與可用設定可能不同，請以目前應用程式顯示為準。Shadowrocket 提供 iPhone / iPad、Mac（Apple 晶片與 Intel）、Windows、Android 和 Linux 版本，取得方式請見全平台下載。
模式選擇
設定、代理、直連分別對應介面中的 Config、Proxy、Direct。模式決定請求如何選擇路徑，與連線開關並不相同。
這是什麼：Global Routing 是選擇整體路由方式的入口。在 Home 找到 Global Routing，進入後查看目前勾選的選項。初次設定時，應先匯入現有伺服器並確認可用，再決定日常使用哪種模式；不要為了嘗試不同選項，同時更換伺服器、DNS 和設定檔。
| 介面選項 | 請求處理方式 | 適用情境 | 檢查重點 |
|---|---|---|---|
| Config（設定） | 依照目前啟用設定中的規則選擇策略。 | 日常依網域、位址或其他條件分流。 | 確認設定已啟用，規則順序與策略參照正確。 |
| Proxy（代理） | 整體採用代理路徑，實際處理仍受應用程式及平台功能限制。 | 短時間進行對照測試，判斷問題是否與規則選擇有關。 | 確認所選伺服器能否連線，以及目標服務能否存取。 |
| Direct（直連） | 整體採用直接連線路徑。 | 檢查本機網路，或暫時進行直連對照測試。 | 確認本機網路與目標服務本身是否正常。 |
已有確認可用的規則設定時，通常從 Config 開始。如果某個目標在 Config 下無法使用，但同一台伺服器在 Proxy 下可以存取，應回頭檢查規則與策略，不必立刻重新匯入訂閱。如果 Direct 也無法存取原本應直連的目標，請先檢查 Wi-Fi、行動網路或目標服務狀態。每次只變更一個條件，記錄對照結果，測試結束後還原原先預定使用的模式。
注意事項：選擇 Direct 不代表關閉連線，選擇 Proxy 也不保證目標服務一定可用。系統仍可能顯示連線狀態；判斷請求的傳輸路徑，應參考請求記錄，而非只看系統狀態圖示。排查時也要區分新請求與已建立的連線；切換後請重新存取目標，再觀察結果。
比對條件與執行策略
規則類型說明「比對什麼」，策略說明「比對後如何處理」，兩者不能互相取代。
在 Config 查看目前設定中的 Rule 內容。DOMAIN 用於精確比對網域，DOMAIN-SUFFIX 用於比對網域後綴，DOMAIN-KEYWORD 用於比對網域關鍵字。IP-CIDR 與 IP-CIDR6 描述位址範圍，GEOIP 依位址對應的地區資料比對；結果會受資料與解析情況影響，不能視為網站所屬地區的保證。
USER-AGENT 能否比對，取決於請求中是否有可供檢查的相應資訊。不要假設所有連線都會提供這項資訊。新增規則前，先確認目標請求實際使用的網域或位址，避免把頁面顯示名稱誤認為請求網域。
DIRECT 表示直接連線，REJECT 表示拒絕，PROXY 表示交由相應代理策略處理。設定也可能參照自訂策略名稱，因此規則中的名稱必須對應設定中定義的策略。只在規則末尾填入名稱，不會自動建立可用的伺服器或策略。
處理比對錯誤時，應先確認命中哪條規則，再決定要修改比對值還是策略。如果目標命中 REJECT，換伺服器通常不會改變結果；如果規則參照的策略無法使用，則應檢查該策略的成員與選取狀態。
以下僅為規則語法範例，並非完整設定，也不含伺服器資訊。example.com 用於說明後綴比對；實際設定應使用你要處理的目標。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY規則通常依序檢查，最先命中的規則會決定請求採用的策略。範圍較小的具體規則應排在涵蓋範圍較大的規則之前；FINAL 用於前面沒有規則命中時的最後處理方式。編輯前請保留目前可用設定的副本，在 Config 確認新設定已啟用，再將 Global Routing 設為 Config，重新存取目標，並在請求記錄中核對命中的規則與策略。
注意事項：遠端設定更新可能會覆寫本機修改。需要長期保留的自訂內容，應依照目前應用程式提供的設定管理方式另外維護。成功儲存只代表內容已寫入，不代表規則已被選取，也不代表目標請求一定會套用該規則。
連線資訊管理
Subscribe 管理一組伺服器的更新來源，Add Server 管理個別連線資訊；Config 則負責規則與相關設定。
這是什麼、在哪裡：在 Home 查看現有伺服器及其群組，透過新增入口進入 Add Server。已有訂閱連結時，使用應用程式支援的 Subscribe 入口；已有單台伺服器資訊時，依照相應協定填寫。也可透過 Scan QR Code 匯入 QR code，但掃描前仍須確認內容來自你的服務供應商。
如何設定：訂閱連結請向你的服務供應商取得，完整保留連結中的路徑、查詢參數與大小寫，貼上前後都要檢查是否混入空格或換行。手動新增時，先選擇協定，再逐項填寫伺服器位址、連接埠，以及該協定要求的驗證、傳輸和 TLS 參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定的欄位各不相同，不應直接套用其他協定的填寫方式。
匯入完成後，先確認 Home 出現伺服器項目，再選取其中一項執行 Connectivity Test，並實際嘗試存取。成功匯入訂閱代表已取得伺服器清單，不代表其中每台伺服器都能使用；Connectivity Test 有結果也不代表所有網站都能存取，兩種情況須分別驗證。
訂閱內容變更時，請更新相應訂閱，再檢查伺服器數量、群組與目前選取項目是否改變。更新失敗時，先確認本機網路能否存取訂閱網址，再檢查連結是否失效，以及回傳內容是否為應用程式可識別的格式。錯誤頁面、登入頁面或一般網頁都不能作為伺服器訂閱匯入。
注意事項：大量清理前，先區分由訂閱產生的項目與手動新增的項目。更新訂閱可能會重建其管理的內容，不宜依賴對自動產生項目的臨時修改。訂閱網址通常含有存取憑證；截圖、記錄與求助資訊中應遮蔽完整連結及驗證欄位。不要將訂閱網址貼到公開留言或不必要的檢測工具中。
查看訂閱匯入與首次連線教學 →連線觸發條件
On Demand 決定何時建立連線；Global Routing 與規則則決定連線建立後如何分流。
這是什麼、在哪裡：On Demand 可依照設定的條件觸發連線。在 Settings 找到 On Demand 或相應的按需連線設定入口，查看目前條件與開關狀態。可設定的條件請以目前平台實際顯示為準，不要假設其他裝置上的設定項目在本機也一定存在。
如何設定：先關閉自動觸發，避免干擾；手動連線並確認伺服器、DNS 與規則都能正常運作後，再設定按需條件。如果目前介面提供 Wi-Fi、行動網路或指定網路等條件，請逐一確認哪些情況會觸發連線、哪些情況不會。儲存後，在可控環境中切換一次網路，觀察連線是否符合預期，再測試目標請求採用的策略。
注意事項：On Demand 不是修復伺服器故障的工具。手動連線已經失敗時，開啟此功能只會再次遇到相同問題。如果關閉連線後又自動連線，請先檢查按需條件及系統中的相關連線設定，不要立即刪除設定。暫時排查時，記錄原有條件並暫停自動觸發；排查結束後再恢復，避免將預期中的自動連線誤判為異常。
用量檢視
統計資料用於查看用戶端記錄的傳輸情況，不能取代服務供應商的用量紀錄或電信業者帳單。
這是什麼、在哪裡：開啟 Data 查看應用程式提供的流量統計，先閱讀目前頁面標示的統計範圍與時間範圍，再比較上傳、下載或不同類別的資料。如果某個平台將相關內容放在其他入口，請以實際介面名稱與說明為準。
如何使用：要排查某項操作是否產生流量，先記錄目前數值，只進行一次明確操作，再回到 Data 查看變化。長期觀察前，應確認計數是否跨連線保留、是否提供重設選項，以及重設會影響哪些記錄。不同範圍的數據不要直接相減，並據此認定是某個應用程式的精確用量。
注意事項：協定開銷、重傳、統計方式與計費週期都可能造成差異。Data 數值增加只能表示應用程式記錄到傳輸，不能單獨證明某個網頁請求經由指定伺服器傳送。要確認分流情況，仍應查看請求與策略；若懷疑背景用量異常，再搭配系統的應用程式網路用量與電池記錄進行比對。
常用設定逐項說明
先保留能正常連線的基準設定。以下各項應分別調整，調整後以相同目標進行驗證。
這是什麼、在哪裡：DNS 負責將網域解析為位址；相關設定可能位於 Settings，或目前 Config 的設定內容中。先確認正在使用哪份設定，以及其中是否已定義 DNS，避免只修改全域入口，卻忽略設定檔中的相關選項。
如何設定、注意事項：先使用目前可正常運作的解析方式，只有在有明確需求時才切換至自訂 DNS 或 DNS over HTTPS。填寫後，使用相同網域重新發送請求，對照解析結果、存取結果與記錄。DNS over HTTPS 端點本身也必須能連線，無法自動修正錯誤的規則、驗證資訊或無法使用的伺服器。詳細說明請見DNS 設定說明。
這是什麼、在哪裡：Settings 中的 Test Method 可用來選擇連線測試方式。不同方式檢查的環節不同；解讀測試結果時，應一併考量所選的方法，不要只比較單一數值。
如何設定、注意事項：比較伺服器前，請保持測試方法、測試目標與本機網路一致，再執行 Connectivity Test。連接埠可連線不等於完整代理請求成功，測試目標可存取也不代表其他目標同樣可用。如果測試結果與實際使用情況不一致，先核對測試方法與目標，再查看實際請求記錄；不應因此頻繁更換所有設定。
這是什麼、在哪裡：Today Widget 是相關平台提供的快速檢視或操作入口。在 Settings 尋找相應設定，並在系統提供的小工具管理介面確認是否能新增；不同系統版本的顯示方式可能不同。
如何設定、注意事項：先在應用程式內選擇伺服器並確認連線正常，再設定小工具實際提供的項目。新增後測試一次快速操作，並返回應用程式核對目前狀態。小工具畫面可能有更新間隔，不應將文字未及時更新視為連線失敗的唯一依據；找不到小工具時，先確認目前系統與應用程式是否提供此入口。
這是什麼、在哪裡：iCloud 相關設定用於應用程式支援的資料同步或備份功能。在 Settings 查看具體說明，同時檢查系統的 iCloud 權限、帳戶與可用儲存空間。同步範圍以應用程式明確列出的項目為準，不要假設所有資料都會移轉。
如何設定、注意事項：首次啟用前，請保留本機可用的設定；先在一台裝置完成上傳或同步，再到另一台裝置確認內容。發生衝突時，先辨認要保留哪一份內容，避免連續覆寫。同步不等於持續有效的獨立備份，刪除動作也可能同步到其他裝置；伺服器憑證與訂閱連結應視為敏感資料妥善管理。
這是什麼、在哪裡：Diagnostics 提供協助定位連線與請求問題的資訊。進入 Settings 中的相應入口，先查看工具實際檢查的對象與目前輸出，不要將單一診斷結果延伸解讀為整個網路的狀況。
如何使用：記錄發生問題的目標、目前的 Global Routing、所選伺服器與網路類型，再重現一次。確認問題是網域解析失敗、連線逾時、驗證失敗，還是策略選擇不如預期，接著只調整相應環節。相同故障在不同網路發生時，也應分別記錄，不要混在同一次診斷中。
注意事項：匯出或分享前，請檢查記錄是否含有伺服器位址、訂閱連結、驗證欄位及個人存取紀錄，並只提供必要範圍的資訊。需要進一步定位時，可依症狀前往故障排除手冊；不必為了尋求協助而公開完整設定。
設定後檢查
分別確認「伺服器可用」、「模式正確」與「規則命中」，可減少反覆修改。
如果修改後出現異常，先還原上一步可用的設定，再一次只變更一個條件重新驗證。需要從匯入開始操作時，請閱讀首次使用教學；已能連線但個別目標仍無法使用時，優先閱讀依症狀整理的故障排除手冊。用戶端下載與安裝問題請至全平台下載頁處理，不必透過修改規則解決。