官方手冊 / iPhone 與 iPad

Shadowrocket 訂閱匯入
與連線檢查教學

先匯入既有資料,再選擇 Global Routing;連線後以實際存取驗證結果。首次操作請依下列五個步驟進行,遇到問題時從相應環節開始檢查。

  • 已有資料 → 匯入
  • Global Routing → 連線
  • 實際存取 → 驗證

尚未安裝時,請先閱讀App Store 下載說明 →。系統需求與購買適用範圍請以 App Store 頁面標示為準。以下步驟以 iPhone、iPad 為例;介面配置可能隨裝置及 App 更新而有所不同,請依英文入口名稱辨識。

步驟 01 / 建立可選取的伺服器記錄

新增伺服器或匯入既有訂閱

開啟 Shadowrocket,先在 Home 查看是否已有伺服器記錄。清單空白只表示尚未新增資料,不代表 App 安裝失敗。新增前先辨識手上的資料:一組位址、連接埠與認證欄位供手動填寫;單一伺服器分享連結通常會匯入一筆記錄;Subscribe 訂閱網址則用於取得及更新一組記錄;設定檔可能包含規則及其他設定。這些資料不能只因「都是連結」就使用相同的匯入入口。

已有訂閱:使用 Subscribe 對應的匯入選項

從自己的服務商複製完整訂閱網址,確認複製的是訂閱內容入口,而非帳戶登入頁、帳單頁或說明文章。返回 Home,開啟新增入口;若 Add Server 的類型清單中有 Subscribe,請選取該項並填入訂閱網址,儲存後等待取得完成。若 App 從剪貼簿辨識出可匯入的內容,請先確認匯入類型及來源,再進行確認;不要一看到提示就直接接受。

儲存後返回 Home,確認訂閱群組及其中的伺服器記錄是否出現。若只有訂閱名稱、沒有伺服器項目,請先檢查更新結果,而非立即開啟連線。訂閱更新可能會變更記錄名稱或可選項目;首次匯入成功後,先選取一筆記錄進行驗證,不必反覆匯入同一網址。重複匯入容易產生相似群組,之後難以判斷連線使用的是哪份資料。

若既有資料明確指向 Config 頁面的遠端設定或 Subscribe 管理入口,請依資料類型操作:在 Config 中新增或取得相應設定,檢查內容後再選取使用。Config 主要用於管理設定檔;匯入設定檔不代表已選取可用伺服器。同樣地,Home 顯示訂閱記錄,也不代表規則設定已切換。入口名稱相近時,請先區分「更新伺服器清單」與「選擇規則設定」這兩種目的。

已有伺服器資料:在 Add Server 逐項填寫

在 Home 點選新增入口進入 Add Server,先選取服務商提供的協定類型,再填入伺服器位址、連接埠及相應的認證欄位。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等類型所需欄位各不相同。只填入資料中明確提供的值;密碼、識別碼、金鑰及傳輸設定都不能依相鄰欄位猜測,也不要把伺服器顯示名稱當成連線位址。

填寫時請留意前後空格、全形標點及複製時多出的換行。位址欄通常只需填入指定的主機名稱或位址,不應自行加上網頁路徑;連接埠則依原始資料填寫。需要 TLS 或其他傳輸參數時,請逐項對照來源說明,不要用「先全部開啟」的方式試錯。儲存後返回 Home,點選剛新增的記錄並再次確認名稱,以免選錯舊記錄。

已有 QR Code 時,可從 Scan QR Code 進行辨識;已有分享連結時,可使用 App 提供的剪貼簿匯入提示。無論採用哪種方式,完成的標準都是「記錄已儲存且可明確選取」,而不是「掃描動作已完成」。協定欄位說明請參閱術語表;四種匯入入口的詳細介紹請見訂閱匯入方式。確認記錄無誤後,再選擇路由。

步驟 02 / 決定連線處理方式

選擇 Global Routing 模式

在 Home 找到並開啟 Global Routing 選項。這裡決定流量的整體處理方式,不會補齊伺服器資料,也無法修復失效的認證資訊。三種模式分別是設定檔(Config)/代理(Proxy)/直連(Direct)。選擇前先確認本次目的:依規則日常使用、對照測試伺服器,或檢查原有網路。

模式處理方式本教學中的用途
設定檔(Config)依目前設定檔中的規則選擇處理策略。用於日常依規則分流,並驗證規則是否符合預期。
代理(Proxy)以代理處理作為主要路徑。用於對照檢查伺服器連線,不取代規則檢查。
直連(Direct)以直接連線作為主要路徑。用於檢查原有網路,不適合驗證代理伺服器。

