官方手冊 · 功能與設定

Shadowrocket 功能介紹
與常用設定

先確認 Global Routing，再檢查 Config 與目前選取的伺服器；確認連線正常後，再設定 On Demand、DNS 與同步。每次只調整一個項目，方便確認設定對實際連線的影響。

依步驟查看使用說明 App Store 正版取得說明
  • Home
  • Config
  • Data
  • Settings

GLOBAL ROUTING

三種路由模式的使用時機

Global Routing 決定進入 Shadowrocket 的連線如何處理。在 Home 開啟 Global Routing，選擇 Config、Proxy 或 Direct。中文說明分別稱為配置、代理、直連；這三個選項會改變路由方式，不會建立伺服器，也不會自動補齊連線參數。設定完成後返回 Home，確認目前選取的伺服器與連線開關。

模式 處理方式 適用時機 確認重點
Config（配置） 依據目前啟用的配置規則選擇策略。 需要依網域、位址範圍等條件分流時。 已啟用的配置檔、規則順序、策略引用。
Proxy（代理） 以代理路由處理流量，仍受系統與應用程式適用範圍限制。 暫時檢查目前伺服器能否處理目標連線時。 伺服器可用性、協定參數、目標連線結果。
Direct（直連） 以直連路由處理流量，不能藉此驗證代理伺服器。 暫時檢查本機網路與目標是否可連線時。 本機網路、網域解析、目標服務狀態。

日常需要規則分流時使用 Config。若某個目標在 Config 下連線失敗、在 Proxy 下可以存取，應優先檢查規則命中了哪個策略，而不是立刻更換協定。若 Direct 也無法存取，則應繼續確認本機網路與目標狀態；單次存取失敗本身不足以證明問題出在用戶端。

Proxy 與 Direct 適合用來對照測試，但測試結束後別忘了恢復原本的模式。切換模式後，既有長連線不一定會立即重新建立；驗證時請重新送出要求，必要時儲存設定後重新連線。Global Routing 也不代表能完全涵蓋系統的所有通訊，系統服務與應用程式本身的連線行為仍可能影響觀察結果。

RULE MATCHING

規則類型、策略與比對順序

規則用來描述「哪些連線交由哪個策略處理」。在 Config 中檢查目前啟用的配置檔與規則內容，並讓 Global Routing 使用 Config。規則類型說明比對條件，策略則說明比對後的處理方式，兩者不可混為一談。通常先放適用範圍明確的規則，再放範圍較廣的規則，最後檢查預設規則。

DOMAIN

DOMAIN-SUFFIX

依網域後綴比對。例如 example.com 可涵蓋該網域及其子網域。DOMAIN 用於比對精確網域，DOMAIN-KEYWORD 則依關鍵字比對；關鍵字範圍太廣，容易涵蓋原本不想處理的目標。

ADDRESS

GEOIP

依據 IP 歸屬資料庫比對，而非依頁面使用的文字或內容判斷。資料庫紀錄、解析結果與實際服務部署位置可能不同，不能只憑網站名稱推斷會符合哪個 GEOIP 條件。

NETWORK

IP-CIDR / IP-CIDR6

分別比對 IPv4 與 IPv6 位址範圍。設定前確認位址類別與前綴長度；同一網域可能回傳不同位址，只有 IPv4 規則時，不應據此推斷 IPv6 連線也會以相同方式處理。

FALLBACK

FINAL

作為前述條件都未比對成功時的預設規則。此規則不含網域或位址範圍的比對值。檢查 FINAL 的策略，有助於了解為何沒有專屬規則的目標最後仍經由代理或直連。

PROXY、DIRECT 與 REJECT

PROXY 表示透過代理處理，DIRECT 表示直連處理，REJECT 表示拒絕相應連線。若配置使用自訂策略或策略群組名稱，還需確認引用的名稱存在且拼字一致。以下是語法說明片段，並非完整配置檔；範例網域僅用於說明規則結構。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

