Shadowrocket 使用教學
既有設定 → 選擇模式 → 連線驗證
本頁說明首次使用的必要步驟。先使用既有伺服器設定完成連線，再處理規則細節與自動連線條件，避免同時變更多項設定。
以下以 iPhone 與 iPad 的操作流程為例。截圖用於辨識頁面與欄位，不代表你的清單應與圖中完全相同。不同協定需要在 Add Server 填寫的欄位也不同，請以目前選取的 Type 和自己的設定資料為準。
- 先確認 設定完整
- 再檢查 連線狀態
- 每次只變更 一項條件
Add Server：新增伺服器或匯入訂閱
先依手邊資料選擇一種新增方式，不必重複匯入同一份資料。
開啟 Shadowrocket，進入 Home。在 SERVER 區域找到 Add Server，或使用頁面上的新增入口。先查看 Type，這會決定後續欄位的用途。若取得的是單一伺服器參數，請依資料指定的協定選擇；若取得的是訂閱連結，請選擇 Subscribe。不要只憑網址外觀猜測協定，也不要將訂閱連結拆開填入 Host 和 Port。
手動輸入伺服器參數
進入 Add Server 後，先選擇與資料相符的 Type，再填寫 Host、Port 及該類型要求的其他欄位。Host 通常是伺服器網域或位址，Port 則是連接埠；Password、Method 等欄位僅在相應協定下按需填寫。不同協定的驗證方式不盡相同，不可將一種協定的填寫方式套用到另一種協定。TLS、傳輸方式等額外項目請依既有資料設定，不要為了嘗試連線而任意切換。
確認複製的內容沒有多出空格、換行或中文標點，尤其要留意連接埠數字與驗證資料是否完整。可以填寫方便辨識的備註，儲存後返回 Home，確認 SERVER 中已出現相應項目。備註有助於區分設定，但修改備註不會改變伺服器連線參數。
匯入既有訂閱連結
在 Add Server 的 Type 中選擇 Subscribe，將自己的完整訂閱連結填入相應的 URL 欄位，儲存後等待取得結果。訂閱連結可能包含識別服務權限的資訊，請從原始資料完整複製，不要刪除問號後的內容，也不要一併貼上聊天訊息中的說明文字。成功儲存訂閱記錄，不代表已成功取得伺服器清單；返回 Home 後，還要確認 SERVER 中確實出現可選項目。
若持有的是 QR Code，可依資料格式使用 Scan QR Code；Import from Cloud JSON 則是特定格式的匯入入口，並非所有訂閱連結都適用。請依資料的實際格式選擇入口；不確定格式時，先向自己的服務供應商確認。不要在不同入口重複匯入同一份內容，以免後續選擇與排查變得混亂。
清單仍是空的話，先確認連結是否完整、目前網路能否取得該連結，以及既有服務狀態是否正常。暫時不要編輯規則，因為規則無法補上尚未匯入的伺服器。清單出現項目後，先保留目前記錄，接著選擇 Global Routing。更多匯入問題請參閱常見問題中的訂閱與節點匯入說明。
完成本步的判斷方式：Home 的 SERVER 中已有可辨識的伺服器項目，而不只是儲存了一筆訂閱記錄。
Global Routing：選擇連線模式
三種模式決定連線採用哪種策略，不會取代伺服器資料，也無法修正錯誤參數。
返回 Home，點開 Global Routing。三種模式分別為設定檔(Config)/代理(Proxy)/直連(Direct)。先確認這次的目的：是要測試所選伺服器是否可用，還是依既有規則進行日常分流。選擇後返回 Home，查看 Global Routing 顯示的目前設定，避免以為已切換，實際上仍停留在原本的模式。
Config：依目前設定檔規則判斷
設定檔(Config)會依據目前設定檔中的規則，決定連線採用的策略。訂閱中的伺服器清單與 Config 設定檔的用途不同：前者提供可選的連線資料，後者則說明如何判斷流量。匯入訂閱後，不能只因清單中出現項目，就認定分流規則也已備妥。使用 Config 前，請進入 Config 確認目前使用的設定檔，並查看 Rule 中的規則與順序。
右側官方截圖顯示設定檔編輯頁中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule。首次連線不需要逐一修改這些區段；尤其不要只因看到進階項目就直接啟用或編輯。先使用自己了解且來源明確的設定檔，待連線驗證完成後再調整規則。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT僅供理解規則語法：依網域後綴或位址範圍比對，未符合的項目由 FINAL 處理；這不是要你整段取代設定檔。
Proxy 與 Direct：釐清測試目的
代理(Proxy)會透過代理路徑處理連線，適合初次排查時用來減少規則比對帶來的變因。但仍須有可用的伺服器設定；若 Host、驗證資料或服務狀態有問題，切換至 Proxy 並不會自動修復。測試通過後，若日常使用目的是依規則分流，請切回 Config，並重新確認實際連線。
直連(Direct)使用直接連線路徑，適合確認基本網路存取是否正常，但不能證明代理伺服器可用。在 Direct 下能開啟某個頁面，只代表這次直接連線成功，不能據此判定所選伺服器正常。初次驗證既有伺服器時，可先使用 Proxy 完成連線與測試，再切回 Config 檢查分流。
若規則需要更細緻的比對順序、策略引用或 DNS 配合，請接著閱讀完整手冊。本教學先維持明確的測試模式，首次連線時不疊加多項設定變更。
完成本步的判斷方式：能在 Home 確認目前模式，並知道接下來要驗證伺服器路徑或規則分流。
Home：選取伺服器並開啟連線
先選擇 SERVER，再開啟頂端開關，最後確認連線狀態是否維持。
返回 Home，在 SERVER 中找到本次要測試的伺服器，點選項目左側的圓點，將它設為目前的預設伺服器。請分清楚「選取伺服器」與「開啟詳細資料編輯」：這裡只需指定要使用哪一項，不必重新填寫資料。若清單中有多個相似備註，先確認它們對應的訂閱群組或伺服器資料，避免測試到另一項設定。
再次確認 Global Routing 符合上一步的測試目的，然後開啟 Home 頂端的連線開關。未連線時會顯示 Not Connected。首次建立連線時，系統可能會要求允許新增 VPN 設定；請確認提示中的 App 名稱與目前操作相符，再依系統流程確認，可能還需要驗證裝置。這裡授予的是建立系統 VPN 設定的權限，不是填寫伺服器驗證資料的頁面。
若取消權限提示，連線流程可能無法繼續。返回 Shadowrocket 後重新發起連線，依實際出現的系統提示操作即可。若裝置受組織管理或系統限制，請先確認裝置允許的設定範圍，不要反覆修改伺服器密碼來處理權限問題。
確認權限後返回 Home，查看頂端連線狀態是否從 Not Connected 變為已連線，並確認開關沒有立即關閉。系統顯示的 VPN 狀態可作為隧道已建立的輔助資訊，但不能取代實際連線驗證。顯示已連線只代表連線流程已建立，不代表所有目標位址都能正常存取，也不代表 Config 中的每條規則都符合預期。
iPad 上的操作方式相同：先確認目前伺服器與 Global Routing，再處理系統權限。即使已在另一部裝置使用過 Shadowrocket，仍須在本機分別確認權限與設定資料。下一步請維持目前伺服器與模式不變，進行 Connectivity Test 並實際連線，以便將結果對應到同一組條件。
完成本步的判斷方式：已明確選取伺服器，連線開關能維持開啟，Home 不再顯示 Not Connected。
Connectivity Test：確認連線是否正常
一併檢視測試結果、實際連線與目前模式；單一項目成功不能取代完整驗證。
在 Home 點選 Connectivity Test，等待本次測試完成，再查看所選伺服器的結果。測試可用來觀察目前條件下的連線狀況；測試有結果不代表所有 App、網域或連線方式都一定成功，逾時也不能單獨證明伺服器資料有誤。測試方法、目前網路及目標的回應狀況都可能影響結果，請再與實際連線交叉確認。
接著開啟瀏覽器，造訪自己熟悉且有權存取的頁面，確認內容是否完整載入，而不只是顯示已快取的標題或圖片。保持伺服器、Global Routing 與網路環境不變，必要時重新整理再試。若同時切換網路、修改 DNS 並更換伺服器，就很難判斷是哪一項造成變化。
接著進入 Data，觀察使用前後的流量是否相應變化。Data 可用於了解使用狀況，但累計數字不能直接作為某個頁面已透過代理連線的證據。尤其使用 Config 時，部分請求可能採用 DIRECT，其他請求則採用 PROXY；即使頁面能開啟，仍須搭配規則判斷流量是否走了預期路徑。
若剛才暫時使用 Proxy 測試伺服器，確認實際連線正常後，再切回設定檔(Config)進行第二次測試。同一伺服器在 Proxy 下可用，切回 Config 後卻異常，應優先檢查目前設定檔與 Rule，而不是立刻重新匯入訂閱。反之，在 Direct 下能連線也不能證明代理路徑正常，兩者應分別判斷。
完成驗證後，記下這組可正常運作的條件：所選伺服器、目前模式、使用的設定檔與網路環境。之後遇到問題時，先與這組條件比較，比反覆切換開關更容易找出變化。若想進一步了解流量判讀或規則判斷，請參閱完整手冊中的連線與 Data 說明。
完成本步的判斷方式：實際連線符合預期，並能說明目前使用的是 Proxy、Direct，還是 Config 中的規則策略。
Settings：依失敗環節排查
先找出問題發生在哪個步驟，再決定要檢查哪個頁面。
遇到異常時，先記錄現象：清單為空、開關無法維持、測試逾時，還是只有特定頁面失敗。不同現象涉及不同環節，不宜用相同方式處理。請依以下順序逐項檢查，每完成一項就用原本條件重試，並保留尚未變更的資料，以便比對。
清單為空：返回匯入步驟檢查
先確認裝置的基本網路正常，再核對 Subscribe 中的完整 URL 與取得結果。連結遭截斷、既有服務狀態變更或訂閱內容無法解析，都可能導致清單為空。向自己的服務供應商確認時，只需說明匯入結果與發生環節，請勿公開完整訂閱連結。此時修改 Global Routing 或 Rule 並無幫助，因為目前尚未取得可選伺服器。
開關無法維持開啟：先檢查權限與目前選擇
確認 SERVER 中已明確選取伺服器，並已完成系統新增 VPN 設定的流程；同時檢查裝置管理限制或其他已啟用的 VPN 連線。依系統提示處理目前連線狀態後再試，不要直接刪除所有設定。若問題只在更換網路後出現，先切回原本的網路重新測試，確認是否與網路環境有關。
已連線但無法存取：區分參數與規則問題
重新核對 Type、Host、Port、驗證資料及設定資料要求的額外參數，逐項比對，不要憑記憶填寫。接著檢查 Global Routing：若原本使用 Config，可暫時改用 Proxy 進行比對；若只有 Config 異常，請優先檢查目前設定檔、規則順序與目標對應的策略。若只有部分網域無法連線，也應檢查 DNS 與規則比對，而不是反覆切換所有選項。
測試結果與實際連線不一致：檢查診斷條件
進入 Settings，查看 Test Method 目前選用的測試方式。不同測試方式檢視的條件不同，不能將單一測試結果套用到所有連線。若需進一步定位問題，請使用 Diagnostics，並依其中實際提供的項目檢查。儲存或轉述診斷資訊前，請隱藏自己的訂閱連結、驗證資料及不希望公開的瀏覽記錄。
初次排查期間，先維持手動連線。On Demand 用於依條件觸發連線，適合在手動連線穩定後再設定；若開關狀態與手動操作不一致，也請確認 On Demand 是否已啟用。Settings 中的 Proxy、TCP、UDP 等項目不必為了嘗試連線而全部變更，請優先保留既有設定，只調整與目前現象直接相關的項目。
排查完成後，將測試期間暫時變更的模式恢復為日常所需設定，再進行一次實際連線驗證。問題仍未解決，請前往常見問題依現象繼續查找；規則、DNS 與長期維護相關說明則收錄於完整手冊。回報問題時，請說明失敗步驟、目前模式與已驗證的條件，比只寫「無法連線」更有助於找出原因。
完成本步的判斷方式：已將問題範圍縮小至匯入、權限、伺服器參數或規則其中一個環節，並具備可重複測試的條件。