日常分流:選擇 Config 並確認目前設定檔

需要依目標分流時,請選擇設定檔(Config),接著進入 Config 頁面,確認目前選取的設定檔就是準備使用的那份。設定檔清單中有檔案,不代表該檔案正在生效。若剛匯入遠端設定,請先確認取得程序已完成且檔案可讀取,再依介面選取。既有設定檔能正常運作時,不必為了完成本教學而額外替換來源不明的規則。

規則中的 DIRECT 代表直接連線,PROXY 代表交由相應代理策略處理,REJECT 代表拒絕。規則通常依序比對,因此目標符合前面的規則後,後續規則可能不會再參與處理。此處只要先理解「設定檔決定路徑」即可,不需要立即改寫規則。若目前設定檔引用了不存在的策略或尚未準備好的伺服器群組,應先修正引用,而非只切換 Home 中的記錄。

對照測試:暫時選擇 Proxy 或 Direct

若無法判斷問題來自伺服器還是規則,可暫時選擇代理(Proxy),以同一個目標進行對照;若 Proxy 可以存取而 Config 不行,接下來應著重檢查設定檔及命中策略。直連(Direct)則用來確認原有網路能否存取該目標。這不保證每個網站都能開啟,也無法證明代理伺服器可用。

每次切換後返回 Home,確認顯示的 Global Routing 值,並記下本次測試採用的模式。對照結束後,請恢復預定使用的設定檔(Config),避免將暫時測試狀態當成日常設定。規則關鍵字與策略說明請參閱術語表;此時先保留明確的模式,再進行連線步驟。

步驟 03 / 建立系統連線

開啟開關並完成 VPN 授權

返回 Home,再次確認選取的伺服器及 Global Routing。尤其剛更新訂閱後,原先選取的記錄可能已變更;不能只因清單中出現熟悉的名稱,就認定目前使用的是該筆記錄。確認後開啟 Home 的連線開關,等待 App 顯示狀態;等待期間不要連續切換開關或同時修改設定。

首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定。此提示是授予 App 建立系統網路通道的權限,不是再次購買 App,也不是確認匯入訂閱。請閱讀提示中的 App 名稱,確認是由本次主動操作發起的要求,再依系統流程允許並完成裝置密碼或生物辨識驗證。若選擇取消,伺服器記錄仍可能保留,但連線無法如預期建立。

完成授權後返回 Shadowrocket,查看開關與連線狀態。系統中的 VPN 標示可作為輔助資訊,但不同裝置的狀態列顯示方式不盡相同,不必為了尋找特定圖示而反覆重新連線。更重要的是 App 是否維持連線,以及接下來的實際存取是否成功。連線狀態成立只代表通道已建立,不能據此推斷認證、DNS、目標服務及分流規則都沒有問題。

若開關立即關閉,請先確認系統授權是否完成,再查看是否有其他系統設定正在管理網路通道。由公司或學校管理的裝置可能會限制相關操作,請遵循裝置管理規定,不要任意刪除用途不明的設定。完成授權後仍反覆失敗時,請保留錯誤訊息,稍後依排查順序處理。

首次驗證期間請保持操作簡單:讓 App 保持在前景並手動連線,不要同時新增 On Demand 條件。On Demand 用於依條件觸發連線,與本次手動驗證屬於不同操作。已設定此功能的使用者,請留意自動重新連線是否影響測試,避免手動中斷後又被條件重新觸發。確認連線穩定後,再進行實際存取驗證。

步驟 04 / 分別檢查三項結果

驗證連線、存取與分流是否生效

驗證時請分別確認三件事:連線是否維持、目標是否可存取、路徑是否符合設定。這三者並非同一項結果。不要只因開關已開啟就結束,也不要只憑一次測試逾時就刪除所有設定。固定使用同一筆伺服器記錄及同一個測試目標,才能比較操作前後的影響。

先執行 Connectivity Test

在 Home 找到 Connectivity Test,對準備使用的伺服器進行測試,等待結果後再繼續。測試方式與目標都會影響結果;收到回應只代表此次探測有結果,不代表所有網站或 App 都能正常連線。反過來說,測試失敗也可能與探測目標或網路環境有關,仍需結合實際存取情形判斷。不要為了追求更低的數字而持續切換伺服器。

接著進行一次可重複的實際存取測試

