Shadowrocket 使用教學
匯入設定與連線驗證

已有訂閱連結：使用 Subscribe

開啟 Shadowrocket 的 Home，在 SERVER 分組附近找到 Add Server。進入新增頁面後點選 Type，選擇 Subscribe，再將使用者已有的完整訂閱連結填入對應的網址欄位。訂閱連結不是一般網站首頁，也不是單一伺服器網域；請使用服務商明確提供給使用者的訂閱網址。複製時注意保留問號後的參數，不要混入空格、換行、引號或聊天訊息中的說明文字。

填入方便辨識的備註後儲存，等待讀取訂閱內容。返回 Home，檢查是否出現訂閱分組及其伺服器項目。如果只有分組名稱，卻沒有伺服器，請勿立即開啟連線開關；先檢查訂閱是否讀取成功，再核對網址是否完整、訂閱權限是否仍有效。更新訂閱會重新取得遠端內容，手動修改訂閱中的伺服器參數可能在更新後遭到覆蓋；若要長期調整，應先確認設定檔來源。

已有單一伺服器資訊：依 Type 填寫

如果取得的是逐項參數，請先在 Add Server 選擇對應的 Type，再填寫 Host、Port 以及該類型要求的驗證資訊。官方截圖中的 Password、Method 等欄位對應截圖所選的類型，並非所有協定都使用相同欄位。Shadowsocks、VMess、VLESS 或 Trojan 等類型應分別依照已有資訊填寫，不要只因欄位看起來相似就互相替換。

Host 通常填寫網域或 IP 位址，不要自行加上網頁路徑；Port 應與伺服器提供的連接埠一致。若已有資訊也包含 TLS、傳輸方式、路徑或其他參數，請一項一項核對。儲存前再次檢查容易遺漏的首尾字元，尤其是複製而來的驗證內容。不確定某項代表什麼時，請先向自己的服務商確認，不要猜測數值並反覆嘗試。

已有 QR Code：使用 Scan QR Code

若已有相容的設定 QR Code，可從 Scan QR Code 進入掃描流程；系統要求相機權限時，依實際需要允許。掃描完成後仍須檢查辨識出的 Type、Host 和 Port，再進行儲存。Import from Cloud JSON 是另一個匯入入口，不要將一般訂閱網址、網頁網址與 JSON 設定檔混為一談。QR Code 和訂閱連結都可能包含存取憑證，請勿轉傳至公開討論區。

返回 Home 後，在 SERVER 分組選擇剛新增的伺服器。此時清單出現項目只代表資訊已儲存，不代表伺服器一定可連線。下一步先決定請求的處理方式，再開啟連線開關，才能有依據地驗證結果。

新增完成後返回 Home，點選 Global Routing 查看目前模式。本教學以設定檔(Config)、代理(Proxy)、直連(Direct)說明三種選擇。初次使用時，不要只記住某個選項的位置；請先確認這次測試要回答什麼問題：是驗證伺服器能否運作，還是確認規則是否依預期分流。這兩種目標需要分開觀察，不能只用一次開啟網頁的結果證明所有設定都正確。

設定檔(Config)：依目前設定檔處理

日常需要依規則分流時，請選擇設定檔(Config)。接著進入 Config 頁面，確認目前啟用的是自己準備使用的設定檔，而不只是確認檔案已存在。伺服器訂閱與規則設定是兩類內容：前者提供連線資訊，後者描述請求如何處理；匯入訂閱不代表已完成符合個人需求的規則設定。

官方 Config 截圖顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。初次使用只要確認設定檔來源、目前啟用狀態，以及 Rule 中的處理方式即可，不必逐段修改。需要編輯時，先保留副本，再透過 Add Rule 或既有的規則編輯入口逐項調整。尤其不要為了讓一次測試通過而同時修改 Hosts、DNS 相關設定與規則，否則發生異常時很難判斷是哪項變更造成的。

代理(Proxy)與直連(Direct)：用於比對

代理(Proxy)可將測試重點放在目前選取的代理連線，適合暫時判斷伺服器參數與連線是否可用，但不代表所有應用程式、所有類型的請求都必然有相同結果。直連(Direct)則用於直連比對；在此模式下網頁能開啟，不能據此判定伺服器連線已成功。完成比對後，應恢復原先預計使用的模式。

例如，Rule 中的 DOMAIN-SUFFIX,example.com,PROXY 表示比對 example.com 及其子網域，並交由 PROXY 處理；它不是可用的伺服器資訊，也不能取代訂閱。規則會依設定檔中的順序比對，較前面的命中項目可能改變後續結果。初次連線不需要編寫複雜規則，先使用已確認來源與用途的設定檔。更多規則限制與異常狀況請參閱故障排查，常見概念請參閱疑難排解。

