Shadowrocket 使用教學
依序完成匯入、模式選擇、連線、驗證與排錯。先建立一次可供檢查的連線，再調整自動連線與複雜規則。
本頁說明 iPhone、iPad 的首次操作。請先讓裝置連上可用的 Wi-Fi 或行動網路，確認一般網頁可以開啟，再準備服務商提供的原始資訊。訂閱連結通常包含存取憑證，請只在 App 內輸入；手動輸入則須確認協定類型、伺服器位址、連接埠及相應的驗證欄位，不能只憑伺服器名稱開始設定。
操作時請以 App 實際顯示的內容為準，介面用語保留英文原文。旁邊的官方 App Store 截圖可協助辨認頁面，不應照抄其中的伺服器參數。iPad 頁面配置可能隨視窗寬度變化，操作仍以 Home、Config 與 Settings 為主；裝置相容性與系統需求請以 App Store 頁面標示為準。
01 新增伺服器或匯入訂閱
訂閱與手動輸入擇一即可，不必重複新增同一批資訊。先前往 Home，找到 Add Server 或頁面上的新增入口，開啟 Add Server 頁面。先查看 Type：它會決定接下來需要填寫哪些欄位。截圖僅顯示其中一種欄位配置；切換至其他協定後，所需的驗證與傳輸選項可能不同，請勿將截圖視為所有協定通用的表單。
使用現有訂閱：選擇 Subscribe
若有訂閱連結，請在 Type 中選擇 Subscribe，將完整連結填入 URL，並以易於辨識的名稱註明來源，再儲存。貼上後檢查開頭或結尾是否混入空格、換行或聊天文字；也別把服務商的登入頁面網址誤當成訂閱網址。訂閱中的驗證參數是連結的一部分，刪除後可能無法取得內容。
儲存後返回 Home，查看是否出現訂閱群組與伺服器項目。如果暫時只看到群組名稱，請檢查訂閱更新結果，必要時使用該訂閱的更新功能。是否成功匯入，應以實際出現可選取的項目為準，而非只看儲存操作是否完成。若出現取得失敗提示，先保留提示內容，檢查目前網路與連結是否有效，請勿連續建立多個相同訂閱。
手動輸入：先選 Type，再填寫欄位
只有單一伺服器資訊時，請先依原始資料選擇 Type，再填寫 Host、Port，以及該協定要求的 Password、Method 或其他驗證欄位。Host 通常填寫伺服器網域名稱或 IP 位址，請勿將整段網頁連結貼入此欄位；Port 必須與服務商提供的連接埠一致。Password 的大小寫與符號都應保留，Method 也必須與伺服器端設定相符，不能只因名稱相近就自行替換。
如涉及 TLS、伺服器名稱或傳輸設定，同樣應以現有伺服器資料為準。請勿因連線失敗就任意關閉驗證或刪除必要欄位。Scan QR Code 適用於掃描使用者已有且確認來源的 QR Code；Import from Cloud JSON 是另一種匯入方式，只有在持有相應格式的資料時才使用，不能因此推斷任何訂閱都能從此處匯入。
儲存並返回 Home 後，在 SERVER 中選取這次要測試的項目。先使用一個項目完成後續步驟，暫時不要加入自動切換或複雜策略，方便判斷問題發生在哪個環節。本步完成條件：Home 中已有儲存的伺服器項目，且已明確選取其中一個。接下來選擇如何處理流量。
02 選擇 Global Routing 模式
Global Routing 決定整體處理方式；選取伺服器不代表已選好流量分流方式。在 Home 點開 Global Routing，確認目前選的是設定 (Config)、代理 (Proxy) 還是直連 (Direct)。三個選項用途不同，並非連線品質的高低檔位。先確認這次要依規則日常使用，還是暫時測試伺服器路徑，再做選擇。
設定 (Config)：依所選設定檔中的規則處理
已有適用的設定檔時，可選擇設定 (Config)。接著進入 Config，確認目前選取的是準備使用的設定檔，而不只是曾匯入過某個檔案。設定頁面中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分別對應不同區塊；首次連線主要確認設定檔選擇與 Rule，暫時不必逐項修改其他部分。
Rule 會依條件決定請求交由哪種策略處理。通常會依序檢查，前面符合的規則會影響最終去向，末尾的 FINAL 則用於兜底。例如，某個網域符合 DIRECT，表示該請求會走直接連線路徑；即使 Home 中選了伺服器，該請求也不會因此自動改走 PROXY。了解這一點，便能避免把「規則依預期直連」誤判為「App 沒有生效」。
代理 (Proxy)：用來檢查代理處理路徑
首次排查時，代理 (Proxy) 有助於縮小規則因素的影響範圍：選取同一台伺服器，再對同一個目標重複測試。但這仍不保證所有目標都能連線；伺服器連線狀態、DNS、目標服務與相關設定都會影響結果。測試結束後，若日常使用依賴規則，請切回原本的 Config，並確認設定檔仍有正確選取。
直連 (Direct)：檢查直接連線路徑
直連 (Direct) 會直接連線，一般不會使用所選代理伺服器作為請求出口。此模式適合與代理路徑比較，但無法證明代理伺服器可用。切換至 Direct 後，若一般網頁恢復正常，只能說明這次請求透過直接連線路徑成功；接下來仍須檢查伺服器與設定檔，不能混為一談比較兩種路徑的結果。
這一步先選定一種明確模式並記下來。請勿同時修改規則、更換伺服器與調整 DNS，否則即使結果改變，也難以判斷是哪項設定造成。本步完成條件：能說明目前的模式，以及 Config 對應的設定檔是否已選取。購買、商店地區與已購項目復原問題，請參閱App Store 正版取得完整指南，不必透過修改此處的規則處理。
03 開啟開關並確認連線
先確認伺服器與模式，再開啟 Home 頂端的連線開關。返回 Home，查看 SERVER 中目前選取的項目，再確認 Global Routing。若剛才編輯過伺服器，請先確認已儲存並離開編輯頁面。頂端顯示 Not Connected 時，表示目前尚未建立連線；不能只因伺服器清單中有項目，就認為連線已開始。
開啟頂端開關後，首次使用可能會出現系統新增 VPN 設定的提示。這是 App 建立網路設定所需的授權流程。確認提示來自目前使用的 Shadowrocket 後，依裝置上的步驟確認，並完成裝置要求的驗證。如果先前曾拒絕授權，請再次發起連線並查看系統提示；不清楚用途時，請勿刪除裝置上的其他網路設定。
完成授權後返回 Home，查看頂端狀態是否顯示已連線。若開關立即跳回，或仍停留在未連線狀態，請先記下當時出現的錯誤，再前往排查常見問題；不要快速反覆切換開關。若系統設定中已有其他正在使用的 VPN 設定，也請確認目前實際啟用的是哪一個，避免把其他設定的狀態誤認為這次的連線結果。
請特別留意：系統隧道顯示已連線，只代表相應的網路設定已啟動，不代表所選伺服器已成功處理所有請求，也不保證特定網站一定能連線。此時先維持目前的伺服器與模式，進入下一步檢查實際請求。只看頂端開關，或只看裝置狀態列中的網路圖示，都不足以完成驗證。
測試期間若要停用，可返回 Home 關閉開關，再確認連線狀態已結束。如果關閉後又自動開啟，請勿繼續反覆點按，改到 Settings 檢查 On Demand 的觸發條件。本步完成條件：了解授權提示，並能在 Home 確認連線狀態的變化。接著以測試和實際連線一併驗證，不要立刻新增更多設定。
04 驗證測試結果與實際連線
分別檢查連線狀態、伺服器測試與目標存取，三者不能互相取代。維持剛才選定的伺服器與 Global Routing，在 Home 使用 Connectivity Test。先查看測試是否有回傳結果或逾時，再開啟平常熟悉且當下能確認狀態的網頁，觀察是否完整載入。不要只看某個數值，也別把網頁快取中已顯示的內容當成新的成功請求。
Connectivity Test 的結果如何解讀，取決於目前的測試方法。測試成功不代表所有協定功能都正常，也不代表所有網站或 App 都能使用；逾時也須搭配使用的方法與實際請求來判斷。若測試正常但只有單一目標失敗，請繼續檢查該目標、DNS 與規則路徑，不要立刻認定所有伺服器都無法使用。
使用 Config 時，確認請求符合的策略
若目前使用 Config，可查看 App 內的連線記錄，檢查目標請求：留意目標網域、符合的規則及策略去向。預期直連的請求符合 DIRECT，預期透過代理處理的請求則符合相應的代理策略，才符合設定目的。Data 的流量變化可作為輔助參考，但總流量變化本身無法證明特定目標符合哪條規則。
需要比較時，先記下目前的 Config，再暫時切換至代理 (Proxy)，使用同一台伺服器連線至同一個目標。若 Proxy 可用而 Config 不行，優先檢查設定檔選擇、規則順序與策略關聯；若兩者都失敗，再檢查伺服器參數與網路路徑。比較完成後請恢復原本模式，避免忘記暫時設定，導致後續操作與預期不符。
每次只變更一個條件
建議簡要記錄四項資訊：目前網路、所選伺服器、Global Routing 與錯誤提示。下一輪只修改其中一個條件，再執行相同測試。例如只切換 Wi-Fi 與行動網路，不要同時修改密碼與 DNS。如此才能依結果差異縮小排查範圍，也方便向自己的服務商說明問題。
本步完成條件：實際請求可順利完成，且處理路徑符合預期。若只有特定 App、網域或類型的請求異常，請保留這個具體範圍再進入排錯；不要把局部故障概括成「全部連線失敗」。確認首次操作流程後，再逐步恢復或新增個人化規則。
05 依序排查常見問題
依照網路、匯入、參數、規則、解析的順序檢查，避免一次重設所有選項。先關閉這次的連線，確認目前的 Wi-Fi 或行動網路本身可正常使用。若網路需要先登入，請先完成網路連線程序。尚未確認網路基本狀態前，反覆更新訂閱或重建伺服器項目，通常無法提供有效線索。
訂閱沒有項目：檢查取得過程
返回已儲存的 Subscribe，確認 URL 是否完整、仍然有效，以及更新時出現的具體提示。訂閱下載失敗與訂閱中某台伺服器連線失敗是兩種不同問題：前者先檢查連結取得與內容格式，後者則檢查伺服器參數與可用性。更新前請保留現有可用資訊，原因不明時不要刪除所有項目。
項目存在但連線失敗：逐項核對欄位
開啟該伺服器的編輯頁面，逐項比對原始資料中的 Type、Host、Port、驗證欄位與傳輸設定。使用 TLS 時，還要確認伺服器名稱及相關參數，並檢查系統日期與時間是否正確。不要只檢查 Password；協定類型、連接埠或必要的傳輸欄位不符，也可能造成逾時或連線失敗。若伺服器端資料已變更，請依自己的服務商提供的新資料重新核對。
部分請求異常：檢查規則與 DNS
先確認 Global Routing 沒有停留在暫時測試模式。使用 Config 時，再確認已選取的設定檔與符合的規則；若只有特定網域異常，請重點查看該請求是否使用預期策略。調整 DNS 時，先保留目前設定，區分「網域解析失敗」與「已解析但連線失敗」，每次只修改一項。不要把更改解析設定當成解決所有問題的通用做法。
檢查 Settings 中的測試與自動連線設定
進入 Settings，可查看 Test Method、On Demand 與 Diagnostics 等相關選項。Test Method 會影響測試結果的解讀；比較兩次結果時，請使用相同方法。On Demand 可能依條件重新觸發連線；若手動關閉後又自動連線，應先檢查這些條件，而非認定頂端開關故障。首次排查時可暫時停用相關自動觸發條件，確認手動連線正常後再恢復。
需要使用 Diagnostics 時，請針對剛發生的一次失敗查看資訊，記錄時間、網路環境、伺服器類型與錯誤內容。分享截圖或診斷資料前，請遮蔽完整訂閱連結、Password、驗證識別資訊及其他敏感內容，只保留排查所需的部分。系統連線正常但目標請求失敗時，這些具體記錄比「無法使用」的描述更有助於釐清問題。
完成修正後，返回開啟連線與驗證是否生效，重複相同的一組操作，確認結果確實改變，再恢復日常使用的 Config 與 On Demand 設定。購買帳號、商店顯示或換機後找回 App 的問題，請前往正版指南；這些問題與現有伺服器參數排查屬於不同流程，不必透過重寫網路規則處理。
