STEP 01 / ADD SERVER
新增伺服器或匯入 Subscribe
開啟 Shadowrocket，進入 Home。這裡可查看現有伺服器、選取目前使用的伺服器及控制連線。首次使用時，先依手上的資料選擇新增方式：可更新伺服器清單的訂閱網址，請使用 Subscribe；若手上有一組位址、連接埠、密碼與協定參數，則手動新增即可。兩種方式擇一，不必為了完成教學重複匯入同一組資料。
已有訂閱連結：選擇 Subscribe
在 Home 點選右上角的新增按鈕，開啟 Add Server。在 Type 中選擇 Subscribe，再將完整訂閱連結貼到 URL。若頁面提供備註欄，可填入方便辨識的名稱。訂閱連結通常包含身分資訊，複製時請勿漏掉問號後的參數，也不要連同網頁標題、說明文字或尾端空白一起貼上。
確認資料無誤後儲存，等待訂閱內容載入完成，再返回 Home 檢查清單。成功的判斷依據不是「已填入網址」，而是清單中出現可選取的伺服器項目。若只看到訂閱群組、沒有伺服器，請先確認內容是否仍在載入、目前網路能否連上訂閱網址，以及連結是否有效。請勿連續重複新增；同一訂閱出現多個群組，容易造成後續選取與更新混淆。
訂閱網址應是服務商提供給 App 使用的網址，而非帳戶登入頁、訂單頁或一般說明頁面。若取得的是網頁而非可辨識的訂閱內容，修改 Global Routing 也無法讓它變成正確的訂閱。請先向服務商取得正確連結，再回到 Add Server 修改 URL。
已有單一伺服器資料：選對協定再填入參數
同樣從 Home 開啟 Add Server，在 Type 中選擇與資料相符的協定，例如 Shadowsocks、VMess、VLESS、Trojan 或 WireGuard。接著依服務商提供的資料填寫。各協定所需欄位不同：連接埠和密碼不能代替 UUID，WireGuard 金鑰也不能填入其他協定的密碼欄位。請勿只憑伺服器名稱猜測協定類型。
若連線需要 TLS，也要確認 TLS、SNI 等相關參數；傳輸方式、路徑與主機名稱也應與原始資料一致。請保留憑證驗證設定，不要把關閉驗證當成一般排錯方式。填寫完成後儲存，返回 Home，點選準備使用的伺服器，並確認選取標記已變更。此時只是完成資料儲存，下一步才會決定請求如何經過這台伺服器。
若服務商提供 QR Code，可在 Home 的新增相關入口使用 Scan QR Code，並依系統提示授予相機權限。匯入後仍須開啟項目，確認協定與位址；辨識成功不代表參數有效，也不表示已建立連線。協定欄位的詳細說明請參閱Settings 設定項目參考與選項手冊。
STEP 02 / GLOBAL ROUTING
選擇 Global Routing 模式
完成匯入後，留在 Home 並開啟 Global Routing。這裡決定 App 如何路由其處理的請求，與「選擇哪台伺服器」是兩項不同操作。切換伺服器不會自動將 Direct 改成 Proxy；匯入訂閱也不代表已啟用合適的規則。首次連線前，請分別確認伺服器選取項目與路由模式。
設定檔 (Config)：依目前規則處理
設定檔 (Config) 適合需要依規則分流的日常使用。請求會依目前設定檔中的規則選擇策略，可能經由 PROXY，也可能採用 DIRECT 或由 REJECT 處理。選擇此模式前，請進入底部的 Config，確認目前啟用哪份設定檔；若有多份檔案，不要只看名稱，還要確認實際選取項目及規則內容。
訂閱與設定檔的用途不同：Subscribe 主要提供伺服器資料，Config 則包含規則與相關設定。清單中有伺服器，不代表 Config 已有符合需求的規則。若服務商另有設定檔說明，請先確認用途再匯入；不了解的遠端設定檔不要直接取代現有檔案。修改前請保留原設定，以便還原。
代理 (Proxy)：先驗證所選伺服器路徑
代理 (Proxy) 會以代理模式路由 App 處理的請求，適合首次測試時減少規則分流造成的判斷變因。選擇 Proxy 後，返回 Home 確認所選伺服器，再進行連線。Proxy 不是用來修改伺服器參數，也無法修復已失效的帳戶或錯誤密碼。
若 Proxy 模式下可以正常瀏覽，但 Config 模式下同一請求失敗，表示兩次請求可能採用了不同策略；接下來應檢查設定檔與命中的規則，而不是立刻刪除伺服器。測試完成後，可依日常需求切回 Config 並再次驗證。一次成功不代表所有規則或目標都已設定正確。
直連 (Direct)：作為基礎網路對照
直連 (Direct) 會以直連模式處理請求，不會透過所選的遠端代理伺服器轉送。這適合與代理路徑互相比較，但不能用來證明伺服器連線正常。即使 Home 已選取伺服器，若 Global Routing 仍是 Direct，開啟連線開關也不能據此判定代理路徑已生效。
這三種模式沒有適用所有情況的固定選擇。首次排查可先用 Proxy 驗證現有伺服器，再切換到 Config 檢查規則行為；Direct 則用來觀察基礎網路。若要深入了解規則順序、FINAL 與 DNS 設定，請繼續閱讀選項手冊；本頁先帶你完成一次可重複的連線驗證。
STEP 03 / VPN
開啟開關並完成 VPN 授權
返回 Home，再次確認目前選取的伺服器與 Global Routing。確認無誤後，開啟頂端的連線開關。首次建立連線時，系統可能詢問是否允許 Shadowrocket 新增 VPN 設定；這是 App 接入系統網路處理功能所需的授權步驟。請先確認提示中顯示的 App 名稱，再依系統指示允許，並完成裝置要求的密碼或生物辨識驗證。
若先前取消授權，App 可能無法維持開關開啟。此時不必重新匯入訂閱，可再次嘗試連線並依提示完成授權。若裝置受組織管理，或系統限制新增 VPN 設定，請先確認裝置管理規定，不要不斷更換伺服器。完成系統授權只代表 App 取得相應權限，不代表遠端伺服器已可使用。
完成授權後返回 Shadowrocket，觀察開關是否維持開啟，以及連線狀態是否穩定。VPN 標示在不同裝置與系統版面上的位置可能不同，不要只以某個圖示是否持續顯示作為判斷依據。接著還要透過 Connectivity Test 與實際瀏覽，確認連線能否傳送請求。
若裝置上另有正在使用的系統 VPN 連線，請先確認目前由哪項設定接管連線，避免將其他連線的狀態誤認為 Shadowrocket 的結果。首次測試期間也請先檢查 On Demand：自動觸發的連線行為可能讓手動開關的狀態不易判讀。先確認目前連線來源，再決定是否調整按需連線條件。
測試結束時，返回 Home 關閉連線開關，並確認狀態已變更。切換 Wi-Fi 與行動網路後，請重新驗證，因為兩種網路連接同一伺服器的狀況可能不同。維持連線、測試有回應、目標頁面載入成功，是三種不同層面的結果，接下來應分別記錄。
STEP 04 / CONNECTIVITY TEST
驗證連線狀態與實際瀏覽結果
在 Home 找到 Connectivity Test 並執行，查看伺服器清單中的測試結果。測試方式可能受目前 Settings 中的相關設定影響，因此應依實際使用的測試方法解讀結果。若回傳時間值，通常表示該測試收到回應；若顯示逾時，則表示此次測試未能在時限內完成，不能直接判定伺服器永久失效。
Connectivity Test 與實際 App 請求並不完全相同。某項探測收到回應，不代表 TLS、驗證、DNS 與目標網站瀏覽都正常；反之，伺服器未回應某種探測，也不一定表示所有網路請求都無法建立。不要只憑延遲數字判定「已成功」，更不能將其視為實際載入速度或穩定性的保證。
使用相同目標進行前後比較
維持 Shadowrocket 連線，開啟瀏覽器瀏覽一個平時能清楚判斷載入結果的頁面，確認內文與必要資源完整顯示，而不只是看到快取的頁面標題。接著開啟新頁面或重新整理內容，避免受到既有快取影響。測試時先固定網路、伺服器與路由模式；一次測試失敗後，不要同時變更多項條件。
若使用 Config，也應透過請求記錄或日誌確認該目標命中的規則與實際策略。頁面能開啟可能是經由 DIRECT，不能只憑「可以瀏覽」就證明流量經過 PROXY。若要驗證代理路徑，可暫時切換到 Proxy，重做相同測試，再切回原模式比較結果。實際記錄入口請以 App 目前顯示為準。
若需確認出口資訊，請使用自己信任的測試目標，並搭配規則記錄判斷。某個目標的出口結果只反映該次請求的路徑，不代表裝置上的每個請求都採用相同路徑。尤其在 Config 模式下，不同網域、位址與 App 請求可能命中不同規則，這正是分流的預期行為。
首次驗證的完成標準：已儲存並選取正確伺服器、確認目前的 Global Routing、系統連線維持開啟，且實際目標請求的結果符合所選策略。建議記下當時的網路類型、伺服器備註與路由模式，日後遇到問題時便能在相同條件下重測，不必憑印象比較。
STEP 05 / CHECKLIST
依問題發生階段排查常見狀況
先判斷問題發生在匯入、連線或瀏覽階段。匯入失敗表示尚未取得伺服器資料，反覆切換 Proxy 並無助於解決；若開關可以開啟但網頁無法載入，也不應優先重新安裝 App。請保留現有項目與設定，每次只變更一項設定，並以相同目標重新測試，才能確認變更造成的影響。
訂閱儲存後沒有伺服器
返回訂閱編輯頁面，檢查 URL 是否完整，特別留意複製時的換行、參數截斷及連結是否過期。確認目前的基礎網路可以取得訂閱內容；若訂閱網址本身無法連線，應先處理連線方式或確認連結是否有效。服務商管理的訂閱狀態與 App 購買狀態彼此獨立，重新購買 App 無法恢復已失效的訂閱。
若原本有伺服器項目，更新後數量減少，請先確認訂閱回傳內容是否變更，以及是否設定了篩選條件，不要立即大量刪除項目。訂閱更新可能覆寫其管理的伺服器參數，手動修改前請先記錄原值。若仍無法確認，請向服務商核對訂閱是否有效；聯絡時請遮蔽連結中的身分參數。
Connectivity Test 逾時或伺服器無法使用
先確認已選取預期使用的伺服器，再核對 Type、位址、連接埠與驗證資訊。若需要 TLS，請檢查 SNI 與相關傳輸參數，避免混用網域、位址與主機欄位。確認 iPhone 或 iPad 的系統日期與時間正確，時間錯誤可能影響憑證驗證。不要任意關閉安全檢查來掩蓋參數問題。
接著在現有伺服器中選擇另一個已知可用的項目，保持路由模式與測試目標不變進行比較；情況允許時，也可切換目前網路後重測。若只有某個網路失敗，應優先確認該網路是否能連到伺服器；若所有網路都失敗，再核對帳戶狀態與伺服器資料。仍須搭配實際網頁瀏覽結果判斷測試結果。
開啟開關後立即關閉
先確認系統 VPN 授權是否完成、是否有其他系統 VPN 正在切換連線，以及裝置管理是否設有限制。接著確認 App 能否正常讀取目前設定。若剛修改過 Config，先還原先前可用的設定，再測試開關。連線無法維持與伺服器回應緩慢是不同問題，不宜混為一談。
若已啟用 On Demand，請檢查其條件是否會在目前網路下自動連線或中斷。首次驗證時應先了解這些條件；必要時可暫時停用自動觸發並記錄變更，完成手動測試後再依需求恢復。反覆點按開關會讓狀態變化更難追蹤，請等目前操作完成後再進行下一步。
部分頁面正常，部分頁面無法載入
先比較 Proxy 與 Config 模式下同一目標的結果。若只有 Config 失敗，請檢查規則順序、命中的策略，以及目標是否被 REJECT；若兩種模式都失敗，再檢查伺服器參數、DNS 與目標本身的狀態。不要一開始就替換整份規則，先找出發生問題的具體請求，避免影響原本正常的部分。
DNS 會影響網域解析方式，路由規則則決定如何處理請求；兩者有所關聯，但不是同一項設定。若遇到網域解析錯誤，請先確認目前設定檔與 Settings 中實際生效的 DNS 設定；不要混合貼上來自不同位置的設定。詳細參數與日誌判讀方式請見選項手冊，本頁僅整理首次連線所需的排查步驟。
排查完成後，返回連線驗證步驟，重做相同檢查。確認可正常使用後，再依日常需求選擇 Config 並逐項調整設定。每次修改都保留可還原的起點，比同時變更伺服器、規則與 DNS 更容易維護。