官方手冊 · iPhone / iPad
Shadowrocket 使用教學
先匯入既有連線資料，再選擇 Global Routing，最後開啟開關並確認實際連線。本頁依首次設定的順序說明操作；已完成的步驟可透過目錄跳過。iPhone 與 iPad 均可依介面上的英文項目名稱操作，實際版面以目前應用程式顯示為準。
備妥資料後，先分清兩種輸入方式：訂閱連結用來取得一組連線項目，單一伺服器資料則用於手動新增一筆連線，兩者不必重複輸入。訂閱也不等於規則設定檔；前者提供伺服器資料，後者決定請求如何分流。首次操作請先建立一筆可供確認的連線，再處理較複雜的規則。
Home → Add Server
步驟一：新增伺服器或匯入 Subscribe
依照手邊資料選擇一種匯入方式。儲存後，先確認 Home 中的 SERVER 項目，再進入模式選擇。
已有單一伺服器資料：填寫 Add Server
開啟 Home，在 SERVER 區域附近點選 Add Server。進入編輯頁面後，先點選 Type，選擇資料所指定的協定。選定 Type 後，頁面欄位會依協定而變化；截圖中的 Host、Port、Password、Method 只是其中一種欄位組合，不代表所有協定都必須填寫相同內容。
在 Host 填入既有伺服器位址，在 Port 填入連接埠，再依資料填寫驗證與加密欄位。Host 通常填寫網域名稱或 IP 位址，請勿自行加上網頁路徑；Password 請保留原有大小寫與符號，貼上後確認前後沒有多餘空格。Method 必須與伺服器資料一致，不要為了讓頁面成功儲存而任意更換。如果資料還包含其他驗證或傳輸參數，也應逐項對照目前頁面填寫；資料不完整時，請先向自己的服務供應商確認。
如果既有資料以 QR Code 提供，可使用 Scan QR Code。掃描後仍須確認 Type、Host 和 Port 與原始資料相符，再儲存。Import from Cloud JSON 是用於特定格式的匯入入口，請勿將一般訂閱連結直接填入。若內容無法辨識，請先確認資料格式，不要反覆切換協定嘗試。
已有自己的訂閱連結：選擇 Subscribe
同樣從 Add Server 進入，開啟 Type 並選擇 Subscribe，在 URL 欄位貼上自己的完整訂閱連結。訂閱網址可能包含查詢參數，這些也是網址的一部分；複製時請勿刪除參數、漏掉換行後的內容或末尾字元。填寫方便辨識的備註後儲存，回到 Home 查看訂閱是否成功取得伺服器項目。
若儲存後只看到訂閱群組，沒有可選擇的伺服器，請先確認是否需要更新該群組，以及畫面是否顯示取得錯誤。更新訂閱時，當前網路必須能連上訂閱網址，且該網址仍須有效。請勿公開傳送訂閱連結，它可能包含存取憑證。如需排查連結失效、驗證或回應格式問題，請參閱疑難排解。
儲存完成後，在 Home 的 SERVER 區域選取要使用的伺服器，並確認目前的選取標記。新增成功只表示資料已儲存至應用程式，不能證明伺服器可以連線。下一步先確認請求的處理方式，再透過測試與實際瀏覽檢查結果。
Global Routing · Config / Proxy / Direct
步驟二：選擇 Global Routing 模式
設定 (Config)、代理 (Proxy)、直連 (Direct) 分別決定請求依規則、透過代理路徑或直接連線處理。
回到 Home，點選 Global Routing 查看選項。這裡變更的是請求處理方式，不會改變匯入來源，也不會替你修正伺服器驗證資料。首次設定時，請先了解目前選項的作用，再開啟連線開關；不要只因某個頁面暫時無法開啟，就同時更改模式、伺服器和 DNS。
設定 (Config)：依目前規則分流
選擇設定 (Config) 時，請求會依目前設定檔中的規則處理。進入 Config 頁面，確認實際啟用的是哪份設定檔，而不只是看到清單中有某個檔案。開啟相應檔案後，檢查 Rule 內容及其引用的策略。設定編輯頁中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 各有不同用途；首次連線不必逐一修改。
規則通常依排列順序判斷，符合條件後便採用相應策略。以下片段僅說明網域後綴與預設規則的寫法，不是為你的網路準備的完整設定，也不應直接取代目前的檔案。example.com 是範例網域；實際目標是否透過代理，應依你的規則與使用需求決定。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT第一行規則會比對 example.com 及其子網域，並採用 PROXY；未符合前面規則的請求則會套用 FINAL，並採用 DIRECT。這也說明了為什麼即使已開啟連線，部分請求仍可能直接連線。若要修改規則，可透過 Add Rule 或編輯現有項目進行；請先保留原設定，再逐項驗證，詳細流程請參閱進階疑難手冊。
代理 (Proxy) 與直連 (Direct)：區分連線路徑
代理 (Proxy) 適合用來暫時確認所選代理路徑是否可用，但實際處理方式仍可能受其他相關設定影響。直連 (Direct) 用於直接連線，不適合驗證遠端代理伺服器。如果在 Config 模式下無法連上某個目標，但 Proxy 模式可以，請優先檢查該目標符合哪一條規則；若代理路徑本身無法使用，請回頭檢查伺服器參數與測試步驟，不要先新增更多分流規則。
選擇後回到 Home，確認 Global Routing 顯示預期模式。日常使用規則分流時，完成驗證後請恢復設定 (Config)，並再次確認啟用的設定檔。此時伺服器與模式都已確認，即可進行連線授權。
Home · Not Connected
步驟三：開啟連線並完成系統授權
先確認選取的伺服器與 Global Routing，再開啟 Home 頂端的連線開關。
在 Home 確認三件事：SERVER 中已有可選項目、已選取預期的伺服器，以及 Global Routing 顯示預期模式。截圖頂端的 Not Connected 表示當時尚未建立應用程式連線。點選旁邊的開關即可開始連線，不必再次進入 Add Server 儲存資料。
首次建立連線時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。這是應用程式使用系統網路延伸功能所需的授權程序。請確認提示中的應用程式名稱，依系統指示允許，並使用裝置目前要求的驗證方式完成確認。若取消授權，連線開關不會因此建立有效連線；請返回應用程式重新操作並完成授權。
完成授權後回到 Home，查看頂端狀態與開關是否維持開啟。應用程式顯示已連線，只代表本機連線功能已啟動，不代表所有遠端伺服器、DNS 請求或目標網頁都已通過驗證。規則仍會決定請求使用代理或 DIRECT；因此，連線狀態與實際可用性應分開確認。
若開關剛開啟就關閉，請先留意是否出現系統提示或應用程式錯誤。不要快速反覆點按開關，也不要立刻刪除所有設定。先確認已完成授權，並檢查裝置是否正在使用其他 VPN 設定，或受到裝置管理限制；受管理裝置的限制應向相關管理單位確認。保留現有資料，依照下方流程找出問題環節。
iPad 的可用空間與版面配置可能不同，但仍可依 Home、SERVER、Global Routing 等英文項目名稱尋找。換用另一台裝置時，須分別確認該裝置的連線授權與目前設定；已安裝應用程式或有購買紀錄，不代表伺服器資料與選取狀態已完成同步。
連線維持後，再切換至瀏覽器進行驗證。測試期間請維持目前的網路環境，不要同時從 Wi-Fi 切換至行動網路，否則難以判斷結果是設定變更所致，還是網路環境改變所致。完成一輪測試後，再分別檢查其他網路環境。
Connectivity Test → 實際瀏覽 → 請求路徑
步驟四：確認連線與規則是否生效
請分別確認兩件事：所選伺服器能否回應測試，以及要瀏覽的目標是否依預期路徑連線。在 Home 開啟 Connectivity Test，查看所選伺服器的測試結果。結果會依目前的測試方式反映相應檢測環節，不能保證所有網頁都可瀏覽、所有協定都正常，或實際傳輸速度符合預期。
測試出現結果後，請在瀏覽器重新開啟原本無法瀏覽的頁面。盡量選擇一個能明確重現問題的目標，不要同時開啟許多頁面。記錄是否完成網域解析、是否開始載入，以及在哪個環節停住。重新整理一次並稍候即可；連續反覆重新整理只會增加連線數量，無助於找出原因。
若要確認規則分流，請查看應用程式提供的連線記錄或日誌，核對目標網域、符合的規則及採用的策略。Config 模式下目標使用 DIRECT，可能正是規則預期的結果；不能只憑系統顯示 VPN 狀態，就認定所有流量都經過代理。Data 中的流量變化可供輔助觀察，但統計數字增加本身不能證明某條規則已符合。
依檢查結果決定下一步
- 測試與實際瀏覽都成功：保留目前的伺服器與設定。若剛才暫時使用 Proxy，請切回 Config，再對同一個目標重新確認。
- 測試失敗，但部分頁面可瀏覽：先確認測試方式與頁面的實際連線路徑。頁面可能採用 DIRECT，測試目標也可能與實際瀏覽的目標不同。
- 測試成功，但頁面無法開啟：檢查該頁面的 DNS、規則策略與連線記錄，不要直接認定伺服器參數都正確。
- 切換網路後結果不同：分別記錄兩種網路的情況，再檢查網路連線限制與解析差異，不要把所有問題都歸因於訂閱。
需要比對時，每次只調整一項。例如只將 Config 暫時切換至 Proxy，其餘設定維持不變，再開啟同一個頁面；結果改變後，才有依據檢查規則。測試完成後，請恢復原本的日常模式。若持續逾時、解析失敗或效能異常，請前往疑難排解依症狀查找，不必在入門階段修改所有進階設定。
Settings · Test Method / On Demand / Diagnostics
步驟五：依失敗環節檢查 Settings
先找出匯入、測試、授權或實際瀏覽的失敗環節。保留原設定，每次只修改一項相關設定。
匯入後沒有伺服器：先確認資料來源
返回 Add Server，確認訂閱使用 Subscribe，不要將連結填入一般伺服器的 Host 欄位。檢查連結是否完整、訂閱是否仍有效，以及更新時是否出現驗證或格式錯誤。若是手動新增，請重新核對 Type、Host、Port 與驗證欄位。能夠儲存不代表參數符合伺服器要求；缺少資料時，請向自己的服務供應商確認，不要根據截圖猜測欄位內容。
Connectivity Test 逾時：先區分測試與連線
進入 Settings 查看 Test Method，確認目前採用的測試方式。不同方式檢查的環節各異，不應將測試結果直接當成應用程式的瀏覽速度。先確認所選伺服器與連接埠，再檢查目前網路是否能連上伺服器。若要用自己的其他既有項目進行比對，請只切換伺服器，並維持模式與網路不變，才能判斷問題是否集中在單一項目。
連線無法維持或自動變更：檢查 On Demand
若連線會因網路狀況而啟動或停止，請檢查 On Demand 是否開啟，以及目前設定的條件。按需連線用來依條件觸發，不是提升速度的開關。初次排查時，可先記錄原本狀態，暫時關閉後手動連線，以區分自動觸發與手動操作；確認原因後，再恢復所需條件。Today Widget 屬於快速操作相關設定，不應用來判斷伺服器是否可用。
測試正常但網頁無法開啟：查看診斷線索
透過 Diagnostics 與應用程式目前提供的日誌查看問題環節，特別留意 DNS 解析、遠端連線與規則策略之間的差異。若只有特定網域無法開啟，請先檢查該目標的記錄，不要立刻更改所有 DNS 設定。Settings 中的 Proxy、TCP、UDP 涉及不同連線行為，初次排查時不要只憑名稱一次全部調整；變更前先確認用途，並保留可還原的原始值。
若更新後出現異常、耗電情況改變或 iPad 有特定問題，請先記錄目前網路、Global Routing、所選伺服器與可重現的操作步驟。不要一開始就重新安裝；先保存必要資料並檢查設定與授權，以免遺失既有的排查線索。更新資訊與系統需求以 App Store 頁面標示為準，不要根據截圖外觀推測應用程式版本。
完成以上流程後，應能明確指出問題發生在哪個環節：匯入後沒有新增項目、伺服器測試未通過、系統授權未完成，或規則下的實際請求失敗。帶著這項判斷閱讀疑難排解；需要逐層檢查時，再前往故障排除疑難手冊。日常使用前，最後確認 Home 的連線狀態、目前選取的伺服器與 Config 檔案都符合預期。
