Shadowrocket 使用指南
匯入訂閱與首次連線
依照「匯入 → 路由 → 連線 → 驗證 → 排查」的順序操作。先完成一次可重複的連線,再調整規則和自動連線設定,避免同時變更多個項目而無法判斷原因。
01 · Add Server:匯入既有資訊
開啟 Shadowrocket 後,先停留在 Home,暫時不要開啟連線開關。首次使用時,清單中可能還沒有伺服器。接下來只需依照手邊的資訊選擇一種匯入方式:可更新伺服器清單的連結通常以訂閱方式處理;單一伺服器的位址、連接埠與驗證欄位則以手動新增方式處理。訂閱連結與伺服器位址不是同一個欄位,請勿將整條訂閱連結填入伺服器位址欄。
有訂閱連結:選擇 Subscribe
- 在 Home 點選右上角的加號,進入 Add Server。點選 Type,在類型清單中選擇 Subscribe,然後返回填寫頁面。
- 將既有訂閱連結完整貼到 URL。如果需要填寫 Remarks,可使用容易辨識的名稱,僅用於區分清單,不會變更連線參數。
- 儲存並返回 Home,等待訂閱內容載入。檢查對應群組下是否出現伺服器項目,而不只是多出一個訂閱名稱。出現項目後,再點選其中一台伺服器用於首次連線。
貼上後先檢查連結首尾是否有空格或換行,尤其留意複製時是否一併帶入說明文字。若載入失敗,先確認基礎網路可用,再核對連結是否完整、是否仍有效。取得訂閱內容與連線至代理伺服器是兩個不同的過程:能更新清單,不代表清單中的每台伺服器都能連線;清單暫時無法更新,也不應立即刪除所有已儲存的資訊。
有單一伺服器參數:依協定填寫
同樣從 Home 的加號進入 Add Server,在 Type 中選擇資料標示的協定,例如 Shadowsocks、VMess、VLESS 或 Trojan。先填寫伺服器位址與連接埠,再逐項核對密碼、UUID 或其他驗證欄位。不同協定需要的欄位也不同;不能只因位址相同,就沿用另一種協定的參數。欄位大小寫、連字號以及傳輸設定都應與既有資料一致。
如果資料包含 TLS、SNI、Host、Path 或傳輸方式,還需要展開對應設定逐一填寫。伺服器位址用於建立連線,SNI 和 Host 可能用於不同階段的識別,不能因為看起來都是網域就互相替換。沒有提供的參數不要憑印象補上;不清楚某項設定的含義時,先向你的服務商確認,再儲存並測試。
若已有相容的 QR Code 或分享連結,也可以使用 Scan QR Code 或剪貼簿匯入入口。掃描 QR Code 需要相機權限;從剪貼簿讀取時,請依照系統提示確認。無論採用哪種方式,匯入後都應開啟項目核對 Type、位址和連接埠。伺服器連結、QR Code 和訂閱 URL 可能包含驗證資訊,請勿公開貼上或傳送到公開討論區。
本步完成標準:Home 清單中已有實際伺服器項目,並且已選取一項。完成匯入並不代表已開始連線。多個訂閱的整理、更新與備份等操作,請參閱訂閱與伺服器管理手冊;首次使用時請先繼續選擇路由模式。
02 · Global Routing:選擇處理方式
返回 Home,找到並開啟 Global Routing。這裡會決定用戶端接管的連線如何處理,不負責匯入伺服器,也無法修正錯誤的驗證參數。三種基本模式為配置(Config) / 代理(Proxy) / 直連(Direct)。切換前先確認本次目的:是要驗證伺服器能否運作,還是讓不同目標依規則分別處理。
配置(Config):使用目前設定的規則
配置(Config)會依照目前啟用的設定檔比對連線,適合需要規則分流的使用情境。進入底部的 Config 頁面,確認準備使用的設定已儲存並選取;僅將檔案匯入清單,不代表它已生效。不同設定可能包含不同的策略和規則,因此不能只看 Home 選取了哪台伺服器,就認定所有請求都會經過該伺服器。
規則通常依照由上而下的順序比對,符合後便使用對應策略。PROXY 表示交由代理策略處理,DIRECT 表示直連,REJECT 表示拒絕;FINAL 用於處理前面沒有符合規則的連線。首次使用不必立刻編輯規則,先確認生效設定的用途。若尚未準備好設定,請勿將陌生檔案直接作為排查起點。
代理(Proxy):用於檢查代理連線
代理(Proxy)會將用戶端接管的流量交由代理策略處理,可用於短暫檢查所選伺服器的連線能力。這也是常被稱為「全域模式」的模式,但不代表應用程式能繞過所有系統限制,或接管裝置上的所有流量。測試時固定使用同一台伺服器和相同的存取目標;如果此時可以存取,切回配置(Config)後卻失敗,就應優先檢查設定與規則,而不是重複匯入訂閱。
直連(Direct):直接存取目標
直連(Direct)會讓用戶端接管的請求直接存取目標,不經過代理伺服器。這可用於對照基礎網路狀況,但無法用來驗證代理伺服器是否正常。如果目前目的是測試既有伺服器,請確認沒有誤選 Direct。完成短暫對照後,將 Global Routing 切回預計使用的模式,再繼續下一步。
本步完成標準:能說明目前選擇的是 Config、Proxy 還是 Direct;使用 Config 時,也知道目前啟用的是哪個設定。先保留預設的自動連線安排,暫時不要調整 On Demand,讓首次連線過程更容易觀察。
03 · Home:開啟開關並授權
返回 Home,再次確認伺服器選擇與 Global Routing,然後開啟頂端的連線開關。首次連線時,iPhone / iPad 會顯示新增 VPN 設定的系統提示。這項提示是允許 Shadowrocket 建立系統網路通道,不是匯入訂閱的提示,也不代表系統已確認伺服器可以連線。確認目前操作來自剛開啟的 Shadowrocket 後,依照提示允許,並完成裝置密碼或生物辨識驗證。
授權完成後返回 Shadowrocket,查看開關與連線狀態。如果先前取消了授權,重新開啟連線開關並依照系統提示操作即可,不需要先刪除所有伺服器。若系統沒有再次提示,可前往「設定 → 一般 → VPN 與裝置管理」查看相關 VPN 設定,再返回應用程式重試。裝置受到管理政策限制時,目前使用者可能無法自行變更權限,請依照裝置管理要求處理。
如果裝置上已有其他 VPN 連線,請先結束正在執行的連線,再測試 Shadowrocket,避免彼此替換而造成狀態變化。排查期間也不要反覆啟用或停用多個網路工具。連線開關剛開啟就關閉、系統設定遭移除、背景自動連線條件觸發,都屬於不同問題;請記錄實際發生的情況,不要一概稱為「訂閱失效」。
VPN 標示或系統中的連線狀態,只能表示網路通道已建立至某個階段,不能證明每個目標都能存取。驗證錯誤、伺服器無法連線以及 DNS 異常,都可能在通道建立後影響請求。因此,看到開關維持開啟後不要就此停止,請繼續進行下一步的實際存取驗證。
若稍後要使用 On Demand,建議等手動連線與中斷連線都正常後再設定。自動觸發條件會影響連線何時開始或恢復,首次排查時保持手動控制,更容易分辨是伺服器問題還是連線條件變化。系統提示的詳細說明,請參閱新增 VPN 設定與系統權限說明。
本步完成標準:系統授權完成,連線開關維持開啟,且沒有立即出現錯誤提示。接下來透過實際請求判斷連線與規則,不要繼續反覆切換開關。
04 · Connectivity Test:驗證生效結果
維持剛才選取的伺服器與路由模式,先使用 Home 中的 Connectivity Test 檢查伺服器是否可連線。測試結果只用於初步判斷,不是存取速度的保證:有結果表示測試使用的方式收到回應,出現 timeout 則表示這次測試未能在指定時間內完成。不同測試方式與實際應用程式請求可能使用不同的連線路徑,不能只憑單次結果判斷所有用途。
接著開啟瀏覽器,重新載入平時熟悉且允許存取的頁面。請發出新的請求,而不是只查看先前已快取的頁面;先測試一般網頁,再測試需要登入或有其他存取條件的功能。如果某個頁面失敗、其他頁面正常,請記錄失敗目標的情況,避免直接判定整個連線無法使用。測試期間不要同時更換網路、伺服器和設定,否則很難比較前後結果。
在 Data 中查看這次請求
返回 Shadowrocket,進入 Data,查看是否出現與剛才操作相關的連線記錄,並根據可見的目標、策略或錯誤資訊判斷。使用配置(Config)時,某些請求走 DIRECT 是規則安排的正常結果,不能以「所有請求都走 PROXY」作為成功標準。若記錄顯示 REJECT,請先檢查是否遭目前設定主動拒絕,而不是繼續更換伺服器。
如果沒有看到預期的記錄,先確認瀏覽器確實發出了新請求、連線開關仍然開啟,並檢查目前的 Global Routing。記錄中出現流量只表示有請求經過處理,還需要搭配頁面結果判斷是否成功。分享排查資訊前,請隱藏伺服器位址、訂閱連結、驗證欄位以及可能連結個人帳號的內容,只保留必要的狀態與錯誤文字。
透過一次對照區分伺服器與規則
如果在配置(Config)下無法連線,可暫時改為代理(Proxy),維持相同的伺服器與目標後再試。Proxy 正常但 Config 失敗時,請優先檢查設定檔選擇、規則順序與 DNS 設定;兩種模式都失敗時,請繼續檢查基礎網路和伺服器參數。完成對照後,請恢復原本預計使用的模式,不要因為測試時切換了選項,就忘記目前實際使用的設定。
本步完成標準:不只確認連線開關已開啟,也能透過實際請求與記錄說明連線結果。需要分流的裝置,應分別驗證一個預期走 PROXY 的目標,以及一個預期走 DIRECT 的目標;具體比對結果以目前設定為準,不要依據網站所在區域直接推測。
05 · 依失敗階段逐項排查
排查的第一步是描述失敗發生在哪個階段:Subscribe 內容沒有載入、伺服器顯示 timeout、開關無法維持開啟,還是只有某個頁面無法開啟。這些情況分別對應不同階段。先保留目前設定或必要備份,每次只調整一個項目,接著重複相同測試;不要一開始就刪除後重新安裝,因為重新安裝無法修正伺服器端參數,也可能遺失有用的診斷線索。
先檢查基礎網路,再檢查訂閱與參數
- 基礎網路:關閉連線後,確認 Wi-Fi 或行動網路能正常瀏覽一般網頁。需要網頁驗證的網路,應先完成驗證。可以更換一次網路進行對照,但應記錄切換前後的結果。
- 匯入結果:確認 Home 中有實際的伺服器項目,並且已選取一台。Subscribe 更新失敗時,請核對 URL 是否完整且有效;不要把訂閱名稱當成已成功匯入的依據,也不要在更新過程中連續重複提交。
- 位址與驗證:進入伺服器編輯頁,對照既有資料檢查 Type、位址、連接埠、密碼或 UUID。複製內容時多出的空格、遺漏的字元,以及選錯協定,都可能導致無法連線。
- 傳輸參數:繼續核對 TLS、SNI、Host、Path 與傳輸方式。不要為了消除錯誤而任意關閉憑證驗證;請先確認網域、憑證要求與伺服器端資料一致。
若 Connectivity Test 持續顯示 timeout,可在相同網路下選擇另一台既有伺服器進行對照。只有一台失敗時,請優先核對該伺服器的參數與狀態;多台同時失敗時,再考慮目前網路與共用設定。更多逐項操作請參閱節點逾時排查順序。
接著檢查路由、時間與系統權限
只有部分目標失敗時,請檢查 Global Routing 是否為預期模式,並在 Config 確認生效檔案。範圍較廣的規則若排在前面,可能會先於後面的特定規則命中;FINAL 應放在最後處理。首次使用不建議一邊測試一邊大量新增規則,請先透過 Proxy 與 Config 的對照確認是否為分流問題,再閱讀自訂規則與比對順序。
出現 TLS 或憑證相關錯誤時,也要檢查裝置日期、時間與時區是否正確。時間偏差會影響憑證有效期判斷,不能只檢查密碼。DNS 相關情況則應搭配失敗目標與 Data 記錄判斷,不要一次替換所有設定。若應用程式可以連線,但某項服務仍無法使用,也可能與該服務本身的帳號狀態、存取條件或伺服器故障有關。
開關立即關閉或系統反覆切換 VPN 時,請檢查 VPN 設定是否仍存在、是否有其他連線正在執行,以及 On Demand 是否設定了自動觸發條件。如果裝置受到組織管理,請先確認管理政策允許該連線。權限問題應先在系統設定中處理,不需要重新產生訂閱或變更伺服器密碼。
完成上述檢查仍無法找到原因時,請整理一份簡要記錄:目前網路類型、使用的協定、Global Routing 模式、Connectivity Test 結果、失敗發生的步驟,以及確切的錯誤文字。請勿附上完整訂閱連結或驗證資訊。伺服器參數與狀態請向你的服務商確認;用戶端設定與常見系統問題可繼續參閱常見問題。
完成後請記下:可用的伺服器、目前路由模式和生效設定;備份必要資料後,再調整訂閱更新或 On Demand。更詳細的掃描 QR Code、剪貼簿匯入、多個訂閱整理、刪除與備份流程,請參閱伺服器管理手冊,首次連線時不必一次完成所有設定。