官方手冊 · 首次連線步驟
Shadowrocket 訂閱匯入與連線教學
依照「匯入資訊 → 選擇 Global Routing → 開啟連線 → 驗證結果 → 排查問題」的順序操作。先確認一筆現有伺服器記錄可正常使用，再整理其他訂閱與規則；初次設定時，請勿同時修改多個選項。
- 操作介面 Home / Config
- 適用裝置 iPhone / iPad
- 準備條件 已有連線資訊
本頁整理初次上手所需的操作步驟；訂閱更新、多筆訂閱管理、欄位說明與備份方式，請繼續閱讀訂閱與伺服器管理手冊。
[Before You Start]操作前，請先從 App Store 安裝 Shadowrocket，並備妥自己的訂閱連結或伺服器資訊。本站不提供、不販售也不推薦節點或訂閱。App 一次買斷不等於線路方案；購買 App 不會自動產生可用伺服器。
尚未安裝的話，請先閱讀App Store 正版購買與安裝說明。iPhone 與 iPad 的系統需求、相容性及購買適用範圍，請以 App Store 頁面標示為準。以下步驟會以 App 內的英文介面名稱引導操作，不依賴按鈕固定的螢幕位置。
[Subscribe]步驟 01 · 準備連線記錄
新增伺服器或匯入現有訂閱
先確認手上的資料是訂閱網址、單筆分享連結，還是逐項列出的伺服器參數。三者的操作入口不同，請勿只因連結看起來像網址就選擇 Subscribe。
已有訂閱網址：選擇 Subscribe
開啟 Shadowrocket，前往 Home，點選右上角的加號進入 Add Server。在 Type 中選擇 Subscribe，將完整的個人訂閱網址填入 URL，並加上方便辨識的備註後儲存。訂閱通常會傳回多筆伺服器記錄；儲存或更新後，請返回 Home 確認是否已新增相應的群組與項目，不要停留在編輯頁就認定匯入完成。
複製網址時，請從第一個字元檢查到最後一個字元。查詢參數可能包含身分憑證，請勿任意刪除問號後的內容，也不要一併複製聊天文字、中文引號、換行或結尾標點。以下僅供辨識訂閱網址的結構，不能用於實際連線；操作時請使用自己持有的完整網址。
https://example.com/sub?token=xxxx若儲存後沒有出現伺服器，請先確認 URL 是否完整，再查看 App 顯示的提示。不要為了讓清單出現項目而連續新增相同訂閱，也不要把 Subscribe 改成某種單一伺服器協定來嘗試解析。清單為空與單台伺服器連線失敗屬於不同階段，應分別處理。
已有伺服器參數：在 Add Server 逐項填寫
如果取得的是位址、連接埠、密碼及協定說明，請在 Add Server 的 Type 中選擇與資料相符的協定，再填寫介面顯示的相關欄位。Address 應填伺服器主機名稱或位址，請勿自行加上網頁路徑；Port 應與原始資料一致。密碼、加密方式、UUID、TLS、SNI 等欄位是否需要填寫，取決於所選協定與伺服器要求，請勿從其他項目複製或自行猜測。
填寫完成後儲存，返回 Home 確認新項目是否出現。協定相同不代表參數也相同；尤其 Trojan 的密碼與 SNI、Shadowsocks 的加密方式與密碼，不能互相替代。若資料未說明必要欄位，請核對現有伺服器資料，不要關閉驗證選項來略過提示。
已有分享連結或 QR Code：匯入後再次確認
以 ss://、vmess://、vless:// 或 trojan:// 開頭的內容通常是單筆分享連結，並非可持續更新的訂閱。使用剪貼簿匯入時，請依照 App 顯示的匯入提示操作；持有 QR Code 時，可使用 Scan QR Code 掃描，並依系統提示允許必要的相機存取權限。請勿將 QR Code 貼到公開頁面，請他人代為辨識。
無論採用哪種方式，最後都要返回 Home，點選這次準備使用的伺服器列，並根據選取標記確認結果。先選定一筆記錄，再進行下一步；訂閱群組內有多筆記錄，不代表它們會同時用於這次連線。更完整的匯入與整理方法，請參閱Subscribe 管理說明。
[Global Routing]步驟 02 · 決定流量處理方式
選擇設定、代理或直連
新增伺服器記錄後，還需要指定如何使用它。Global Routing 與伺服器選擇是兩件事：前者決定流量處理方式，後者則決定需要代理時使用哪一筆伺服器記錄。
在 Home 點選 Global Routing，依目前需求選擇三種模式之一：設定（Config）、代理（Proxy）或直連（Direct）。選好後返回 Home，確認目前顯示的模式，再開啟連線開關。不要只憑印象認定曾經選過哪個選項；排查問題時也應重新確認目前模式。
設定（Config）：依目前設定檔處理流量
已有規則設定，且希望不同目標採用不同策略時，請選擇設定（Config）。接著前往 Config，確認準備使用的設定檔確實已啟用。只在 Config 看到檔名，或剛把檔案匯入清單，都不能取代確認目前啟用項目的步驟。訂閱用來提供伺服器記錄，設定檔則用來整理規則；匯入訂閱並不代表規則已準備就緒。
在 Config 模式下，目標可能依規則使用 PROXY、DIRECT 或其他指定策略。規則順序與最後的兜底規則都會影響結果。因此，看到某個網站使用直連，不應立即判定伺服器失效；應先確認該目標原本應符合哪項策略。初次設定只要確認目前的設定檔即可，無須立即編輯整份規則。
代理（Proxy）：確認所選代理路徑
若想先確認所選伺服器能否處理一般存取流量，可暫時選擇代理（Proxy）。這可減少規則比對造成的變因，但仍會受到系統網路行為及相關設定影響，不能視為對裝置所有通訊的絕對保證。驗證完成後，若日常使用需要依規則分流，請切回設定（Config），並再次確認目標服務是否如預期運作。
直連（Direct）：不經過所選代理伺服器
直連（Direct）用於直接存取，不能用來證明代理伺服器可用。如果 Home 已選取伺服器，但 Global Routing 仍為 Direct，目標存取可能根本沒有經過該伺服器。若要比較基本網路與代理路徑，可記錄切換前後的結果；每次只改變模式，避免同時更換伺服器而無法比較。
本步完成的標準是：能說明目前選擇的模式，以及選擇它的原因。若要了解 DOMAIN-SUFFIX、IP-CIDR 與 FINAL 的比對細節，請前往節點管理與設定說明繼續閱讀；初次連線時，先保留已確認的設定。
[Connect]步驟 03 · 建立系統連線
開啟開關並允許 VPN 設定
返回 Home，再次確認所選伺服器與 Global Routing，然後開啟頂端的連線開關。首次授權僅允許 App 在裝置上新增 VPN 設定；連線使用的是你已有的訂閱或伺服器資訊。
首次啟用時，系統可能會提示 Shadowrocket 要求新增 VPN 設定。確認提示與目前操作相符後，依照系統指示允許，並完成裝置要求的驗證。此授權是允許 App 在裝置上建立相應網路設定，不代表系統已檢查伺服器密碼，也不保證遠端服務一定可連線。
如果先前取消了提示，請先返回 Home，再嘗試開啟開關，並留意授權畫面是否再次出現。不要為了繼續操作而刪除裝置上用途不明的設定；若裝置由組織管理，應先確認管理政策是否允許此操作。若系統明確提示受到限制，反覆修改伺服器參數無法解決授權問題。
完成系統確認後，返回 Shadowrocket，查看連線開關是否維持開啟。連線建立期間請等候目前操作完成，不要快速連續切換開關。若開關立即關閉，請記下當時顯示的錯誤訊息，再於第五步區分系統授權、目前網路與設定問題。明確的提示比「無法開啟」這類籠統描述更有助於找出原因。
iPhone 與 iPad 都依照相同步驟確認。不同螢幕尺寸下，清單與詳細資訊的位置可能不同，請以 Home、Global Routing、Config 等介面名稱尋找功能，不要照抄固定座標。也不要只因狀態列沒有在固定位置顯示 VPN 字樣，就判定連線失敗。
此時先不要啟用其他自動連線功能，也不要同時調整 On Demand。先確認手動連線與中斷是否如預期運作，之後再考慮自動化設定。關閉 Home 的連線開關後，也應再次檢查 App 狀態，尤其是曾設定 On Demand 的裝置，以免將自動重新連線誤認為手動開關失效。
[Checkpoint]開關維持開啟，只表示本機連線狀態已進入下一階段。伺服器是否可用，以及目標是否依預期策略處理，仍須透過下一步的測試與實際存取確認。
[Connectivity Test]步驟 04 · 檢查實際結果
先執行測試，再驗證目標存取
請分開觀察本機開關、伺服器測試與實際存取結果。任何單一結果都不足以證明所有設定正確。
在 Home 使用 Connectivity Test，測試現有伺服器記錄，並留意這次準備使用的項目回傳什麼結果。測試結果可用來觀察目前網路下的連線狀況與回應情形，但不代表服務品質保證，也不能取代登入、載入網頁或其他實際使用驗證。請勿只依一次測試數值選擇伺服器並頻繁切換。
接著開啟瀏覽器或所需的 App，存取自己有權使用的目標服務。選擇容易判斷結果的頁面，確認是否能載入實際內容，而不只是顯示先前快取的標題。若目標服務需要登入，也要區分帳號權限問題與網路連線問題；登入遭拒並不代表代理連線一定失敗。
使用設定（Config）時，請確認目前設定檔是否讓該目標套用預期策略。如需進一步確認，可參考 App 內可用的連線記錄，查看目標與處理策略是否相符；記錄內容以目前介面顯示為準，無須尋找特定顏色或圖示。若目標符合 DIRECT，即使頁面順利開啟，也不能據此證明該次存取是由所選代理伺服器處理。
若 Proxy 下可以存取、Config 下卻不行，請先返回 Config 檢查目前啟用的檔案與規則，不要立刻重新匯入訂閱。若 Connectivity Test 有結果，但目標仍無法存取，請接著檢查目標服務狀態、協定所需欄位及 DNS 等因素。這兩種結果並不矛盾，因為測試要求與實際存取的目標及流程可能不同。
完成後簡單記錄：使用哪種基本網路、選了哪台伺服器、Global Routing 模式、Connectivity Test 的結果，以及目標存取時的現象。只需記下方便自己辨認的名稱，請勿附上密碼或完整訂閱連結。接著手動中斷連線，再確認基本網路是否恢復正常，以便清楚比較操作前後的差異。
所選伺服器、路由模式與目標存取結果彼此吻合，才算完成這次首次連線驗證。之後更換訂閱、伺服器或設定檔時，也可重複這組檢查，無須重新修改所有設定。
[Diagnostics]步驟 05 · 逐步縮小排查範圍
常見問題與自我檢查順序
先找出問題發生在哪個步驟，再修改相應設定。每次只變更一項因素，修改後都回到相同目標重新驗證，並保留結果以便比較。
訂閱儲存後清單為空或解析失敗
返回訂閱編輯頁檢查 URL，確認它不是服務商網站的登入頁、說明頁或單筆分享連結。檢查複製時是否漏掉查詢參數，以及網址是否已變更或失效。若 App 顯示與回傳內容相關的提示，請保留提示文字並確認自己現有訂閱的狀態。不要公開貼出網址請他人測試，其中的 token 可能直接代表存取權限。
更新失敗時不必立刻刪除現有群組。先確認原有記錄是否仍在，再判斷是更新要求失敗，還是更新後的內容確實有所變動。若沒有備份，請避免反覆刪除再新增，以免原始資訊與調整記錄一併遺失。
伺服器已出現，但測試失敗
先中斷連線，確認 Wi-Fi 或行動網路本身能正常存取一般服務；若網路需要登入網頁確認，請先完成網路連線。接著返回 Add Server，依照原始資料檢查協定、位址、連接埠與驗證欄位。手動填寫時，特別留意尾端空格、大小寫及容易混淆的字元，不要只比對備註名稱。
如果協定需要 TLS 或 SNI，請依現有資料檢查相關設定。伺服器位址與用於驗證的名稱可能各有用途，不能只因字串不同就自行改成相同內容。請勿關閉憑證驗證來掩蓋問題；應先確認參數、裝置時間與伺服器端狀態。
開關無法維持開啟
先確認系統是否已允許 VPN 設定，以及 App 是否顯示明確錯誤。確認目前確實選取了一台伺服器，並檢查是否有其他正在使用的網路設定影響操作。先中斷已知的衝突連線再重試；不要刪除用途不明的裝置設定，也不要把重新購買 App 當成排查步驟。
連線後只有部分目標無法存取
先檢查 Global Routing。若為 Direct，目前並未使用預期的代理路徑；若為 Config，請確認目標是否符合不同策略，再以 Proxy 進行一次可控的對照測試。若只有特定 App 無法使用而瀏覽器正常，請繼續檢查該 App 的帳號狀態、快取及目標服務可用性，不要因此判定整組訂閱都無法使用。
若需進一步分析 DNS、規則順序與協定欄位，請參閱訂閱與伺服器管理手冊。在本教學階段不建議同時修改 DNS、規則、伺服器與自動連線選項，否則即使恢復存取，也難以確認是哪項修改發揮作用。
整理檢查結果後再繼續調整
完成檢查後，將結果歸納為匯入、路由、系統授權或目標存取其中一個階段。若要向自己的服務商確認資訊，只需提供失敗時間、網路類型、協定類型及已移除敏感資訊的錯誤提示；請移除完整訂閱 URL、密碼、UUID、分享連結與 QR Code，也要留意截圖中可能出現的個人資訊。
後續重新操作時，可從第一步匯入檢查開始；若伺服器記錄已正確儲存，則直接從Global Routing 選擇繼續。每個步驟都有可確認的結果，比反覆重建所有設定更容易找出真正的問題所在。