Shadowrocket入門指南與連線驗證
依照「匯入資料 → 選擇路由 → 啟用連線 → 驗證結果 → 找出問題」的順序操作。本頁適用於 iPhone、iPad，帶你先完成一次可重現的連線，再調整日常設定。
截圖取自 App Store 官方素材，供辨認介面位置。欄位會因所選 Type 與 App 介面而異；操作時請以裝置上的英文介面詞和實際提示為準。
STEP 01 / IMPORT
Add Server / Subscribe：匯入現有資料
開啟 Shadowrocket 的 Home，先找到下方的 SERVER 區塊與 Add Server。這裡要分辨兩類資料：訂閱連結是用來取得及更新一組伺服器項目的網址；單一伺服器資料則包含連線至某部伺服器所需的協定與參數。兩者的輸入位置不同，請勿將訂閱網址當成 Host，也不要將一般說明網頁當作訂閱網址匯入。
已有訂閱連結：使用 Subscribe
在 Home 點選 Add Server，進入新增頁面後點選 Type，選擇 Subscribe。將自己持有的完整訂閱連結輸入相應的 URL 欄位，再儲存。貼上前後請檢查連結是否被通訊 App 截斷，或混入換行、前後空白；連結中的查詢參數通常是網址的一部分，請勿自行猜測並刪除。訂閱網址可能包含存取憑證，應只保存在自己的裝置中，勿貼到公開留言或截圖裡。
完成儲存與資料取得後，返回 Home 檢查 SERVER 是否出現預期項目。如果只看到訂閱記錄，卻沒有伺服器，請先查看是否有更新錯誤，不要反覆開啟連線開關。訂閱取得失敗發生在「取得資料」階段，與之後伺服器能否連線是兩回事。請先確認網址有效且目前網路可存取該網址，再使用訂閱項目中的更新功能重試。
已有伺服器參數：依 Type 逐項填寫
如果取得的是單一伺服器資料，一樣從 Add Server 進入，但 Type 必須與資料中的協定相符。接著填寫 Host、Port，以及該 Type 所需的驗證與傳輸欄位。官方截圖展示的是其中一種參數表單，不代表每種 Type 都使用 Password、Method 這組欄位；請勿為了與截圖一致而更改協定。Host 通常填入資料提供的主機名稱或位址，Port 填入相應連接埠；大小寫有別的驗證資料請完整保留。
若已有適用的 QR Code，可使用 Scan QR Code 匯入，再開啟產生的項目逐項確認。Import from Cloud JSON 僅適用於格式相符的現有資料，並非通用的訂閱連結匯入入口。無論採用哪種方式，儲存後都應返回 Home，確認項目名稱與參數相符，並選取這次準備測試的伺服器。名稱只是識別標籤，不能取代實際參數確認。
STEP 02 / ROUTING
Global Routing：選擇設定檔、代理或直連
匯入資料後，返回 Home 點選 Global Routing。這裡的選擇決定請求採用哪種處理模式，而不是更換伺服器。三個選項分別是設定檔 (Config)、代理 (Proxy) 與直連 (Direct)。初次使用時，不要只記住「應該開啟」哪個選項；請先確認這次驗證要排除哪些因素，再選擇相應模式。
| 模式 | 處理方式 | 入門使用方式 |
|---|---|---|
| 設定檔 (Config) | 依目前設定檔中的規則決定請求的去向。 | 確認目前規則設定有效後，用於日常分流。 |
| 代理 (Proxy) | 以代理模式處理由用戶端接管的請求。 | 用於暫時比較測試，降低規則選擇對結果的影響。 |
| 直連 (Direct) | 以直連模式處理請求，通常不會使用所選代理伺服器作為出口。 | 檢查目標服務在目前網路中的直連情形。 |
準備使用設定檔 (Config) 時，進入 Config，先確認目前使用哪個設定檔，再查看其中的 Rule。Config 頁面中的檔案選取與編輯內容，比檔名本身更能反映實際行為：相同檔名的檔案也可能包含不同規則。截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定檔編輯區段；入門操作只需確認目前設定檔與 Rule，不必逐項啟用或修改其他區段。
規則通常依序由上而下比對，符合後便採用該條規則指定的策略。以下兩行僅供辨認格式，並非可直接取代現有檔案的完整設定。第一行會將範例網域及其子網域交由 PROXY 處理；最後一行則是未符合前述規則時的後備處理方式。實際結果仍取決於整份設定檔及其策略定義。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT如果暫時不清楚現有規則的來源與作用，可以先記下原本的選項，再暫時切換至代理 (Proxy) 進行連線比較。如果同一部伺服器在 Proxy 下可以連線，但在 Config 下無法連線至某個目標，請優先檢查規則比對結果與目標策略，而非立刻刪除伺服器。直連 (Direct) 也不是「自動選擇最快伺服器」；它適合用來建立直連基準，不能用來證明代理出口有效。
第一次連線不需要隨意點選 Add Rule，也不必啟用 HTTPS Decryption。先保留現有設定，完成後續驗證，再依明確需求修改規則。各項功能的使用範圍可繼續參閱功能介紹；若要重新操作，可返回Global Routing 選擇步驟逐項確認。
STEP 03 / CONNECT
Home：開啟連線並完成 VPN 設定授權
選好模式後返回 Home，依序確認三處：SERVER 中目前選取的伺服器、Global Routing 的目前選項，以及頂端的連線狀態。截圖中的 Not Connected 表示尚未連線。先確認前兩項無誤，再開啟頂端的連線開關，發生錯誤時才能確認這次實際測試的條件。
首次連線時，系統可能會提示是否允許 Shadowrocket 新增 VPN 設定。這是 App 建立系統網路連線所需的授權流程，不代表訂閱已成功匯入，也不表示遠端伺服器已可使用。確認提示是由剛才操作的 Shadowrocket 發起後，依系統畫面選擇允許，並按照裝置要求完成身分驗證。授權完成後返回 Home，查看連線狀態是否改變。
如果先前選擇了不允許，請返回 App 重新發起連線，再處理系統提示；不要快速連續切換開關。如果提示沒有再次出現，或剛開啟連線就立刻中斷，可前往系統設定中的 VPN 相關頁面，確認是否有相應設定，再參考 App 的錯誤訊息判斷。若裝置由組織管理，部分網路設定可能受到管理政策限制，請先確認裝置是否允許進行這類設定。
iPad 上的操作順序同樣是「選擇伺服器、確認模式、開啟連線、完成系統授權」。螢幕尺寸或系統介面配置可能不同，但請依 Home、Global Routing 等介面詞尋找位置，不必照著截圖逐像素尋找。系統需求與相容性仍以 App Store 頁面標示為準。
連線期間先稍候片刻，觀察狀態是否能穩定維持。如果開關隨即關閉，請記下完整提示；如果開關保持開啟，也不要因此認定所有請求都已如預期處理。系統 VPN 標示只代表系統網路連線處於相應狀態，不能單獨證明伺服器驗證、網域解析與目標服務連線都成功。下一步應綜合 App 狀態與實際連線結果判斷。
STEP 04 / VERIFY
Connectivity Test：分辨可連線與實際使用效果
返回 Home 使用 Connectivity Test，查看目前伺服器在所選測試方式下的結果。測試有結果，表示相應探測收到回應；測試逾時，則表示這次探測未能在指定時間內完成。兩者都不能直接等同於「所有 App 都可使用」或「伺服器一定失效」。不同 Test Method 檢查的連線環節可能不同，因此比較前後結果時，應使用相同的測試方式。
接著開啟 Safari，前往自己有權使用且已知運作正常的目標頁面。除了確認首頁能否顯示，也要檢查必要的頁面資源是否載入，以及登入或服務操作是否正常。如果頁面先前已開啟，請重新載入，避免只依快取內容判斷。某個頁面可以連線，只代表該次請求路徑有效，不能據此保證其他網域、協定或 App 也能使用。
在設定檔 (Config) 下驗證時，先確認目標應走 PROXY 還是 DIRECT。設定檔允許部分請求直連是正常情況，不能因某項服務仍使用原本的網路出口，就直接認定 App 沒有生效。如果只對單一目標有疑問，可維持伺服器與網路不變，暫時切換至代理 (Proxy) 重試，記錄兩種模式的差異；測試完成後，恢復適合日常使用的設定。
也可以建立直連比較：先記錄中斷連線時目標的狀況，再於連線後重試。比較期間不要同時切換 Wi-Fi 與行動網路，也不要更換伺服器，否則無法確認變化來自哪個步驟。為減少背景請求干擾，驗證時只操作少數明確的頁面。若涉及登入、付款或敏感服務，請以該服務本身的提示為準，不要用網路測試結果判斷帳號狀態。
- 先記錄連線狀態：Home 是否維持連線，是否出現明確錯誤。
- 再記錄測試條件：所選伺服器、Global Routing、Test Method，以及使用 Wi-Fi 或行動網路。
- 最後記錄連線結果：目標是否開啟、問題發生在載入或登入階段，以及切換 Config 與 Proxy 後有何差異。
完成本步的標準不是看到某個延遲數字，而是連線能穩定維持，且預期使用的目標在相同條件下可以重複連線。如果測試有結果但實際連線失敗，請保留這項差異，進入下一步依問題發生環節排查；不要為了降低數字而連續修改協定參數。
STEP 05 / CHECK
Settings：從問題發生環節開始排查
先將問題歸類到具體環節，再修改設定。訂閱未更新出項目、Connectivity Test 逾時、連線開關無法維持，或只有特定服務無法開啟，分別需要不同的檢查方式。每次只修改一項，再重做相同測試；確認沒有改善後，還原原值再進行下一項。相較於同時更換網路、模式與參數，這樣更容易得出明確結論。
資料取得失敗：先檢查訂閱，不要先改路由
如果 SERVER 中沒有預期項目，請返回訂閱記錄，確認網址是否完整、存取憑證是否仍有效，以及更新時顯示了什麼錯誤。確認訂閱是否需要特定的目前網路環境，並向提供你現有資料的一方確認格式與有效狀態。不要將訂閱網址貼到公開頁面，也不要透過不斷新增重複訂閱來掩蓋錯誤。成功取得資料後，再測試個別伺服器。
測試逾時或連線失敗：先檢查參數與目前網路
逐項確認 Type、Host、Port 與驗證資料，特別留意貼上時帶入的空白、連接埠填錯或協定選擇不符。如果資料包含額外的傳輸或 TLS 參數，請逐項對照原始說明，不要任意停用驗證。接著檢查裝置日期、時間與時區是否正確，避免系統時間異常影響安全連線。
前往 Settings 查看 Test Method，確認比較的是相同的探測方式。某種探測逾時但實際連線正常時，不要只因逾時就刪除項目；反之，探測有回應但實際連線失敗，也應繼續檢查驗證、傳輸與目標路徑。必要時在其他條件不變的情況下，分別測試 Wi-Fi 與行動網路，判斷差異是否與網路連線方式有關。
只有部分請求失敗：透過模式比較找出規則問題
同一部伺服器在代理 (Proxy) 下正常、在設定檔 (Config) 下異常時，請優先返回 Config 檢查目前檔案與 Rule。留意是否符合了 DIRECT、REJECT，或引用了與預期不同的策略。不要只在檔案末尾新增規則，就認為它會覆蓋先前已符合的規則；規則順序會影響結果。暫時無法判斷時，請保留原設定，先記下目標網域與兩種模式下的狀況。
連線狀態反覆變化：檢查 On Demand 與診斷資訊
如果手動中斷後又自動重新連線，或切換網路時狀態反覆變化，請前往 Settings 檢查 On Demand 是否已有觸發條件。測試手動連線時，先記錄這些條件，並視需要暫時停用，再觀察相同情況是否仍會發生。初次排查時不要任意修改 Proxy、TCP、UDP 等區段中的進階選項；這些選項並非連線失敗時必須一律啟用的清單。
若要進一步找出問題，可查看 Settings 中的 Diagnostics，並保留問題發生時間附近的相關資訊。分享診斷內容前，請遮蔽訂閱連結、驗證資料、個人位址及其他敏感欄位，只提供重現問題所需的錯誤提示與條件。遇到逾時可繼續閱讀節點逾時與連線失敗檢查順序；系統授權問題可參閱新增 VPN 設定提示說明。
