[Quickstart]官方手冊
Shadowrocket 快速上手
從既有訂閱或伺服器資訊開始,依序完成匯入、選擇 Global Routing、連線與驗證。先確認連線可用,再調整規則及其他設定。
[Subscribe]
01 新增伺服器或匯入訂閱
開啟 Shadowrocket 後,先返回 Home。這裡可檢視及選擇伺服器項目;Config 則用於管理設定檔,兩者用途不同。初次使用時,先將既有連線資訊加入 Home,不必為了顯示伺服器清單而尋找規則檔。訂閱連結也不是一般網站網址,通常包含存取服務設定所需的憑證,不應傳送至公開討論區。
已有訂閱連結:選擇 Subscribe
在 Home 點選右上角的加號,進入 Add Server。點選 Type,選擇 Subscribe,接著在 URL 欄位貼上從自己的服務提供者取得的完整訂閱連結。貼上前後各檢查一次:確認連結開頭與結尾完整,且沒有混入空格、換行或聊天訊息中的說明文字。可在備註中填入方便辨識的名稱,接著點選右上角的完成按鈕儲存。
返回 Home 後,請等待訂閱內容下載。正常取得後,應能在相應群組中看到伺服器項目。群組名稱只是管理標記,不代表已經連線;還需要點選其中一個項目。若只有群組名稱而沒有伺服器,請先檢查訂閱更新是否出現錯誤,不要重複新增同一個連結。訂閱可能需要有效帳戶或符合存取條件的網路,實際狀態請以使用者既有服務的帳戶資訊為準。
有些使用者取得的是單一伺服器分享資訊,而不是訂閱連結。兩者不能只憑網址長短判斷;應先確認提供者標示的用途。將單一伺服器資訊填入 Subscribe,或把訂閱網址當成伺服器主機名稱,都會造成匯入錯誤。若暫時無法分辨,請先查看術語表中的訂閱與設定說明,不要把未知連結逐一填入所有輸入欄位。
已有伺服器參數:在 Add Server 手動填寫
如果取得的是一組伺服器參數,請在 Add Server 的 Type 中選擇與原始資料一致的協定,再填入伺服器位址、連接埠和驗證資訊。Shadowsocks、VMess、VLESS、Trojan 等協定所需欄位各不相同,不能將某種協定的密碼或身分欄位直接套用到另一種協定。TLS、SNI、傳輸方式與路徑也應逐項對照原始資料,不要根據伺服器名稱推測。
儲存後返回 Home,確認項目出現在清單中,並點選準備使用的伺服器。此時先不要急著開啟連線:下一步需要明確選擇 Global Routing,讓後續測試結果能對應到確定的流量處理模式。若訂閱中有多個項目,初次只選一個進行驗證,避免同時變更伺服器與分流方式,導致難以判斷失敗原因。
[Rule]
02 選擇 Global Routing
在 Home 點選 Global Routing,查看目前選取的模式。這裡有三種模式:設定(Config)、代理(Proxy)、直連(Direct)。它們決定請求如何交由策略處理,不負責補齊伺服器參數,也無法修復已失效的驗證資訊。切換前先記下原本的選項,方便測試結束後還原。
設定(Config)依照目前啟用的設定檔比對規則。開啟 Config 後,應確認實際選取的檔案,而不只是檢查檔案是否存在。檔案中的規則通常依序比對,請求符合哪一條,就依該條指定的策略處理。某個網域可以直連,不代表代理伺服器已可使用,因為該請求可能根本沒有經過代理。
代理(Proxy)可用於初步排除規則因素,讓適用流量以代理模式處理。初次驗證時,可先選擇 Proxy,再返回 Home 確認已選取伺服器。這是為了建立容易觀察的測試條件,並非要求長期固定使用此模式;系統流量範圍、App 本身的行為與網路條件仍會影響結果。
直連(Direct)用於直接連線,不適合拿來驗證代理伺服器是否正常。如果開啟連線後的存取狀況與未連線時相同,請先檢查是否停留在 Direct,而不是立刻重新填寫密碼。Direct 也可作為對照條件,協助判斷原本能直接存取的網站在其他模式下是否出現額外問題。
確認 Proxy 模式下的實際存取正常後,再進入 Config 選擇使用者已有且了解其來源的設定檔,返回 Global Routing 並切換至 Config。不要將來源不明的網路規則整份覆蓋目前設定,也不要只為了「讓所有測試通過」而任意調整 DNS。規則順序、DNS 與 On Demand 的詳細關係請參閱Settings 設定項目參考;本頁只說明基本連線流程。
[Connect]
03 開啟連線並完成授權
返回 Home,再確認選取標記位於準備測試的伺服器上,並確認 Global Routing 與上一步相同。接著開啟頂端的連線開關。首次建立連線時,iPhone / iPad 可能會顯示新增 VPN 設定的系統提示;請確認這是剛才由 Shadowrocket 發起的操作,再依照系統提示允許,並完成裝置要求的身分驗證。
系統授權的作用是允許用戶端建立相應的網路連線,不是購買服務,也不會自動建立伺服器帳戶。如果選擇取消,請先返回 Home 查看開關狀態;需要連線時再重新操作。若裝置由組織管理,相關設定可能受管理政策限制,此時應由裝置管理者確認權限,而不是反覆刪除系統設定。
完成授權後返回 Home,查看開關是否保持開啟,以及用戶端是否顯示已連線狀態。系統狀態列或控制中心也可能顯示 VPN 狀態提示,但不同裝置的顯示位置不盡相同。不要只依賴某一處的小圖示,應一併考量連線狀態、實際存取與請求記錄。VPN 通道已建立,只代表系統連線環節完成,不代表遠端服務一定可用。
若開關剛開啟就關閉,或系統立即顯示錯誤,請先保留錯誤訊息,再檢查是否有其他 VPN 連線正在使用、系統權限是否已完成,以及目前設定是否有明顯錯誤。初次排查期間先不要啟用 On Demand 等自動連線條件,避免手動關閉後又自動重新連線,影響目前狀態的判斷。每次修改一項設定後再重新連線,不要連續快速切換開關。
日後更換伺服器、網路或重要參數時,可先關閉連線,完成修改後再開啟,並重新進行下一步的驗證。離開至桌面不代表已中斷連線;不再需要時,請返回 Home 主動關閉,並確認狀態已變更。這也能避免將上一次連線結果誤認為目前參數的測試結果。
[Test]
04 驗證連線是否生效
在 Home 使用 Connectivity Test 取得初步回饋。這項功能可協助發現目前伺服器是否有明顯的連線問題,但測試採用的目標與方式不一定等同於日常使用的 App。測試有結果,不代表所有網站都能存取;測試失敗時,也應依據具體錯誤與實際存取狀況繼續判斷,不能只憑一次回饋就刪除整份設定。
接著開啟瀏覽器,前往一個自己有權存取,且能明確判斷是否載入完成的網站。測試時請主動重新整理頁面,避免只看到上一次保留的內容。若需要登入、提交表單或使用即時功能,應分別驗證這些操作,因為頁面主體載入成功,不代表其引用的所有網域都使用了正確策略。
使用 Config 時,也要確認預期的分流結果。以某個應使用 PROXY 的測試網域為例,先在設定中找到對應規則,再配合可用的連線或記錄資訊查看實際處理狀況。若符合的是 DIRECT,應檢查是否有更前面的規則先符合,而不是將問題歸因於伺服器。規則關鍵字的含義可參閱術語表,具體設定請參考設定參考。
如果 Proxy 模式下能存取,Config 模式下卻失敗,表示應優先檢查目前設定的規則、策略引用與 DNS 設定;如果兩種模式都失敗,應先檢查伺服器參數、服務狀態與目前網路。若只有某個 App 失敗,還需區分該 App 本身的登入狀態、快取或服務故障。每次只變更一項條件,前後兩次測試才有比較意義。
最後分別在實際需要使用的 Wi-Fi 與行動網路下重新測試。切換網路後,請等待系統狀態穩定,再確認連線狀態與選取的伺服器;不要將切換網路時短暫的失敗視為持續性故障。完成這一步後,保留已驗證可用的伺服器與模式,基本上手流程便告完成;後續新增自動連線、修改規則或替換設定,都以這組可用條件作為還原依據。
[Troubleshoot]
05 依照失敗位置逐項排查
排查應從「最後一個成功的步驟」開始,而不是從重新安裝開始。先記下目前網路、匯入方式、協定、選取的伺服器、Global Routing 和錯誤訊息,再判斷失敗發生在下載訂閱、建立連線還是實際存取階段。這樣既能減少重複操作,也能在詢問自己的服務提供者時清楚描述狀況。
訂閱中沒有伺服器,或更新失敗
先檢查 URL 是否完整、訂閱是否仍有效,以及目前網路能否存取訂閱所在位址。伺服器項目已存在,不代表下一次訂閱更新一定成功;訂閱下載與伺服器連線是不同環節。保留原有群組,確認連結及服務狀態後再更新,不要反覆刪除後重建。若取得的只有一段網頁說明,而非可辨識的設定內容,請向原提供者確認連結用途。
Connectivity Test 失敗
確認選取的是準備測試的伺服器,而不是只展開了某個群組。手動填寫時,請重點核對協定、位址、連接埠與驗證參數;啟用 TLS 的連線也應核對 SNI 等原始要求。不要任意開啟 Allow Insecure 來掩蓋參數問題,也不要為了讓測試顯示成功而更換未知的測試目標。若既有訂閱中的其他項目可用,可在相同網路與模式下改用另一個既有項目重新測試。
開關無法保持開啟,或已連線但無法存取
開關無法保持開啟時,優先檢查系統授權、其他 VPN 狀態與明確的錯誤訊息。開關保持開啟但無法存取時,先確認目前不是 Direct,並使用 Proxy 進行一次對照測試。若 Proxy 仍失敗,請核對伺服器狀態與參數;若 Proxy 成功而 Config 失敗,請檢查目前啟用的 Config 檔案。不要同時變更 DNS、協定、規則和測試網站,否則無法判斷是哪一項造成變化。
只有部分網站無法使用,或切換網路後失敗
部分網站異常時,通常需要檢查特定網域的規則比對結果、DNS 回應及目標服務狀態;請先確認其他網站是否正常,再縮小排查範圍。切換 Wi-Fi 與行動網路後發生異常,請先等待網路穩定並重新連線,再以相同目標重新測試。若需要更完整的狀況分類,請繼續閱讀常見問題,不要在基本上手階段大量替換進階設定。
完成排查後,請依照「選取伺服器 → 確認 Global Routing → 開啟連線 → 實際存取」的順序重新測試。確認恢復後,再逐項加入原有設定。需要備份或長期維護設定時,請接著閱讀設定參考,不必在第一次連線時就完成所有功能設定。