Shadowrocket 官方手冊 · 功能

Shadowrocket
功能與常用設定

先確認連線採用哪種路由方式，再檢查伺服器、規則與系統設定。每次只調整一類參數，方便觀察結果並還原設定。

Global Routing · 路由方式 Config · 匹配規則 Settings · 連線行為

Home / Global Routing

Global Routing：設定、代理與直連

功能說明：Global Routing 決定進入 Shadowrocket 的連線採用哪種處理方式。Config 是設定檔模式，依目前設定檔中的規則選擇策略；Proxy 是代理模式，主要將連線交由所選代理伺服器處理；Direct 是直連模式，連線不經代理伺服器送出。模式、伺服器與連線開關屬於不同層級：選取伺服器不代表已啟用連線，啟用連線也不代表所有請求都會經過代理。

介面位置：在 Home 找到 Global Routing，進入後確認 Config、Proxy、Direct 的選取狀態。先記下原本的模式與目前使用的伺服器，再進行測試；不要同時切換伺服器和更換設定檔，否則難以判斷是哪個步驟造成變化。

三種模式的用途與檢查重點
介面選項 處理方式 適用情況 注意事項
Config · 設定檔 依目前啟用設定檔中的規則匹配策略。 日常需要區分代理、直連或拒絕的連線。 確認設定檔已啟用，且規則引用的策略有效。
Proxy · 代理 主要透過目前選取的代理伺服器處理連線。 暫時檢查伺服器能否處理實際連線。 伺服器可連線，不代表所有目標都能存取。
Direct · 直連 直接送出連線，不經過代理伺服器。 確認本地網路是否正常，縮小問題範圍。 直連成功不代表代理參數正確。

設定方式：日常分流通常選擇 Config，並確認 Config 頁面已選取預期的設定檔。如果部分連線異常，可暫時切換至 Proxy，以同一個目標測試所選伺服器；再切換至 Direct，比較本地網路的結果。比較完成後，請恢復日常使用的模式。測試時應重新送出請求；既有連線可能仍沿用建立時的路徑。

注意事項：不要長期以 Proxy 取代修正規則。Proxy 正常而 Config 異常時，請檢查匹配結果、策略名稱與 DNS；兩者都異常時，再檢查伺服器參數、網路環境，以及服務商提供的狀態資訊。

Config / Rule

規則分流：匹配條件與執行策略

規則說明：每條規則都會描述「匹配條件」和「匹配後的處理方式」。DOMAIN 用來匹配指定網域，DOMAIN-SUFFIX 匹配網域後綴，DOMAIN-KEYWORD 匹配網域中的關鍵字；IP-CIDR 與 IP-CIDR6 依 IP 網段匹配，GEOIP 則依 IP 地理資料庫判斷。USER-AGENT 會依賴請求中可取得的相關資訊，不適合作為所有連線都能匹配的通用條件。

介面位置：在 Config 查看目前使用的設定檔及其規則。除了確認檔案中是否有某條規則，也要確認該檔案是否正在使用、Global Routing 是否設為 Config，以及目標請求是否包含規則所需的資訊。

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

以上為語法範例，並非可直接取代現有設定檔的完整檔案。PROXY、DIRECT、REJECT 分別表示代理、直連與拒絕；自訂策略名稱必須與設定檔中的定義一致。FINAL 用來處理未符合前面條件的連線，不應誤認為網域規則。

設定方式：先備份目前的設定檔，再透過規則編輯入口加入明確條件。規則通常依序匹配，請將較具體的例外放在範圍較廣的規則之前，並將最終處理規則放在最後。儲存後確認已啟用修改過的設定檔，使用已知目標重新測試，再從記錄或連線紀錄確認實際採用的策略。

注意事項：同一個目標可能涉及多個網域和 IP 位址，只修改首頁網域未必涵蓋所有請求。IP 規則也可能受到網域解析結果影響。不要只憑頁面是否開啟來判斷規則是否匹配；應搭配紀錄確認連線路徑，並避免一次加入大量難以說明的規則。

Home / Subscribe / Add Server

訂閱與伺服器管理：分開維護參數與清單

功能說明：Subscribe 用來匯入及更新你已有的伺服器清單，Add Server 則用來手動填寫單一伺服器。訂閱提供伺服器項目，不等於 Config 中的完整路由策略；更新伺服器清單，也不代表所有分流規則都會自動更換。

介面位置：在 Home 的新增入口選擇對應類型；手動輸入時選擇 Add Server，匯入訂閱時選擇 Subscribe。也可以透過 Scan QR Code 或剪貼簿匯入既有資料，能否辨識取決於內容格式及目前版本的支援情況。

