Shadowrocket 使用教學
從現有連線資訊開始，依序完成匯入、選擇模式、連線與驗證。
本頁主要介紹 iPhone、iPad 上的操作。截圖取自 App Store 官方素材；實際項目位置與可用選項請以 App 內顯示為準。首次設定時先完成一條連線，再逐步調整規則與自動連線設定。
01 新增伺服器或匯入訂閱
先確認輸入的是單一伺服器參數，還是用來更新清單的訂閱網址。
開啟 Shadowrocket 後進入 Home，在 SERVER 區段附近找到 Add Server，也可以使用頁面上的新增入口。先不要開啟頂端的連線開關；此時最重要的是正確儲存連線資料。單一分享連結、訂閱網址和設定檔用途不同，不能只因為都是一段文字就使用同一個入口。
已有伺服器參數：使用 Add Server
進入 Add Server 後，先選擇 Type。Type 應與現有資訊中的協定相符，例如 Shadowsocks、VMess、VLESS 或 Trojan；不要只憑名稱相似就猜選。選定後，頁面會依協定顯示相應欄位。請依原始資料填寫 Host、Port，以及該協定要求的驗證資訊。截圖顯示的是包含 Password 與 Method 的其中一種表單，不代表所有 Type 都使用相同欄位。
逐項核對時，Host 只填資料指定的伺服器位址，不要把整個網頁網址誤填進去；Port 請照原值填寫，不要自行更改。Password、Method，以及其他協定可能使用的傳輸或安全設定，都應與原始資料一致。若資料未提供選填欄位，請先保留預設值，不要拼湊其他協定的範例。完成後使用頁面上的儲存功能，返回 Home，確認 SERVER 中已出現新增項目。
已有訂閱網址：選擇 Subscribe
若持有可更新伺服器清單的訂閱網址，請在 Add Server 中將 Type 設為 Subscribe，再將完整網址填入對應的 URL 欄位，確認後儲存並等待讀取。請保留網址中的所有查詢參數，複製時留意開頭、結尾及是否不慎混入空格。訂閱網址通常包含存取憑證，應妥善保管如同密碼，不要貼到公開留言或截圖中。伺服器訂閱用來取得或更新伺服器清單，並不等同於 Config 中的規則設定檔。
若資料以 QR Code 提供，可使用 Scan QR Code 掃描；只有持有相應格式內容時才使用 Import from Cloud JSON。辨識成功後仍須核對 Type 與重要欄位，不能把「讀取到文字」當成「參數已正確」。匯入後請確認清單中確實出現項目，並選取這次要測試的伺服器。若清單為空，請先至排查問題確認網址與讀取結果，不必繼續切換連線開關。
02 選擇 Global Routing
伺服器決定連線目的地，Global Routing 則決定請求採用哪種處理方式。
選好伺服器後，返回 Home 並點選 Global Routing。這裡的選擇與 SERVER 清單中的選擇並非同一回事：選取伺服器不代表每個請求都會使用它。首次操作時，先了解三種模式，再決定這次要驗證什麼，可減少「明明已連線，結果卻和預期不同」的誤判。
設定檔 (Config)：依目前設定檔處理
設定檔 (Config) 依目前設定檔中的規則決定請求的去向。規則可能將部分請求交由 PROXY 處理，部分交由 DIRECT 處理，也可能透過 REJECT 拒絕特定連線。因此，使用 Config 時看到某個請求直接連線，不一定代表設定失效，也可能正好符合規則。進入底部的 Config 頁面，確認目前使用的設定檔；開啟檔案檢視時，可依 General、Rule、Hosts、URL Rewrite 等區段檢查相關內容。
截圖顯示的是設定檔編輯頁面，其中 Add Rule 可用來新增規則。首次連線不必立即編寫大量規則：請先確認設定檔的來源與內容，並儲存可還原的副本，再考慮修改。不了解用途時，不應整份覆蓋應用程式中既有的設定檔。尤其要檢查 Rule 的比對順序及最後的 FINAL；否則只看單一規則的名稱，很難判斷實際請求會採用哪種策略。
代理 (Proxy) 與直連 (Direct)：用於明確比對
代理 (Proxy) 會將全域路由切換為代理模式，適合暫時排除規則分流對測試結果的影響；但無法修正錯誤的伺服器位址、驗證資訊或傳輸參數。直連 (Direct) 採用直接連線模式，不能用來驗證代理伺服器是否正常。理解這兩種模式時，都應考量目前的網路環境，不要把它們當成提升連線成功率的固定開關。
若已有明確可用的規則設定檔，日常使用可選擇 Config；若要判斷新新增的伺服器是否可用，可暫時使用 Proxy 進行比對。測試完成後，請返回 Global Routing 並恢復所需模式。更多規則類型、PROXY／DIRECT／REJECT 策略與首條命中邏輯，請參閱規則手冊；本頁將繼續介紹首次連線，不深入說明複雜的規則編輯。
03 開啟連線並完成授權
先選取伺服器，再處理系統提示，最後確認應用程式內的連線狀態。
返回 Home，確認 SERVER 中目前選取的是剛才準備使用的項目，再檢查 Global Routing。若訂閱中有多個項目，首次驗證只使用其中一個參數完整且已知的項目，記下名稱即可，不必在多個項目之間快速切換。如此一來，發生問題時才能判斷自己是在檢查同一條連線，還是測試條件已經改變。
開啟 Home 頂端的連線開關。未連線時，頁面可能顯示 Not Connected；開啟後請觀察實際狀態是否改變，而非只看手指是否碰到開關。首次使用時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。這是應用程式透過系統網路延伸功能處理連線所需的授權步驟，不是購買確認，也不會補上缺少的伺服器資訊。
確認彈出視窗中的應用程式名稱後，依系統提示完成允許操作與裝置驗證。若先前取消授權，請返回應用程式重新發起連線，並依系統畫面提示處理。不要為了略過提示而修改無關的系統設定。系統介面的文字與驗證方式可能因裝置設定而異，請以目前畫面上的實際提示為準。
完成後返回 Home，確認連線狀態是否維持。系統允許新增 VPN 設定，與遠端伺服器已可連線，是兩項不同的檢查。即使系統顯示已連線，仍可能發生伺服器驗證失敗、目標無法連線或規則不符合預期等情況；下一步必須以實際請求驗證，不能只憑系統標示下結論。
首次設定期間，請先保留可手動控制的連線流程。若同時啟用自動連線設定，測試時手動關閉後又自動開啟，容易誤以為開關故障。可在 Settings 查看 On Demand 的運作方式；了解觸發條件前，不必為了首次連線額外啟用。現在請先維持目前選擇，繼續進行下方的驗證步驟。
04 驗證連線與分流結果
依照「應用程式狀態 → 測試結果 → 實際連線」的順序檢查。
開啟連線後，先使用 Home 中的 Connectivity Test 進行一次檢查。測試結果反映的是目前測試方式下的連線情況，不代表所有網站、所有協定與所有請求都能成功。出現逾時也不能立刻認定訂閱已失效：測試方式、測試目標及目前網路狀態都可能影響結果。請先記下這次的情況，再驗證實際連線。
開啟瀏覽器，前往你知道原本可正常使用、且與本次驗證目標相關的頁面。盡量開啟新頁面或重新載入，避免把快取內容誤認為新連線成功。先確認頁面能否完整載入，再檢查特定資源或操作；頁面文字能顯示，不代表其中引用的圖片、影片或其他請求也採用相同路徑。
若使用設定檔 (Config)，請對照目前設定檔中應命中的規則，確認該目標預期經由 PROXY 還是 DIRECT 連線。不能只因為「頁面開得啟」就推斷代理生效，因為該目標可能原本就走 DIRECT。若要判斷所選伺服器本身是否可用，可暫時切換至代理 (Proxy)，保持相同伺服器與目標重新發出請求；測試後再切回 Config。
比對時一次只變更一項條件。例如，先固定伺服器，只切換 Global Routing；或維持模式不變，只在自己已有的伺服器中更換一個項目。不要同時更換伺服器、重寫設定檔及切換網路，否則難以判斷成功或失敗的原因。若要比較 Wi-Fi 與行動數據，也應分別記錄結果，不要把兩次不同條件下的測試混為一談。
05 依問題逐項排查
從最早出現異常的地方開始，每次檢查一個層面。
清單沒有項目：返回匯入步驟
儲存後 SERVER 仍是空白，請先確認使用的是伺服器訂閱網址、單一分享連結，還是規則設定檔網址。確認輸入類型與入口相符，再檢查網址是否完整、有沒有多餘換行，以及讀取時網路是否正常。訂閱回傳的內容、有效狀態與存取限制，需向你取得相關資訊的提供者確認；反覆切換連線開關無法修復匯入失敗。重新匯入前請保留原始資料，以免誤刪後失去核對依據。
清單有項目但無法使用：檢查參數與測試方式
手動輸入的項目請逐一比對 Type、Host、Port 與驗證資訊，再檢查該協定所需的傳輸與安全設定。訂閱匯入的項目則先確認是否已成功更新；不了解欄位用途時，不要大量修改。進入 Settings 查看 Test Method，了解目前採用的測試方式；不同測試方式的結果不應直接視為同一種數值比較，更不能用單次結果作為所有連線的最終判斷。
已連線但連線結果不符：檢查模式與規則
先返回 Home 檢查 Global Routing：目前是否仍為直連 (Direct)，或 Config 中的規則本來就將目標交給 DIRECT。若暫時切換至 Proxy 後可以連線，但恢復 Config 後結果仍不符合預期，請著重檢查目前的設定檔、規則順序與策略引用，而不是重複匯入同一台伺服器。若兩種模式都無法連線，再檢查伺服器本身、目前網路與目標是否可用。DNS 相關異常也應依具體錯誤訊息分析，不要只因頁面無法開啟就任意更改所有解析設定。
開關自動恢復或診斷資訊不清楚：查看 Settings
若手動關閉連線後又自動啟動，請進入 Settings 確認 On Demand 是否已啟用，以及是否符合目前的測試需求。需要更多線索時，可查看 Diagnostics 中實際提供的診斷項目。頁面也可能顯示 Proxy、TCP、UDP 等分類；這些不是首次連線時必須全部修改的清單，請勿為了排查問題而逐一切換所有選項。只操作與目前現象相關的項目，並記下原始值以便還原。
準備診斷記錄時，請寫明「在哪個步驟失敗、使用哪種模式、Connectivity Test 的結果、實際目標是否可連線」，通常比只說「連不上」更有幫助。分享內容前，請移除完整訂閱網址、密碼、驗證識別資訊與 QR Code；也要檢查截圖是否洩漏這些資訊。確認問題已修復後，返回驗證步驟重複相同的檢查；若要進一步了解設定檔結構、比對優先順序與規則片段，再閱讀規則手冊。
