官方手冊 · 首次連線流程
Shadowrocket 使用教學
新增現有設定 → 選擇 Global Routing → 連線並驗證
適用於 iPhone 與 iPad。先完成一次可供檢視的連線，再調整規則、On Demand 和其他設定。文中依據官方 App Store 截圖說明介面位置，實際畫面請以目前 App 內顯示為準。
01 · Add Server：新增與匯入
先確認手上的資料類型：若有伺服器位址、連接埠和認證參數，可手動輸入；若有訂閱連結，可使用 Subscribe；若有可辨識的設定 QR Code，則可使用 Scan QR Code。三種方式不必全部操作，選擇符合手上資料的一種即可。訂閱連結可能包含存取憑證，請勿將完整連結貼到公開頁面或公開討論區。
手動輸入伺服器資料
開啟 Shadowrocket 的 Home，在 SERVER 分組中找到並進入 Add Server。先點選 Type，選擇資料明確標示的協定類型，再填寫頁面隨之顯示的欄位。以 Shadowsocks 為例，核對 Host、Port、Password 與 Method：Host 是伺服器網域或位址，Port 是連接埠，Password 與 Method 必須分別和現有資料一致。請勿憑欄位外觀猜測參數，也不要把整段分享連結貼到 Host 欄位。
不同 Type 的欄位並不相同。選擇 VLESS、VMess、Trojan 等類型時，請繼續核對相應的認證資訊，以及資料明確要求的傳輸與 TLS 參數。若某個欄位沒有資料依據，請先向原資料提供者確認，不要為了儲存而任意填寫。填妥後使用頁面上的儲存操作返回 Home，確認清單中出現新項目，再點選要使用的項目。儲存成功只代表資料已輸入，並不表示伺服器已可連線。
使用 Subscribe 匯入現有訂閱
若已有訂閱連結，進入 Add Server 後在 Type 中選擇 Subscribe，將完整連結填入 URL，並視需要填寫方便辨識的備註。複製時請檢查連結開頭與結尾，避免混入說明文字、空格或換行。此處填寫的是現有訂閱網址，不是一般網頁網址，也不是單一伺服器的 Host。儲存後返回 Home，等待訂閱內容載入，並確認是否出現相應分組與項目。
若只看到訂閱名稱，卻沒有可選項目，請先確認更新是否完成，再檢查連結是否仍有效，以及基本網路能否連上該網址。更新訂閱是重新取得伺服器清單，與更新 Config 中的規則檔不同。日後需要重新載入內容時，請在該訂閱的管理操作中執行更新；手動新增的項目與訂閱項目也應分開辨識，避免操作錯誤。
使用 Scan QR Code
在 Add Server 頁面選擇 Scan QR Code，依系統提示授予相機權限，再掃描現有設定對應的 QR Code。辨識後先檢查 Type、Host 與 Port 等資訊是否符合預期，再儲存。QR Code 也可能包含認證資料，因此分享截圖或尋求協助時，請遮蔽完整 QR Code。Import from Cloud JSON 是另一個匯入入口，僅在確實持有相應格式資料時使用，首次連線不必額外操作。
完成本步的判斷依據是：Home 中已有可選取的伺服器項目，且參數與原始資料相符。接著先決定流量處理方式，再開啟連線；沒有項目時，請勿反覆切換頂端開關。
02 · Global Routing：選擇模式
返回 Home，點選 Global Routing 查看目前模式。這裡決定用戶端如何處理請求，不是伺服器協定選擇器。三種模式分別是設定 (Config)／代理 (Proxy)／直連 (Direct)。先確認這次要驗證的項目，再選擇相應模式；切換模式不會自動修正伺服器參數，也不代表訂閱內容有所變動。
設定 (Config)：依據目前設定處理請求
日常需要依規則區分請求的處理方式時，請選擇設定 (Config)。接著進入 Config，確認目前實際啟用的設定檔，而不只是檔案清單中是否有某個名稱。設定檔可包含 General、Rule、Hosts 等區段；截圖也顯示 URL Rewrite、HTTPS Decryption 等入口。首次使用時不必逐一啟用這些入口，也不需要為了連線加入尚不了解的內容。
在 Rule 中，規則順序會影響比對結果。例如 DOMAIN-SUFFIX,example.com,PROXY 表示依網域後綴比對並指定 PROXY；DIRECT 表示直連處理。前面的規則都未命中時，還須查看設定中的最終處理方式。首次驗證建議優先使用來源明確、內容易懂的現有設定；需要有依據地調整規則時，再使用 Add Rule。協定欄位與規則的作用不同，更多說明請參閱協定參考。
代理 (Proxy)：檢查所選代理路徑
選擇代理 (Proxy) 後，用戶端接管的請求會依此模式透過代理處理，可用來判斷問題是否與 Config 中的分流規則有關。切換後仍須確認 Home 選取的是哪一台伺服器，並重新發出測試請求。請勿將 Proxy 理解為必定加速；基本網路、伺服器可用性、目標回應與協定參數都會影響結果。
直連 (Direct)：對照基本連線
選擇直連 (Direct) 時，請求會以直連模式處理，不會使用所選伺服器作為代理路徑。這適合與其他模式對照，但不等於關閉系統 VPN 設定。若要停止用戶端連線，請使用 Home 頂端的連線開關。測試結束後，請切回原先預定使用的模式並記錄選擇，避免將疑難排解時暫時切換的模式當成日常狀態。
本步結束前，應能回答兩個問題：目前 Global Routing 選擇了什麼模式；若為 Config，實際使用的是哪一份設定檔。確認這兩項後，再繼續系統授權與連線。
03 · Home：授權並開啟連線
返回 Home，先檢查 SERVER 分組中的目前選項，再確認 Global Routing。兩者都正確後，開啟頂端的連線開關。官方截圖中的 Not Connected 表示截圖拍攝當時尚未連線，是狀態文字，不是需要填寫的參數。連線期間請留意 App 內的狀態變化，不要在短時間內反覆切換開關，以免無法判斷目前結果對應哪次操作。
首次新增 VPN 設定
首次啟用連線時，系統可能會要求新增 VPN 設定。請閱讀提示，確認要求來自目前使用的 Shadowrocket，再依系統流程允許並完成裝置認證。此授權可讓 App 使用系統提供的網路機制處理連線，不會代為建立伺服器、補齊訂閱資料或修正失效參數。授權完成後返回 App，檢查連線是否已建立；若尚未連線，確認頁面狀態後再試一次。
若先前取消了要求，請返回 App 重新發起連線，確認系統是否再次顯示確認提示。若系統中的相關設定已刪除，也須依 App 與系統提示重新建立。不要只因系統設定中有 VPN 項目就認定連線成功：設定存在、連線開關已開啟，以及目標請求可用，是三種需要分別確認的狀態。
連線後先保留目前設定
App 顯示已連線時，先不要立即啟用更多選項。維持目前伺服器、Global Routing 與設定檔不變，進入下一步進行實際瀏覽驗證。如此若發生問題，可依據這組已知設定進行疑難排解。iPad 上的清單與詳細資料位置可能因版面配置而異，但操作順序相同：先選取項目，再確認模式，最後啟用連線。
若開關立即自動關閉，或長時間停留在連線中，請前往設定與疑難排解檢查系統授權及其他連線的影響，不要連續新增相同項目。成功進入連線狀態後，再進行 Connectivity Test 與瀏覽器驗證。
04 · Connectivity Test：驗證連線效果
返回 Home 執行 Connectivity Test，查看目前項目的測試結果。測試結果與 Settings 中的 Test Method 有關，不同測試方法檢查的環節也不同。出現耗時數值通常只表示相應測試收到回應，不能直接證明所有網頁、App 或協定流量都能正常運作。反之，單次測試逾時也無法單獨判定是密碼錯誤，請配合實際瀏覽結果判斷。
接著開啟瀏覽器，前往熟悉且可供確認的目標頁面，並手動重新載入。盡量發出新的請求，避免只查看已快取的頁面。再瀏覽另一個獨立目標作為對照：若只有單一網站失敗，先考慮目標網站本身、相關規則或解析問題；若多個目標都失敗，再檢查伺服器、模式與基本網路。測試期間不要同時切換伺服器和設定，否則結果難以比較。
若目前使用設定 (Config)，請配合可查看的連線記錄，核對目標網域及命中的規則、策略或處理結果。預期使用 DIRECT 的請求沒有經過代理，不一定是故障；預期使用 PROXY 的請求卻以其他方式處理，則須檢查啟用的 Config 與規則順序。記錄的實際位置與欄位請以目前 App 內顯示為準，不要只憑系統 VPN 標示判斷分流結果。
建議記下本次驗證使用的伺服器備註、模式與設定檔名稱，但不要記錄或公開完整認證資料。之後若要測試另一台伺服器，請先只切換伺服器，再重複相同的瀏覽流程。若要進一步了解測試結果，請閱讀疑難排解，避免將延遲測試、DNS 解析與實際內容瀏覽混為同一項指標。
05 · Settings：設定與疑難排解
遇到問題時，依照以下順序逐步縮小範圍。每次只變更一個條件，變更後以相同目標重新測試瀏覽，並記錄結果。Settings 提供 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等設定入口，但有入口不代表每項都需要調整；首次連線應先檢查基本條件，再考慮更深入的參數。
先區分基本網路與設定問題
- 基本網路：關閉 App 連線，檢查目前 Wi-Fi 或行動網路是否能瀏覽原本就可存取的頁面。若網路需要先登入，請先完成登入，再返回連線。
- 匯入內容：確認 Home 中已有實際的伺服器項目。訂閱更新失敗與伺服器連線失敗屬於不同環節，請先解決清單取得問題，再測試清單中的項目。
- 參數與選項：檢查 Type、Host、Port、認證資訊及資料要求的其他欄位，同時確認目前測試的確實是剛核對過的項目。
- 模式與設定：檢查 Global Routing。使用 Config 時，確認目前的設定檔；必要時可暫時切換至 Proxy 作對照，測試後再切回原本模式。
- 系統連線：檢查是否已完成授權、App 是否維持連線狀態，以及是否有其他 VPN 連線影響目前連線。先停止可能衝突的連線，再重新驗證。
測試有回應，網頁仍無法開啟
先改用另一個獨立目標測試，再確認問題是否只出現在特定網域。可能相關的環節包括 DNS 解析、規則命中、目標服務回應，以及測試方法與實際請求之間的差異。不要直接將所有問題歸因於 DNS，也不要一次更換所有解析設定。先核對目前 Config 中的相關設定與記錄，再依據情況修改一項並重新測試；需要進一步排查時，請參閱規則分流與疑難排解說明。
On Demand：基本連線穩定後再設定
On Demand 可依設定條件觸發連線行為，與手動開啟 Home 開關不同。首次使用建議先完成手動連線與驗證，再進入 Settings 查看 On Demand 條件。若手動中斷後又自動連線，請檢查此處設定，不要反覆刪除伺服器。變更後，分別觀察符合與不符合條件時的狀況，確認行為符合預期。
使用 Diagnostics 並保護連線資料
需要進一步找出問題時，可在 Settings 查看 Diagnostics 中可用的診斷入口。記錄問題發生時的狀況、網路類型、所選模式，以及是否只有特定目標失敗，比只寫「無法使用」更有助於判斷。提供截圖或記錄給他人前，請移除完整訂閱連結、認證欄位、QR Code 與其他個人資料。不要為了疑難排解公開整份設定檔。
若某次調整後狀況變差，請先還原至上一組已驗證的設定，再逐項重試。連線正常後可在此結束；之後可依需要閱讀協定參考與設定說明。本教學旨在建立清楚且可重複的操作流程，而非要求首次使用時修改所有選項。
