Official Manual / First Connection

Shadowrocket 使用教學

從現有連線資料開始,依序匯入、選擇模式、連線與測試,完成初次設定。本頁適用於 iPhone 與 iPad;進階參數請參閱技術參考。

  • Add Server
  • Global Routing
  • Connectivity Test

STEP 01 / INPUT

Add Server:新增伺服器或匯入訂閱

開啟 Shadowrocket,先進入 Home。此頁可查看伺服器項目、選取目前使用的伺服器及控制連線。初次使用時,先輸入資料,不必立刻開啟連線開關。請先確認手上的資料類型:可更新一組項目的訂閱連結,或只對應單一伺服器的位址、連接埠與驗證資訊。兩種資料的輸入位置相近,但欄位用途不同。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角的加號,進入 Add Server,開啟 Type 並選擇 Subscribe。將完整的訂閱連結貼到 URL 欄位,再填寫方便辨識的備註並儲存。複製時請留意連結前後的空格、換行與聊天訊息中的標點;若網址含有查詢參數,請保留完整內容,不要只複製到第一個問號之前。

儲存後返回 Home,等待讀取訂閱內容。成功讀取後,應能看到訂閱群組及其中的伺服器項目。點選展開相應群組,再點選要使用的伺服器,確認其已選取。儲存訂閱記錄不代表已成功取得伺服器清單;如果只看到群組名稱而沒有項目,請先檢查讀取結果,再進行後續步驟。

更新訂閱會重新取得現有連結中的項目,不代表伺服器本身已修復。首次讀取失敗時,請先確認該網址確實會傳回用戶端可辨識的訂閱內容,而非帳號管理網頁。只需向原資料提供者確認連結狀態,請勿將含有憑證的完整網址貼到公開討論區。若已有清單,也請先確認目前選取的項目仍屬於有效群組。

已有單一伺服器資料:依 Type 填寫

若資料對應單一伺服器,仍從 Add Server 開始,並在 Type 選擇資料明確標示的協定類型,例如 Shadowsocks、VMess、VLESS 或 Trojan。接著逐項填寫伺服器位址、連接埠及相應驗證欄位。請勿依名稱相似程度選擇協定;密碼、UUID、加密方式與傳輸設定也不能互相替代,請以自己的原始資料為準。

位址欄填寫伺服器網域或 IP,連接埠則填入資料提供的數字。若資料包含 TLS、伺服器名稱或傳輸路徑,也請一併核對,不能只因位址和連接埠齊全就認定設定完整。若已有伺服器分享連結或 QR Code,可依其格式匯入;使用 Scan QR Code 後仍須檢查匯入結果,尤其是 Type 與驗證欄位,避免掃描到其他用途的 QR Code。

儲存並返回 Home 後,為項目填寫容易辨識的備註,再選取該伺服器。此時只需確認兩件事:清單中確實有該項目,且目前選取的就是預計使用的項目。若要了解協定欄位的用途,請先參閱協定技術參考,初次連線前不必逐項調整進階參數。完成資料輸入後,下一步是決定請求如何透過這些項目處理。

STEP 02 / ROUTING

Global Routing:選擇設定檔、代理或直連

在 Home 點選 Global Routing,查看目前模式。此處的選擇決定建立連線後如何處理請求,並非選擇伺服器協定。三種模式分別是設定檔 (Config)/代理 (Proxy)/直連 (Direct)。匯入伺服器後,不代表目前設定檔一定符合自己的用途,因此開啟開關前請先確認。

依本次操作目的選擇模式
模式處理方式初次使用檢查項目
設定檔 (Config)依照目前設定檔中的規則選擇策略。確認 Config 中使用的設定檔與末尾策略。
代理 (Proxy)以代理模式處理流量,用於檢查所選伺服器的轉送情況。確認 Home 中已選取預期使用的伺服器。
直連 (Direct)採用直連模式,不能以此證明伺服器轉送成功。適合與裝置原有網路的連線狀況對照。

日常依規則使用:先檢查 Config

準備依規則分流時,請進入 Config 頁面,確認目前使用的設定檔。開啟相應設定檔查看內容,特別留意 [Rule] 中的規則與末尾策略。伺服器訂閱提供伺服器項目,設定檔則用來描述處理方式,兩者並非同一份資料;匯入訂閱後,仍應確認目前生效的設定檔是否符合自己的用途。

