官方手冊 · 功能介紹

Shadowrocket 功能與常用設定

先確認流量如何處理，再決定何時連線。Global Routing 控制整體路由方式，Config 中的規則決定請求的去向，On Demand 則決定系統在什麼條件下自動發起連線；這三者並非同一個開關。

Home 選擇伺服器與路由
Config 管理規則設定檔
Settings 檢查一般設定
Data 查看流量紀錄

本頁主要說明 iPhone、iPad 上的操作，依「功能是什麼、在哪個介面、如何設定、有哪些注意事項」逐項介紹。介面語言和 App 更新可能會影響選項位置；找不到某個項目時，請先確認目前所在頁面並查看 App 內說明，不必同時修改多個開關。

Global Routing：設定檔、代理與直連

Global Routing 位於 Home，可選擇目前連線的整體路由方式。設定檔、代理、直連分別對應介面中的 Config、Proxy、Direct。日常需要依規則區分請求時，使用 Config；若要確認某個請求能否透過所選伺服器完成，可暫時切換至 Proxy；若要判斷問題是否與代理路徑有關，可暫時使用 Direct 作為對照。

模式	主要處理方式	適用情境	優先確認項目
Config（設定檔）	依照目前啟用設定檔中的規則與策略處理請求。	日常規則分流，區分區域網路與其他請求。	目前的設定檔、規則順序與策略指向。
Proxy（代理）	以代理方式處理流量，不依 Config 的一般規則逐項分流。	短暫確認所選伺服器的連線路徑。	所選伺服器是否有效、協定參數是否正確。
Direct（直連）	以直接連線方式處理流量。	與目前網路的直接存取結果比較。	目前網路本身是否能存取目標。

設定方式：先選模式，再測試新請求

開啟 Home，進入 Global Routing，選擇所需模式後返回。使用 Config 時，還要到 Config 確認目前啟用的是預期的設定檔；使用 Proxy 時，則要確認 Home 中選取的是預期的伺服器。返回目標 App 重新發出請求，再觀察結果，避免把既有連線或快取頁面當成新的測試。

Direct 不代表關閉系統 VPN 連線；它描述的是請求處理方式，而非連線開關狀態。同樣地，Proxy 也無法修正錯誤的伺服器參數。比較模式時，請維持網路、目標網址與所選伺服器不變，每次只修改一個條件。測試結束後，請恢復原本的路由方式，避免暫時性的排查設定影響後續使用。

Config：規則類型、順序與策略

Config 用來管理設定檔，規則分流是其中的重要部分。規則用來判斷「哪些請求屬於這一類」，策略則決定「符合後如何處理」。在 Global Routing 選擇 Config 後，開啟目前的設定檔，檢查規則內容及其引用的策略。只匯入檔案但未啟用，不代表連線已使用該檔案。

常見規則類型說明

DOMAIN 用於精確比對網域；DOMAIN-SUFFIX 用於比對網域後綴及其子網域；DOMAIN-KEYWORD 則依網域中的關鍵字判斷。需要比對 IP 位址範圍時，可使用 IP-CIDR 或 IP-CIDR6；GEOIP 則依 IP 地理資料庫分類。USER-AGENT 用於比對請求中可讀取的 User-Agent 資訊，不應視為適用於所有加密請求的通用識別方式。

PROXY、DIRECT、REJECT 是常見的處理策略，分別用於代理、直連與拒絕。設定檔也可能引用自訂策略群組；遇到自訂名稱時，還要確認實際選用的成員，不能只憑名稱推斷最終連線路徑。

[Rule]
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXY

以上片段僅示範規則語法與順序，並非完整設定檔。example.com 是示範網域；關鍵字規則也可能比對到非預期的網域，請依實際需求縮小範圍。no-resolve 表示該 IP 規則不額外觸發網域解析，不等於全域關閉 DNS。

修改方式：具體規則在前，最後處理規則在後

規則通常由上而下比對，符合後即依對應策略處理，因此較具體的例外規則應放在範圍較廣的規則之前。FINAL 用於前面的規則都未符合時，作為最後處理方式。修改前請保留原設定檔；修改後重新發出請求，並透過可用的請求紀錄確認符合的規則與處理策略。

遠端維護的設定檔可能在更新時取代本機內容。若要長期保留個人修改，請先確認設定檔的更新方式及其與本機副本的關係。不要一次加入大量來源不明的規則；發生異常時，最有用的資訊是「哪個請求符合哪條規則」，而非規則總數。

Home：訂閱與伺服器管理

伺服器項目會儲存單一連線所需的協定、位址、連接埠與驗證參數；Subscribe 則依據使用者已有的訂閱資料更新一組項目。伺服器資訊與 Config 的用途不同：前者說明要連線到哪裡，後者則決定如何分配請求。匯入訂閱後，仍須確認所選伺服器與 Global Routing。

Add Server：逐項確認既有伺服器資訊

