Shadowrocket 使用教學
從現有資料開始，依序完成匯入、模式選擇與連線驗證。先建立一條可驗證的連線，再調整規則與自動連線條件。
- iPhone / iPad 操作說明
- 五步操作流程
- 官方截圖對照
本頁依首次使用流程編排，不必一次調整所有設定。官方截圖可協助辨認介面位置；實際顯示的欄位會因所選 Type、App 介面及目前設定而異，請以裝置上的畫面為準。訂閱網址、QR Code 與密碼都屬於敏感資料，操作時請勿向他人展示。
STEP 01 / INPUT
新增伺服器與匯入訂閱
先確認手邊資料的類型：用於更新伺服器清單的網址，通常以訂閱方式匯入；包含協定、位址、連接埠與驗證參數的資料，則新增為單一伺服器。兩者的輸入位置不同，請勿將訂閱網址拆成 Host 和 Port，也不要只憑網址外觀猜測 Type。請先確認資料提供者說明的用途與欄位。
已有訂閱連結：選擇 Subscribe
進入 Home，點選 Add Server。在新增頁面開啟 Type，選擇 Subscribe，再於訂閱網址欄位貼上完整連結。複製時請保留查詢參數，不要加入空格、換行或說明文字；部分網址中的參數用於識別訂閱，遺漏內容可能導致更新失敗。名稱可用來辨識來源，不會影響連線方式。
儲存後返回 Home，等待清單載入；若介面提供更新功能，可更新這筆訂閱。判斷是否成功，不是看「網址已儲存」，而是確認 SERVER 分組下出現可選取的伺服器項目。若只看到訂閱名稱，卻沒有伺服器項目，請先檢查更新結果與網址是否完整，再前往本頁的故障環節排查，不要重複新增同一個網址。
已有伺服器資料：依 Type 填寫
若手邊資料是單一伺服器參數，同樣開啟 Add Server，先選擇正確的 Type，再填寫相應欄位。截圖顯示的表單包含 Host / Port / Password / Method；切換協定後，欄位可能有所不同。Host 填入伺服器網域或位址，Port 填入連接埠，驗證資料與加密選項則依現有資料逐項填寫。請勿為了填滿表單而自行補上不存在的參數。
若現有資料以 QR Code 提供，可使用新增頁面底部的 Scan QR Code，依系統提示授權相機；掃描後仍須檢查 Type、位址與連接埠。Import from Cloud JSON 是另一種資料匯入方式，並非適用於所有訂閱連結；僅在現有資料明確適用時使用。儲存後返回 Home，確認項目已出現並選取目標。此時完成的是「新增」，下一步才是選擇連線的路由方式。
STEP 02 / ROUTING
選擇 Global Routing 路由方式
伺服器出現在 Home 後，先不要急著開啟連線開關。點選 Global Routing，確認目前的選項。這裡決定流量如何處理，不是選擇協定，也不是切換伺服器。本教學使用三種寫法：設定檔(Config) / 代理(Proxy) / 直連(Direct)，分別對應介面中的英文選項。
先了解三種選項的用途
設定檔(Config)會依目前設定檔中的規則決定連線策略。部分請求可能使用 DIRECT，其他請求則使用 PROXY，也可能透過 REJECT 拒絕連線。因此，選擇 Config 後，某個頁面能開啟，並不能單獨證明流量經過目前的伺服器；還須參照命中的規則與連線記錄判斷。
代理(Proxy)會以代理路由處理流量，適合首次檢查時用來減少規則分流造成的變數，但實際連線仍受伺服器能力、目標網站及相關設定影響。直連(Direct)使用直連路由，適合對照裝置本身的網路狀態；在 Direct 下連線正常，不代表剛新增的伺服器可用。測試前請記下目前選項，避免切換路由方式後誤判結果。
使用 Config 前先確認設定檔
若要使用 Config，請進入 Config 確認目前使用的設定檔，再查看其中的 Rule。截圖中的 General / Rule / Hosts / URL Rewrite / HTTPS Decryption 是設定檔編輯頁面的不同區段；首次使用只需辨認設定檔與規則，不必為了建立連線而逐一修改。Add Rule 用於新增規則，不是新增伺服器。
訂閱主要用來更新伺服器資料；設定檔則會影響規則及其他連線設定，匯入其中一種不代表另一種也已備妥。若已有設定檔，請先維持原狀；沒有明確的規則需求時，不要直接照抄不熟悉的設定。首次驗證時可記下使用的路由方式，連線成功後再切回需要的 Config 並重新測試。規則順序、策略與協定欄位的深入說明，請參閱技術參考；這裡先完成可重複的連線檢查。
STEP 03 / CONNECT
開啟連線與 VPN 設定授權
返回 Home，確認已在 SERVER 分組中選取要使用的伺服器，再檢查 Global Routing 是否符合前一步的規劃。清單中若有多個項目，請勿只依排列位置判斷目前選取的伺服器；應核對項目名稱與資料，避免誤選舊項目。
點選 Home 頂端的連線開關。首次建立連線時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。此視窗是系統管理網路設定的授權步驟，僅用於授予連線權限，不會替你補上既有伺服器的參數。確認這是剛才主動執行的操作後，依系統提示允許，並完成裝置要求的身分驗證。
授權完成後返回 Shadowrocket，查看頂端狀態是否從 Not Connected 變為已連線。若授權完成但開關仍關閉，請確認目前選取的伺服器後再開啟。若狀態短暫變化後又中斷，先記下當時顯示的訊息；請勿連續切換開關、同時更換伺服器及修改規則，否則難以判斷是哪項變更影響結果。
分別確認連線狀態與實際連線
開關維持開啟，代表系統連線流程已進入相應狀態，但不表示所有目標都能連線。伺服器驗證、DNS 解析、路由策略及目標網站本身都可能影響請求。此時先維持伺服器與模式不變，直接進行下一步，以相同目標完成測試；不要只看頂端狀態或系統 VPN 標示就結束驗證。
若裝置已啟用其他 VPN 設定，請先到系統設定確認目前實際使用的設定，避免連線狀態互相切換。暫時不需要連線時，可返回 Home 關閉開關。之後若發現關閉後又自動連線，請檢查 On Demand 條件，不要誤以為手動開關沒有反應。首次使用時先確認手動連線流程，待連線穩定後再設定自動化功能。
STEP 04 / CHECK
驗證連線與規則是否生效
驗證時應分別確認三件事：伺服器是否回應測試、實際頁面能否連線，以及請求是否依預期策略處理。三者彼此相關，但不能互相取代。維持剛才選擇的伺服器與 Global Routing 不變，在 Home 點選 Connectivity Test，先確認測試能否完成，再進行實際連線。
測試結果會受測試方法與測試目標影響。個別項目出現測試結果，表示該項測試收到回應，不代表所有 App、網域或 UDP 請求都正常；若發生逾時，也應先確認測試條件，不能因此推斷訂閱中的所有伺服器都已失效。若需修改 Test Method，請先記下原設定，再使用相同方法比較，避免直接比較不同測試條件下的結果。
以實際請求確認連線結果
切換至瀏覽器，開啟一個熟悉且通常可以正常連線的頁面，確認主要內容已載入，而不只是顯示頁面標題或快取內容。接著測試實際需要使用的 App。若某個頁面正常、另一個卻失敗，先將問題範圍縮小至特定目標，不必立即刪除訂閱或重設所有設定。必要時重新整理頁面或重新送出請求，以觀察新的連線。
返回 Shadowrocket，在 Data 查看可用的連線記錄，核對剛才存取的目標及相關策略資訊。使用設定檔(Config)時，請確認結果是否符合規則預期：應直連的請求是否使用 DIRECT，應經代理的請求是否使用 PROXY。若出現 REJECT，請先檢查對應規則，不要立即更換伺服器。記錄頁面所提供的資訊，請以 App 畫面顯示為準。
完整驗證後，應能清楚說明「使用哪台伺服器、選擇哪種路由方式、存取哪個目標、結果如何」。確認這四項後，再逐一恢復日常所需的規則或 On Demand；每調整一項，就重複相同的連線測試。如此即使之後發生問題，也能回到上一個已驗證的狀態。不要只用速度測試數字概括整體使用情況，實際體驗還取決於請求類型與當下網路狀況。
STEP 05 / DIAGNOSE
依失敗環節逐項排查
從最早發生問題的步驟開始排查。若清單尚未匯入，先檢查資料；若伺服器已出現但無法連線，再檢查參數與授權。每次只修改一項，並記錄修改前後的結果。不要一開始就重新安裝 App，這會增加還原本機資料與設定的工作，也可能讓有用的排查線索消失。
儲存成功，但 SERVER 清單為空
先回到訂閱項目，確認 Type 是否為 Subscribe、網址是否完整，以及是否誤把一般網頁網址當成訂閱網址。接著確認裝置目前的網路能否連線至該網址，並查看更新時顯示的訊息。訂閱可提供哪些項目、驗證是否有效，取決於該訂閱所對應的服務狀態；必要時請向資料提供者確認。請勿在公開提問或截圖中附上完整訂閱網址。
項目已存在，但無法建立連線
逐一核對 Type、Host、Port 與驗證欄位，特別留意複製時混入的空格及大小寫錯誤。有些協定還需要設定傳輸或 TLS 參數，請以現有伺服器資料為準，不能只填寫看起來熟悉的欄位。接著確認系統 VPN 授權已完成，且目前選取的伺服器正確；確認參數與授權後，再執行相同的 Connectivity Test。
已連線，但部分請求失敗
先確認 Global Routing。直連(Direct)無法驗證代理伺服器；使用設定檔(Config)時，則應查看命中的規則與策略。若測試目的明確，可暫時切換至代理(Proxy)，對同一目標重新測試，以區分規則影響與伺服器連線問題；測試後請恢復原選項。若只有特定網域失敗，再檢查相關 DNS 與連線記錄，不要一次修改所有 DNS 項目。
需要進一步檢查 Settings 時
進入 Settings，先確認 Test Method / On Demand / Diagnostics。Test Method 會影響測試方式，On Demand 會影響自動連線條件，Diagnostics 則用於進一步診斷；這些設定用途不同，不應當作通用的修復開關。若手動中斷後又自動連線，優先檢查 On Demand；若測試結果與實際使用情況不同，先檢查 Test Method。
截圖也顯示 Proxy / TCP / UDP 等設定分組。首次使用不必逐項修改，尤其不要為了排查單一頁面而批次調整傳輸設定。整理問題時，只需保留必要資訊：問題發生在哪個步驟、使用的 Type、Global Routing 選項、測試方式及顯示訊息。隱藏密碼、訂閱參數與其他個人資料後，再利用診斷資訊定位問題。
若問題仍未解決，可前往疑難排解依問題類別繼續檢查；若要了解協定欄位、設定檔及技術取捨，請參閱技術參考。連線驗證成功後，保留目前可用的設定，再逐步加入規則與自動連線需求，避免一次引入多項尚未驗證的變更。