規則通常依序檢查,命中後便採用相應策略。PROXY、DIRECT、REJECT 代表不同的處理結果;FINAL 則在前面的規則都未命中時作為預設策略。初次使用不必立刻編寫規則,但至少要了解:某個網站採用直連,可能是設定檔的安排,不一定代表連線失效。請勿為了恢復單一網站的連線,就直接清空整份設定檔。

先測試伺服器:保留明確的對照條件

若要確認剛新增的伺服器能否運作,可暫時選擇代理 (Proxy),並以相同的目標請求觀察結果。測試結束後,依自己的使用目的切回設定檔 (Config)。直連 (Direct) 可用來對照本機網路:直連正常但代理失敗時,問題較可能在伺服器或其參數;兩種模式都失敗時,還需檢查裝置的基本網路連線與目標網站。

切換模式後返回 Home,再確認一次 Global Routing 的目前值。每次只變更模式或伺服器其中一項,不要同時更換伺服器、設定檔與 DNS;否則即使連線恢復,也難以判斷是哪項設定發揮作用。確認模式後,維持目前設定進入連線步驟。

STEP 03 / CONNECT

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

返回 Home,確認所選伺服器與剛才檢查的相同,再確認 Global Routing 顯示預期模式。請區分三種狀態:資料已儲存、伺服器已選取、連線開關已開啟。只在清單中看到伺服器,不代表裝置流量已依所選模式處理;確認前兩項後,再開啟 Home 頂端的連線開關。

首次出現 VPN 設定提示

首次建立連線時,iOS 或 iPadOS 可能會顯示新增 VPN 設定的系統提示。請閱讀提示中的 App 名稱,確認操作來自剛開啟的 Shadowrocket,再依系統指示允許並完成裝置要求的驗證。系統設定授權是用戶端接管網路流量所需的步驟,不是登入伺服器帳號,也不應在此過程中輸入訂閱密碼。

若先前取消了提示,連線可能無法繼續。返回 App 後重新發起連線,依實際顯示的系統提示完成授權即可。系統介面的文字可能因裝置語言與系統狀態而異;本頁不要求尋找特定按鈕文字,而是要確認提示用途與 App 來源。裝置系統需求請以 App Store 頁面標示為準。

授權後返回 App 確認

完成驗證後返回 Home,確認連線開關是否維持開啟。裝置可能會顯示 VPN 狀態圖示,但位置會因系統版面而異,因此不能只憑狀態列有無圖示判斷。開關維持開啟,表示連線流程已進入運作狀態;這仍不代表遠端伺服器、網域解析與每條規則都已通過測試。

若開關立即關閉,請先檢查系統授權是否完成,以及是否有其他 VPN 設定正在接管連線。初次操作時也請先確認 On Demand,避免自動連線條件與手動操作交錯,造成「剛關閉又自動連線」的誤判。請勿反覆快速點按開關;先等待狀態穩定,再決定是否重試。

若系統顯示具體錯誤,請記下錯誤文字與出現時機,例如「授權後立即停止」或「開關維持開啟但網頁無法載入」。這些資訊比只說「無法使用」更有助於找出問題。需要保存記錄時,請遮蔽伺服器位址、驗證欄位及訂閱連結中的憑證。開關狀態穩定後,請繼續以實際請求測試,不要把狀態圖示當成操作終點。

STEP 04 / VERIFY

Connectivity Test:測試實際連線與規則

開啟連線開關後,先在 Home 使用 Connectivity Test 查看伺服器測試結果。此測試有助於找出明顯無法連線的項目,也能比較相同網路條件下的回應情況;不過結果會受測試方式與目標影響。有回應只代表這次測試收到回應,不能據此推斷所有網頁及各種協定傳輸都正常。

發出新的網頁請求

開啟 Safari,前往自己熟悉且目前需要使用的網站,重新整理頁面或開啟新頁面。不要只查看先前已開啟的頁面,因為快取內容可能在連線變更後仍然顯示。請觀察頁面能否完整載入;若只能看到標題或部分圖片,也應記錄為部分請求失敗,而非籠統認定「整體連線正常」。