從 Home 進入 Add Server，依照既有資料選擇協定，再填入相應欄位。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定的欄位不能互相套用。除了位址和連接埠，也可能需要確認驗證資訊、傳輸方式、TLS、Server Name 等；請以既有伺服器資料及 App 目前顯示的欄位為準。

掃描匯入時使用 Scan QR Code，並在儲存前檢查解析結果。QR Code 只是資訊載體，不代表其中的參數一定正確。手動輸入時，請留意前後空白、連接埠數字及驗證資訊是否完整；顯示名稱方便辨識，但更改名稱無法修正連線參數。

Subscribe：更新後檢查項目與選取狀態

新增自己已有的訂閱時，選擇 Subscribe 並填入既有訂閱網址，儲存後執行更新。訂閱更新成功，只代表網址可讀取並產生可辨識的項目，不代表每台伺服器都能連線。先確認項目是否出現，再選取一台伺服器執行 Connectivity Test，最後驗證實際請求。

訂閱更新失敗時，先確認連結是否完整、是否仍有效，以及目前網路能否讀取該網址；不要反覆刪除所有項目。更新後，項目名稱或數量可能改變，原本的選取項目也可能需要重新確認。訂閱網址與 QR Code 可能包含驗證資料，回報問題時請遮蔽敏感內容。

On Demand：依條件自動連線

On Demand 透過系統的按需連線機制，在符合條件時發起連線。它決定連線的觸發時機，不會取代 Global Routing 的分流設定。App 可能提供與 Wi-Fi、行動網路或網域相關的條件；實際可選項目請以目前的 On Demand 介面為準。

設定方式：從一個明確條件開始

進入 Settings 中與 On Demand 相關的設定，先閱讀現有條件，再依實際使用情境新增或修改。首次設定時，只保留一個容易驗證的條件，例如檢查在指定 Wi-Fi 環境中的連線行為。儲存後切換至該網路，等待系統處理，再觀察系統連線狀態與一筆實際請求。

若條件之間有順序或優先權關係，請依介面說明檢查。不要同時新增多個彼此矛盾的連線與中斷條件，也不要在修改條件時同時切換伺服器、DNS 和設定檔；否則即使現象改變，也無法判斷是哪個項目造成影響。

注意事項：手動中斷後再次連線的原因

如果手動中斷後又再次連線，請先檢查 On Demand 是否仍在符合條件時觸發，而不是立刻認定開關異常。若排查時需要穩定的手動連線環境，可先關閉 On Demand 並記下原有條件，測試完成後再恢復。啟用 On Demand 也不代表一定比較省電，實際耗電仍會受到觸發頻率、背景請求與網路切換影響。

若要了解 Wi-Fi、行動網路與網域條件的組合方式，請參閱On Demand 設定說明；若要觀察背景耗電，請依照背景耗電檢查順序，在相近的使用條件下比較結果。

Data：查看流量統計

Data 用來查看用戶端記錄的流量資訊，適合觀察一段使用期間內的上傳、下載或各項目的統計變化，但不等同於電信業者帳單，也不等同於既有服務的流量計量結果。統計範圍、重設時間與網路開銷不同，都可能造成不同位置顯示的數字不一致。

查看方式：固定時間區間比較增量

開啟 Data，先確認目前頁面顯示的統計範圍與可用分類。記下測試前的數值，返回目標 App 完成一次操作，再回來查看增量。若要清除紀錄，請先確認是否需要保留歷史資訊；清除統計不會恢復已使用的外部流量額度。

若要判斷某台伺服器是否實際承載流量，應一併確認所選伺服器、路由模式與規則比對結果，而非只看總計。直連請求、背景同步和其他 App 的請求都可能影響觀察結果。下載數值較大也不能單獨證明連線品質較佳；傳輸量、延遲和請求成功率是不同的衡量面向。

若 Data 的變化與預期不同，先確認目標請求是否重新發出，以及是否使用了快取。接著確認連線是否持續、網路是否曾切換。不要只根據重新整理一次頁面，就推斷所有請求的處理路徑。

Settings：DNS、測試方式與輔助功能

Settings 集中管理一般行為與輔助設定。檢查時，請先確認設定影響的是解析、測試、系統入口還是資料同步。有些選項也可能由目前的 Config 控制，因此修改一般設定前，請確認使用中的設定檔是否另有指定，避免誤以為「已修改但實際行為沒有改變」。

DNS：先確認設定來源，再調整解析設定

DNS 負責將網域解析為位址。網域解析失敗與伺服器連線失敗，可能呈現類似的載入狀況，但處理方式不同。請檢查 Settings 中與 DNS 相關的選項，並同時查看目前 Config 的 DNS 設定，確認實際使用的解析設定，而不只是記下某個頁面上的位址。

設定時請使用自己清楚了解用途的解析參數，保留原值，每次只修改一個變數。修改後重新建立測試條件，並發出新的網域請求；快取可能讓舊結果持續出現。區域網路裝置、內部網域與公用網域可能需要不同的處理方式，不宜將所有 DNS 請求都改走同一路徑，再逐一追查原因。

