Shadowrocket訂閱匯入與連線步驟
依照「新增 → 選擇模式 → 連線 → 驗證」的順序完成首次設定。先確認每個步驟的結果，再進行下一步；發生異常時，不必把所有設定重新調整一遍。
閱讀順序：有訂閱連結，從 Subscribe 開始；只有單一伺服器參數，直接查看 Add Server；已完成匯入，可跳至 Global Routing。
STEP 01 · 新增現有資訊
Subscribe 匯入與 Add Server
先確認手上的資料是訂閱連結，還是單一伺服器的連線參數。訂閱通常對應一組由服務供應商維護的伺服器，更新後清單可能會變動；單一伺服器資訊則需要逐項儲存。兩種方式不必重複操作，以免同一台伺服器出現多筆記錄，後續測試時難以辨認。
使用 Subscribe 匯入訂閱連結
進入 Home，點選 Add Server 或右上角的新增入口，開啟 Add Server 頁面。點選 Type，選擇 Subscribe，再將向你的服務供應商取得的完整連結貼到 URL。Remark 可用來填寫方便自己辨認的名稱，不需要填入帳號密碼。確認後使用頁面上的儲存按鈕返回 Home，等待訂閱取得完成。
連結應從開頭到末尾完整複製，尤其要留意查詢參數中的字元。不要將服務供應商網頁網址、說明文字或換行一併貼到 URL。以下僅為格式範例，不能用來連線，也不需要在瀏覽器中開啟。
https://example.com/sub?token=xxxx儲存後查看 SERVER 分組，確認訂閱下是否出現伺服器記錄。只有訂閱名稱、沒有伺服器，不代表匯入完成；先檢查是否顯示取得錯誤，再向服務供應商確認連結是否有效、是否需要特定的訂閱格式。連結尚未成功取得時，不要反覆切換 Global Routing，路由模式無法修復訂閱下載問題。
使用 Add Server 填寫單一伺服器
如果取得的是單一伺服器參數，請在 Type 中選擇與資料相符的協定，再填寫 Host、Port 及該協定要求的驗證資訊。截圖中的 Password、Method 對應目前選取的類型；切換為 VMess、VLESS 或 Trojan 後，欄位可能不同。不要為了讓表單看起來和截圖相同而更動協定，位址、連接埠、密碼和其他參數都應以服務供應商提供的資料為準。
填寫完成後再核對一次：Host 不應包含說明文字，Port 應與伺服器提供的連接埠一致，密碼前後不要多出空格。若資料包含 TLS、伺服器名稱或傳輸參數，也應依原值填寫。缺少必要欄位時，先補齊資訊，不要猜測數值後儲存。
Scan QR Code 掃描新增
已有伺服器 QR Code 時，可使用 Scan QR Code 讀取，並在系統詢問時允許相機權限。掃描後仍需核對辨識出的 Type、Host 和 Port，再儲存記錄。QR Code 可能包含完整驗證資訊，不宜公開分享。Import from Cloud JSON 是另一種匯入入口，只有持有相符格式的資料時才使用，不要將一般訂閱 URL 隨意填入其中。
本步完成標準：Home 的 SERVER 分組中已出現可選擇的伺服器。接著先確認流量處理方式，再開啟連線開關。
STEP 02 · 確認流量處理方式
Global Routing 三種模式
Global Routing 決定請求的處理方式，伺服器清單則決定代理請求使用哪台伺服器。這是兩項不同的設定。返回 Home，點選 Global Routing 查看目前的選擇；日常希望依規則分流時，使用配置(Config)，並接著確認 Config 中目前使用的設定檔。
配置(Config)：依規則判斷
配置(Config)依目前的設定檔處理請求。進入 Config，確認使用的是預期檔案，再開啟查看內容。官方截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同的設定區段；初次使用時，優先檢查 Rule，不必為了完成連線而同時修改其他區段，也不必啟用 HTTPS Decryption。
在 Rule 中，規則通常依序比對，符合後執行對應策略。以下範例表示 example.com 及其子網域使用 PROXY，最後一行則處理先前未符合的請求。這是用來說明語法的片段，不能直接取代現有的完整設定檔；實際設定還需要相應策略及其他必要內容。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,PROXYPROXY、DIRECT、REJECT 代表不同的處理策略，不能將它們當成伺服器位址。新增規則時，應確認目標策略在設定中有效，並留意規則位置。透過 Add Rule 新增規則後，如果它位於已涵蓋該請求的規則之後，就可能沒有機會比對。先了解現有規則，再做最小範圍的修改。
代理(Proxy)與直連(Direct)：用於明確對照
代理(Proxy)會讓請求依此模式經由代理處理，適合暫時檢查所選伺服器是否可用；直連(Direct)用於直連對照，不代表已透過代理。若 Proxy 下瀏覽正常、Config 下只有特定頁面異常，應優先檢查規則與策略，而不是立即刪除伺服器。測試結束後，回到日常需要的模式，避免忘記暫時選擇的模式。
本步完成標準：能說明目前選擇的是配置(Config)、代理(Proxy)還是直連(Direct)，並知道 Config 使用哪個檔案。更完整的規則原理請參閱Rule 分流說明；遇到複雜異常再前往故障排除，本頁則繼續完成首次連線。
STEP 03 · 連線與系統授權
在 Home 選擇伺服器並連線
返回 Home，在 SERVER 分組中點選一台現有伺服器，確認選取標記位於預期記錄上。若有多個訂閱分組，先核對分組名稱，避免選到先前匯入的舊記錄。首次測試只使用一台伺服器，暫時不要頻繁切換，以便將後續測試結果與特定設定對應。
再次查看 Global Routing，然後開啟 Home 頂端的連線開關。首次連線時，系統會詢問是否允許新增 VPN 設定。閱讀提示後允許，並依裝置要求完成密碼或身分驗證。這個步驟是在系統中建立連線所需的設定，不是匯入伺服器，也不會自動補齊訂閱資訊。
授權後返回 Shadowrocket，查看頂端是否仍顯示 Not Connected，以及開關是否維持開啟。如果仍未連線，先確認是否出現明確的權限或設定錯誤提示，不要只憑系統狀態列是否出現 VPN 標示來判斷。若先前拒絕授權，重新發起連線並完成系統提示；若沒有再次出現提示，可在系統設定的 VPN 項目中確認設定狀態。
如果裝置上有其他正在建立通道的網路工具，應先結束相關連線，再單獨測試 Shadowrocket。由公司或學校管理的裝置可能限制 VPN 設定；遇到管理限制時，應聯絡裝置管理員，不要反覆刪除系統管理項目。刪除現有 VPN 設定前，也應確認它屬於哪項服務。
連線開關維持開啟，表示系統連線流程已繼續進行，但不能據此斷定所選伺服器可用。連線狀態、伺服器可連線性、目標頁面能否瀏覽，是三項需要分別確認的結果。下一步執行 Connectivity Test，再透過實際瀏覽進行驗證，不要只停留在「開關已開啟」這個階段。
本步完成標準：已選定伺服器、完成必要授權，且 Home 的連線狀態不再停留於未連線。若開關立即關閉，請直接查看本頁的故障排查。
STEP 04 · 檢查實際結果
Connectivity Test 與生效驗證
先在 Home 執行 Connectivity Test，查看此次測試是否完成。測試結果反映目前測試方法與目標下的連線情況，不代表所有網站都能瀏覽，也不能單憑某個數字判斷實際瀏覽速度。如果測試逾時，先記下目前使用的伺服器、Global Routing 與網路環境，其他條件保持不變，再進行對照。
接著切換至瀏覽器，開啟自己平日使用且有權限瀏覽的頁面，檢查頁面文字、圖片與必要操作是否正常。只開啟已快取的頁面不足以驗證目前連線，可重新整理頁面或換一個可正常使用的頁面再次測試。若瀏覽器正常、某個應用程式無法使用，應將問題範圍縮小至該應用程式、目標網域與規則，不要直接判定整體連線失效。
分別確認「能否瀏覽」與「是否依預期分流」
使用配置(Config)時，即使某個頁面能正常開啟，也可能是 DIRECT 規則正在生效。若要確認分流，可搭配目前 Config 中該網域對應的規則與應用程式內的連線記錄，查看實際使用的策略；再確認所選伺服器。不要為了證明「所有請求都走代理」而刪除所有已正常運作的直連規則，分流本來就允許不同請求使用不同路徑。
若 Config 下結果異常，可暫時切換至代理(Proxy)，保持相同伺服器與測試目標再試一次。Proxy 正常而 Config 異常時，通常應從規則比對、策略引用及相關設定繼續定位；兩種模式都異常，則先檢查伺服器參數和基本網路。切換至直連(Direct)可用於確認基本瀏覽狀況，完成對照後請恢復原本的模式。
本步完成標準：實際瀏覽結果符合預期，並能說明目前請求使用規則或暫時代理模式。完成後保留有效設定；不要讓為了排查而暫時修改的模式、測試方法或規則處於不明狀態。
STEP 05 · 依失敗步驟排查
常見故障與 Settings 檢查
從最早失敗的步驟開始排查。訂閱尚未成功取得，就先處理訂閱；開關無法維持開啟，就先處理授權；只有部分頁面異常，再檢查規則與目標。以下流程只處理初次使用的常見情況；若遇到持續 DNS 異常、耗電或更新後發生的問題，請前往故障排除總覽繼續定位。
已儲存訂閱，但 SERVER 中沒有記錄
返回訂閱編輯頁確認 URL，確定沒有漏掉參數、混入空格或複製成服務供應商的網頁入口。再檢查裝置目前的網路是否正常。訂閱取得失敗與伺服器連線失敗是兩個階段；前者不應透過隨意修改 Host 或 Port 處理。如果連結已失效或回傳內容格式不符，請向你的服務供應商取得有效連結後再更新，不要公開傳送完整 URL。
連線開關關閉，或系統提示權限問題
先返回 Home 重試一次，留意系統是否正在等待新增 VPN 設定的授權；再檢查系統 VPN 設定中是否有衝突或裝置管理限制。若誤拒絕權限，重新進行授權流程即可，不必先重新安裝。若確實需要重新安裝，請先妥善保存自己的伺服器資訊與設定，避免排查過程中遺失尚未備份的內容。
開關已開啟，但 Connectivity Test 逾時
確認目前選取的伺服器是否仍有效，再依原始資料核對 Type、Host、Port、驗證資訊與 TLS 參數。接著保持伺服器不變，改用其他可用的基本網路進行測試，區分網路環境與伺服器本身的問題。Settings 中的 Test Method 會影響測試方式，因此不同方法的結果不宜直接比較；測試失敗時也應搭配實際瀏覽結果判斷。
只有部分頁面異常，或規則未依預期生效
先檢查 Global Routing 是否確實設為配置(Config)，再確認目前的設定檔。查看目標是否被較前面的 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 等規則涵蓋，並檢查最終策略。若頁面主要文字正常、部分資源載入失敗，相關資源可能使用其他網域，應依據連線記錄定位，不要只根據瀏覽器網址列中的單一網域判斷所有請求。
如何處理 On Demand 與 Diagnostics
Settings 中的 On Demand 可依設定條件觸發連線。首次手動連線尚未驗證成功前，請先讓觸發條件保持簡單，不要依賴自動連線取代基本測試。若發生意外自動重新連線，再確認 On Demand 條件。Diagnostics 可用於進一步收集線索，但不要看到 Proxy、TCP、UDP 等設定就逐一嘗試修改；保留原值，只針對已確認的症狀調整。
需要向服務供應商描述問題時，提供失敗步驟、錯誤提示和已完成的對照即可。診斷記錄、QR Code、訂閱 URL 可能包含伺服器位址、驗證資訊或個人瀏覽記錄，分享前應隱藏敏感內容。不要將包含完整憑證的截圖作為公開求助資料。
排查結束：將 Global Routing 恢復為日常使用模式，再執行一次生效驗證。若問題仍然存在，保留可重現問題的最小條件，前往詳細文件依症狀繼續排查，不必從匯入步驟全部重做。