開啟瀏覽器,前往熟悉、可正常存取且能明確判斷是否載入完成的目標。請重新載入頁面,避免把快取中的頁面誤認為剛才已成功連線。確認頁面正文或實際要求已完成,而非只看到舊標題或封面。首次測試不宜同時開啟多個 App,否則難以判斷是哪次要求對應到哪筆記錄。

接著返回 Shadowrocket,查看 Data 中與本次操作相關的流量變化;若 App 顯示目前連線記錄,也可比對目標位址與處理策略。Data 有流量只代表發生了傳輸,背景要求也會增加數值,因此不能只憑數字增加就認定目標使用了 PROXY。請一併參考存取時間、目標及策略判斷。

最後檢查 Config 的分流結果

使用設定檔(Config)時,請選擇一個依設定應走 DIRECT 的目標,再選一個依設定應走 PROXY 的目標,分別存取並核對紀錄。不要預設某個固定網域在所有設定檔中都應採用相同路徑;實際結果取決於目前使用的檔案。若目標符合 REJECT,遭到阻擋可能正是規則預期結果,並非連線開關失效。

若使用代理(Proxy)時可正常存取,恢復設定檔(Config)後同一目標卻失敗,請記下目前設定檔名稱及命中的策略,著重檢查規則與策略引用。若兩種模式都失敗,請繼續檢查伺服器資料與網路條件。驗證完成後請保留預期的 Global Routing 設定;Data 的數值也不能直接視為服務商的用量帳單,兩者的統計方式可能不同。

步驟 05 / 每次只修改一項

依失敗環節繼續排查

從最早發生問題的步驟開始排查,不要重新填寫所有設定。先記下使用的網路、選取的伺服器、Global Routing 值、目前設定檔名稱及可見錯誤。每次只變更一項條件,再重複相同的存取測試。如此才能判斷是哪項修改帶來改善,也方便還原原本狀態。

匯入訂閱後沒有出現記錄

先確認網址是否完整,以及回傳內容是訂閱資料,還是需要登入的網頁。網址中的查詢參數可能用於認證,漏掉一段就可能造成取得失敗;請勿自行刪除。確認既有服務仍有效且格式適用後,再執行更新。若服務商變更網址,請先更新原有訂閱項目,確認成功後再清理舊內容,避免過早刪除唯一可用的資料。

記錄存在,但開關無法保持開啟

確認系統 VPN 授權是否完成、所選設定檔是否可讀取,以及目前是否有其他網路通道設定影響連線。返回 Add Server 核對協定類型及必填欄位,不要只重新填寫密碼。若匯入設定檔後立即失敗,可先切回先前確認可用的設定檔進行對照,判斷問題來自新設定檔或連線本身。

已連線,但目標無法開啟

先中斷 Shadowrocket,確認原有 Wi-Fi 或行動網路可正常連線,並處理可能出現的網路登入頁面。重新連線後確認實際選取的記錄,再執行 Connectivity Test。若自己已有多筆可用記錄,可在其他條件不變時改用另一筆進行對照;排查時不需要持續新增來源不明的資料。

伺服器認證失敗時,請逐項確認位址、連接埠、認證及傳輸欄位是否取自同一份資料。訂閱中的記錄可能已更新,但手動儲存的舊副本不會因此自動變更。若出現與憑證或網域解析相關的錯誤,請檢查伺服器網域、裝置時間及目前設定檔的 DNS 設定,不要任意關閉安全檢查來掩蓋問題。複雜欄位請先查閱術語表,再向自己的服務商確認資料。

只有 Config 失敗,或只有部分目標失敗

保留同一個目標,在代理(Proxy)與設定檔(Config)之間進行一次對照。只有 Config 失敗時,請檢查目前檔案、規則順序、策略引用及 DNS;只有個別目標失敗時,也要考慮目標本身是否可用、是否需要登入,以及設定檔是否刻意拒絕該目標。不要直接認定整份訂閱失效,也不要為了讓單一目標通過而刪除整份規則。

Wi-Fi 與行動網路結果不同時,可在自己允許使用的網路之間進行對照,並留意網路存取權限及 On Demand 條件。同一部伺服器在不同網路下可能遇到不同的解析或連線條件;記錄這些差異,比反覆重新安裝 App 更有助於找出問題。每次切換網路後,請重新確認連線狀態,再進行相同的存取測試。

完成以上檢查後,若連線穩定、實際存取符合預期,且 Config 的處理路徑與規則相符,即可完成首次設定。之後只需在資料或需求變更時調整相應環節。購買、商店地區及換機還原問題請參閱正版指南;這些問題應與伺服器連線排查分開處理,無須透過修改規則解決。

App Store 下載