現在返回 Home，確認 SERVER 分組中已選取要測試的伺服器，並記下 Global Routing 目前的值。點選頁面頂部的連線開關；尚未連線時會看到 Not Connected。首次建立連線時，系統可能會出現新增 VPN 設定的授權提示。確認要求來自 Shadowrocket 後允許，並依系統要求完成裝置驗證。這個步驟是允許客戶端建立系統網路設定，不是購買線路或取得訂閱。

完成授權後返回 Home，觀察開關與連線狀態是否維持。如果先前曾取消授權，請再次開啟連線開關並查看系統提示；不要因為曾點過一次開關，就認為授權已完成。iPad 的頁面配置可能因螢幕寬度而有所不同，但仍可依 Home、Global Routing 和 SERVER 這些介面用語尋找對應位置，不必逐一對照截圖中的像素位置點選。

開關已開啟，只能證明客戶端進入連線流程；系統顯示 VPN 狀態也不代表遠端伺服器、網域解析和每條規則都已驗證成功。因此此時先不要批次更換節點或匯入更多設定，而應繼續完成下一步測試。保持目前的伺服器、網路和模式不變，後續觀察才有比較基準。

如果開關開啟後立即關閉，先查看是否有權限提示或錯誤說明，再檢查系統中的 VPN 設定是否允許使用。受組織管理的裝置可能受到網路權限政策限制，請向裝置管理者確認，不要自行刪除管理設定。如果裝置上同時有其他 VPN 連線，請先停止衝突的連線再重試；不確定用途時不要刪除系統設定。

準備更換伺服器或大幅修改設定檔前，可先關閉連線，儲存變更後再重新開啟。這樣可以確認目前使用的資訊，也能避免將舊連線狀態誤認為新設定的結果。若之後發現自動重新連線，先記錄狀況，再到 Settings 檢查 On Demand，不要連續反覆切換開關。

儲存或匯入失敗：檢查輸入內容

訂閱讀取失敗時，先確認完整網址是否複製成功、目前網路能否連線至訂閱所在的服務，以及使用者自己的訂閱權限是否有效。伺服器項目儲存失敗時，檢查 Type 與必填欄位，不要試圖透過更換 Global Routing 解決輸入錯誤。訂閱更新成功卻沒有預期項目時，先核對回傳內容與分組，再聯絡自己的服務商確認；不要將連結貼到公開頁面請他人代為測試。

開關無法維持：檢查授權與系統狀態

如果問題發生在開啟開關的當下，優先檢查系統授權是否完成，以及是否有其他 VPN 連線或裝置管理政策造成影響。如果關閉後又自動連線，請進入 Settings 查看 On Demand 是否啟用，並核對觸發條件。On Demand 用於依條件連線，無法修正伺服器密碼或連接埠錯誤；為排查問題而暫時調整時，請記下原本設定，驗證後依自己的使用需求恢復。

測試逾時：檢查參數與 Test Method

開啟 Settings 可查看 Test Method 等選項。測試方式不同，結果代表的意義也可能不同，因此請先確認目前採用的方式，再解讀 Connectivity Test 的結果。對照既有伺服器資訊檢查連接埠、驗證、TLS 和傳輸參數，並確認系統日期與時間正確。如果只在一種網路下失敗，可在條件允許時改用另一種網路重新測試，但每次切換後都應再次確認連線狀態。

只有部分請求失敗：檢查設定檔與 Diagnostics

部分網頁異常時，不要立即將所有請求長期改為 Proxy。先依照上一步的模式進行測試，檢查 Config 中是否有更早命中的規則，再搭配 Settings 的 Diagnostics 與可用記錄找出問題。截圖中的 Proxy、TCP、UDP 是設定分類，不應視為必須全部修改的修復清單。只有證據指向特定選項時，才調整相應設定。

需要分享診斷資訊時，先移除伺服器位址、驗證資訊、訂閱參數，以及可能辨識個人瀏覽內容的記錄。單次故障無法判斷原因時，保留最少的重現步驟，比反覆刪除應用程式更有幫助。重新安裝前先備份既有設定，否則還會增加重新匯入與還原的工作。

本頁到此完成初次上手的完整流程。若持續逾時、DNS 異常、更新後出現異常或遇到 iPad 特定問題，請前往故障排查依症狀逐項處理；介面用語與日常使用疑問可參閱疑難排解。繼續排查時，沿用本頁「每次只修改一項、使用相同目標重新測試」的方法，避免增加新的不確定因素。