官方手冊 / 首次操作
Shadowrocket 訂閱匯入
與首次連線步驟
依照「新增 → 選擇模式 → 連線 → 驗證 → 排除問題」的順序操作。先準備一筆現有連線資料供測試，再逐步了解規則與設定。
下文保留英文介面用語，並以括號補充中文說明。配圖取自 App Store 官方截圖，供辨識所在頁面；欄位內容與排列方式可能因協定、裝置及 App 介面而異，請以目前 App 顯示的內容為準。
步驟 01 / 準備連線項目
Add Server / Subscribe：新增伺服器或匯入現有訂閱
先確認手上的資料是訂閱 URL，還是一組伺服器參數。兩者的輸入位置不同，請勿將訂閱網址填入 Host。
有訂閱連結：選擇 Subscribe
從 Home（首頁）進入 Add Server（新增伺服器），通常可點選右上角的新增按鈕，也可使用列表中的 Add Server 入口。開啟 Type（類型）選單，選擇 Subscribe（訂閱）。此時表單應切換為訂閱所需的欄位，而非手動新增伺服器使用的 Host、Port 等欄位；確認類型後，再將已有的完整訂閱連結填入 URL。
- 從你的服務提供者複製現有訂閱的原始連結，檢查網址開頭與結尾是否完整，避免夾帶空格、換行或聊天訊息中的說明文字。
- 在 Subscribe 表單填入 URL；如有需要，可新增方便辨識的備註，再點選頁面右上角的完成或儲存按鈕。
- 返回 Home，等待訂閱取得完成，並檢查對應群組中是否出現伺服器項目。若只看到群組、沒有項目，請先確認是否出現錯誤提示，不要立刻重複新增相同網址。
訂閱連結通常包含身分憑證，應如同密碼般妥善保管。請勿將完整連結貼到公開頁面、截圖或診斷記錄中。本頁也不需要你提供連結。若複製的是一般網頁網址，而非用戶端可讀取的訂閱 URL，即使能在 Safari 開啟，也不代表可以透過 Subscribe 匯入。
有伺服器參數：依 Type 逐項輸入
如果手上有主機、連接埠及認證資料，請先在 Add Server 選擇與資料相符的 Type。不同協定顯示的欄位各異，不能只憑一組密碼猜測類型。以官方截圖中的表單為例，Host（主機）填入伺服器位址，Port（連接埠）填入連接埠號碼；Password（密碼）與 Method（加密方法）須與原始資料一致。其他類型可能還需要身分、傳輸或 TLS 欄位。
主機範例可寫成 example.com，這只是網域格式示意，並非可連線的伺服器。只接受主機名稱的欄位，請勿填入含網頁路徑的完整 URL；也不要將訂閱連結中的參數拆出來當作伺服器認證資料。未提供的選項先維持原值，確實需要某項參數時，再向你現有服務的資料來源確認。
若已有 QR Code，可在 Add Server 使用 Scan QR Code（掃描 QR Code）；掃描後仍須核對 Type 與伺服器資料。Import from Cloud JSON（從雲端 JSON 匯入）適用於相應格式的資料，並非可通用於任意訂閱網址的替代入口。儲存後返回 Home，確認剛新增的項目已出現，再選擇路由模式；「儲存成功」只表示資料已輸入，尚未完成連線驗證。
步驟 02 / 決定流量處理方式
Global Routing：設定(Config) / 代理(Proxy) / 直連(Direct)
伺服器項目回答「連線到哪裡」，Global Routing 則回答「哪些連線採用哪種處理方式」。兩者需要分別確認。
返回 Home，點選 Global Routing（全域路由）查看目前模式。先記下原本的選項，再依測試目的調整。不要將「已匯入訂閱」和「已設定分流規則」視為同一件事：訂閱通常用於更新伺服器項目；Config 中的設定檔則可包含規則等設定，兩者用途不同。
- 設定(Config)：依目前使用的設定檔規則決定處理方式。日常分流可使用此模式，但前提是先確認目前使用哪份設定檔，以及它對目標連線的預期處理方式。
- 代理(Proxy)：透過所選代理處理由用戶端接管的連線。初次排查伺服器是否可用時，可暫時使用此模式，減少規則分流造成的變數；但它無法取代伺服器參數與網路檢查。
- 直連(Direct)：採用直連方式，不經遠端代理。適合用來對照原始網路狀況，不適合用來判斷遠端伺服器是否連線成功。
使用 Config 前，先確認目前的設定檔
開啟 Config（設定）頁面，查看設定檔列表與目前使用狀態。進入某份設定檔的編輯頁面，可看到 General（一般）、Rule（規則）、Hosts（主機對應）等區段。右側官方截圖展示的是設定檔編輯頁，並非 Home 中的 Global Routing 選單。開啟或編輯某個檔案，不代表已將它設為目前使用的設定檔；返回列表後仍須確認使用狀態。
初次操作不必立刻進入 Add Rule（新增規則）。若設定檔來自你自己的可信資料來源，請先閱讀說明並保留原始檔案。規則通常依序比對，前面符合的規則可能決定流量去向；不能只看最後一條規則，就認定所有網站都會經過同一台伺服器。
例如 DOMAIN-SUFFIX,example.com,PROXY 表示對應的網域後綴採用 PROXY 策略；FINAL,PROXY 則用於處理前面尚未符合規則的連線。這些只是規則語意範例，並非要求你取代整份設定檔。更多規則關鍵字說明請參閱術語表；設定與 Settings 的詳細資訊請見選項手冊。
完成這個步驟後，應能說明目前選擇的模式及預期結果。若此時只想檢查剛新增的伺服器，可先記下 Config 狀態，再暫時選擇 Proxy；驗證後，依實際需求恢復 Config。每次只變更一項條件，之後才容易分辨問題出在伺服器還是規則。
步驟 03 / 建立系統連線
Home：選擇伺服器，再開啟連線開關
先確認所選項目與路由模式，再處理系統 VPN 設定授權。授權、建立連線與實際存取是三個不同環節。
返回 Home，在 SERVER（伺服器）或訂閱群組中點選要測試的項目，確認目前選取標記位於目標項目上。列表中「有這台伺服器」不代表「正在使用這台伺服器」。若剛匯入多個群組，先選擇其中一個，測試期間暫時不要反覆切換，以免無法對照結果。
- 確認 Global Routing 符合上一步的測試計畫，再開啟 Home 頂端的連線開關。尚未連線時，頂端可能會顯示 Not Connected（未連線）等狀態提示。
- 首次要求連線時，系統可能會提示新增 VPN 設定。確認提示來自剛才開啟的 Shadowrocket 操作，閱讀說明後選擇允許，並依系統要求完成裝置驗證。
- 返回 App，查看頂端狀態與開關是否維持開啟。若開關很快恢復關閉，先保留當下的錯誤訊息，再前往本頁的設定與問題排除，不要連續重複授權。
VPN 設定授權可讓 App 透過系統網路延伸功能處理連線，但不代表系統已驗證你填寫的伺服器，也不保證一定能存取特定網站。若先前選擇不允許，再次開啟連線開關時請依實際提示操作；必要時前往系統「設定 → 一般 → VPN 與裝置管理」確認相關 VPN 項目。不同系統版本顯示的名稱可能不同，請以裝置目前介面為準。
檢查系統設定時，請勿任意刪除其他用途的管理設定。若裝置由公司或學校管理，且系統限制新增 VPN 設定，應先確認裝置管理規範，而非反覆修改 App 中的伺服器欄位。能否新增設定與遠端服務是否可用，是兩個不同問題。
連線開關維持開啟後，請繼續下一步進行實際驗證。系統 VPN 標示只能說明相關連線狀態，無法單獨證明規則命中了哪項策略。若同時有其他 VPN 連線正在運作，先確認目前是哪個連線在處理網路，再判斷 Shadowrocket 的狀態；不要只憑狀態列圖示下結論。
步驟 04 / 確認實際結果
Connectivity Test：搭配實際存取情形判讀測試結果
開啟連線後，先確認目前的 Wi-Fi 或行動網路本身能正常連上網路。若網路需要登入網頁驗證，請先完成驗證，再返回 Shadowrocket 操作。否則，訂閱取得失敗、測試失敗與網頁無法開啟，可能只是同一個基礎網路問題，不一定是伺服器參數有誤。
先執行 App 內測試，再開啟目標網頁
- 在 Home 點選 Connectivity Test（連線測試），等待測試完成並查看所選項目的結果。測試期間不要切換伺服器或修改 Global Routing。
- 若不確定結果代表什麼，請開啟 Settings（設定）查看 Test Method（測試方法）。不同方法檢測的層級不同，應依目前使用的方法解讀結果，不要把所有數字都當成實際網頁速度。
- 開啟 Safari，前往你明確知道應如何處理的目標網頁，並嘗試重新載入或開啟新頁面。依目前模式判斷結果，不要只以已載入的快取頁面作為依據。
測試有結果，只表示在相應測試條件下收到回應，不代表整個代理連線、網域解析及所有網站要求都能順利完成。反過來，某項測試失敗，也無法單獨證明伺服器在所有使用情境下都不可用。先確認測試方法，再搭配實際存取情形與錯誤記錄判斷，通常比一再執行相同測試更有幫助。
使用 Config 時，還要確認策略命中情形
若目前使用設定(Config)，請分別選擇一個預期走 DIRECT 的目標，以及一個預期走 PROXY 的目標進行檢查。兩者都能開啟，不代表經過相同路徑。若要進一步確認，可查看 App 提供的連線記錄或 Log（記錄），依目標網域、符合的規則與策略結果判斷；記錄包含哪些欄位，請以目前 App 實際提供的內容為準。
若目標在 Proxy 下可存取，切回 Config 後卻失敗，請優先檢查目前設定檔、規則順序與 DNS 相關設定，不必立刻重新輸入所有伺服器資料。若 Proxy 下也失敗，先維持目前模式，再檢查所選伺服器、參數與基礎網路。如此可分別處理「遠端連線失敗」與「分流未依預期執行」。
步驟 05 / 依失敗環節逐一檢查
Settings：保留原值，一次排查一項變數
先判斷問題發生在匯入、授權、連線還是存取階段，再決定是否需要調整設定。不要一次開啟所有開關。
訂閱沒有項目：先檢查取得過程
若 Subscribe 儲存後沒有建立伺服器，先確認 URL 是否完整、目前網路能否存取訂閱網址，以及現有訂閱是否仍有效。若網頁能開啟但匯入失敗，也要確認取得的是訂閱內容入口，而非帳戶管理頁面。伺服器項目尚未成功取得時，修改 Global Routing 通常無法解決訂閱格式或認證問題。
不要反覆新增相同 URL 嘗試修復，否則會產生難以辨識的重複群組。保留一份原始資料，記下介面顯示的錯誤類型；若需確認有效期限或連結格式，請向你現有服務的資料來源查證。刪除並重新新增訂閱前，先確認其中是否包含自行修改過的資訊。
項目存在但連線失敗：檢查參數與授權
手動新增的項目應逐一核對 Type、Host、Port 與認證欄位，特別留意複製時混入的空格、大小寫差異，以及遺漏的傳輸或 TLS 參數。不同協定所需資料也不同；不要把其他類型表單中的預設值當成目前服務的必要設定。若項目來自訂閱，先嘗試依原訂閱更新並核對，不要直接覆寫多個欄位。
若連線開關無法維持開啟，先確認系統 VPN 設定授權是否完成，以及 App 是否回報連線錯誤。拒絕授權與伺服器拒絕連線是不同的問題。若曾誤刪相關 VPN 項目，可返回 Shadowrocket 再次嘗試連線，依系統實際提示重新授權；裝置受管理限制時，則應遵循裝置管理規範處理。
連線已開啟但無法存取：檢查規則與 DNS
先確認目前不是直連(Direct)，並再次核對 Home 中所選的伺服器。若只有部分網域無法使用，記錄目標與錯誤情形，例如無法解析、連線逾時或頁面部分資源載入失敗，再對照 Config 中的規則路徑。不要只因一個網頁無法開啟就更換所有 DNS 選項，也不要為了排查問題而任意啟用 HTTPS Decryption（HTTPS 解密）。
DNS 決定網域如何解析，路由規則決定連線如何處理，兩者都會影響結果。若要比較 Config 與 Proxy，先記下原本的模式，在相同網路與目標下測試，再恢復原值。測試期間盡量只變更一項，才能判斷是哪項調整造成影響。更多 DNS、規則與記錄的說明，請繼續閱讀選項手冊。
先了解 Settings 的用途，再調整數值
官方截圖中的 Settings 包含 Test Method、Today Widget（今日小工具）、On Demand（依需求連線）、Diagnostics（診斷）、Proxy、TCP 與 UDP 等項目。Test Method 會影響連線測試的解讀；On Demand 用於依條件觸發連線，建議先完成手動連線驗證，再進行設定。Today Widget 是快速存取相關設定，並非修復伺服器連線的步驟。
Diagnostics 可用來蒐集排查線索，但查看記錄時應聚焦於一次明確的失敗操作。先記下操作順序，再重現問題，避免連續切換多台伺服器後只留下最後一段提示。分享記錄前，請移除完整訂閱連結、密碼、身分憑證及其他私人資訊；本指南不要求公開提供這些資料。
現有伺服器可依預期存取後，先保留這組可重現的設定，再逐步啟用依需求連線或其他便利選項。重新測試時，沿用本頁的驗證順序，不必反覆刪除 App 或重建所有設定。其他購買、授權與訂閱更新問題，請參閱常見問題；若要釐清 Subscribe、Config、PROXY 與 DIRECT 的差異，請使用術語表逐項對照。
