官方手冊 · 首次使用

Shadowrocket 快速入門 匯入訂閱與首次連線

依照介面順序完成五個步驟:先準備 Home 中的伺服器,再選擇 Global Routing、開啟連線,最後驗證請求。先完成一次可重現的連線,再調整其他設定。

資訊完整再儲存 選取伺服器再連線 每次只調整一項

STEP 01 · Home → Add Server

新增伺服器或匯入 Subscribe

訂閱連結、單一伺服器參數與 QR Code 是不同形式的資訊。先確認手上已有哪種資料,再選擇對應的入口。

開啟 Shadowrocket,進入 Home,在伺服器區找到 Add Server 並開啟。新增頁面中的 Type 會決定需要填寫哪些欄位;不要將訂閱網址填入單一伺服器的 Host,也不要只憑網址外觀猜測協定。先查看服務商提供的說明,確認拿到的是可更新的訂閱連結,還是單一伺服器的完整連線參數。兩種方式都會在 Home 建立項目,但後續更新與確認方式不同。

已有訂閱連結:使用 Subscribe

在 Add Server 中點選 Type,選擇 Subscribe,再將向服務商取得的完整訂閱連結貼到 URL。若頁面提供備註欄位,可填入方便辨識來源的名稱。貼上後檢查網址開頭與結尾,避免混入聊天訊息中的說明文字、空格或換行,也不要自行刪除網址中的查詢參數;服務商可能需要這些參數來識別訂閱。

確認後儲存,返回 Home,等待讀取訂閱內容,再查看對應群組中是否出現伺服器項目。儲存訂閱項目,不代表已讀取到可用伺服器。若群組為空或出現讀取錯誤,先確認連結是否完整、訂閱是否仍有效,以及目前網路能否連上訂閱網址。不要連續重複新增相同連結;先保留一份,依服務商說明重新讀取,以免清單出現重複群組。

已有單一伺服器參數:依 Type 逐項填寫

如果取得的是伺服器位址、連接埠、密碼與協定資訊,請在 Type 中選擇實際使用的協定,再填寫 Host、Port 及該類型要求的驗證欄位。截圖展示的新增頁面包含 Password 與 Method,但不同 Type 所需欄位並不相同。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等類型所需資訊,請以服務商提供的參數及 App 目前頁面為準,不要將某種類型的欄位照搬到其他類型。

填寫時請特別確認位址沒有多出空格、連接埠沒有抄錯,以及密碼的大小寫是否正確;若需要額外的傳輸或安全參數,也要一併確認。遇到不清楚的欄位,先向服務商確認用途再儲存。自行猜填參數可能讓項目看似完整,卻無法連線。

已有 QR Code:使用 Scan QR Code

若已有伺服器 QR Code,可使用 Scan QR Code,並在系統提示時允許相機存取。掃描完成後仍須確認 Type、位址與連接埠,再儲存;QR Code 可成功辨識,只代表內容能被解析,不代表伺服器目前可用。Import from Cloud JSON 是另一種匯入方式,不應當成一般訂閱連結的替代輸入方式;只有在你已有相應格式且了解用途時才使用。

完成此步驟的標準是:在 Home 中找到準備使用的伺服器,並能開啟詳細資料確認來源。先不要急著更改 DNS 或其他 Settings。下一步先決定請求要採用哪種 Global Routing 方式。

Shadowrocket Add Server 新增頁面,顯示 Type、Host、Port、Password、Method 與 Scan QR Code 入口
Add Server:先選擇 Type,再填寫該類型實際需要的欄位。截圖中的欄位不適用於所有協定。

STEP 02 · Home → Global Routing

選擇 Global Routing,確認 Config

新增伺服器解決「使用哪台伺服器」;Global Routing 則決定「請求採用哪種處理方式」。兩者須分別確認。

返回 Home,點開 Global Routing。首次使用時,先分清三種模式:設定檔 (Config)/代理 (Proxy)/直連 (Direct)。這裡的選擇不會替你補齊伺服器參數,也無法讓失效的訂閱恢復有效。切換前記下目前選項,測試後才能輕鬆還原,避免將模式變更誤認為伺服器變更。

設定檔 (Config):依目前設定檔比對規則

選擇設定檔 (Config) 時,請求會依目前啟用的設定檔處理。前往底部的 Config,確認實際啟用的檔案,再查看其中的 Rule。規則可將不同請求交由 PROXY、DIRECT 或 REJECT 等策略處理,因此同一次連線中,不同網站的處理路徑可能各不相同。看到 VPN 狀態不代表所有請求都使用目前的伺服器。

官方截圖展示設定檔編輯頁面,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule。此圖用於協助辨識頁面位置,並非要求首次使用時逐一啟用。先保留現有設定檔的結構,尤其不要只為了完成一次連線測試就更改 HTTPS Decryption;這不屬於首次連線步驟。

代理 (Proxy):縮小首次驗證範圍