設定方式：訂閱網址請向你的服務商取得，複製時保留完整內容，並檢查是否有首尾空格、換行或缺少參數。手動新增時，先選擇對應協定，再逐項確認位址、連接埠、驗證資訊及傳輸參數。Shadowsocks、VMess、VLESS、Trojan、WireGuard、Hysteria2 的欄位各有不同，不要將某一種協定的填寫方式直接套用到其他協定。

  1. 為每份訂閱取一個容易辨識用途的名稱，並保留來源紀錄。
  2. 匯入後檢查群組與伺服器項目，再選取一個項目執行 Connectivity Test。
  3. 完成實際連線測試後，再整理排序或刪除重複的手動項目。
  4. 更新訂閱後，確認所選伺服器仍存在，以及設定檔引用的名稱仍然有效。

注意事項：更新訂閱可能會覆蓋訂閱中的手動修改；需要長期保留的自訂項目應分開管理。訂閱連結可能包含帳戶憑證，若完整網址出現在記錄、截圖或備份中，請妥善保護。刪除訂閱前，先確認備份可以還原；詳細操作請參閱訂閱與伺服器管理手冊。

Settings / On Demand

On Demand：依條件觸發連線

功能說明：On Demand 會依系統支援的網路條件觸發連線行為，決定何時嘗試建立連線；它不能取代 Global Routing 的流量選擇，也無法修復失效的伺服器。規則分流處理的是「請求要走哪裡」，On Demand 處理的是「何時啟動連線」，兩者應分開理解。

介面位置：在 Settings 尋找 On Demand 及其規則入口。可用條件以裝置系統與目前介面為準。啟用前先以手動方式確認訂閱、伺服器和設定檔正常，確保連線基礎已就緒。

設定方式：先保留現有設定，再選擇目前介面提供的網路條件，例如針對不同 Wi-Fi 環境或網路類型設定連線行為。每次只新增一項條件，分別測試連上該網路、離開該網路及切換行動網路時的狀況。確認正常後再新增其他條件，不要同時啟用多條彼此重疊的規則。

注意事項：啟用後即使手動關閉連線，下次符合條件時仍可能再次觸發。若遇到「關閉後又重新連線」，請先檢查 On Demand，再檢查系統網路設定。測試時也應考量網路切換、裝置休眠後恢復及系統權限；不要只根據一次切換結果，就認定所有情況都已涵蓋。

Data

Data：查看流量，不取代服務商帳單

功能說明：Data 顯示客戶端記錄的流量狀況，可用來判斷連線後是否有資料傳輸，以及測試前後的用量變化。統計範圍、重設方式與顯示項目請以頁面說明為準；某個計數值不一定等於裝置所有網路活動的總量。

介面位置：開啟 Data，先確認目前顯示的是哪項統計及其時間範圍，再查看上傳與下載資料。若介面提供重設功能，請先記下需要保留的數值，以免重設後失去比較依據。

設定方式：測試前記下目前數值，暫停無關的背景傳輸，再存取已知目標，接著返回 Data 比較變化。若同時查看記錄，請讓測試時間區間一致，方便分辨「已建立連線但沒有業務資料傳輸」與「有資料傳輸但目標回應異常」等不同狀況。

注意事項：客戶端統計方式可能與服務商的計費方式不同，例如統計時間、協定額外負擔及重設週期可能不一致。Data 顯示有流量，不代表所有請求都成功；數值偏低也不代表連線失效。請搭配實際存取結果、匹配策略與記錄一起判斷，不要用它推算訂閱剩餘流量。

Settings

Settings：DNS、測試方式與同步

DNS：先釐清網域解析與連線

功能與位置：DNS 會將網域名稱解析為 IP 位址；相關選項可在 Settings 或目前 Config 的 DNS 設定中查看，實際生效方式需配合設定檔內容判斷。伺服器可連線但網域存取異常時，DNS 是其中一項檢查方向，但並非所有存取失敗都是解析問題。

設定方式與注意事項：先記錄目前設定，並檢查設定檔中是否也有覆寫項目，再依現有設定說明進行調整。每次只更換一項 DNS 選項，重新送出請求並查看記錄中的解析與連線結果。不要同時修改 DNS、Global Routing 和伺服器；既有連線或快取結果可能影響測試，請重新連線後再比較。

Test Method：確認測試項目

