Shadowrocket 使用教學
先匯入既有資料，再選擇 Global Routing，最後檢查連線與請求。依照五個問題逐步操作，不必先變更所有設定。
閱讀順序：有訂閱連結，選擇 Subscribe；有單一伺服器資料，選擇手動新增。完成其中一種方式即可，之後進入相同的連線檢查流程。
伺服器資料要在哪裡輸入？
從 Home 開啟 Add Server；訂閱與手動新增是兩種不同的輸入方式。
先確認手邊資料的類型，再進入 Add Server。用於更新伺服器清單的網址屬於訂閱連結；只有 Host、Port、Password 等欄位的資料，則需依協定手動填寫。不要把訂閱連結當成 Host，也不要把單筆伺服器分享內容直接當成訂閱網址。若不確定資料用途，先向自己的服務商確認格式，避免反覆嘗試不相關的 Type。
已有訂閱：選擇 Subscribe
開啟 Shadowrocket，在 Home 下方的 SERVER 區域找到 Add Server，或使用頁面上的新增入口進入 Add Server。開啟 Type，從可選類型中選擇 Subscribe，再將自己的完整訂閱連結填入對應的 URL 欄位。訂閱網址可能包含身分驗證資料，複製時請保持參數完整，避免多出前後空格、換行或聊天文字。
- 確認網址來自自己的服務商，並確認複製的是訂閱網址，而非帳戶管理網頁。
- 依頁面提示儲存訂閱；返回 Home 後等待取得結果，必要時使用該訂閱項目的更新功能。
- 展開回傳的群組，確認其中出現可選取的伺服器項目。若只有訂閱名稱而沒有實際項目，應先處理更新問題。
匯入訂閱會讀取遠端內容，不等於取代應用程式的所有設定。匯入後先檢查 SERVER 清單是否完整，再進行下一步。若網址更新失敗，先不要重新購買用戶端；應先檢查連結是否有效、原始網路是否可用，以及自己的服務是否仍可使用。
已有單一伺服器：依 Type 填寫欄位
再次從 Home 進入 Add Server，先選擇與原始資料一致的 Type，再逐項填寫。以介面中顯示的 Host、Port、Password、Method 為例，Host 填入伺服器位址，Port 填入資料中的連接埠，Password 和 Method 分別對應驗證資料與加密方式。不同 Type 顯示的欄位不盡相同，不能將一種協定的欄位順序套用到另一種協定。
儲存前逐字核對大小寫、連接埠和驗證內容；若資料另有指定 TLS、SNI 或傳輸設定，也請依原始說明填寫。不要為了「試試看」而隨意切換協定或加密方式。若資料提供 QR Code，可使用 Scan QR Code 讀取；Import from Cloud JSON 是另一種匯入入口，只有手邊資料確實採用該格式時才使用，不需要為了完成本教學額外設定。
完成輸入後，下一步不是立刻修改 DNS 或開啟進階選項，而是確認 Global Routing 的處理方式。這樣才能區分「伺服器本身無法使用」與「規則選擇了不同策略」。
Global Routing 要選哪一種？
日常依規則處理時選配置(Config)；代理(Proxy)與直連(Direct)可用於比對檢查。
Global Routing 決定請求採用哪一類處理方式，不會補齊伺服器資料。返回 Home，開啟 Global Routing，先確認目前選取的項目。介面中的配置(Config)、代理(Proxy)、直連(Direct)分別代表依配置分流、使用代理路徑和直接連線；選擇模式後返回 Home，再繼續操作。不要混淆模式名稱與 Config 底部頁面：前者選擇處理方式，後者管理配置檔。
| 模式 | 本次入門操作 | 判斷範圍 |
|---|---|---|
| 配置(Config) | 已有可信任的配置時，用它檢查規則分流。 | 結果取決於目前配置內容及比對順序。 |
| 代理(Proxy) | 需要單獨檢查所選代理連線時使用。 | 不保證連線可用，仍須驗證實際請求。 |
| 直連(Direct) | 作為原始網路的比對條件。 | 頁面能開啟，不代表流量經過所選代理。 |
配置(Config)：先查看目前配置
切換到 Config，確認目前使用的配置檔，再進入查看或編輯頁面。官方畫面中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同設定區段；初次使用只需了解位置，不必逐項開啟或變更。進入 Rule 可以查看規則，Add Rule 用於新增規則。訂閱中的伺服器清單與這裡的規則檔用途不同，更新前者不代表後者已依照你的需求設定。
規則通常依序比對，最先符合的條件會決定採用的策略。較具體的網域條件應放在適當位置，FINAL 用於處理未符合前面條件的請求。以下僅展示規則語法，並非建議整段取代現有配置的清單；PROXY 是否為有效策略，仍須依目前配置中的實際定義確認。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXYDIRECT 表示直接連線，REJECT 表示拒絕請求；PROXY 指向配置中的代理策略。規則未符合某個網域時，請求可能繼續套用後續條件，因此「清單中寫過這個網域」不代表「實際一定會套用該條規則」。排除問題時應一併檢查規則位置、策略名稱和請求記錄，不能只看單一行文字。
先保留能說明的設定
若尚未確認配置內容，可以先用代理(Proxy)檢查已輸入的伺服器，再切回配置(Config)觀察差異。不要同時新增規則、修改 Hosts 和開啟 HTTPS Decryption；一次變更多個變數後，很難判斷是哪個步驟造成變化。完成比對後，應切回符合日常需求的模式。若要了解配置檔管理與較完整的規則說明，可先透過本頁故障排除步驟定位問題，再依具體主題繼續查閱官方手冊。
如何開啟 VPN 連線？
先選擇伺服器，再開啟 Home 頂端開關；首次連線時需處理系統權限提示。
在 Home 選擇實際伺服器後，開啟頂端 Not Connected 對應的開關。先確認 SERVER 中選取的是剛才核對過的項目，而不是只停留在訂閱群組名稱。再確認 Global Routing 是否為上一步準備測試的模式。畫面中的 Not Connected 表示截圖當時尚未連線，不是需要手動輸入的設定值。
- 返回 Home，在 SERVER 清單中點選要測試的伺服器。資料較多時，先只選擇一個已確認參數的項目。
- 開啟 Home 頂端的連線開關，留意系統是否顯示新增 VPN 設定的提示。
- 確認提示對應 Shadowrocket，再允許新增；依系統要求完成裝置驗證，然後返回應用程式。
- 觀察連線狀態是否穩定。若開關立即切回，先記下提示文字，不要快速連續切換。
允許新增 VPN 設定是建立本機 VPN 連線所需的系統步驟，不會替使用者產生訂閱或驗證資料。若首次誤按取消，重新開啟連線開關並依實際提示處理即可；若提示沒有再次出現，可到系統設定中的 VPN 管理位置確認設定狀態。裝置受管理策略限制時，請向裝置管理人員確認權限，不能透過修改伺服器密碼解決系統權限問題。
先以手動連線建立基準
第一次測試建議先手動開啟或關閉連線，不必急著啟用 On Demand。On Demand 會依設定條件觸發連線，適合在基礎連線已可用後再設定。若尚未了解觸發條件，可能會出現手動關閉後又重新連線的情況，進而誤以為開關異常。若目前正在使用其他 VPN 連線，也應先確認實際啟用的設定，避免把另一條連線的狀態當成 Shadowrocket 的結果。
本步完成標準是系統允許新增設定，且應用程式顯示已建立連線；但這只能表示本機連線流程已完成，不能只憑開關狀態斷定遠端伺服器可用。請繼續下一步，以實際請求驗證；若連線無法維持，請直接前往故障排除，先檢查權限與項目參數。
如何確認連線已生效？
分別檢查系統狀態、Connectivity Test 與實際瀏覽，不要以單一結果代替全部判斷。
連線是否建立、伺服器是否有回應、請求是否採用正確策略，是三個不同問題。先在關閉連線時確認 Wi-Fi 或行動網路本身可用，再開啟 Shadowrocket 連線，造訪平時使用的網頁。如果原始網路尚未完成登入認證，或裝置根本沒有網路，請先處理這一層問題，再檢查用戶端。
先測試項目，再測試實際請求
返回 Home 使用 Connectivity Test，查看目前伺服器的測試結果。測試方式會受到 Settings 中 Test Method 等設定影響；測試完成不代表所有網站和應用程式都能正常使用，測試失敗也不能直接證明訂閱網址已失效。請一併參考同一伺服器的測試結果與實際瀏覽情況，而不是測試後立刻變更所有參數。
接著開啟熟悉的頁面，確認是否完成載入，而不只是顯示快取內容。需要查看新請求時，可重新載入頁面，再到 Data 查看這次操作對應的記錄。依應用程式實際顯示核對目標網域與可見的策略資訊；若記錄沒有提供某個欄位，就不要只憑連線圖示推斷已套用特定規則。
透過模式比對縮小範圍
若代理(Proxy)下可以瀏覽，但配置(Config)下失敗，請優先檢查目前配置及 Rule，而不是立刻刪除伺服器。若直連(Direct)可以瀏覽，但代理(Proxy)失敗，請回頭確認所選伺服器與服務狀態。每次只變更一項條件，並盡量維持伺服器、目標頁面與網路環境相同，才能讓兩次結果具有參考價值。
- 系統層：連線開關能維持開啟，系統 VPN 設定處於相應狀態。
- 連線層：所選伺服器通過測試，或實際請求能透過該伺服器完成。
- 規則層：配置(Config)下的請求記錄與預期策略一致。
瀏覽器顯示的出口位址只能反映該次請求，不能代表所有應用程式都採用相同路徑。不同網域可能符合不同規則；同一個頁面也可能同時請求多項資源。若只有圖片或某項功能失敗，請保留相關目標的記錄以便進一步排查，不要把局部失敗概括成「全部都無法連線」。
連線失敗時該從哪一步檢查？
依發生階段排除問題；保留原始配置，每次只變更一項條件。
先找出失敗階段，再開啟對應設定。Settings 中的 Language、Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 用途各不相同，排除問題時不必全部修改。先保留目前配置的副本或記錄原始值，再進行有目標的檢查；匯出的配置也可能含有驗證資料，請妥善保管。
訂閱無法更新：檢查連結與原始網路
若 Subscribe 儲存後沒有回傳實際項目，先檢查完整 URL 是否遭截斷、是否誤複製帳戶頁面，以及連結是否仍有效。確認裝置未連線時能正常上網，再重新更新一次，並記下具體錯誤。驗證或服務狀態問題請向自己的服務商確認；不要將含有驗證資料的完整連結貼到公開問答區，也不要透過變更 Global Routing 掩蓋尚未匯入訂閱的前置問題。
已出現項目但無法連線：逐項核對資料
開啟該項目的編輯頁面，依原始資料檢查 Type、Host、Port 和驗證欄位，再核對協定要求的傳輸參數。訂閱管理的項目請先更新再測試，避免手動修改被後續更新覆蓋而不自知。若所有項目在同一網路都失敗，可在自己有權使用的另一種網路上進行比對；若只有單一項目失敗，請著重檢查該項目及其遠端服務狀態。
開關立即關閉：先檢查權限與系統提示
確認系統是否允許新增 VPN 設定，以及目前是否有其他 VPN 設定正在使用。記下應用程式或系統顯示的錯誤文字，然後在 Settings 查看 Diagnostics 提供的診斷資訊。診斷資料可能包含網域、位址與請求記錄，提供給相關支援人員前請先遮蔽敏感內容。系統權限失敗與伺服器驗證失敗是不同階段，不能以反覆切換 Method 取代權限檢查。
VPN 已連線但網頁無法開啟：檢查模式與請求
返回 Global Routing，依本頁的驗證步驟分別比對配置(Config)與代理(Proxy)。只有配置(Config)失敗時，檢查 Rule 順序、策略引用和最終處理規則；所有代理請求都失敗時，優先確認伺服器。若網域相關請求表現異常，再依可見記錄檢查解析設定；不要一看到頁面錯誤就同時清除 Hosts、修改 DNS 並重設配置，否則會失去可供比對的基準。
測試結果與應用程式表現不同：核對 Test Method
在 Settings 查看 Test Method，確認目前測試衡量的連線條件。部分服務需要 UDP，普通網頁能開啟不代表相關服務已可使用；同樣地，某項測試未通過，也不一定代表 TCP 網頁請求全部失敗。請依伺服器能力、目前配置和具體服務分別確認 Proxy、TCP、UDP 相關選項，不要直接套用與自己協定無關的參數。
關閉後又自動連線：檢查 On Demand
若手動關閉後又重新連線，先查看 Settings 的 On Demand 是否已啟用，以及目前條件是否會再次觸發連線。暫時停止自動觸發後再進行手動測試，有助於區分自動連線行為與網路故障。基礎連線穩定後，再恢復符合自身需求的按需條件；入門測試不必保留尚未了解的自動化設定。
若仍無法定位問題，請整理「在哪一步失敗、使用什麼模式、錯誤文字、是否只有單一伺服器受影響、切換網路後是否相同」等資訊。若涉及帳戶與商店取得問題，可繼續閱讀取得指南；需要重新確認安裝管道時，請前往用戶端下載頁。不要一開始就刪除所有項目或解除安裝應用程式，以免遺失可供比對的資料。