REJECT 的作用對象是連線，而非頁面中的某個部分。若頁面正文與其他資源共用網域，拒絕該網域可能連帶影響正常功能。USER-AGENT 等條件也取決於用戶端能否取得相應資訊，並非適用於所有加密連線。修改規則後，應根據實際連線紀錄確認目標、命中規則與最終策略，不要只看頁面是否有變化來判斷。

若要了解協定欄位與選擇依據，可繼續閱讀協定技術參考。規則命中錯誤與協定參數錯誤屬於不同層次，排查時先確認流量流向，再檢查該處能否建立連線。

SERVER MANAGEMENT

既有訂閱與伺服器管理

伺服器項目會儲存單一連線所需的位址、連接埠、協定與驗證參數；訂閱則用於取得及更新一組項目。這些資訊主要在 Home 管理。若已有訂閱，可透過 Add Server 進入新增流程，選擇 Subscribe 並填入完整連結；若已有單一伺服器資訊，請選擇實際協定類型，再依資料逐項輸入。若已有 QR Code，可使用 Scan QR Code 匯入，匯入後仍須檢查內容。

匯入後先確認，再連線

儲存後檢查項目名稱、協定類型、伺服器位址與連接埠，確認選取的確實是準備使用的伺服器。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的參數結構各不相同，不能只修改 Type 就將一種協定轉換成另一種。TLS 名稱、傳輸設定等附加欄位也應與既有資料一致，不應為了讓測試通過而任意關閉驗證。

更新訂閱會重新取得遠端清單，但不保證原有項目的名稱和數量不變。更新前先確認訂閱群組，更新後再次確認目前選取的項目。若曾手動編輯由訂閱產生的項目，也要留意後續更新是否會覆蓋修改；需要長期保留的獨立設定，應先確認應用程式內的儲存與管理方式。

分別處理清單空白與連線失敗

清單空白時，先檢查連結是否完整複製、是否包含空格，以及回傳內容是否符合支援的訂閱格式，再確認既有訂閱是否有效。若清單有項目但連線失敗，再檢查位址、連接埠、驗證資訊與網路連線狀況。Config 中的路由配置與 Home 中的伺服器清單用途不同，匯入訂閱不代表已啟用合適的分流配置。

訂閱連結可能包含存取憑證。回報問題時只需描述錯誤類型，截圖和記錄應遮蔽連結參數、驗證欄位與個人位址；不要將完整連結貼到公開討論區。詳細匯入步驟請參閱使用說明。

ON DEMAND

按需連線條件與驗證

On Demand 可依據已設定的條件，觸發系統建立 VPN 連線。它處理的是「何時連線」，而非「連線後如何分流」；後者仍由 Global Routing 與目前配置決定。它也不同於訂閱自動更新，不會透過自動連線補上失效的伺服器資訊。

在 Settings 中尋找 On Demand，確認目前版本顯示的條件項目，再依實際使用的網路環境設定。首次設定前，應先在 Home 手動連線並確認伺服器可用，之後再啟用自動觸發。若包含 Wi-Fi 相關條件，請逐項確認網路名稱與對應動作，避免將原本要排除的環境設為連線條件。

設定後，分別在符合與不符合條件的環境下測試，並觀察系統 VPN 狀態及應用程式中的連線狀態。手動中斷後又重新連線，不一定代表開關失效，也可能是 On Demand 條件再次成立。暫時排查時，先記錄原有條件，再暫停 On Demand，完成手動測試後恢復設定。

DATA

流量統計與連線結果的差異

Data 用於查看用戶端記錄的流量資訊。進入 Data 後，先確認頁面顯示的統計範圍與計數意義，再比較上傳、下載等項目。流量計數表示用戶端觀察到資料傳輸，不代表目標頁面一定正常，也不能單憑計數證明所有要求都使用預期的策略。

若要觀察某項操作，先記下目前計數，再進行一次明確的存取，接著返回比較變化。若目前介面提供清除計數的操作，請確認不需要保留歷史資料後再使用，並留意清除只會影響相應統計，不會清除服務端的用量紀錄。背景應用程式與系統活動也可能同時產生流量，測試時請盡量減少其他資料傳輸。

