官方手冊 · 入門指南

Shadowrocket 使用教學

新增資訊 → 選擇分流 → 連線與驗證

適用於 iPhone 與 iPad。先完成一次可驗證的連線,再逐項調整日常設定;協定細節與完整規則可留待後續閱讀。

App Store 下載說明
STEP 01 / INPUT

Add Server:新增或匯入

訂閱連結與單一伺服器資訊是兩種不同的輸入方式。依照你現有的資料選擇其中一種即可,不必重複新增。

先確認手邊的資訊類型

開啟 Shadowrocket,進入 Home。頁面下方的 SERVER 會顯示可選取的伺服器項目;若尚未新增,請先找到 Add Server。服務商提供的完整訂閱 URL 通常用來取得一組項目;逐項列出的協定、位址、連接埠與驗證資訊,則適合手動填寫。不要只憑連結長度判斷類型,也不要把訂閱 URL 當成伺服器 Host。

請將原始資料保存在安全的位置,填寫時逐項核對。訂閱 URL、Password、UUID 等可能包含存取憑證,不應貼到公開頁面或分享完整截圖。若資料未說明協定類型或必填欄位,請先向自己的服務商確認,避免依據其他教學猜測。

方式一:填寫現有伺服器參數

  1. 在 Home 點選 Add Server,先開啟 Type,選擇與資料相符的協定,例如 Shadowsocks、VMess、VLESS 或 Trojan。Type 會影響後續顯示的欄位,請務必先確認。
  2. 依照資料填寫 Host 與 Port。Host 填伺服器網域名稱或位址,不要附加網頁路徑;Port 使用資料中提供的連接埠,不要以網頁常見的連接埠代替。
  3. 接著填寫所選協定的驗證與傳輸參數。Shadowsocks 需要核對 Password 與 Method;其他協定可能會顯示 UUID、TLS、Server Name 或傳輸相關欄位。只填寫實際需要的項目,不要混用不同協定的欄位。
  4. 檢查輸入內容是否含有前後空格、換行或誤複製的標點符號,儲存後返回 Home。確認 SERVER 中出現新項目,並點選該項目作為後續測試對象。

Add Server 底部的 Scan QR Code 可讀取你現有資料中的 QR Code;辨識後仍需檢查 Type 與參數。Import from Cloud JSON 是特定的 JSON 匯入方式,並非所有 URL 通用的入口。本步只需完成一種有效的新增方式。

方式二:匯入現有訂閱

若已有訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,將完整連結貼到 URL,並填寫方便辨識的備註後儲存。返回 Home 後,等待訂閱取得完成;必要時使用該訂閱的更新功能。取得成功後應會看到所屬伺服器項目,再選取其中一項進行測試。儲存訂閱記錄不代表已成功取得遠端內容。

若沒有出現項目,請先檢查連結是否完整,以及訂閱是否仍有效,不要立刻重建所有設定。訂閱 URL 與用於規則分流的配置檔並非同一種資料:匯入伺服器清單後,請求是否依規則處理,還要看下一步的 Global Routing 與目前配置。相關概念可繼續參閱術語表。

Shadowrocket Add Server 官方介面,顯示 Type、Host、Port、Password、Method 及底部的匯入入口
App Store 官方截圖:Add Server。欄位會隨 Type 改變,請以實際選擇的協定及目前 App 介面為準。
STEP 02 / ROUTING

Global Routing:選擇請求處理方式

伺服器決定代理請求要送往何處;Global Routing 則決定如何處理請求。兩者都需要分別確認。

返回 Home,點選 Global Routing,查看目前選取的項目。首次操作時,不要因為已選取伺服器,就認定所有請求都會經過該伺服器。請先了解 Config、Proxy、Direct 三種方式,再依本次驗證目的選擇。

三種方式的用途

  • Config:依目前啟用配置中的規則比對請求。部分請求可能走 PROXY,部分走 DIRECT,也可能符合其他策略。適合日常使用已設定明確規則的情況,但實際結果取決於配置內容與比對順序。
  • Proxy:以代理方式處理用戶端可處理的請求,適合初次檢查所選伺服器能否支援實際存取。這不保證能避開所有系統限制,也不代表目標服務一定可用。
  • Direct:以直接連線方式處理請求,可用來與代理結果比較。選取伺服器後再選擇 Direct,無法藉此證明該伺服器是否正常。