如果尚未準備好規則檔,或需要先確認已選取的伺服器能否處理請求,可暫時選擇代理 (Proxy) 進行驗證。此時由 Shadowrocket 處理的請求會透過代理方式測試,有助於分辨「伺服器連線是否可用」與「某條規則是否命中」。這不代表一定成功,也不應解讀為裝置上的所有流量都必定經過代理;實際結果仍須透過下一步的連線與請求測試確認。

直連 (Direct):不能用來證明伺服器可用

選擇直連 (Direct) 時,相關請求會以直連方式處理。此時網頁能正常開啟,不能證明已新增的伺服器可連線;同樣地,選取某台伺服器後一直停留在 Direct,也不能以網頁可存取作為伺服器驗證。若只是進行對照測試,完成後請還原原本模式,以免忘記切回。

需要規則分流時,通常應切回設定檔 (Config),並確認目前檔案的策略符合用途。首次連線不必立刻編寫冗長的規則清單;先確認模式、檔案與目前伺服器的對應關係。若想進一步了解 DNS、On Demand 與其他設定,請參閱Settings 設定手冊。本頁接著說明如何完成連線,不會展開完整的設定檔管理。

Shadowrocket Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:確認已啟用的檔案後,再檢查 Rule。首次連線不需要修改圖中的所有區段。

STEP 03 · Home → SERVER → 連線開關

選取伺服器,開啟頂端開關

先選取目前項目,再連線。首次出現的 VPN 設定授權是系統步驟,與訂閱是否有效是不同層面的檢查。

在 Home 的 SERVER 清單中找到準備使用的項目,點選伺服器前的圓點,將它設為目前項目。只開啟伺服器詳細資料查看參數,並不代表已切換目前伺服器;返回 Home 後,請確認選取標記確實位於目標項目上。清單中若有多個訂閱群組,也要確認群組來源,避免選到舊訂閱中的同名項目。

接著確認 Global Routing 仍是上一步選定的模式,再開啟 Home 頂端的連線開關。官方截圖頂端顯示 Not Connected,用來辨認未連線時開關的位置;截圖不代表你的裝置目前狀態。連線後請以實際介面文字和系統狀態為準,不必要求畫面上的每個細節都與截圖完全相同。

首次連線時允許新增 VPN 設定

首次連線時,系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。確認提示中的 App 名稱後,依系統要求授權;裝置可能要求輸入裝置密碼或使用生物辨識確認。這裡使用的是裝置的系統驗證,不是將服務商密碼輸入系統授權欄位。允許此步驟是讓 App 建立所需的網路設定,並非驗證伺服器參數或線路狀態是否有效。

若先前取消授權,請返回 Home 再次嘗試連線,並留意系統提示。若裝置由組織管理或受到相關限制,請遵守裝置管理規定,不要刪除來源不明的系統設定來嘗試排除問題。授權後返回 App,觀察頂端開關是否保持開啟;若開關立即關閉,先記下當時的提示,再進行後續排查。

狀態改變後,先維持其他條件不變

建立連線後,系統可能會顯示 VPN 狀態標示,實際呈現方式會受裝置與目前介面影響。連線狀態表示設定已啟用,不代表遠端伺服器與每個目標都已驗證成功。因此不要看到狀態標示就結束操作,也不要立刻連續切換伺服器、網路和模式。先維持目前組合,接著執行一次 Connectivity Test,再發出實際請求。

使用 iPad 時,同樣依照 Home 清單、Global Routing 與頂端開關完成檢查;介面配置以裝置顯示為準。此時至少應記下目前伺服器、目前模式,以及連線開關能否保持開啟。確認這三項資訊後,即使測試失敗,也能在相同條件下重現問題,而不必從匯入開始重來。

Shadowrocket Home 頁面,頂端顯示 Not Connected 開關、Global Routing 與 Connectivity Test,下方為 SERVER 與 Add Server
Home:在 SERVER 中選取目前項目,再使用頂端開關;連線後可透過 Connectivity Test 進一步檢查。

STEP 04 · Home → Connectivity Test

交叉比對測試結果與實際請求

分別確認「連線能否維持」、「測試是否有結果」和「實際目標能否載入」,不要只看一個圖示或數字。

維持剛才的伺服器、網路與 Global Routing 不變,在 Home 點選 Connectivity Test。等待本次測試完成並記下畫面結果;若失敗,請記錄具體提示,不要把所有失敗都簡稱為「連不上」。測試目標、目前路由方式和網路環境都可能影響結果;尤其使用設定檔 (Config) 時,應依規則判斷測試請求的處理路徑,不能只憑一次成功就推斷所有請求都經過代理。

接著開啟瀏覽器,造訪一個你熟悉且有權存取的網頁,手動重新整理或開啟新頁面,避免只看到先前快取的內容。確認頁面正文與必要資源能持續載入,而不只是標題先出現。測試目標正常但實際頁面失敗,與兩者都失敗是不同情況;前者應優先檢查目標本身、規則比對及相關解析,後者則要重新檢查網路、目前伺服器和連線參數。

延遲結果不足以完整判定可用性

