Shadowrocket
匯入與首次連線
先準備連線資料，再選擇模式、開啟開關並確認結果。本篇官方手冊適用於 iPhone 與 iPad，依首次操作順序說明各步驟應檢查的畫面與狀態。
- Add Server
- Subscribe
- Global Routing
- Connectivity Test
單一伺服器與訂閱是兩種資料匯入方式，不必重複新增。若已有訂閱連結，可直接跳到第二步；若已有完整的伺服器參數，請先完成第一步，再選擇模式。
Add Server：填入現有伺服器資料
開啟 Shadowrocket，進入 Home，在 SERVER 分組中找到 Add Server。進入後先查看 Type，不要急著填入位址。Type 會決定接下來顯示的欄位：不同協定的驗證方式與連線參數各有不同，不能只憑伺服器名稱判斷。請依現有資料選擇對應類型，例如 Shadowsocks、VMess、VLESS、Trojan；不要為了減少欄位而改用其他協定。
接著填入 Host 與 Port。Host 是伺服器網域或位址，Port 是該服務實際監聽的連接埠，兩者必須來自同一份連線資料。範例中的 example.com 僅用於說明格式。請勿將完整訂閱連結貼到 Host，也不要把連結中的路徑或查詢參數當成連接埠。貼上後請檢查前後空格、換行與標點，避免輸入法將英文符號替換成其他字元。
接著填入該 Type 所需的驗證資訊。畫面中的 Password、Method 是所示類型的欄位，不代表所有協定都使用相同參數。若現有資料也列出 TLS、Server Name 或其他傳輸選項，請逐項保持一致；不確定某個值時，先核對原始資料，不要藉由關閉驗證或任意更換加密方式來嘗試。
若資料以 QR Code 提供，可使用 Scan QR Code 匯入，再返回編輯頁面確認 Type、Host 與 Port。Import from Cloud JSON 是用於特定內容格式的另一個入口，不應將任意網頁網址當作相應設定。儲存後返回 Home，確認 SERVER 清單中出現新項目。此時僅完成儲存，尚不能據此判定連線成功。
Subscribe：匯入自己的訂閱連結
若手上有用來更新伺服器清單的訂閱連結，請使用 Subscribe，不必逐一手動新增伺服器。先從自己的服務供應商複製完整連結，再進入 Home 的 Add Server，將 Type 設為 Subscribe，在對應的 URL 欄位貼上連結，並填寫方便辨識的備註。實際欄位位置以目前 App 顯示為準；儲存前請確認沒有把介紹網頁、帳戶頁面或訂單頁面的網址誤當成訂閱連結。
訂閱網址可能包含用於識別帳戶的查詢參數，必須完整保留。複製時漏掉結尾字元、夾入換行，或手動刪除看似多餘的參數，都可能導致無法讀取伺服器清單。請將連結視為私人資料妥善保管；尋求協助時，只需描述提示文字與失敗階段，不要公開完整連結。無須將訂閱內容貼到其他網站處理。
儲存後更新訂閱，等待讀取完成，再返回 Home 檢查相應分組是否出現伺服器。請分別確認「是否成功取得項目」與「項目是否能連線」：更新成功表示本次內容可讀取，不代表每台伺服器都能連線；清單為空也不代表連線開關故障。請先檢查連結、訂閱狀態，以及目前網路是否能連上該網址。
初次使用建議先手動更新一次，確認內容正常後再考慮自動更新。重複建立相同訂閱通常無法修復連結本身的問題，反而會增加難以辨識的分組。更新失敗時，請保留現有項目與原始連結，記下錯誤提示，並依訂閱解析失敗或清單為空的自我檢查步驟逐項核對；自動更新的差異請參閱訂閱更新說明。
Global Routing：了解三種模式
返回 Home，點開 Global Routing 查看目前選項。三種模式分別是設定(Config)、代理(Proxy)與直連(Direct)。它們描述的是要求路徑的選擇方式，而非伺服器協定。新增伺服器不能取代這個步驟：相同伺服器在不同模式下，可能只處理部分要求，也可能不會處理目前的要求。
| 模式 | 用途 | 操作前檢查 |
|---|---|---|
| 設定(Config) | 依目前設定中的規則選擇策略。 | 確認目前使用的 Config 與 Rule。 |
| 代理(Proxy) | 透過代理路徑處理要求，用來確認所選伺服器是否可用。 | 確認已選取預期的伺服器，並留意設定中的例外項目。 |
| 直連(Direct) | 使用直接連線路徑。 | 目標可直接存取，不代表代理連線成功。 |
日常依規則使用時，請選擇設定(Config)，並進入 Config 確認實際使用的設定檔。在對應檔案的編輯頁面可查看 General、Rule、Hosts 等區段；其中 Rule 決定比對條件與策略。只開啟檔案查看，不代表已切換至該設定；請返回清單確認目前使用標記。初次操作請保留原設定，不要同時編輯多個區段。
例如，DOMAIN-SUFFIX,example.com,PROXY 表示符合該網域後綴條件的要求使用 PROXY；FINAL,PROXY 用於前面的規則都未符合時，作為最後的選擇。以上僅說明語法，並非適用於所有人的完整設定。規則順序與使用的策略都會影響結果，不能只看到關鍵字就判定要求一定會經過代理。
若暫時只想區分「伺服器連線問題」與「規則選擇問題」，可先記錄原本模式，再暫時使用代理(Proxy)進行對照測試，測試後記得還原。直連(Direct)適合確認直接存取的情況，但無法驗證伺服器是否可用。更完整的比對順序與模式說明，請參閱Global Routing 設定參考及規則檢查章節；本篇先完成一次可驗證的連線流程。
Home：選取伺服器並啟用連線
返回 Home，在 SERVER 分組中點選這次要使用的伺服器，並留意項目左側的圓點標記。進入項目編輯頁面與選取預設伺服器是不同操作；不要只查看參數，就以為已完成選擇。若匯入了多個分組，請先確認所選項目屬於哪個分組，之後的測試都維持同一選擇，以便比較結果。
確認 Global Routing 後，開啟 Home 頂端的連線開關。首次連線時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。請確認要求來自目前正在操作的 App，再依系統流程允許並完成裝置驗證。這項授權用於建立 App 所需的網路設定，不會取代伺服器密碼，也不會為帳戶增加可用訂閱。
返回 Shadowrocket，查看頂端狀態是否仍顯示 Not Connected，以及開關是否維持開啟。若取消了系統授權，請先完成授權步驟，不要立即修改伺服器參數。若開啟開關後隨即關閉，請記下提示文字與發生時機：是在授權前、授權後，還是開始存取目標時。不同階段需要檢查的項目也不同。
開關維持開啟與目標可正常存取，仍是兩回事。連線狀態首先表示本機連線流程是否建立，不能只憑狀態文字推斷伺服器驗證、DNS 和每條規則都正確。現在先維持模式與伺服器不變，進入下一步進行驗證，避免沒有對照結果就連續修改設定。
Connectivity Test：分別確認連線與存取狀況
在 Home 執行 Connectivity Test，等待本次測試完成，再查看所選伺服器的結果。測試方法會影響檢測內容，因此比較時應維持相同的 Test Method。測試結果可用只表示在對應檢測條件下收到回應，不代表目標 App 的所有連線都已成功；單次逾時也無法單獨判定是驗證錯誤、伺服器無法連線，還是測試目標暫時沒有回應。
接著開啟要使用的目標網頁或 App，執行一項明確操作，例如重新載入頁面，而不是只查看已快取的內容。可選擇兩個日常使用的目標進行對照，記錄哪些成功、哪些失敗。若在設定(Config)下只有特定目標異常，請先檢查該要求符合的規則，不要立即更換所有伺服器。
需要確認連線路徑時，可查看目前 App 提供的連線記錄或日誌，核對目標網域與最後套用的策略。PROXY、DIRECT、REJECT 分別表示代理、直接連線與拒絕策略；本機連線開關開啟時，DIRECT 要求仍可能正常直連。若要求符合 REJECT，請先確認相應規則是否符合預期，不能直接將遭規則拒絕的要求歸因於伺服器失效。
可依照「伺服器測試有回應 → 系統連線維持正常 → 目標實際可用 → 策略符合預期」的順序記錄結果。前三項正常但策略不符時，請回到 Global Routing 與 Config 檢查；測試失敗且目標也無法使用時，再依下一步檢查資料與網路狀況。每次只變更一個變數，重新測試後再決定是否保留，才能確認是哪項調整造成影響。
Settings：依失敗階段逐項檢查
匯入失敗：先確認資料完整
若訂閱儲存後解析失敗或清單為空，請先返回訂閱編輯頁面，確認連結完整，再確認現有服務狀態，以及目前網路能否連上訂閱網址。若是單一伺服器，請重新核對 Type、Host、Port 與驗證欄位。此階段無須先修改 DNS、規則與 On Demand；尚未確認有可用項目時，後續設定無法補回缺少的連線資料。
無法連線：檢查選取項目與系統授權
若項目已存在，但開啟連線後立即停止，請先檢查 Home 中的選取標記，以及系統 VPN 設定授權是否已完成，再查看 App 提示。切換網路環境可用於對照，但請維持同一伺服器與相同參數。不要同時重建訂閱、修改連接埠並切換模式，否則難以追查成功或失敗的原因。
測試結果與實際存取不一致：核對 Test Method 與 DNS
進入 Settings 查看 Test Method，確認測試方式是否符合要驗證的項目。有些測試只涵蓋部分連線狀況，因此應搭配實際存取結果判斷。若網域無法解析，但其他連線仍正常，再檢查 DNS。先記錄目前值與 Config，不要直接加入多個解析位址。關於系統 DNS、自訂 DNS 與 DNS over HTTPS 的進一步選擇，請參閱DNS 設定說明。
連線行為不如預期：檢查 On Demand
若連線會依網路條件自動啟動，或行為與手動開關的預期不同，請檢查 Settings 中的 On Demand 及其條件。初次排查時先記錄目前狀態，維持手動連線條件穩定，再決定是否調整。On Demand 的預設值以目前 App 顯示為準，不要只因其他人的設定不同就直接照搬。
仍無法排除：保留必要的診斷資訊
需要進一步分析時，再查看 Diagnostics 或目前 App 提供的相關日誌。初步只需記錄發生時間、操作步驟、錯誤提示、使用的 Type 與最後套用的策略。分享前請遮蔽訂閱連結、伺服器驗證資訊，以及與問題無關的存取記錄。日誌可能包含目標網域與位址，不宜整份公開。
若已找到可用設定，請先恢復正常使用，再逐項處理需要最佳化的選項。Settings 中的 Proxy、TCP、UDP 等項目屬於進階連線行為設定，首次連線不必全部調整。各項目說明與設定建議請參閱Settings 選項手冊；若要重新依序操作，可返回本教學的 Add Server 步驟確認資料匯入方式。
