Shadowrocket 使用教學：
匯入、連線與驗證
以 iPhone / iPad 介面為例，透過五個步驟將既有訂閱或伺服器資訊加入用戶端，再檢查連線與規則是否如預期運作。初次設定先完成一條連線，其他設定等驗證通過後再調整。
操作前先分辨資料類型：訂閱連結用於取得一組伺服器資訊；單一節點連結、QR Code 或參數表用於新增一台伺服器；規則設定則決定如何處理流量。這三類資料不能只因為都是連結，就填入同一個欄位。
新增伺服器 / 匯入訂閱
開啟 Shadowrocket，進入 Home。初次使用時，先不要開啟連線開關，而是點選右上角的加號進入 Add Server。接著依手邊資料選擇一種新增方式即可，不需要為了完成教學而重複匯入同一份資料。訂閱、單一伺服器與設定檔各有不同用途，選對入口比反覆嘗試儲存更重要。
已有訂閱連結：選擇 Subscribe
- 在 Add Server 中開啟 Type，選擇 Subscribe，返回填寫頁面。
- 在 URL 中貼上向自己的服務商取得的完整訂閱連結。可在 Remarks 中填寫容易辨識的名稱，不要將密碼或連結中的私人內容寫進名稱。
- 檢查連結前後是否多出空格、換行或聊天內容，再點選右上角的儲存。返回 Home，等待訂閱內容載入；若未取得內容，再更新該訂閱。
- 展開訂閱群組，確認其中已出現伺服器項目，再點選一個項目作為這次連線使用的伺服器。
訂閱連結通常包含個人存取憑證，應視為敏感資訊妥善保存。複製時請複製完整連結，而不是只複製頁面上縮短顯示的文字；也不要將連結提交給不明的解析頁面。若匯入後只看到群組名稱卻沒有伺服器，表示尚未取得可用項目，此時開啟連線開關無法補齊缺少的資料，應先檢查訂閱內容與更新結果。
已有單一伺服器：依協定填寫 Add Server
如果手邊有伺服器位址、連接埠與驗證參數，請在 Type 中選擇資料註明的協定，例如 Shadowsocks、VMess、VLESS 或 Trojan，再逐項填寫。位址欄填入主機名稱或 IP 位址，連接埠填入連接埠欄；不要將整條分享連結當作位址。驗證資訊、傳輸方式與 TLS 相關選項必須符合原始資料，不能只因為協定名稱相同就沿用另一台伺服器的設定。
如果資料還提供傳輸路徑、主機名稱或伺服器名稱，請填入對應欄位。是否需要啟用某個選項，取決於伺服器的實際設定，而不是教學中是否提到這個選項。儲存後返回 Home，點選剛新增的項目；如需修正參數，請從該項目的編輯入口返回檢查，避免連續新增多個相似名稱後選錯目標。
若有 QR Code，可使用 Scan QR Code 掃描，再檢查辨識出的協定與參數後儲存。無論使用哪一種入口，本步驟的完成標準都相同：Home 中有伺服器項目，且已明確選取這次要使用的伺服器。不確定協定欄位時，先查閱概念速查，不要隨意切換選項來試錯。
選擇 Global Routing 模式
新增伺服器後，仍需決定哪些連線使用它。在 Home 點開 Global Routing，可以看到設定(Config)、代理(Proxy)、直連(Direct)三種模式。這裡選擇的是流量處理方式，不是再次選擇伺服器，也不會自動修正上一階段填錯的位址或驗證資訊。
| 模式 | 作用與使用情境 |
|---|---|
| 設定(Config) | 依目前設定中的規則分流，連線可以使用代理、直連或其他設定策略。適合需要依規則處理流量的日常使用。 |
| 代理(Proxy) | 將可代理的流量交由所選代理策略處理。適合短時間進行對照測試，不能據此判定 Config 中的每一條規則都正確。 |
| 直連(Direct) | 直接連線，不透過所選代理伺服器轉送。適合檢查原始網路存取情況，不適合作為驗證代理伺服器是否生效的模式。 |
日常依規則使用時，選擇設定(Config)，接著進入底部的 Config 頁面，確認目前啟用的是自己準備使用的設定。Config 頁面與 Global Routing 中的同名選項彼此相關，但不是同一個操作位置：前者管理設定檔，後者決定目前是否依設定執行。
不要將「訂閱匯入成功」理解為「規則設定也已完成」。訂閱主要用於更新伺服器資訊，設定檔則描述規則、策略與相關設定。目前設定中的規則通常依序比對；若某個網域先符合直連規則，即使已選好伺服器，該連線也可能不會經過代理。因此，稍後驗證時應一併查看規則命中結果，而不是要求所有頁面的表現完全一致。
這次先保留既有、可信且了解用途的設定，不要在初次連線時同時調整 DNS、複雜策略群組與多條規則。需要了解 DOMAIN-SUFFIX、GEOIP、FINAL 等關鍵字時，請繼續閱讀代理模式說明；本頁先完成「已選取伺服器、已確認 Global Routing」的基本設定，再進入連線步驟。
開啟 Home 連線開關
返回 Home，先確認伺服器清單中的目前選取項目沒有變更，再確認 Global Routing 是剛才設定的模式。接著開啟頂端的連線開關。第一次啟用時，iPhone / iPad 會顯示新增 VPN 設定的系統提示；閱讀提示後選擇允許，並依系統要求使用裝置密碼或生物辨識完成驗證。這裡要求的是裝置授權，不是伺服器密碼。
- 讓 Shadowrocket 保持在前景，開啟連線開關，等待系統提示出現。
- 完成系統授權後返回 App，查看開關是否維持開啟，以及 App 顯示的連線狀態是否已建立。
- 若先前取消授權，再次嘗試連線並完成提示；若裝置受管理、限制新增 VPN 設定，應先檢查裝置管理規則。
- 建立連線後先保持目前的伺服器與模式不變，進入下一步測試，暫時不要啟用其他自動連線設定。
系統顯示 VPN 狀態，表示裝置已啟用相應的網路設定，並不能直接證明遠端伺服器可連線，也不保證每一筆流量都會經過代理。伺服器驗證失敗、遠端無法連線或規則指向直連，都可能發生在開關已開啟時。因此，本步驟只確認授權與本機連線狀態，實際可用性需要透過下一步的測試與實際連線共同判斷。
如果開關剛開啟就關閉，先記錄 App 顯示的提示，再檢查系統授權、目前設定是否可用，以及是否有其他 VPN 連線正在接管網路。不要快速連續切換開關；每次切換後留出時間等待狀態變更。對於受管理的裝置，不要自行刪除用途不明的管理設定，應先確認裝置的使用要求。
On Demand 用於依條件觸發連線，並非初次連線的必要步驟。先以手動方式確認可以正常使用，再考慮是否需要按需連線。初次驗證時增加自動重新連線條件，可能導致連線在檢查時自行恢復，反而不容易判斷某次變化是來自手動操作還是自動觸發。
Connectivity Test 與生效驗證
返回 Home，使用 Connectivity Test 測試清單中的伺服器。查看目前選取的伺服器是否回傳結果，或顯示逾時、失敗。測試有助於判斷目前網路環境中的回應情況，但某種測試方式有回應，不代表驗證、規則、DNS 與所有目標網站都已正常；單次逾時也不能單獨證明參數一定錯誤。
接著切換至瀏覽器，開啟要驗證的頁面，等待完整載入一次，再嘗試重新整理。不要只查看先前已開啟的頁面，因為頁面可能來自快取，既有連線也可能沿用切換前的處理方式。為減少干擾，這次只測試少數明確目標；不要同時切換 Wi-Fi、伺服器、模式與瀏覽器設定，否則出現差異後很難找出原因。
若要驗證設定(Config)中的分流，請進入 Data 查看相關連線記錄，留意目標網域、命中的規則及最後使用的策略。若記錄中尚未顯示所需資訊，可在測試前確認相關記錄功能已啟用，再重新送出請求。頁面可以開啟，但記錄顯示直連，只能證明這次直連成功，不能作為所選代理伺服器已參與轉送的證據。
需要進行對照時，可以先記下設定(Config)的結果，短暫切換至代理(Proxy)，對同一個目標重新建立請求，再比較結果；檢查完成後恢復原先準備使用的模式。若代理(Proxy)可用而設定(Config)異常，優先檢查規則命中與設定中的策略指向，而不是立即刪除伺服器重新新增。若兩種模式都失敗，則應先檢查網路與伺服器參數。
完成驗證後，可以保留簡短記錄：使用哪台伺服器、哪種網路、哪種 Global Routing 模式，以及哪個目標成功或失敗。之後出現異常時，先與這份已通過的狀態比較，通常比從頭修改所有設定更容易找出變動之處。
常見問題與檢查順序
遇到問題時，先判斷問題發生在匯入、測試、授權還是實際連線階段。上一階段尚未完成，就先處理上一階段的問題；例如清單仍是空白時，不需要繼續修改 Global Routing。每次只變更一個條件，重新執行同一項測試，記錄變化後再決定是否保留修改。
訂閱無法匯入，或更新後清單空白
先檢查複製的內容是否為完整訂閱連結，有沒有缺少查詢參數、被通訊軟體截斷或多出標點。接著確認目前網路可以取得訂閱內容，而且自己的服務仍然有效。可以在瀏覽器開啟的帳戶管理頁面，不一定就是可匯入的訂閱；若回傳的是登入頁面或錯誤提示，用戶端無法將它當成伺服器清單。資料類型不清楚時，請向自己的服務商確認所提供連結的用途。
更新失敗後不要立即刪除既有訂閱，先確認舊項目是否仍在，並保留能說明錯誤的文字提示。反覆新增同一份訂閱可能產生重複群組，無法解決原連結回傳內容錯誤的問題。訂閱恢復正常後再更新一次，確認新的伺服器項目確實已載入。
已顯示伺服器，但 Connectivity Test 逾時
先在未連線代理時確認本機網路本身可用，再核對伺服器位址、連接埠與協定。手動新增的項目尤其要檢查驗證資訊是否完整，以及 TLS、傳輸方式與相關名稱是否符合原始資料。如果訂閱中還有其他自己可用的項目，可以在保持網路與測試方式不變時換一台測試，以分辨是單一伺服器異常還是目前網路整體異常。
測試逾時可能與遠端狀態、網路路徑或測試目標有關，不宜只憑一次結果下結論。可以稍後重試，或在允許的情況下切換本機網路進行對照，但不要將關閉必要的安全驗證當成通用處理方式。
連線顯示已開啟，頁面仍無法正常瀏覽
首先檢查是否誤選直連(Direct)，接著確認 Config 中啟用的設定是否符合預期。如果只有部分目標異常，查看該目標命中了哪條規則，是否被分配至不同策略。若網域無法連線而其他連線正常，再檢查目前設定的 DNS；不要一開始就同時更換所有 DNS 位址，以免失去原本可用的條件。
如果同一個目標在代理(Proxy)下可用、在設定(Config)下失敗，先檢查規則與策略。若所有目標都異常，則重新檢查伺服器狀態與連線授權。若問題只發生在某個瀏覽器或 App，也應確認問題是否僅限於該 App，避免將 App 本身的登入、快取或權限問題都歸因於代理連線。
修正後重新完成一次驗證
修改參數並儲存後，視需要中斷連線並重新連線，讓新的請求使用目前設定。接著執行 Connectivity Test，重新瀏覽先前無法連線的目標，最後檢查記錄中的策略。不要只因為某項錯誤暫時消失就結束檢查；原先的問題情境也恢復正常，才能確認這次修改有效。
仍無法找出原因時，可以整理裝置系統、使用的網路、發生問題的步驟，以及已移除敏感資訊的提示文字，再查閱常見問題。介面用語與規則含義請參閱概念速查；iPhone / iPad 的商店地區、購買與已購項目回復問題請參閱App Store 指南。這些問題與伺服器參數屬於不同層面，應分別處理。