Shadowrocket 官方手冊 · 入門步驟

Shadowrocket 使用教學
訂閱匯入與連線驗證

從 Home 開始,依序完成匯入、選擇 Global Routing、連線與驗證。本文說明首次使用時必須完成的操作流程,適用於 iPhone 與 iPad;進階規則與持續性故障,請參閱其他排查手冊。

操作順序:先確認項目已儲存,再確認連線路徑,最後送出實際請求。過程中每次只變更一項,避免混淆匯入問題與連線問題。

STEP 01 / IMPORT

透過 Add Server 與 Subscribe 匯入

開啟 Shadowrocket,進入 Home。先確認手上的資料類型:訂閱連結通常用來一次取得並更新多台伺服器;單台伺服器資料則包含協定、位址、連接埠及驗證參數。兩種資料的輸入方式不同,不要只因連結看起來很長,就認定它是 Subscribe 訂閱連結。若不確定資料類型,請先查看提供者對該資料的說明。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角的加號,進入 Add Server,開啟 Type 並選擇 Subscribe。將自己的完整訂閱連結貼到 URL,再填入方便辨識的名稱並儲存。貼上後請確認連結開頭、結尾及查詢參數,移除訊息附帶的引號、空格或換行,但不要自行刪除連結後半段。訂閱網址可能包含存取憑證,請只在自己的裝置上使用。

儲存後返回 Home,等待首次擷取完成,或手動更新訂閱。訂閱群組中出現伺服器項目,才表示用戶端已取得並辨識內容;只看到訂閱名稱,不代表伺服器已成功匯入。若清單為空,請先檢查連結與更新結果,不必繼續嘗試開啟連線。

https://example.com/sub?token=xxxx

上方內容僅用於說明網址格式,並非可用的訂閱連結。實際操作時請貼上自己的連結,不要將範例填入應用程式。

已有伺服器資料:依協定填寫

若取得的是單台伺服器的參數,同樣從 Home 點選加號進入 Add Server,但 Type 應選擇資料指定的協定,而非 Subscribe。接著逐項確認 Address、Port 及該協定所需的驗證欄位。Shadowsocks、VMess、VLESS、Trojan 等協定的欄位並不完全相同,不能照著其他協定的表單填寫,也不要憑經驗猜測加密方式或傳輸參數。

若資料包含 TLS、伺服器名稱或傳輸相關參數,請依原始資料填寫;連線位址與憑證驗證使用的名稱可能不同,不要任意合併為同一個值。使用自己的伺服器分享連結或透過 Scan QR Code 匯入後,也應開啟項目檢查重要欄位。成功儲存只代表項目格式可被接受,不代表遠端伺服器一定可用。

返回 Home 後,點選準備使用的伺服器,確認選取標記位於預期項目上。首次驗證只使用一個明確的項目,不要連續切換多台伺服器後才判斷結果。匯入完成的條件是:清單中有實際伺服器、可以檢視參數,且目前選取的項目明確。接著再決定如何使用這些伺服器進行連線。

STEP 02 / GLOBAL ROUTING

Global Routing 的三種模式

在 Home 開啟 Global Routing,選擇這次驗證需要的模式。這裡決定流量的處理方式,與「目前選取哪台伺服器」是兩回事。本文統一使用以下名稱:設定檔 (Config)、代理 (Proxy)、直連 (Direct),括號內是介面上要尋找的英文名稱。

模式處理方式本次用途
設定檔 (Config)依目前設定檔中的規則與策略處理請求。用於規則分流;先確認目前設定檔及策略指向。
代理 (Proxy)以代理模式處理流量,方便檢查所選伺服器的代理路徑。首次排查時可暫時使用,減少規則比對帶來的變數。
直連 (Direct)直接連線至目標,不能據此證明所選伺服器可用。用來對照本機網路能否直接存取目標。

首次匯入後,若只想確認所選伺服器能否承載實際請求,可以先選擇代理 (Proxy),完成一次測試後再視需要切回設定檔 (Config)。這是排查時的操作順序,不代表日常使用必須維持 Proxy。切換模式後請返回 Home,再次確認顯示的設定值,避免以為已切換,實際上仍停留在原選項。