Data 不是查詢訂閱剩餘額度的通用入口。用戶端統計與既有服務的計費紀錄可能因統計週期、協定額外負荷及重設時間而不同。檢查「用量為何不一致」時，先對齊時間範圍與統計方式；檢查「為何無法存取」時，則轉而查看連線紀錄、DNS 與伺服器狀態，不要將流量數字當成可用性的判斷依據。

SETTINGS & DIAGNOSTICS

常用設定的檢查順序

Settings 集中提供連線、測試及輔助功能相關設定，部分選項也可能由目前 Config 的內容控制。操作時以應用程式目前顯示的項目為準，先記錄原始值，再修改一項並驗證。不要一次疊加多份配置中的 DNS、測試與自動連線選項，否則很難判斷是哪一項造成變化。

DNS：先確認由哪一層控制

DNS 會將網域解析為位址，解析結果會影響後續連線與部分規則比對。先在 Settings 檢查 DNS 相關選項，再查看目前 Config 是否包含 DNS 設定；不要只修改一處就認定設定已生效。使用既有配置時，應先了解其中的解析要求如何路由及回退。

若網域無法存取但位址可以連線，可將解析列為檢查方向，但這只是線索。憑證名稱、伺服器端要求與快取也可能造成差異。變更 DNS 後重新送出要求，必要時重新連線，並搭配診斷結果確認；不要只因某個解析位址看起來熟悉，就判定設定正確。

Test Method 與 Connectivity Test

Test Method 用於選擇連線測試的方法，Connectivity Test 則用於執行相應測試。先在 Settings 確認 Test Method，再回到伺服器清單測試需要檢查的項目。不同方法測量的對象不同，結果不能直接視為下載速度，也不宜將不同方法測得的數值混在一起排名。

測試成功只能表示在相應測試條件下完成了互動，不能保證所有目標都可存取。測試失敗時也應一併考量測試方法、目標與目前網路；某些測試行為可能受網路條件限制。比較項目時，請維持測試方法與網路環境一致，最後仍以實際使用結果為準。

Today Widget：輔助入口與狀態確認

Today Widget 是與系統小工具相關的輔助功能。在 Settings 查看對應選項，並在裝置系統允許的位置新增或管理小工具。可用位置、顯示形式與操作能力會受系統環境及應用程式目前的實作方式影響，請以裝置實際顯示為準。

小工具狀態不宜取代 Home 中的完整檢查。若透過小工具操作後發現狀態不一致，請返回應用程式確認連線開關、Global Routing 與伺服器選取狀態。首次使用仍應在應用程式內完成設定及必要的系統授權。

iCloud：區分同步與購買記錄

iCloud 相關功能用於同步應用程式支援範圍內的資料。在 Settings 確認同步選項，並檢查裝置系統中的 iCloud 是否可用。要在另一部裝置上查看資料前，請確認兩部裝置使用的帳戶、同步權限與網路條件皆符合要求；不要假設任意修改都會立即顯示在另一部裝置上。

同步範圍以應用程式目前的說明為準，不能預設會包含所有伺服器憑證、統計紀錄及系統 VPN 授權。調整重要配置前，先保留可供還原的副本。App Store 購買記錄與 iCloud 資料同步屬於不同機制；還原購買不等於還原配置，匯入配置也不等於完成購買。

Diagnostics：修改前保留線索

Diagnostics 用於收集及查看排查連線問題所需的資訊。在 Settings 尋找相應入口，先重現一次問題，再檢查或匯出目前可用的診斷內容。記錄問題發生時的網路類型、Global Routing、目標網域、目前配置與錯誤狀況，有助於區分解析、建立連線與規則處理階段。

回報前檢查記錄是否包含訂閱網址、驗證資訊、個人網域或其他敏感內容，並視需要遮蔽。診斷記錄是特定時段的觀察結果，並非所有過往行為的完整證明。若變更設定後問題消失，也應記錄調整項目，而非繼續大量重設其他選項。

本文主要說明 iPhone 與 iPad 上的功能。Mac、Apple TV 與 Apple Vision 的相容性、系統需求及購買適用條件，請以 App Store 頁面標示為準；不同裝置的介面配置可能不同，不應將本文所述操作位置視為所有裝置的固定版面。