Subscribe：匯入現有訂閱
從 Home 的新增入口進入相應類型，選擇 Subscribe 後輸入已有的訂閱網址，儲存並更新清單。先確認更新成功，再查看回傳項目是否符合預期；名稱相似不代表參數相同，選取時請確認項目所屬群組。
更新可能會取代由訂閱產生的記錄，因此不要只在這些項目中保留需要長期使用的手動修改。更新失敗時，請檢查連結是否完整、是否已過期，以及目前網路能否連線至訂閱網址；不要反覆刪除所有設定來嘗試解決問題。
官方手冊 · 功能參考
Shadowrocket
Shadowrocket
功能與常用設定
先確認流量處理模式，再調整規則、連線條件與診斷選項。
iPhone / iPad 版可從 App Store 取得，$2.99 一次性付費；Mac（Apple 晶片與 Intel）、Windows、Android、Linux 版免費。各平台取得方式請參閱取得應用程式頁，電腦與 Android 安裝檔由本站 /dl/ 提供。iPhone / iPad 系統需求以 App Store 頁面標示為準。
先看 Global Routing
再看 Config 與 SERVER
最後檢查 Settings
以下以 iPhone / iPad 介面用語說明操作位置；其他平台的選單排列、系統整合功能與可用設定可能不同，請以目前安裝版本顯示的項目為準。本文說明如何使用使用者已有的訂閱或伺服器資訊，不提供、銷售或推薦節點或訂閱。一次買斷客戶端 ≠ 線路方案。
01 · 模式
Global Routing：Config、Proxy 與 Direct
Global Routing 決定客戶端如何處理進入隧道的連線。在 Home 找到 Global Routing，依使用目的選擇 Config、Proxy 或 Direct。這不是伺服器協定選項，也不是連線開關：選好模式後，仍須確認 Home 目前選取的伺服器及連線狀態。
| 介面用語 / 中文說明 | 處理方式 | 適用情境 | 優先檢查項目 |
|---|---|---|---|
| Config / 設定 | 依目前設定中的規則決定處理策略。 | 需要區分代理、直連或拒絕連線時。 | 目前選取的設定檔、規則順序及最終規則。 |
| Proxy / 代理 | 通常會將進入隧道的流量交由目前代理處理。 | 暫時確認伺服器能否建立實際連線。 | 目前伺服器、驗證參數及目標服務是否可用。 |
| Direct / 直連 | 通常讓進入隧道的流量直接連線至目標。 | 比對問題是否與代理路徑有關。 | 本機網路、DNS 與目標網站本身的狀態。 |
日常依規則使用時選擇 Config，再到 Config 確認目前啟用的檔案。需要排查故障時，可短暫切換至 Proxy 或 Direct，針對同一目標進行比對測試；測試完成後請恢復原模式。切換模式只會改變處理方式，不會自動修正錯誤的位址、密碼或憑證設定。
02 · 分流
規則類型與 PROXY / DIRECT / REJECT
規則由「比對條件」和「處理策略」組成。在 Config 開啟目前的設定，查看規則清單或編輯內容；返回 Home 後，Global Routing 必須設為 Config，規則才會依設定參與分流。一般規則會依序比對，較具體的條件應排在較寬泛的條件之前，最後以 FINAL 處理其餘連線。
PROXY 表示交由設定中的代理策略處理，DIRECT 表示直連，REJECT 表示拒絕。策略名稱必須能由目前設定辨識；若檔案引用自訂策略群組，也要確認該群組已定義，且已選取可用項目。請勿只修改規則末尾的名稱，卻忽略對應策略是否存在。
右側片段僅供說明語法，並非完整設定，也不代表實際線路。新增前請先備份目前檔案；每次只修改一條規則，儲存並確認目前設定後再建立新連線，避免同時變更多項而難以判斷原因。
Rule · Policy
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
DOMAIN-KEYWORD,ads,REJECT
FINAL,DIRECT| 規則關鍵字 | 比對對象 | 設定注意事項 |
|---|---|---|
DOMAIN | 指定的完整網域名稱。 | 網域名稱不包含協定前綴或 URL 路徑。 |
DOMAIN-SUFFIX | 網域名稱本身及其子網域。 | 適合依網站網域範圍設定。 |
DOMAIN-KEYWORD | 網域名稱中出現的關鍵字。 | 比對範圍較廣，請留意誤判。 |
IP-CIDR / IP-CIDR6 | IPv4 / IPv6 位址區段。 | 分別確認位址類型與網路前綴長度。 |
GEOIP | IP 地理位置資料庫中的區域。 | 結果取決於資料庫及實際解析出的位址。 |
USER-AGENT | 可讀取的 User-Agent 請求欄位。 | 並非所有連線都會提供此欄位，不能取代通用的應用程式識別。 |
FINAL | 先前未比對到的連線。 | 通常放在末尾，明確指定預設處理策略。 |
03 · 資訊管理
Subscribe 與 Add Server
伺服器記錄會保存單一連線的協定、位址、連接埠與驗證資訊；訂閱則用來批次取得及更新這些記錄。兩者都需要使用者已有相關資訊。訂閱和 Config 並非同一概念：匯入伺服器清單後，仍須另外確認目前使用的規則設定及 Global Routing 模式。
Add Server：新增單筆記錄
在 Home 開啟 Add Server，先依現有資訊選擇協定類型，再逐項填入伺服器位址、連接埠及驗證欄位。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 所需欄位各不相同，不能只靠位址格式猜測類型。
使用 Scan QR Code 時，匯入後仍須確認協定及重要欄位。儲存後在 SERVER 清單選取相應項目，先執行 Connectivity Test，再嘗試實際連線；測試通過只代表在該測試條件下的結果。
04 · 連線條件
On Demand：依條件觸發連線
On Demand 可讓系統在符合條件時建立或恢復 VPN 連線。它回答「何時連線」，Global Routing 則決定「連線後如何處理流量」。兩者用途不同：啟用 On Demand 不會自動選擇合適的伺服器，也不能取代 Config 中的規則。
設定位置與驗證方式
在 Settings 尋找 On Demand，查看目前版本提供的網路條件與連線行為。先手動連線確認伺服器可用，再啟用按需連線；若介面提供 Wi-Fi、行動網路或指定網路條件，只設定確實需要的項目，不必一次全部設定。
儲存後切換一次相應網路，再返回 Home 檢查連線狀態，並以新請求驗證實際連線。測試時一併記錄目前網路與觸發條件，避免把系統短暫重新連線誤判為規則分流錯誤。
暫停連線時的注意事項
啟用 On Demand 後，手動關閉連線不一定代表之後會持續保持中斷；系統可能在條件再次符合時重新連線。如需明確暫停，請先確認按需設定是否仍在生效，再查看 Home 的連線狀態。
按需連線取決於系統權限、網路狀態及目前設定。頻繁切換網路時，重新建立隧道可能需要短暫等待；請先簡化觸發條件並逐項驗證，不要同時調整 DNS、伺服器與規則。
05 · 用量觀察
Data：流量統計與連線觀察
Data 可查看客戶端記錄的傳輸用量及目前版本提供的連線資訊。進入 Data 後，先確認頁面統計的是目前連線、累計值或特定時間範圍，再觀察上傳與下載的變化。若介面提供重設統計功能，請先記錄必要資料再操作，並記下重設時間，方便日後比較。
排查時可先關閉其他正在傳輸的工作，記錄目前數值，再造訪一個目標，觀察是否產生新流量。若能查看連線詳情，可搭配網域、目標位址及命中策略判斷處理路徑；「有流量」只能表示發生了傳輸，不能單獨證明目標網頁已完整載入，或所有連線都採用相同策略。
客戶端的統計方式可能與系統、網路業者或伺服器端記錄不同；協定封裝、統計時間範圍、是否計入直連流量等因素都會影響結果。Data 不應作為遠端帳戶剩餘用量的依據，也不能只憑單次上傳量判斷是否異常。分享截圖或記錄前，請先確認其中是否包含瀏覽記錄及伺服器資訊。
06 · 常用設定
Settings：DNS、測試與系統整合
進入 Settings 前，先記下目前設定及既有數值。不同平台與系統版本的項目可能有所差異；以下依功能說明，不需要開啟所有開關。若設定檔也包含同類設定，請一併檢查內容，避免只調整介面選項而忽略目前設定的影響。
DNS：網域解析
DNS 會將網域名稱轉換為連線所需的 IP 位址。檢查 Settings 中的 DNS 相關項目，並在 Config 查看目前設定是否定義了解析方式。請使用已確認可用的解析服務，區分一般解析、加密解析與代理路徑，不要將不同格式的位址填入同一欄位。
若出現「位址可以連線，但網域無法開啟」，請優先檢查解析是否失敗、傳回的位址類型是否可連線，以及解析請求本身的路由。變更後依目前介面提供的方式清除快取或重新連線，再送出新請求。不要只因某個網站一次連線失敗，就關閉所有 IPv6 或全面改寫 DNS。
Test Method：測試方法
Test Method 決定伺服器清單採用的測試方式，可在 Settings 尋找此項目。先了解選項測試的是連線建立，還是指定目標的回應，再透過 Home 的 Connectivity Test 執行測試。比較多個項目時，請保持測試方法、目標及本機網路一致。
顯示的時間不是下載速度，也無法預測所有網站的使用體驗。目標網站狀態、交握過程及網路瞬間變化都會影響結果；若某種方法失敗，請以實際請求再次確認，不要只因單次結果就刪除記錄。
Today Widget：快速查看與操作
Today Widget 是系統小工具的快捷入口，適用於系統與目前版本仍支援此功能的環境。在 Settings 查看相關選項，再前往系統支援的小工具管理介面新增。可用版面及操作方式請以裝置實際顯示為準。
首次設定後仍應返回 Home 確認伺服器、Global Routing 及連線權限。小工具狀態可能有更新間隔；若顯示內容與實際連線不一致，請先開啟應用程式確認，不要反覆切換快捷開關。小工具也不能取代 On Demand 的條件設定。
iCloud：設定同步
iCloud 可在支援此功能的裝置間同步相應設定內容。在 Settings 或設定管理中的雲端入口查看可同步項目，並確認系統 iCloud 權限及登入狀態。同步範圍請以目前介面說明為準，不要預設所有伺服器記錄、統計資料或連線狀態都會同步。
啟用前請先備份本機資料；不要在多部裝置上同時編輯同一份設定。若內容發生衝突，請先比較檔案再決定保留哪一份，避免覆寫仍在使用的規則。設定可能包含訂閱網址及驗證欄位，是否同步應依自己的帳戶與裝置存取權限評估。
07 · 排查
Diagnostics：依據證據縮小範圍
Diagnostics 提供目前版本可用的診斷入口。在 Settings 找到 Diagnostics，依問題選擇相應工具或記錄方式。先確認問題發生於更新訂閱、建立連線、解析網域或連線至目標的哪個階段，再進行相應檢查；不要把所有故障都歸因於伺服器速度。
- 確認本機網路。暫時中斷客戶端連線，檢查本機網路能否正常存取原本可連線的服務，排除 Wi-Fi 登入頁面、系統切換網路等因素。
- 確認連線參數。檢查協定、位址、連接埠、驗證及 TLS 相關欄位，留意複製時是否帶入空格或遺漏內容。遇到憑證錯誤時，請確認網域、裝置時間及參數，不要直接略過驗證。
- 分別檢查模式與規則。使用同一目標分別測試 Proxy 與 Config。若前者正常而後者失敗，請優先檢查規則命中、策略引用及 DNS 路徑。
- 記錄最小重現步驟。記下問題發生時的網路類型、操作步驟、目標及錯誤提示。只有必要時才開啟詳細記錄，重現問題後即停止，以減少無關資料及隱私外洩風險。
記錄中可能包含目標網域、IP 位址、訂閱連結或身分欄位。分享前請遮蔽敏感內容，但保留錯誤類型及必要背景資訊；只說「無法連線」，通常不足以判斷是解析失敗、交握失敗還是規則選擇錯誤。
08 · 檢查順序
變更設定後如何確認生效
建議依照「在 Home 選擇伺服器 → 在 Config 確認檔案 → 在 Global Routing 選擇模式 → 建立連線 → 送出新請求 → 在 Data 或 Diagnostics 查看結果」的順序檢查。每次只變更一項因素並保留原值；若結果變差，先還原該項再繼續排查。初次使用可參閱快速入門依步驟操作。
已匯入訂閱，為什麼沒有依規則分流？
訂閱主要提供伺服器記錄，不一定包含所需的規則設定。先在 Home 確認 Global Routing 設為 Config，再檢查 Config 中選取的檔案、規則順序及策略引用。匯入成功不代表目前檔案已生效。
Connectivity Test 正常，但網頁仍無法開啟，該先檢查什麼？
先確認測試與實際連線使用的是同一筆伺服器記錄，再檢查目標網域的 DNS 結果、命中的規則及連線錯誤。測試目標與實際網頁可能採用不同路徑，單次回應不能代表所有連線都正常。
關閉連線後又自動連線，該調整哪個項目？
先檢查 On Demand 的啟用狀態與觸發條件。網路條件符合時，它可能會重新連線；若要暫停，請先調整按需連線行為，再返回 Home 確認狀態。不要以刪除伺服器或設定檔來取代關閉按需連線。
電腦和 Android 也能使用 Shadowrocket 嗎？
可以。iPhone / iPad 版 App Store 售價 $2.99，一次性付費；Mac（Apple 晶片與 Intel）、Windows、Android、Linux 版免費。請前往全平台取得說明選擇對應平台；實際設定位置及系統整合功能請以該平台介面為準。