準備使用設定檔 (Config) 時,請進入 Config 頁面,確認目前選取的設定檔。訂閱中的伺服器清單與 Config 中的規則檔用途不同:前者提供連線項目,後者決定請求比對哪些規則及採用哪些策略。更新訂閱不等於更新規則;匯入伺服器也不代表已選好規則設定檔。使用自己的設定檔前,請保留原始檔案,並確認其中引用的策略能找到預期的伺服器或策略群組。

不要只為了首次連線,就複製整套自己不了解的規則。先確認單台伺服器的連線路徑,再處理分流。DOMAIN-SUFFIX、PROXY、DIRECT 等關鍵字的意思,請參閱術語手冊;本頁不深入說明規則優先順序與複雜策略組合。選好模式後,接著完成系統連線授權。

STEP 03 / CONNECT

開啟連線開關並完成系統授權

返回 Home,依序確認所選伺服器、目前的 Global Routing,以及本機 Wi-Fi 或行動網路本身可正常使用,再開啟上方的連線開關。首次連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定;這是建立系統網路連線所需的授權步驟,不是更新訂閱,也不需要再次購買應用程式。確認應用程式名稱後,依系統提示允許並完成裝置驗證。

完成授權後返回 Shadowrocket,確認開關是否維持開啟。系統的 VPN 狀態也可作為連線狀態的參考,但它只表示系統已建立連線,無法證明每個目標都能存取,更不能證明每筆請求都經過所選伺服器。請繼續下一步進行實際驗證,不要只確認「開關已開啟」就結束。

若先前拒絕系統授權,或開關剛開啟又自動關閉,請勿立刻刪除伺服器。先再次嘗試連線,查看是否出現授權提示;再檢查系統設定中的 VPN 狀態,以及是否有其他 VPN 連線正在使用。排查期間先中止其他 VPN 連線,避免同時切換多個網路設定。若裝置由組織管理,系統政策也可能限制新增設定,請向裝置管理人員確認允許的操作。

首次手動連線尚未穩定時,先不要設定 On Demand。它會依條件觸發連線,但無法修正錯誤的訂閱網址或伺服器參數。先確認手動開啟與關閉都符合預期,再另外設定自動觸發條件。iPad 也請依照相同步驟操作;介面配置可能因裝置與應用程式更新而改變,請以應用程式中目前顯示的英文項目名稱為準。

STEP 04 / VERIFY

Connectivity Test 與實際連線驗證

開啟連線後,先對目前的伺服器執行 Connectivity Test,查看是否有測試結果。測試只能提供連線狀況的線索,不能保證所有網站都能正常存取:測試目標、協定路徑與實際網站請求可能不同,單次測試成功不代表所有請求都會成功;單次逾時也不能直接判定伺服器永久失效。先保留目前選取的伺服器與模式,避免測試時引入新變數。

接著開啟瀏覽器,造訪一個熟悉且有權存取的目標網站,重新載入頁面,確認一般請求是否正常完成。不要只查看已開啟的舊頁面,因為快取可能掩蓋連線狀態。若要比較,請記錄同一目標在關閉連線、代理 (Proxy) 及設定檔 (Config) 模式下的結果;每次變更狀態後都重新送出請求,不要同時更換網路與伺服器。

網站能開啟,還要確認流量走向

網站能開啟,不代表流量一定經過代理。在設定檔 (Config) 模式下,部分請求原本就可能符合 DIRECT。若要確認分流結果,請查看應用程式中的相關請求記錄,根據目標網域、符合的規則及最終策略判斷。Data 頁面的流量變化可供參考,但背景活動也會產生流量,不能直接把數字變化歸因於剛才的網頁瀏覽。

若 Proxy 可以存取、Config 無法存取,請優先檢查目前設定檔中的比對規則與策略指向;若 Direct 可以存取、Proxy 無法存取,請檢查所選伺服器及遠端連線路徑。兩種模式都無法存取時,先確認本機網路與目標網站是否正常。這種比對只能協助縮小問題範圍,不能取代對具體錯誤記錄的判斷。

