官方手冊 · 首次使用
Shadowrocket 使用教學
匯入現有訂閱 → Global Routing → 連線授權 → 實際驗證
依照五個步驟完成基本連線，再根據驗證結果調整設定。建議先保留預設值，只修改目前步驟需要的項目，避免同時變更多個選項而難以找出原因。
- 備妥訂閱或單一伺服器資訊
- 連線前確認本機網路可用
- 每次只修改一項，再重新驗證
步驟 01 · 匯入連線資料
Add Server 新增與匯入訂閱
訂閱連結與單一伺服器參數是兩種不同的資料形式。先確認手邊是哪一種，再選擇相應的入口，不需要兩種方式都操作。
使用現有訂閱連結
開啟 Shadowrocket，進入 Home，點選 Add Server；部分介面也可透過頂端的新增按鈕進入。在 Add Server 中點選 Type，選擇 Subscribe，再將完整的現有訂閱連結貼到相應的 URL 欄位。訂閱連結請向你的服務商取得，請勿將服務商網站的登入頁、訂單頁或說明頁網址當成訂閱網址。
貼上後檢查連結開頭與結尾，尤其留意複製時帶入的空格、換行、引號和省略號。訂閱網址中問號後方的內容可能用於驗證，請勿自行依外觀刪減。填入方便辨識的備註並儲存，等待用戶端讀取訂閱。接著返回 Home，確認清單中出現伺服器項目，再選取其中一台作為本次測試對象。
首次匯入完成後，請勿連續重複新增同一個連結。若清單沒有變化，先查看是否出現讀取失敗提示；若已出現項目，只要選取伺服器並繼續下一步即可。重新整理訂閱是再次取得伺服器資料，不代表代理連線已建立，也不代表設定檔中的規則已啟用。
使用單一伺服器資訊
如果取得的是位址、連接埠、驗證資訊與協定參數，請在 Add Server 的 Type 中選擇資料所註明的協定，再逐項填寫。Host 填入伺服器網域或 IP 位址，Port 填入連接埠。所選協定需要 Password、Method 或其他驗證欄位時，請依原始資料填寫；不同協定的欄位各異，請勿將一種協定的參數套用到另一種協定。
截圖中的 Password 與 Method 是該頁面所示類型的欄位範例，不代表每種類型都需要填寫。若資料還提供 TLS、SNI、傳輸方式或路徑，也應一併核對，請勿只憑位址和連接埠猜測設定。若缺少參數，向你的服務商確認完整資訊，比反覆修改用戶端選項更容易找出問題。
如果資料是 QR Code，可使用 Scan QR Code 讀取，並依系統提示授予所需權限；Import from Cloud JSON 用於相應的 JSON 資料，並非一般訂閱連結的通用替代入口。無論採用哪種匯入方式，儲存前都應檢查辨識出的類型、位址和連接埠。完成後返回 Home，確認 SERVER 清單中已有目標項目，再進入模式選擇。
步驟 02 · 確認請求處理方式
Global Routing 三種模式
選擇模式前，先分清楚「使用哪台伺服器」和「哪些請求使用代理」。前者由伺服器選擇決定，後者則由模式與設定決定。
在 Home 點選 Global Routing，查看目前選取的模式。這裡可依設定檔(Config)／代理(Proxy)／直連(Direct)理解：它們控制請求的處理方式，並非三組不同的伺服器。切換模式後返回 Home，再次確認顯示的選項，避免以為已完成修改，實際上仍停留在原本的設定。
設定檔(Config)：依目前規則處理
日常需要依規則分流時，請使用 Config。用戶端會根據目前啟用設定檔中的規則，將不同請求交由相應策略處理。因此，選擇 Config 前，請前往 Config 頁面確認要使用的設定檔已啟用。只有伺服器清單不代表已有適用的規則檔；訂閱與設定檔的用途不同，匯入訂閱也不一定會取代目前的規則。
官方截圖展示的是設定檔編輯頁，可看到 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 等區段。首次連線不需要逐段修改，也不需要為了一般連線啟用額外的解密功能。若開啟 Rule 或使用 Add Rule，請先了解規則條件與順序，避免範圍過廣的規則蓋過後面的精確規則。
例如 DOMAIN-SUFFIX,example.com,PROXY 表示依網域後綴比對，並交由指定策略處理；這只是語法說明，不是需要照抄的完整設定。看到請求走 DIRECT，不一定代表連線失敗，也可能是目前規則的預期結果。進一步了解規則類型、策略引用與比對順序，請參閱代理模式與規則說明。
代理(Proxy)與直連(Direct)：用於比較
Proxy 可用於檢查所選伺服器的代理連線，降低規則分流對本次測試的影響；但仍不能取代實際連線驗證，也不表示裝置上的所有流量類型都能一概處理。Direct 可作為直連對照，協助判斷本機網路原本是否可用，不能將它當成代理已生效的證據。
若暫時不確定設定是否正確，可先選擇 Proxy 進行基本連線測試，確認伺服器可用後再切回 Config。每次切換都記錄目前選項，並使用相同的目標比較結果。接著保留本次要測試的模式，返回 Home 開啟連線開關。
步驟 03 · 建立連線
Home 開關與首次授權
完成匯入與建立連線是兩個階段。先選取伺服器，再確認 Global Routing，最後才開啟頂端開關。
返回 Home，在 SERVER 群組中選取本次要使用的伺服器。若清單中有多個項目，請勿只看訂閱群組名稱，還要確認實際選取了一台伺服器。接著檢查 Global Routing 是否仍是上一步選定的選項，再點選頂端顯示 Not Connected 的連線開關。
首次建立連線時，系統會詢問是否允許新增 VPN 設定檔。確認操作來自目前使用的 Shadowrocket 後，依系統提示允許，並完成裝置密碼或其他身分驗證。這是系統授權流程，不是在 App 內新增伺服器，也不需要重新貼上訂閱。完成後返回 Shadowrocket，觀察連線狀態是否維持，不要立刻連續開關多次。
若取消首次授權提示，可返回 App 再次開啟開關，並依提示完成授權。若裝置由學校或公司管理，系統政策可能會限制 VPN 設定檔，請先確認裝置允許使用這類連線；不要反覆刪除不熟悉的裝置管理項目。若已有其他 VPN 連線，請先中斷目前的連線再測試，以免系統切換連線時影響判斷。
開關維持開啟，表示用戶端連線流程已啟動或建立，但不能證明目標網站一定能連線。伺服器失效、驗證參數錯誤、DNS 解析異常或設定策略不符合預期，都可能造成「開關已開啟，頁面卻無法開啟」的情況。因此完成授權後，下一步必須進行實際連線驗證。
首次測試時，先維持目前的 Wi-Fi 或行動網路，不要同時更換網路、伺服器與模式。需要測試另一台伺服器時，先記錄原本的結果，再切換並重複相同的檢查。如此才能判斷變化來自哪個項目，而不是只得到「有時可以使用」的模糊結論。
步驟 04 · 檢查實際請求
Connectivity Test 與連線驗證
驗證時要同時查看連線測試、實際頁面與規則結果，不能只根據單一數值或頂端狀態下結論。
先測試，再造訪相同目標
在 Home 執行 Connectivity Test，觀察目前伺服器是否能完成所選測試。測試結果反映的是相應測試方式下的回應，不等同於網頁下載速度，也不保證所有網站或 App 都能正常連線。若發生逾時，先記錄測試方式與目前網路，不要立即判定所有伺服器都已失效。
接著開啟瀏覽器，造訪已知可用的 HTTPS 頁面，檢查是否能完成載入，而不只是出現標題或快取內容。可重新載入頁面，或使用新的瀏覽器分頁，減少舊快取造成的干擾。若只有某個 App 異常，先用瀏覽器造訪同類目標進行比較，不要直接重設所有設定。
在 Config 下確認規則去向
使用 Config 時，進入 Data 查看可用的請求記錄，搭配目標網域、命中規則與策略資訊核對結果；不同版本的顯示位置可能略有差異，請以目前介面為準。預期直連的請求使用 DIRECT 是正常情況；預期使用代理的請求卻命中直連策略時，才需要檢查目前設定檔是否啟用，以及規則是否被較前面的項目覆蓋。
若切換至 Proxy 後能造訪同一個目標，但在 Config 下失敗，應優先檢查設定與規則，不必重新匯入已可用的伺服器。反過來說，若兩種模式都失敗，請先檢查伺服器參數、本機網路與伺服器端狀態。比較時維持相同伺服器與網路，一次只切換模式，結果才有參考價值。
完成一輪驗證後，將日常需要的模式恢復為 Config，再造訪一次目標確認結果。只需記錄「網路類型、伺服器備註、模式、現象」，不要為了回報問題而公開完整訂閱連結、驗證欄位或包含這些內容的截圖。若結果不如預期，請依下方的現象分支繼續檢查。
步驟 05 · 保留有效設定再排除問題
常見問題檢查順序
先判斷問題發生在匯入、授權、伺服器連線或規則處理階段，再處理相應層級。
儲存訂閱後沒有伺服器
返回該訂閱項目，檢查 Type 是否為 Subscribe、連結是否完整，以及目前網路能否連線至訂閱服務。一般網頁連結不能當成訂閱資料讀取，缺少驗證參數也可能導致回傳內容不正確。請勿將完整連結貼到公開交流頁面；需要確認有效性時，請向你的服務商確認連結狀態與回傳格式。
若先前可以更新、現在突然失敗，先在相同網路重試一次，再以另一個可用網路進行比較。保留原有項目有助於比對，不建議原因未明時反覆刪除並重新建立。匯入成功後仍須選取伺服器並開啟連線；重新整理本身不會完成後續步驟。
開關無法開啟或開啟後自動關閉
先確認是否已完成系統授權，再檢查裝置是否有連線限制，或目前是否使用其他 VPN。出現明確系統提示時，記下提示原文會比反覆點選開關更有幫助。尚未完成首次授權前，請勿修改 DNS 或規則，因為這些變更通常無法解決授權階段的問題。
開關已開啟但測試逾時
依序核對伺服器類型、位址、連接埠與驗證欄位，再檢查 TLS 或傳輸參數。在相同網路測試另一台現有伺服器，有助於判斷是單一伺服器問題還是本機網路問題。若切換網路後結果不同，應進一步檢查網路環境；若同一台伺服器在不同網路下都失敗，再向你的服務商確認伺服器狀態。
只檢查 Settings 中的相關項目
進入 Settings，查看 Test Method，了解目前 Connectivity Test 使用的測試方式；若某種測試逾時但實際網頁能開啟，不能只憑測試結果判定連線無法使用。Diagnostics 可用於進一步查看診斷資訊，分享記錄前應遮蔽伺服器位址、驗證資訊與訂閱內容。
首次手動連線尚未穩定時，先不要設定複雜的 On Demand 條件。若已啟用，排除問題時可暫時關閉，以減少自動觸發的干擾；連線穩定後再恢復並單獨驗證。截圖中的 Proxy、TCP 與 UDP 是設定分組，不代表排除問題時需要全部調整；盲目修改會增加新的變因。
可以連線，但部分請求仍然失敗
先比較 Proxy 與 Config 對相同目標的結果。若只有 Config 異常，請檢查命中規則與策略；若兩種模式都異常，再檢查 DNS、協定與目標服務。不要因為一個目標失敗就刪除所有伺服器或重新安裝 App。若遇到 DNS、速度、耗電與更新後異常，可繼續閱讀故障排除手冊；需要複查基本步驟時，可返回本教學的新增與匯入步驟。
完成以上步驟後，一輪可供複查的上手流程應包含：儲存資料、選定伺服器、確認模式、完成授權、進行測試並實際造訪。日後更換訂閱或伺服器時，可沿用這套順序；只有在驗證結果明確指向某項設定時，再深入修改相應項目。
