官方手冊 · 快速上手
Shadowrocket 匯入與連線教學
依照「資料 → 模式 → 連線 → 驗證」的順序操作。首次設定請先完成手動連線，再調整規則與自動連線條件。
開始前：分別備妥 App 與連線資料本教學假設使用者已從 App Store 安裝 Shadowrocket，並備妥個人訂閱連結或伺服器資料。本站不提供、不販售、不推薦節點或訂閱。用戶端一次性買斷 ≠ 線路方案。
尚未安裝？請先閱讀App Store 正版下載說明。確認開發者為 Shadow Launch Technology Limited，且 App ID 為
932747118；系統需求請以 App Store 頁面標示為準。
以下主要說明 iPhone 與 iPad 上的操作。配圖為 App Store 官方截圖，供辨識頁面使用；實際欄位與排列方式請以裝置上的 App 為準。請勿照抄截圖中的連線資料。
步驟 01 · 連線資料
Add Server：新增伺服器或匯入訂閱
開啟 Shadowrocket 後進入 Home。下方的 SERVER 群組會顯示伺服器項目，Add Server 則是新增入口。先確認手上的資料類型：完整訂閱網址、單一伺服器分享連結，或包含網址、連接埠與驗證欄位的參數表。三種資料的新增方式不同，請勿將訂閱網址填入 Host，也不要把單一伺服器連結當成訂閱反覆更新。
已有訂閱：選擇 Subscribe
從自己的服務商取得完整訂閱網址後，在 Home 點選 Add Server，開啟 Type 並選擇 Subscribe，再將網址貼到 URL 欄位。確認網址開頭、結尾及查詢參數都完整，尤其留意複製時是否帶入空格、換行或聊天軟體的標點符號。完成後使用頁面上的儲存功能，返回 Home 等待訂閱內容載入。
匯入成功後，Home 應會顯示相應群組與伺服器項目。展開群組，點選要使用的項目並確認已選取。儲存訂閱網址只代表用戶端記住了網址；若沒有載入項目，還需檢查更新結果，不能直接進入連線步驟。更新訂閱是重新取得遠端清單，不等於開啟連線，也不保證原有伺服器仍然有效。
手動填寫：先確認 Type 與協定欄位
若已有伺服器參數，請先在 Add Server 選擇正確的 Type，再依序填寫 Host、Port 與該協定所需的驗證資料。Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等協定所需欄位各不相同；變更 Type 後，頁面欄位也可能隨之改變。先選擇協定，可避免填錯欄位。
以配圖中的欄位為例，Host 是伺服器位址，Port 是連接埠，Password 與 Method 請依個人資料逐項確認。其他協定中的 UUID、TLS、Server Name 或傳輸參數，也應與資料一致。請勿憑印象補填加密方式或省略驗證欄位。儲存後返回 Home，找到新項目並選取；如需修改，請重新開啟該項目的編輯頁面，不要接連建立多個名稱相似的副本。
已有 QR Code 時，可在適合的新增頁面使用 Scan QR Code，並依需求授予相機權限。Import from Cloud JSON 是另一種資料匯入方式，僅在已有相應格式檔案時使用。QR Code、單一分享連結、訂閱網址與 JSON 檔案雖都包含連線資訊，卻不能互相取代。
完成本步的判斷方式：Home 已顯示伺服器項目，且已明確選取其中一個。接著先選擇 Global Routing，再開啟連線開關。
步驟 02 · 請求路徑
Global Routing：選擇設定檔、代理或直連
返回 Home，點選 Global Routing 查看目前模式。本教學使用三種模式：設定檔 (Config)、代理 (Proxy)、直連 (Direct)。這裡決定請求採用哪一類路徑；SERVER 中選取的項目則決定需要代理時使用哪一台伺服器。兩者用途不同，選取伺服器不代表每個請求都會經過它。
- 設定檔 (Config)：依據目前設定檔中的規則，決定請求使用 PROXY、DIRECT、REJECT 或設定檔中的其他策略。若要日常依規則使用，請先確認設定檔內容及策略引用。
- 代理 (Proxy)：一般請求會交由所選的代理路徑處理，適合初步確認伺服器是否具備基本連線能力。這不是「修復連線」的按鈕；伺服器參數錯誤仍會導致連線失敗。
- 直連 (Direct)：讓一般請求直接連線，適合作為對照。若目標在此模式下能開啟，不能因此判定代理伺服器已可使用。
Config：確認設定檔與 Rule
若要使用設定檔 (Config)，請進入 Config，確認目前選取或啟用的是預期設定檔，再查看 Rule。配圖展示設定檔編輯頁面，其中 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同的內容區段；Add Rule 用於新增規則。開啟過某個檔案不一定代表它已設為目前設定檔，請返回檔案清單再次確認選取狀態。
規則會依設定檔指定的順序參與比對。以下僅展示語法，不能直接取代完整設定檔：第一行表示網域後綴比對，第二行是最終比對。PROXY、DIRECT、REJECT 是策略關鍵字，不是伺服器位址，也不是訂閱內容。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT首次連線時，請勿同時修改多條規則。可先使用代理 (Proxy) 完成基本驗證，再切回設定檔 (Config) 檢查分流結果。若 Proxy 可用，但 Config 下某個目標連線失敗，排查重點應放在規則比對與策略，而不是立刻重新填寫伺服器資料。複雜規則的調整順序請參閱規則分流與故障排除。
完成本步的判斷方式：能清楚說明目前選取的模式，以及需要代理時會使用哪台伺服器。保留此設定，進入下一步連線。
步驟 03 · 系統連線
Home：開啟開關並確認 VPN 設定
返回 Home，先檢查兩處：SERVER 群組中選取的伺服器是否正確，以及 Global Routing 是否維持上一步預定使用的模式。確認後開啟頂端的開關。未連線時會顯示 Not Connected；開啟開關後請觀察後續狀態，不要把「點過開關」當成已成功連線。
首次連線時可能會出現系統新增 VPN 設定的提示。這是系統允許 App 建立相關網路連線的授權流程，與在 Config 中新增規則檔案不同。確認提示是由剛才主動操作的 Shadowrocket 所發出後，依系統要求核准，必要時完成裝置驗證。返回 App 等待狀態變更，再進行實際存取測試。
若上次選擇拒絕，可再次開啟連線開關，確認授權提示是否重新出現。若仍無法建立設定，請前往系統設定中的 VPN 管理位置，檢查相關紀錄與裝置限制。受組織管理的裝置可能套用了額外政策，請依裝置管理要求處理，不要反覆刪除與目前問題無關的設定。
系統顯示 VPN 狀態，代表通道已建立或處於啟用狀態；但這無法單獨證明伺服器驗證、網域解析與目標存取都正常。反過來說，有些規則會讓部分請求直接連線，因此也不能只憑某個頁面成功開啟，就認定所有流量都經過代理。
本次練習先維持手動連線，暫不啟用 On Demand。若連線後立即中斷，先記下提示內容與發生時間，再依後續步驟排查；若開關維持開啟，則進行 Connectivity Test 與實際存取驗證。無論哪種情況，都不需要重新購買用戶端。
步驟 04 · 結果驗證
Connectivity Test：分別判斷測試結果與實際存取
在 Home 使用 Connectivity Test，等待測試完成。測試結果反映所選測試方法及目標的回應情況，並不代表所有網站、所有 App 都能正常運作。若某個項目沒有回傳結果，先記錄狀況；不要只憑一次測試就刪除整份訂閱。
接著開啟自己有權存取且預期可正常使用的目標頁面。先測試一般網頁，再測試實際需要使用的功能。若頁面能顯示，但圖片、登入或其他請求失敗，請分別檢查；同一頁面可能呼叫不同網域，而 Config 中的規則也可能為各網域選擇不同策略。
- 檢查連線層：返回 Home，確認開關仍維持開啟，且連線狀態沒有反覆變動。
- 檢查伺服器路徑：維持伺服器不變，使用代理 (Proxy) 檢查基本存取，再與預定使用的設定檔 (Config) 比較。
- 檢查規則結果：若只有在 Config 下出現差異，請檢查相關網域規則、最終比對規則及其引用的策略。
比較時一次只變更一個條件。例如固定伺服器，只切換 Global Routing；或固定模式，只切換另一台已有的伺服器。每次操作後重新送出請求，必要時重新開啟目標頁面，避免舊連線與快取影響判斷。若同時更新訂閱、切換伺服器、變更 DNS 和修改規則，就很難判斷是哪個步驟造成結果改變。
驗證完成後，請恢復預定日常使用的模式。Data 中的上傳、下載數值可協助確認是否有流量活動，但數值增加本身不代表目標存取成功，也不能證明所有請求都經過代理。能穩定重現「連線維持、目標可存取、規則行為符合預期」，才算完成本次入門操作。
步驟 05 · 依階段排查
Settings：先找出故障點，再調整設定
發生問題時，先關閉連線，確認裝置透過目前的 Wi-Fi 或行動網路能否正常存取基本內容。需要登入的 Wi-Fi，請先完成網路驗證。基本網路尚未連通時，反覆更新訂閱或修改規則通常無法解決問題；先恢復基本存取，再依故障發生的位置繼續檢查。
訂閱沒有項目：檢查網址與更新結果
確認使用的是完整訂閱網址，而非服務頁面網址或單一分享連結。檢查訂閱是否到期、參數是否遭截斷，以及目前網路能否取得訂閱內容。網址可以儲存但沒有項目，表示新增動作與內容載入需要分開檢查。若錯誤與帳戶狀態或遠端內容有關，請向自己原有的服務商確認，不要將私人訂閱網址貼到公開討論區。
開關無法維持開啟：檢查設定授權與驗證資料
先判斷是「系統尚未允許 VPN 設定」還是「伺服器無法連線」。前者請返回連線授權步驟檢查；後者請重新確認 Type、Host、Port 與驗證欄位。網址能解析不代表連接埠可連通；連接埠可連通也不代表密碼或其他驗證參數正確。遇到明確錯誤時，先記下原始訊息，再逐項對照個人資料，不要隨意修改欄位碰運氣。
測試結果與瀏覽狀況不一致：確認 Test Method 與規則
前往 Settings 查看 Test Method，先了解目前採用的測試方式。不同測試方法觀察的對象不同，不能以測試結果完全取代實際服務請求。若代理 (Proxy) 可以存取而設定檔 (Config) 失敗，請返回 Config 檢查 Rule；若兩者都失敗，再檢查伺服器資料、基本網路與目標本身的狀態。
Settings 中也能查看 Diagnostics，以及 Proxy、TCP、UDP 等相關設定。這些並非一組需要全部開啟的「連線強化」選項。初次排查時請保留原設定，只在有證據指向特定項目時才修改，並記下原值。TCP 請求正常，也不能直接證明 UDP 請求正常，應依實際故障的功能分別檢查。
若需要進一步分析，可使用 Diagnostics 收集相關資訊。記錄故障時間、目前網路、Global Routing、所選伺服器及錯誤狀況，有助於縮小問題範圍。分享記錄或截圖前，請遮蔽訂閱網址、密碼、UUID、存取權杖及其他私人資料；診斷內容也可能包含存取網域，不宜整份公開。
本頁僅說明首次上手時的排查順序。更多情況請參閱Shadowrocket 無法連線與規則排查；購買恢復與商店地區問題，請前往App Store 指南，不要在連線設定中處理帳戶購買問題。
步驟 06 · 選用設定
On Demand：手動連線穩定後再啟用
On Demand 用於依條件觸發連線，無法修復錯誤的伺服器資料或失效的訂閱。完成前述手動連線與存取驗證後，再前往 Settings 查看 On Demand。先確認自己的需求，例如在特定網路條件下連線，或在特定條件下維持中斷，再閱讀目前頁面提供的條件與動作。
初次設定時，只新增一個容易驗證的條件。儲存後分別測試條件符合與不符合時的狀況，並返回 Home 查看連線狀態。若條件涉及 Wi-Fi 名稱，請依實際網路名稱填寫；若涉及網域條件，請依 App 提供的規則格式輸入，不要混用完整網頁網址與網域。若同時設定多個條件，也要檢查順序與動作是否衝突。
若手動關閉後連線又自動啟動，請先查看 On Demand 是否仍在生效，不要立刻認定開關故障。排查其他連線問題時，可先暫停 On Demand，讓測試回到明確的手動狀態；確認基本連線恢復後，再逐項恢復自動條件。
至此，基本使用流程已完整走過：已有資料可載入、所選模式明確、系統允許連線，且目標存取已完成驗證。之後若出現異常，優先檢查發生變動的環節，不必從頭重做所有設定。訂閱內容變動先檢查更新，模式變動先檢查規則，切換網路後失敗則先檢查基本網路。