請以明確條件判定驗證是否通過:所選伺服器的測試結果合理、目標請求能正常完成、需要分流的請求走向符合預期。完成後切回日常所需的 Global Routing 模式,再對同一目標檢查一次。記下目前可用的伺服器與設定檔名稱,日後發生異常時便有明確的比對依據,不必重新猜測所有設定。

STEP 05 / CHECKPOINTS

依問題發生的位置檢查

遇到問題時,從最早未完成的步驟開始排查。清單中沒有伺服器,就先處理匯入問題;開關無法維持開啟,就先處理系統連線;只有特定目標失敗,再檢查該目標的規則與解析設定。不要把所有問題都當成需要重新安裝應用程式;重新安裝可能遺失本機設定,也無法修復已失效的遠端連結。

Subscribe 儲存後沒有出現伺服器項目

重新開啟訂閱設定,確認 URL 是否完整,是否含有空格、換行或訊息中的標點符號。確認貼上的是訂閱網址,而非帳戶網頁網址。執行一次更新並查看結果;若內容為空、格式無法辨識或連結已失效,請向自己的提供者確認連結狀態及適用格式。請勿將完整訂閱網址貼到公開討論區,因為其中可能包含個人存取憑證。

若訂閱先前一直能正常更新,現在卻突然失敗,請先確認一般網路存取正常,再測試同一訂閱在目前網路下是否能取得內容。不要反覆新增相同訂閱碰運氣,重複的群組會讓後續更難辨認選取的項目。更新訂閱與更新應用程式是不同操作:前者更新伺服器資料,後者透過 App Store 更新用戶端。

開關已開啟,但伺服器測試逾時

先確認伺服器位址、連接埠與驗證參數符合原始資料,再檢查該協定所需的 TLS 或傳輸參數。嘗試改用另一個可用的本機網路進行比對,過程中維持伺服器不變;若更換網路後恢復,優先檢查原本的網路路徑。若在多個網路下都失敗,再向自己的伺服器管理者確認遠端狀態,不要任意更改連接埠或關閉必要的驗證。

若只有匯入後的某個項目失敗,可改選同一訂閱中自己已有的其他項目進行比對,並記錄切換前後的結果。每次只更換伺服器,不要同時更換 Config 與 DNS。若偶爾測試成功,但實際請求仍失敗,請繼續檢查具體目標與錯誤記錄,不要只根據測試結果反覆開關連線。

Proxy 正常,Config 下部分目標無法存取

確認 Config 頁面選取的是預期檔案,再查看失敗的請求符合了哪條規則。規則可能指定 DIRECT、REJECT,或指向未正確設定的策略群組;伺服器本身可用,不代表每條規則都會使用它。先找出相關規則再修改,並保留原始檔案,避免整份替換而掩蓋真正原因。

若網域存取異常,但其他連線看起來正常,請將 DNS 納入檢查,但不要同時變更多項解析設定。先記錄目前設定,確認原有設定的用途後再逐項比對;遇到憑證提示也不要直接忽略,請檢查目標名稱、裝置時間及相關連線參數。DNS、TLS 與規則問題的完整流程,請參閱故障排查手冊。

切換網路或返回應用程式後發生異常

先手動中斷並重新連線,確認新網路本身可正常使用,再檢查伺服器與 Global Routing 是否仍為剛才驗證通過的組合。若已設定 On Demand,請記錄觸發條件;必要時暫時關閉自動觸發,只驗證手動連線。基礎連線尚未穩定前,不要再加入自動化設定,否則難以分辨問題來自觸發條件或伺服器連線。

完成本頁後,您應能在 Home 找到自己的伺服器、說明目前模式的用途、手動開啟與關閉連線,並透過實際請求確認結果。日常只需依需要更新訂閱、保留可用設定,並在調整後重新驗證。購買與授權問題請參閱常見問題;不熟悉的英文項目可查閱術語手冊,持續性故障則依故障排查手冊逐項深入檢查。