Home 清單中的測試數字,與網頁實際載入情況並非同一項指標。Settings 中的 Test Method 會影響測試方式;探測收到回應,不代表驗證、傳輸與目標存取的整個流程都正常。反之,探測沒有結果,也不能直接斷定所有實際請求都會失敗。先確認採用的測試方法,再搭配 Connectivity Test 和瀏覽器請求判斷,不要只因數字較小就頻繁更換目前項目。

需要比對時,每次只變更一個條件

若要確認問題是否與目前伺服器有關,請維持相同網路、目標和路由模式,只切換至另一台自己已有的伺服器再測。若要確認是否與規則有關,先記下原本設定,暫時改用代理 (Proxy) 重測相同請求,再切回設定檔 (Config)。不要同時更換伺服器、修改 DNS、切換網路並重寫規則;即使結果改變,也無法判斷是哪個變更造成影響。

完成驗證後,將暫時使用的測試選項還原為預計長期使用的設定。一次成功只能表示當時條件下請求可用,不代表日後每次存取都會得到相同結果。若連線狀態、Connectivity Test 與實際頁面都符合預期,首次上手便告完成;若結果不一致,請依下一節的現象逐步定位,不必刪除所有已成功匯入的內容重來。

STEP 05 · Settings → Test Method / On Demand / Diagnostics

依錯誤狀況檢查設定

先確認問題發生在哪個環節,再前往 Settings。首次排查不需要一次調整 Proxy、TCP 與 UDP 的所有選項。

匯入後沒有項目:先檢查輸入內容與讀取結果

返回 Home 檢查匯入來源。若訂閱群組為空,請確認 Subscribe 的 URL 是否完整、連結是否仍有效,以及讀取時出現的具體錯誤。若手動新增的項目可以儲存卻無法連線,請回到詳細資料重新確認 Type 與所有必要欄位。儲存成功只表示 App 接受輸入格式,並不會替你確認服務商端的狀態。這類問題應優先確認現有資訊,不要先修改與匯入無關的設定。

開關無法保持開啟:先檢查授權與提示

若連線開關立即關閉,請確認系統 VPN 設定授權是否已完成,並記下 App 或系統顯示的文字。再確認目前伺服器確實已選取,且必要設定沒有缺漏。若先前調整過多個選項,先還原有明確記錄的原值,不要憑印象繼續嘗試。裝置管理限制與伺服器無法連線是不同問題,應依提示分辨;反覆重新安裝 App 通常無法取代這些檢查,也可能讓原有設定更難追查。

已連線但測試失敗:確認測試方法與目前伺服器

前往 Settings,找到 Test Method,先記下目前方法,再確認它與目前看到的測試結果有何關聯。接著返回 Home,針對相同目標重新測試。若所有實際請求也都失敗,再檢查服務商提供的參數、伺服器狀態與目前網路條件。可使用自己已有的另一台伺服器進行比對,但不要只因「換了測試方法後出現數字」,就認定所有請求都已恢復正常。

只有部分目標失敗:返回 Config 檢查路徑

若連線能維持且部分頁面正常,請優先查看 Global Routing 與目前的 Config。確認發生問題的目標是否命中 DIRECT、PROXY 或 REJECT,以及是否由預期的設定檔處理。DNS 與規則都可能影響結果,但不要只因一個目標就立刻更換整份設定檔。先保留原檔,在確認原因後一次只調整一處,再以相同目標重新測試;若想了解 DNS 與設定檔之間的關係,請前往設定手冊繼續閱讀。

手動測試時狀態再次改變:檢查 On Demand

在 Settings 中查看 On Demand。若先前已設定依網路條件觸發連線,手動測試期間可能出現與預期不同的連線變化。先記下現有條件;若為了排除問題而暫時停用,測試完成後請還原原設定。尚未了解目前條件前,不要新增多條觸發規則。本教學的目標是先驗證一次明確的手動連線;確認基本連線後,再設定長期按需連線方式。

仍需進一步定位:使用 Diagnostics 並保護資訊

若仍無法判斷原因,再查看 Settings 中的 Diagnostics,並根據問題發生時間、目標與現象檢查可用的診斷資訊。記錄應有助於重現問題,不必公開所有內容。訂閱網址、驗證欄位、伺服器識別資訊和存取紀錄都可能包含敏感資料;傳送診斷內容前,請先檢查並遮蔽不必要的資訊。調整 Proxy、TCP、UDP 等選項前,先了解其用途;不要把反覆切換開關當成固定的解決方法。

排查後,返回Connectivity Test 與實際請求驗證,依照相同條件再測試一輪。確認能重複得到正常結果後,再還原日常使用的 Global Routing 和 On Demand。若問題出在現有訂閱或伺服器參數,請將確認後的狀況提供給服務商;若只是忘了操作順序,從本頁對應步驟繼續即可,不必重複購買用戶端。

Shadowrocket Settings 設定頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:先檢查 Test Method、On Demand 和 Diagnostics;其他選項依具體問題逐項確認。
首次使用完成檢查

Home 中已有伺服器且目前項目明確;Global Routing 符合用途;連線開關能保持開啟;Connectivity Test 與實際請求已交叉驗證;暫時調整的設定已還原或記錄。

繼續閱讀 Settings 設定手冊 →