第一步：使用 Add Server 新增，或透過 Subscribe 匯入
先確認手上的資料類型。訂閱連結可取得一組伺服器項目，通常由原服務提供者更新；單一伺服器資料則包含協定、位址、連接埠和認證欄位。無須重複新增，依照自己持有的資料選擇其中一種方式即可。開始前請確認原始資料完整，尤其不要把網頁介紹頁面的網址當成訂閱連結，也不要混淆設定檔網址與伺服器訂閱網址。
已有訂閱連結：選擇 Subscribe
開啟 Shadowrocket，進入 Home，點選新增按鈕進入 Add Server。在類型選單中找到 Subscribe，將完整的既有訂閱連結填入 URL，並為這組資料設定容易辨識的名稱，接著儲存。返回 Home 後等待取得資料，確認訂閱群組下方出現伺服器項目。如果只看到訂閱名稱，尚未出現項目，請先確認資料是否已載入完成，再開啟連線開關。
複製連結時請保留問號後的參數，不要加入引號、空格或換行。部分連結包含個人存取憑證，請只在自己的裝置上使用，不要在公開截圖或問題描述中貼出完整連結。儲存後若出現錯誤，請返回編輯頁面並比對原始連結；重複建立相同訂閱無法修正網址錯誤，反而容易造成後續選擇混淆。需要更新訂閱內容時，請更新既有訂閱，再確認結果是否有變化。
已有伺服器資料：依實際協定填寫
若取得的是單一伺服器資料，請在 Add Server 中選擇相符的協定類型，再填寫位址、連接埠和對應的認證欄位。例如 Shadowsocks、VMess、VLESS、Trojan 的認證資料各不相同，不能只因位址相似就套用其他協定。若資料包含 TLS 或其他傳輸參數，也須核對相關欄位；所有欄位都應依原始資料填寫，不要自行猜測補上。
伺服器位址請填入該欄位要求的主機名稱或位址，連接埠則填入連接埠欄位。使用者名稱、密碼、UUID、TLS 名稱各有用途，不可互相替代。若資料以 QR Code 提供，可使用 Scan QR Code 掃描；匯入後仍須開啟項目，核對類型與重要欄位，確認資料完整後再儲存。QR Code 和訂閱連結也可能包含憑證，請勿公開展示。
新增完成後返回 Home，在 SERVER 清單中選取這次要使用的項目。請注意「項目已儲存」和「項目已選取」並不相同：清單中有多台伺服器時，後續連線應使用明確選取的那一台。記下該項目的名稱，下一步切換 Global Routing 與驗證結果時都使用同一台伺服器，避免同時變更多項條件。
第二步：選擇 Global Routing 模式
新增並選取伺服器後，在 Home 開啟 Global Routing。這項設定會決定請求整體採用哪種處理方式，不會替使用者補齊伺服器資料。首次連線時尤其需要確認此處設定：即使伺服器資料正確，若請求採用不同模式，實際結果仍可能不如預期。本教學以配置(Config) / 代理(Proxy) / 直連(Direct)標示三種模式，請依裝置上的英文介面選項辨識。
| 模式 | 請求處理方式 | 首次使用時的用途 |
|---|---|---|
| 配置(Config) | 依目前生效的設定檔與規則決定策略。 | 驗證既有設定檔的分流結果。 |
| 代理(Proxy) | 以代理方式處理請求；系統與 App 的特定例外仍須依實際設定判斷。 | 先驗證所選伺服器的代理路徑。 |
| 直連(Direct) | 直接連線至目標，不以所選伺服器的代理轉送結果作為驗證依據。 | 對照本機網路的直接連線狀況。 |
如果手上只有伺服器訂閱，尚未準備好規則設定檔，可以先選擇代理(Proxy)進行一次受控測試。這樣能暫時減少規則選擇造成的變因，但不代表所有 App 和系統請求都會以完全相同的方式處理。測試時仍應指定明確的目標頁面，並綜合實際連線情況與連線記錄判斷，不能只看模式名稱就推斷某次請求已經經過伺服器。
準備使用配置(Config)時，請先進入 Config，確認目前實際生效的是哪個設定檔。Global Routing 中的 Config 是路由模式，底部的 Config 頁面則是設定檔管理入口，兩者彼此相關，但不是同一項操作。匯入伺服器訂閱不代表已切換規則設定檔；若分流結果不如預期，應確認目前生效的檔案，而非反覆新增伺服器。
規則通常依序比對，符合條件後便採用相應策略。排查時先掌握這項原則即可，首次連線前不必編輯完整規則。若要了解 PROXY、DIRECT、REJECT 與 FINAL，請參閱規則與設定參考逐項確認。選好模式後返回 Home，確認伺服器仍是剛才選取的項目，再進行下一步開啟連線。
第三步：開啟連線開關並完成系統授權
現在確認三個條件：Home 中有可用的伺服器項目、已選取這次要使用的項目，且 Global Routing 模式與剛才選定的一致。確認後開啟 Home 的連線開關。首次在此裝置建立連線時，系統可能會顯示新增 VPN 設定檔的授權提示；這是建立系統網路連線設定的步驟，與透過 Subscribe 取得伺服器清單是兩回事。
閱讀系統提示，確認提示是由剛才在 Shadowrocket 中的操作觸發，再選擇允許，並依系統要求完成裝置驗證。系統授權完成後返回 App，查看連線開關與狀態是否維持在已連線。如果先前取消提示，請重新發起連線並完成授權；連續點按開關無法取代尚未完成的系統確認。
如果開關開啟後很快又關閉，請先留意 App 或系統顯示的錯誤訊息。此時應優先檢查設定檔是否成功建立、是否有其他網路連線設定正在接管，以及裝置管理政策是否限制相關操作。尚未記錄狀況前，不要刪除所有設定；先正常關閉其他正在使用的連線，再單獨測試 Shadowrocket，可減少狀態切換造成的干擾。
系統顯示 VPN 已連線，只能表示相關網路連線設定正在運作，不能單獨證明遠端伺服器認證成功，也不代表每個網頁都能開啟。完成這個步驟後，還需驗證目標請求。尤其使用配置(Config)時，部分目標依規則走 DIRECT 可能是預期結果，不應直接認定為「開關沒有生效」。
首次排查期間，請先使用手動開關控制連線，暫時不要同時調整 On Demand。按需連線會依條件影響連線建立或恢復；若尚未了解這些條件，可能會誤以為關閉後又重新連線是操作失敗。先完成下一步的穩定驗證，再依實際使用情境閱讀On Demand 功能說明。要結束本次測試時，返回 Home 關閉連線開關，並確認狀態已更新。
第四步：使用 Connectivity Test 並驗證實際連線
建立連線後，先執行 Connectivity Test，記錄是否有結果及錯誤提示，再開啟 Safari，瀏覽已知可正常連線的頁面。測試與實際瀏覽是兩項不同檢查：前者反映指定測試方式與目標的結果，後者則涉及目標網域解析、連線、TLS 和頁面資源載入。測試出現數值不代表所有目標都能連線；單次逾時也不足以判定所有請求都無法完成。
先建立可重複的對照條件
選擇一個明確的頁面，記錄使用的網路、伺服器和 Global Routing 模式。等待頁面載入完成後，再重新整理一次或開啟另一個已知可正常連線的頁面，確認結果能否重現。測試期間不要同時更新訂閱、切換伺服器和修改 DNS，否則結果改變後將難以找出原因。若要比較 Wi-Fi 與行動網路，請先記錄目前網路的結果，再只切換網路條件重新測試。
若代理(Proxy)模式下可正常瀏覽，而配置(Config)模式下同一個目標異常，請保持伺服器不變，優先檢查目前的設定檔與規則命中情況。反之，若兩種模式都無法正常連線，請繼續確認伺服器資料、遠端服務狀態與本機網路，而非先重寫整份規則。直連(Direct)可用來對照本機連線狀況，但直連成功不代表代理路徑也可正常使用。
依個別請求核對結果，不要只看整體狀態
若要確認特定目標使用了哪種策略，請開啟 App 內的連線記錄，依目標網域或位址尋找這次請求，並查看顯示的策略、規則或錯誤訊息。不同版本的記錄入口與欄位可能不同，請以實際介面為準。先發出一個明確的新請求，再查看相應記錄，會比從大量歷史記錄中推測更容易比對。
看到 DIRECT 時，先確認是否符合目前規則；看到 REJECT 時，先查看是否命中預期的封鎖規則；使用 PROXY 時，再確認所選伺服器與連線結果。網頁可能同時請求多個網域，因此主頁面成功開啟，不代表圖片、登入或其他資源也都正常載入。若只有部分內容失敗，請記錄失敗資源所屬的網域，不要直接判定整個網站都無法使用。
驗證通過後，再將 Global Routing 調整為日常需要的模式。若使用配置(Config)，請保留已驗證的伺服器與設定檔，之後每次只修改一項設定。至此首次連線流程已完成；若仍有異常，請依下一節從最接近問題發生的位置開始排查。
第五步：依照問題發生的位置排查
先釐清「在哪個步驟失敗」，再處理相應設定。訂閱未取得內容、連線開關無法維持開啟、測試逾時、網頁只載入部分內容，是四種不同情況。若一律歸類為「連不上」，很容易反覆修改原本正確的欄位。以下從本機網路開始依序縮小範圍；每完成一項檢查，都使用相同目標重新測試。
訂閱匯入失敗或清單沒有項目
先確認裝置已連上可正常使用的網路；若目前連線使網路狀態難以判斷，可先正常關閉 Shadowrocket，再測試基本網頁瀏覽。接著檢查訂閱連結是否完整、是否仍在有效期限內，以及回傳內容是否為可辨識的訂閱資料。能開啟網頁，只表示該網頁可連線，不代表訂閱網址一定會回傳正確內容。
確認連結來自自己的原始資料，且未包含複製時附帶的說明文字。如果服務提供者更換了連結，請更新對應訂閱的 URL，不要一直重新整理舊網址。更新後確認群組下方實際出現的項目，再選取伺服器；如果取得資料的步驟已經失敗，接著切換 Global Routing 通常無法解決問題。
伺服器已新增，但認證或測試失敗
開啟目前選取的項目，逐一核對協定類型、位址、連接埠、認證欄位，以及 TLS 和傳輸設定。特別留意密碼尾端是否多了空格、UUID 是否完整，以及 TLS 名稱是否填在正確欄位。修改顯示名稱不會改變連線參數，重新命名也無法解決認證錯誤。
若同一份既有資料中還有明確可用的其他項目，可只切換伺服器進行比對，並保持其他設定不變。若多個項目都失敗，再檢查本機網路是否變動，以及原服務提供者提供的狀態資訊。不要為了通過測試而隨意關閉憑證驗證；請先核對裝置時間、目標名稱與原始 TLS 設定是否一致。
已連線且測試有結果，但網頁無法開啟
此時先分辨是網域解析失敗、連線逾時，還是規則拒絕。查看目前設定檔中的 DNS 設定是否為原本打算使用的內容，再搭配連線記錄找出具體網域。若只有單一網域無法開啟，其他頁面正常，不應立即判定整體連線失效；若多個網域都無法解析，請優先檢查 DNS 路徑與目前的網路條件。
不要一次加入多個來源不明的 DNS 位址。先記錄原有設定，還原為自己確認可用的值，重新發出請求，再比較結果。如果代理(Proxy)正常而配置(Config)異常，請確認是否有規則將該目標導向 DIRECT 或 REJECT，以及 FINAL 是否符合預期地作為預設策略。詳細設定與症狀分類請參閱DNS 與連線問題排解。
修改後更難判斷：還原至最近一次正常狀態
保留原始訂閱資料與可用設定檔的副本，撤銷剛才單獨變更的項目，再重新測試。更新訂閱可能改變伺服器清單，切換設定檔可能改變策略，切換網路也可能影響解析；依變更順序逐項核對，比直接重新安裝 App 更有助於找出原因。若確實需要重新取得 App，請依App Store 已購項目復原說明操作，不要把重新安裝當成通用的網路修復方式。
完整的首次連線驗證，應確認四件事：伺服器資料已正確儲存並選取、路由模式符合本次用途、系統連線已建立，以及實際目標請求的結果可以合理解釋。完成這些檢查後，再逐步加入按需連線或更細緻的分流設定；之後若遇到變化，也能依相同順序重新檢查。