不要把調整 DNS 當成解決所有逾時問題的通用方法。如果是協定驗證失敗、連接埠無法連線或伺服器時間條件不符，單獨更換解析設定通常無法解決根本原因。請先區分「網域無法解析」與「已取得位址但連線失敗」。

Test Method：確保測試結果可比較

Test Method 決定 Connectivity Test 使用的測試方式。在 Settings 找到該項目，依目前介面提供的選項選擇，並確認相關測試目標。不同方式測量的環節不同：基本往返測試與需要完成更多網路步驟的測試，數值不能直接放在一起比較。

比較伺服器時，請使用相同的 Test Method、相同的測試目標，並維持相近的網路環境。測試逾時只表示該次測試未能在預期時間內完成，不一定代表所有服務請求都無法使用；反之，測試成功也不能證明每個目標網站都能正常存取。仍須進行實際存取驗證。

Today Widget：確認系統入口是否可用

Today Widget 用於系統小工具的快速操作或狀態顯示。先在 Settings 查看對應設定，再前往系統小工具編輯介面，確認可加入的 Shadowrocket 項目；支援情況與顯示方式會受到系統及 App 目前提供的功能影響，請以裝置上的實際介面為準。

若執行快速操作後狀態沒有立即改變，請返回 Home 並確認系統 VPN 狀態，不要連續重複點選。小工具只是操作入口，並非獨立的連線設定；所選伺服器、Global Routing 與 On Demand 仍會影響實際行為。

iCloud：先確認同步範圍，再於另一台裝置驗證

iCloud 相關設定可在支援範圍內同步 App 資料。請先檢查系統 iCloud 狀態及 Shadowrocket 中的同步選項，閱讀目前介面說明，確認哪些內容會參與同步。不要把「開啟 iCloud」理解成所有伺服器、規則和系統權限都已完整複製。

在另一台裝置上操作前，請先保留重要的本機設定，再確認同步結果、所選伺服器與目前的設定檔。系統 VPN 授權仍須在各裝置上分別確認。App Store 的已購項目還原與 iCloud 資料同步是兩回事：前者關聯購買資格，後者關聯 App 資料，不能依其中一項的狀態推斷另一項。

Diagnostics：收集有助於定位問題的資訊

Diagnostics 可協助檢視網路與連線問題。在 Settings 中尋找 Diagnostics 相關入口，依目前介面提供的項目執行檢查。有效的診斷應對應明確現象，例如「既有訂閱無法更新」或「指定網域請求逾時」，而不是一次執行所有檢查後，只比較哪個數字較小。

操作方式：先重現問題，再查看相關紀錄

先記下目前的網路、Global Routing、設定檔與伺服器；必要時暫時關閉 On Demand，以減少自動切換。接著只重現一次問題，再查看問題發生時間附近的診斷或請求紀錄。優先尋找可區分原因的線索，例如解析失敗、連線逾時、驗證錯誤及規則策略不符。

若要確認分流，請對照目標網域、符合的規則與最終策略；若要確認連線，則從 Connectivity Test 和伺服器參數著手。若沒有請求紀錄，也請檢查請求是否使用快取、是否確實經過目前的連線，以及紀錄功能是否可用。

設定檢查順序：每次只修改一個條件

各項功能之間有所關聯。先確認 App 與既有資料，再確認連線，最後檢查規則與自動行為，可減少反覆修改。以下順序適用於「已匯入，但存取結果不如預期」的情況。

確認既有資料。在 Home 檢查伺服器項目是否完整、訂閱是否更新成功，以及目前是否選取預期的項目。訂閱可讀取，不代表連線可用。
確認系統連線。檢查首次 VPN 設定授權是否已完成，並確認實際連線狀態。權限提示的說明請見VPN 設定授權說明。
確認測試條件。維持網路不變，選擇明確的 Test Method，執行 Connectivity Test，再驗證實際請求。逾時問題可參考連線失敗排查順序。
確認路由與規則。檢查 Global Routing；若使用 Config，接著確認目前的設定檔、規則順序與策略指向。暫時切換模式後，請記得恢復原設定。
最後檢查自動與輔助設定。基本連線穩定後，再逐項確認 On Demand、DNS、自訂測試方式與同步結果。保留修改前後的紀錄，方便還原。

Proxy 可以存取，但 Config 結果不如預期，該先檢查什麼？

先檢查目前啟用的 Config、目標請求符合的規則及其策略，再確認自訂策略群組的成員。不同模式造成結果改變，可作為縮小排查範圍的線索，但不足以直接判定 DNS 或伺服器有問題。

換到另一台裝置後，為什麼仍須檢查設定？

已購項目還原、資料同步與系統 VPN 授權分別處理不同事項。即使 App 已還原，也要檢查該裝置的授權、目前設定檔與伺服器選擇。iPhone、iPad 的相容性與系統需求，請以 App Store 頁面標示為準。

哪裡可以查看從匯入到首次連線的完整步驟？

請依序閱讀入門指南，完成既有資料匯入、Global Routing 選擇、系統授權與實際存取驗證。購買與已購項目還原問題，請參閱App Store 取得指南。