官方手冊 / 初次使用
Shadowrocket 使用教學
訂閱匯入與連線驗證
從哪裡開始？先將現有連線資訊加入 App，再選擇 Global Routing、建立連線，最後透過實際連線確認結果。本頁帶你完成一次基本設定流程；規則細節請參閱規則手冊。
如何對照截圖？下文使用 App Store 官方截圖說明介面位置；實際選項請以裝置上顯示的內容為準。截圖中的伺服器資訊不是要照著填寫的參數。
STEP 01 / ADD SERVER
新增伺服器或匯入訂閱
取得連線資訊後要點哪裡？先進入 Home，找到 Add Server。接著依手邊資料選擇新增方式：完整訂閱連結適合透過 Subscribe 匯入；個別伺服器參數則依相應的 Type 手動填寫。兩種方式都是讓伺服器出現在 Home 的 SERVER 群組中，不必重複新增同一份資料。
已有訂閱連結：選擇 Subscribe
如何匯入現有訂閱？進入 Add Server 後，開啟 Type 並選擇 Subscribe，在訂閱網址欄位貼上自己的完整連結，然後儲存並等待內容載入。請直接從原始資料複製，並檢查開頭和結尾是否混入空格、換行或訊息中的標點符號。連結中的查詢參數通常屬於網址的一部分，不能只保留網域，也不要自行刪改看起來較長的字元。
儲存後應該看到什麼？返回 Home，確認訂閱中的伺服器是否已出現在清單中。若只看到訂閱項目，卻沒有伺服器，請先檢查匯入或更新是否出錯，再確認網址完整、目前網路能否連線至訂閱來源，以及現有服務是否仍有效。訂閱成功載入，只代表已取得伺服器清單，不表示清單中的每台伺服器都能建立連線；接著仍須進行 Connectivity Test。
已有伺服器參數：先選 Type 再填寫
手動新增時要先填哪個欄位？先選擇與資料相符的 Type，再依介面填寫 Host、Port 及該協定要求的驗證資訊。官方截圖展示了 Password、Method 等欄位，但不同 Type 的欄位組合並不相同，不能把某一種協定的表單當成所有協定的通用表單。Host 通常填伺服器網域或位址，Port 填相應的連接埠；密碼、UUID、TLS 與傳輸參數都應逐項對照現有資料。
有 QR Code 時該怎麼處理？可使用頁面底部的 Scan QR Code 掃描自己已有的伺服器 QR Code，匯入後仍須檢查 Type、Host 與 Port。Import from Cloud JSON 適用於相應格式的資料，不能取代貼上任意訂閱網址的入口。無法判斷資料類型時，請先核對原始說明，不要任意切換 Type 嘗試配對。
如何確認這個步驟已完成？儲存後返回 Home，在 SERVER 中選取準備使用的伺服器，確認目前選取的是該伺服器。訂閱網址與 QR Code 可能包含存取憑證，請勿公開分享。不清楚欄位意義時可查閱術語表；若遇到更新失敗或內容空白，可繼續參閱疑難排解。清單準備好後，再進入下一步選擇流量處理方式。
STEP 02 / GLOBAL ROUTING
選擇 Global Routing 模式
新增完成後就能決定所有請求的處理方式嗎？還不行。返回 Home，開啟 Global Routing，確認目前使用的是設定檔 (Config)／代理 (Proxy)／直連 (Direct)中的哪一種。選取伺服器決定可用的代理連線對象；Global Routing 則決定整體採用哪種處理方式，兩者都要確認，不能只看伺服器是否已選取。
設定檔 (Config)：依目前設定檔分流
何時選擇 Config？需要依規則區分不同請求時使用。Config 會按照目前啟用設定檔中的規則選擇策略，例如 DIRECT、PROXY 或 REJECT。開啟 Config 頁面，先確認目前使用哪個設定檔，再檢視其內容。官方截圖展示了 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段，以及 Add Rule 入口；初次上手時，請先確認 Rule，不必為了首次連線同時修改所有區段。
規則如何影響結果？通常依排列順序比對，符合後便執行該規則指定的策略。以下僅以兩個例子說明結構：example.com 及其子網域會符合第一條規則，其他未符合的請求則套用 FINAL。這段範例不是適合所有人的完整設定，也不應直接取代已正常運作的規則。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT代理 (Proxy) 與直連 (Direct)：用來確認連線路徑
何時使用 Proxy？需要確認代理路徑能否完成連線時，可暫時選擇 Proxy 再測試。何時使用 Direct？需要確認目前網路直接連線的表現時，可切換至 Direct 進行對照。即使選取了某台伺服器，Direct 也不會自動改為代理連線；同樣地，切換至 Proxy 也無法修正錯誤密碼或無法連線的伺服器。
初次使用時應保留哪種模式？已有明確且可信的設定，並希望依規則分流時，選擇 Config；仍在排查連線問題時，記下原本的選項，再暫時切換進行對照。測試完成後，恢復符合用途的模式。規則順序、策略與 FINAL 的完整說明請參閱規則手冊；本頁不會展開設定檔的完整結構。確認模式後，返回 Home 準備開啟連線。
STEP 03 / CONNECT
開啟 Home 頂端的連線開關
現在可以連線了嗎？先在 Home 做最後確認：SERVER 中選取的是預期的伺服器，Global Routing 顯示的是剛才決定的模式。確認後，開啟頁面頂端的連線開關。官方截圖中的 Not Connected 表示拍攝截圖時尚未連線，並不是要尋找或輸入的伺服器名稱；實際操作時請留意自己裝置上的狀態變化。
首次出現系統提示時該怎麼辦？Shadowrocket 建立連線需要新增 VPN 設定，首次操作時可能會出現系統授權提示。確認提示是針對 Shadowrocket 後，依系統介面指示允許新增設定，並完成裝置要求的身分驗證。這是裝置系統的網路設定授權，不是要求輸入訂閱密碼；請勿在用途不符的系統欄位中輸入伺服器密碼。
完成授權後要檢查哪裡？返回 Home，確認連線開關與狀態文字是否已變更。如果剛才取消了授權，裝置可能仍未連線；請重新開啟開關並依提示完成操作。若開關隨即關閉或一再失敗，先記下介面顯示的錯誤訊息，不要連續觸發授權，也不要在原因尚未確認前同時重設多個選項。
出現 VPN 狀態就代表連線成功嗎？不是。這表示系統中的 VPN 連線已建立，但不能單憑此狀態證明遠端驗證、DNS 解析與目標請求都成功。即使 Home 顯示已連線，仍須繼續進行下一步的實際連線驗證。反過來說，某個網頁載入失敗也不一定是授權有問題，可能是伺服器或目標請求的處理路徑不符合預期。
iPad 需要採用不同步驟嗎？本頁流程同樣適用：新增資訊、選擇 Global Routing、開啟開關、驗證結果。介面配置可能因裝置與 App 內顯示而異，請依相同的英文項目尋找。測試期間先維持網路環境穩定，避免剛開啟開關就切換 Wi-Fi 與行動網路，以免無法判斷問題來自設定還是網路變更。
STEP 04 / VERIFY
透過測試與實際連線確認結果
如何判斷設定是否生效？分兩個階段檢查：先確認伺服器的基本連線能力，再確認實際請求是否依預期完成。在 Home 使用 Connectivity Test 查看測試結果，接著開啟自己要使用的網站或 App。不要只依據單一測試數值判斷所有功能都正常，也不要只因網頁從快取載入，就認定新的請求已透過預期路徑。
先執行 Connectivity Test，再檢查目標請求
測試成功代表什麼？表示在目前的測試方式下收到相應回應，可用來初步檢查伺服器。測試結果會受 Settings 中的 Test Method、目前網路與遠端回應影響，不能等同於所有服務請求的連線速度。若測試有結果但頁面無法開啟，請繼續檢查協定驗證、DNS 與規則，不要直接認定伺服器完全正常。
如何驗證實際連線？選一個自己確定需要開啟的頁面，重新送出請求並觀察是否能完成載入，再測試另一個常用目標。使用 Config 時，兩個目標可能符合不同規則，因此結果不同不一定代表異常。若能查看連線記錄，請核對目標、符合的規則及最終策略：預期透過代理連線的請求是否使用 PROXY，預期直接連線的請求是否使用 DIRECT。
以單一變數進行模式對照
使用 Config 時失敗，接下來怎麼排查？保留同一台伺服器與同一個測試目標，暫時切換至 Proxy 再測一次。若 Proxy 可用但 Config 結果不如預期，優先檢查目前選取的設定檔與符合的規則，而不是立刻更改密碼。若 Direct 可用而 Proxy 失敗，先檢查代理連線路徑及相應參數。對照測試只能協助縮小排查範圍，不能只憑一次結果就確定唯一原因。
如何判斷這個步驟已完成？連線狀態穩定，所需頁面能正常送出新請求，而且路由模式符合用途。記下目前可用的伺服器、設定檔與 Global Routing 組合，之後遇到問題時可用來對照。若目前不需要依條件自動連線，先維持手動連線；基礎流程驗證成功後，再另行設定 On Demand，避免自動觸發影響初次測試。
STEP 05 / DIAGNOSTICS
依問題發生階段逐項排查
未達預期時該從哪裡查起？先確認問題發生在匯入、測試、連線還是實際瀏覽階段，再依下列順序檢查。開啟 Settings 可找到 Test Method、On Demand、Diagnostics 等項目。截圖僅供尋找這些設定名稱，不表示需要逐一變更；尤其不要為了排查問題一次更改 DNS、規則、伺服器與測試方式，否則難以判斷哪個步驟影響了結果。
匯入失敗：先檢查資料與取得內容的過程
訂閱內容空白或更新失敗怎麼辦？返回訂閱編輯頁面，檢查網址是否完整，確認該資料確實是訂閱網址而非說明頁面，並核對訂閱是否仍有效。重新取得內容前，先保留原有且可用的項目，避免原因不明時刪除所有記錄。手動新增失敗時，返回 Add Server，確認 Type 與資料相符，並特別檢查 Port、驗證欄位、TLS 與傳輸參數；欄位填滿不代表內容正確。
測試失敗：區分目前網路與伺服器問題
Connectivity Test 沒有回應時該怎麼辦？先確認裝置在中斷 Shadowrocket 連線後能正常上網，再測試自己已有的另一組伺服器資訊。若只有一台失敗，優先核對該伺服器的參數與遠端狀態；若全部失敗，檢查目前網路及測試方式。需要切換 Wi-Fi 與行動網路時，每次切換後都重新執行同一項測試並記錄網路條件，不要混合比較不同條件下的結果。
已連線但無法瀏覽：檢查模式、DNS 與規則
開關已開啟卻無法開啟頁面時該怎麼辦？先返回 Home，確認 Global Routing 與伺服器選取，再依上一節的方法對照 Proxy 與 Config。如果主要問題是網域無法解析，請檢查自己是否修改過 DNS，優先檢視最近的變更，不要同時增加多組解析設定。若只有部分目標失敗，檢查是否符合 REJECT、是否已被較前面的規則比對，或是否採用了與預期不同的最終策略。
如何使用 Diagnostics？依目前的問題查看 App 提供的診斷資訊，並對照錯誤發生階段、目標與當時的網路條件。單筆錯誤記錄只能說明當時那次請求的狀況，不代表後續所有連線。若要保存記錄或提供給自己的服務業者，請先遮蔽訂閱網址、驗證資訊及可識別個人身分的資料，只保留排查所需的錯誤訊息與相關欄位。
反覆自動連線：檢查 On Demand
手動關閉後為何又自動連線？先到 Settings 檢查 On Demand 是否已啟用，以及觸發條件是否符合目前網路。排查期間可暫時停用自動觸發，再使用手動開關重現問題；完成後依原本用途恢復設定。若近期曾匯入或修改設定檔，也請記錄修改前後的差異，盡量恢復到最近一次確認可用的組合，再逐項加入變更。
仍然失敗時，接下來該怎麼做？整理四項資訊：問題發生的步驟、目前的 Global Routing、Connectivity Test 結果，以及實際目標出現的錯誤。根據這些資訊查閱疑難排解，比只描述「無法連線」更容易找到相關問題。若問題涉及規則優先順序與設定檔結構，請參閱規則手冊；若只是不清楚某個欄位，請使用術語表。請勿在公開頁面貼上完整訂閱或驗證資料。