若使用設定檔 (Config),請各選一個預期由代理處理及預期採直連的目標進行對照。目的不是證明所有流量都經由同一路徑,而是確認規則是否依預期執行。App 或網頁顯示的地區資訊可能受帳號、快取與定位權限影響,不能將地區文字當作唯一的連線判斷依據。

在 Data 查看相應請求記錄

返回 Shadowrocket,在 Data 中查看與剛才瀏覽相對應的連線記錄;若目前未記錄所需資訊,請依介面提供的記錄選項啟用記錄後,再次發出請求。優先依存取時間與目標網域尋找,並核對實際採用的策略及可見的匹配資訊。不同頁面提供的資訊詳細程度可能不同,請以目前介面顯示為準。

例如,預期經由代理的網域卻採用 DIRECT,請返回 Config 檢查規則順序,不要立刻重新輸入伺服器密碼。若請求採用 PROXY 卻持續失敗,接著檢查所選伺服器、驗證欄位與解析情況。若顯示 REJECT,請先確認目前的設定檔是否刻意封鎖該請求。記錄是用來協助解讀結果,不應為了讓記錄看起來一致而隨意更改策略。

完成一次有效測試後,記下當時選取的伺服器、Global Routing 模式與設定檔名稱。日後發生問題時,可先與這組已驗證的條件比較。測試結束後,依需要管理記錄功能;準備分享記錄時,請移除目標位址中的個人資訊與所有存取憑證。至此已完成初次連線流程,後續排查只需針對故障發生的位置進行。

STEP 05 / CHECK

常見故障:依發生位置逐項檢查

請從最早出現異常的步驟開始排查。若未讀取到伺服器清單,先停留在匯入階段;若開關無法維持開啟,先處理連線與授權;只有特定網站失敗時,再檢查目標請求的解析與規則。每輪只變更一項設定,並重新執行相同的測試請求,才能比較結果。

匯入失敗:檢查連結與內容類型

返回 Add Server 的訂閱記錄,確認 Type 是否為 Subscribe、URL 是否完整,以及內容是否混入空格或標點。若傳回內容實際上是登入頁面、錯誤訊息或空白內容,用戶端就無法產生伺服器清單。請勿將訂閱網址當成伺服器位址輸入,也不要把單一伺服器分享連結誤認為可更新的訂閱。若無法確認格式,請向原資料提供者確認資料用途。

伺服器無法使用:先檢查原始欄位

若 Connectivity Test 持續失敗,先確認關閉連線時裝置能否正常上網,再檢查所選項目的位址、連接埠、協定類型及驗證資訊。手動新增的項目請逐欄對照原始資料;訂閱項目則確認訂閱是否成功更新,以及目前項目是否仍有效。頻繁變更協定類型通常無法解決驗證資訊不符,反而會掩蓋原本的問題。

開關已開啟但無法連線:檢查模式與 DNS

先確認 Global Routing 是否仍為測試時預期的模式。若為直連 (Direct),連線結果無法證明伺服器轉送正常;若為設定檔 (Config),還需確認目標是否實際匹配 PROXY。維持伺服器不變,暫時改用代理 (Proxy) 進行一次對照,有助於區分規則與伺服器問題;測試後再恢復日常使用的模式。

若測試有回應,但網頁顯示找不到網域,請檢查目前設定檔中的 DNS 相關設定。先確認使用的是哪個 Config,再檢查解析設定能否在目前網路環境中運作。看到 DNS 錯誤時,請勿連續更換多個位址;保留原值,每次只變更一項,再次請求同一網域。解析成功與伺服器轉送成功是不同環節,請分別確認。

只有部分網站失敗:查看匹配結果再調整規則

只有部分目標發生異常時,請在 Data 中找出這些目標的請求,並對照 Config 的規則順序與 FINAL 策略。單一網頁可能同時請求多個網域,因此首頁能開啟但圖片載入失敗,可能是不同請求匹配了不同規則。先找出失敗請求的網域與策略,再決定是否調整規則;不要將整份規則改成同一策略來取代問題定位。

需要繼續排查時,請前往常見問題依現象查閱;若要了解協定與參數的選擇,請參閱技術參考。更換裝置後重新安裝 App 的購買恢復步驟,請見已購項目恢復說明。重新下載 App 無法取代恢復自己的設定檔與連線資料,操作前請先確認資料已完整保存。