功能與位置：Test Method 位於相關測試設定中，用來選擇客戶端執行連線或延遲檢查的方式。不同測試方式驗證的環節不盡相同，因此解讀結果時必須一併考量所選方法，不能只比較顯示的時間數值。

設定方式與注意事項：在 Settings 查看 Test Method；比較時請保持測試方法、測試目標及網路環境一致，再對一組伺服器執行 Connectivity Test。若測試有回應但實際存取失敗，請繼續檢查協定、TLS、SNI 等適用參數；若某種方法全部失敗，也應先確認測試目標本身可用，不要立刻刪除所有伺服器。

Today Widget：在系統支援範圍內使用捷徑

功能與位置：Today Widget 是系統小工具相關入口，可在支援的小工具介面查看狀態或執行可用操作。先在 Settings 確認是否提供相關設定，再前往系統的小工具管理介面查看是否能新增項目。

設定方式與注意事項：依系統提示新增後，返回客戶端確認伺服器與連線狀態，再測試捷徑操作。系統版本可能影響小工具能否新增、顯示內容及更新時機。若小工具顯示延遲，請以客戶端和系統的連線狀態為準，不要將小工具文字當成即時診斷結果。

iCloud：同步前先備妥可還原的副本

功能與位置：iCloud 相關設定可在支援範圍內同步資料。先在系統帳戶設定中確認 iCloud 可用，再查看 Shadowrocket 的同步選項及同步項目；不要假設所有本機資料、系統授權和即時連線狀態都會同步至其他裝置。

設定方式與注意事項：啟用前匯出需要保留的設定檔，確認兩台裝置使用預期的 iCloud 帳戶，並等待同步完成。還原後逐項確認 Subscribe、伺服器選擇、Config 和 Global Routing，再建立連線。同步不能取代獨立備份，誤刪或錯誤修改也可能同步到其他裝置；在電腦與其他系統間移轉時，請使用各平台實際支援的匯入與匯出方式。

Settings / Diagnostics

Diagnostics：逐層排查連線問題

功能說明：Diagnostics 可收集或查看診斷資訊，搭配 Connectivity Test、連線紀錄與記錄檔定位問題。它的用途是提供判斷依據，並不會自動修復連線；排查時應依序檢查本地網路、伺服器、解析、規則及目標服務。

介面位置：在 Settings 尋找 Diagnostics；實際的記錄與工具入口請以目前介面為準。先記下異常發生時的網路、時間與現象，再啟動所需的記錄功能。有些記錄必須在問題重現前開啟，事後才開啟未必能看到先前連線的完整過程。

  1. 確認本地網路：確認裝置已連上可用網路，並檢查系統時間是否正確。
  2. 檢查伺服器：對目前使用的伺服器執行 Connectivity Test，確認位址、連接埠、驗證資訊及適用的 TLS 參數。
  3. 比較路由方式：使用相同目標分別測試 Config 與 Proxy，並維持所選伺服器不變。
  4. 重現並記錄：重新開啟目標，確認解析、匹配策略及連線失敗分別發生在哪個環節。
  5. 還原設定：關閉臨時診斷記錄，恢復日常模式，只保留已驗證的修改。

注意事項：分享診斷資料前，請檢查訂閱網址、伺服器憑證、存取網域及個人網路資訊，並遮蔽不需公開的內容。若交握失敗，請檢查相關協定參數與系統時間；若規則不符，請檢查匹配順序。不要把所有錯誤都歸因為「伺服器逾時」。更多用語說明請參閱術語表。

功能範圍與取得方式

分開判斷客戶端設定與線路服務

Shadowrocket 提供伺服器匯入、代理連線、規則分流與診斷等客戶端功能。既有伺服器是否可用、訂閱是否仍有效，以及伺服器端支援哪些傳輸方式，請依你的服務商提供的資訊確認。客戶端一次性購買 ≠ 線路方案；本站不提供、銷售或推薦節點或訂閱，也不會以調整設定取代你已有的服務授權。

取得方式分為兩種：iPhone / iPad 版於 App Store 一次性付費 $2.99；Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片與 Intel 兩種版本。iPhone / iPad 的系統需求請以 App Store 頁面標示為準，並確認開發者為 Shadow Launch Technology Limited、應用程式 ID 為 932747118；其他平台的安裝檔由本站 /dl/shadowrocket/ 提供。

需要取得客戶端或查看系統允許設定的步驟，請前往全平台下載與安裝說明。已可連線的裝置，請先備份目前設定，再依本頁相關章節調整功能；每次先驗證一項再進行下一項，避免同時修改多個設定而無法追查原因。