若本次只是要驗證剛新增的伺服器,可先選擇 Proxy,記下這項設定後再進行下一步。若已有可信且了解用途的配置,可選擇 Config。驗證完成後,再切回適合日常使用的方式,避免長期保留臨時排錯設定。

使用 Config 前先檢查目前配置

若需要規則分流,請前往底部的 Config,確認已選取準備使用的配置。開啟配置編輯頁後,可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。Rule 與 Add Rule 用於管理規則;初次使用不必逐一修改各區段,也不需要為了完成首次連線而啟用 HTTPS Decryption。

例如 DOMAIN-SUFFIX,example.com,PROXY 表示依網域後綴比對,並使用 PROXY 策略;這只是規則語法範例,不是要求你直接加入的完整配置。規則通常依序比對,較後面的項目未必有機會生效。若要了解 FINAL 與 DIRECT 的處理關係,請閱讀完整手冊的 Global Routing 章節;本次驗證時不要同時修改伺服器參數與規則。

Shadowrocket Config 配置檔編輯官方介面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
App Store 官方截圖:Config 配置編輯頁。此處用於管理配置內容;Global Routing 的方式選擇入口位於 Home。
STEP 03 / CONNECT

Home:開啟連線開關

先確認伺服器與處理方式,再處理系統 VPN 設定提示。系統授權與伺服器驗證是兩個不同步驟。

返回 Home,再次確認 SERVER 中選取的項目與 Global Routing。確認匯入或返回頁面時設定沒有變動後,開啟頁面頂端的連線開關。連線前可能會顯示 Not Connected;開啟開關後,請觀察狀態是否改變,以及開關能否維持開啟。

首次啟用時,iPhone 或 iPad 可能會跳出要求新增 VPN 設定的系統提示。這是允許用戶端透過系統網路延伸功能處理連線的授權,不是重新購買 App,也不是向服務商驗證 Password。確認提示來自剛才操作的 Shadowrocket 後,選擇允許,並依系統要求完成裝置密碼或其他驗證。驗證須在系統介面進行,請勿將裝置密碼填入 Add Server。

完成授權後返回 Shadowrocket,查看連線狀態。若先前拒絕提示,請重新開啟開關並留意是否再次要求授權;若仍無法完成,再依第五步檢查系統中的 VPN 設定狀態。不要連續快速切換開關,也不要在授權流程尚未結束時反覆編輯伺服器,以免難以判斷失敗原因。

連線開關維持開啟,表示用戶端的網路處理流程已啟動,但不能單獨證明遠端伺服器、DNS 與目標網站都正常。此時先不要修改 On Demand;保留手動連線狀態,繼續下一步驗證。iPad 上的頁面空間或排列可能不同,但仍請依序確認 Home 中的伺服器、Global Routing 與連線開關。

Shadowrocket Home 官方介面,頂端顯示 Not Connected 開關,下方為 Global Routing、Connectivity Test 與 SERVER
App Store 官方截圖:Home。頂端開關控制連線;Global Routing 與伺服器選擇需要分別確認。圖中狀態不代表你的即時連線狀態。
STEP 04 / CHECK

Connectivity Test:驗證實際存取

分別確認「伺服器測試有回應」、「開關維持開啟」及「網頁請求成功」,才能判斷各個環節是否完成。

先測試目前選取的項目

在 Home 使用 Connectivity Test,等待結果並記錄測試方式與目前網路。測試數值反映所選測試方式下的結果,並非固定的線路品質排名;單次逾時也不能直接推論伺服器長期無法使用。

再測試實際請求

開啟瀏覽器,前往自己有權使用且網址明確的網頁,重新整理並等待新內容載入。不要只看先前已載入的頁面或快取圖片,也不要因為單一網站失敗,就認定所有連線都失敗。

若測試有結果,但網頁無法開啟,請先確認目前的 Global Routing。在 Config 下,該網頁可能符合 DIRECT 或其他規則,未必會經過剛測試的伺服器;記下原本狀態後,可暫時切換至 Proxy,重新嘗試相同網址。若 Proxy 可存取但 Config 失敗,應優先檢查配置與規則,不要立刻重新填寫驗證資訊。

接著可進入 Data,觀察發出新請求時流量數值是否變化。這能提供請求活動的線索,但統計範圍未必與服務商後台用量一致,也不能只憑數字增加就斷定目標內容已成功傳回。系統 VPN 圖示同樣只能作為連線狀態的參考,不能取代實際存取驗證。

若要建立本地網路基準,請先記下目前方式,再切換至 Direct 或關閉連線,使用相同網址進行比對。若直接連線也失敗,可檢查目前 Wi-Fi 是否需要網頁認證、網路是否可用,或目標服務本身是否異常。比對完成後請恢復原本方式,不要讓測試狀態留在背景。

STEP 05 / DIAGNOSE

Settings:依失敗階段排查

回到最早未能完成的步驟。每次只變更一項條件,再重複相同測試,並保留可還原的記錄。

訂閱已儲存,但沒有伺服器項目

先檢查訂閱 URL 是否遭截斷、是否包含誤複製的空格,以及服務商是否要求重新產生連結。儲存 Subscribe 記錄只表示用戶端記住了網址;若遠端請求失敗或回傳內容不符預期,SERVER 仍可能沒有可用項目。確認目前網路可以完成訂閱請求,再檢查自己的訂閱是否有效。請勿將包含憑證的完整 URL 公開作為排錯資訊。

伺服器已顯示,但測試失敗

手動新增的項目,請優先核對 Type、Host、Port 與驗證欄位,再檢查 TLS 和傳輸參數是否與原始資料相符。匯入訂閱的項目則先更新一次,並確認所選項目仍有效。前往 Settings 查看 Test Method,確認目前測試是否依賴實際請求;不同測試方式的數值不能直接比較。若切換 Wi-Fi 或 Cellular 後結果改變,請保留這項差異作為網路層線索,不要同時更換所有參數。

開關可以開啟,但網頁無法載入

先依第四步比較 Proxy 與 Config 的結果。若只有 Config 失敗,請檢查目前配置與規則;若兩種方式都失敗,但伺服器測試有回應,再檢查 DNS 解析、目標位址、TLS 或傳輸設定。裝置日期與時間明顯不正確,也可能影響安全連線。DNS 並非換得越多越好,請先保存原值,每次只修改一項,再重新測試相同目標;完整說明請參閱FAQ 的規則分流與疑難排解分類。

關閉後又重新連線,或切換網路後行為改變

前往 Settings 查看 On Demand。它可依已設定的條件觸發連線,因此「剛手動關閉」和「之後又被條件觸發」可能同時發生。初次排查時,先記錄現有的 On Demand 設定,暫時停用相關觸發,再用手動開關重新測試;確認基本連線穩定後,再恢復設定並逐項檢查條件。不要把自動觸發誤認為伺服器參數未儲存。

保留精簡的排錯記錄

Settings 中的 Diagnostics 可用於進一步診斷;Proxy、TCP、UDP 等項目則涉及更細部的網路行為,完成首次連線不必逐項修改。若需要尋求協助,請記錄失敗步驟、目前方式、使用 Wi-Fi 或 Cellular、測試方法及錯誤原文。分享診斷資訊前,請移除訂閱 URL、Password、UUID 及其他可識別憑證;不要直接公開完整配置。

重新安裝 App 並非優先處理方式:這可能導致原有配置與觀察線索遺失,卻無法改變遠端服務狀態。請先保存自己的配置與原始參數,再依失敗階段逐步驗證。訂閱維護、規則順序與常用設定的完整說明,請繼續閱讀Shadowrocket 完整手冊。

Shadowrocket Settings 官方介面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
App Store 官方截圖:Settings。先檢查 Test Method 與 On Demand 的影響,再依實際問題判斷其他設定。

完成後:保留可用設定

確認連線可用後,記下所選伺服器、Global Routing 方式與目前配置。將暫時修改的測試選項恢復至預期狀態,再逐項設定日常所需的規則或 On Demand。伺服器訂閱與配置檔需分別維護;更新其中一項後,都應重新驗證實際請求。

下次遇到問題時,依序檢查「匯入是否成功、開關能否維持、測試與實際存取是否一致」,比直接重設所有設定更容易找出原因。