官方手冊 · 首次連線流程
Shadowrocket 快速上手
匯入訂閱、連線與驗證
本頁以 iPhone / iPad 介面為例。先正確匯入既有資訊,再選擇 Global Routing,最後透過實際存取確認結果。第一次操作時,依照五個步驟完成即可,不必同時調整所有設定。
- 01 匯入資訊
- 02 選擇模式
- 03 連線授權
- 04 驗證結果
- 05 找出失敗原因
先確認訂閱連結可以完整複製,或伺服器資料包含協定類型、位址、連接埠與必要的驗證欄位。訂閱連結可能包含個人存取憑證,請勿貼在公開留言、截圖或聊天群組中。已有設定的使用者,建議先儲存原設定再進行本頁操作;遇到問題時即可還原原狀,會比連續嘗試多項未知設定更容易判斷原因。
下方圖片來自 App Store 官方截圖,用於辨認 Home、Add Server、Config 與 Settings。介面排列可能隨 App 更新而調整,操作時請以裝置顯示的英文介面詞與實際欄位為準。完整設定管理請前往訂閱管理手冊;本頁只說明首次連線所需的最短流程。
STEP 01 / IMPORT
Add Server:新增伺服器或匯入訂閱
開啟 Shadowrocket,進入 Home。第一次開啟時,SERVER 分組可能還沒有可用項目,表示尚未新增連線資料。找到 Add Server 進入新增頁面;先確認手上的資料是訂閱連結、單一伺服器分享連結,還是需要手動填寫的欄位,再選擇相應方式。不要把不同類型的資料都填入 Host 位址。
已有訂閱:選擇 Subscribe
在 Add Server 的 Type 中選擇 Subscribe,將完整訂閱連結貼入 URL 欄位。貼上後檢查開頭、結尾及中間的查詢參數,避免一併貼入說明文字、換行或空格。備註可使用方便自己辨識的名稱,例如「個人訂閱」;名稱僅供管理,不能取代實際連結。確認後儲存,等待 App 讀取訂閱,再返回 Home 查看對應分組與伺服器項目。
儲存訂閱資訊不代表一定已成功取得伺服器清單。如果分組為空或顯示讀取失敗,請先確認連結是否完整、目前網路能否存取該位址,以及連結本身是否仍有效。不要靠重複新增相同訂閱來解決讀取問題,否則清單恢復後容易出現重複項目。訂閱更新與分組整理的完整說明請參閱Subscribe 管理章節。
已有伺服器資料:逐項核對欄位
手動新增時,先選擇 Type,再填寫該類型要求的欄位。Host 填伺服器位址,Port 填連接埠;Password、Method 等欄位依照使用者既有資料填寫。不同協定的要求各異,截圖中的欄位並非所有協定都通用的必填項目。不要因為協定名稱相近就替換類型,也不要把完整分享連結貼進 Host。包含路徑、傳輸方式或其他參數的資料,也需要逐項核對一致。
如果已有 QR Code,可使用 Scan QR Code 讀取;掃描後仍須檢查解析出的 Type 與伺服器位址。剪貼簿中已有支援的分享連結時,可使用 App 提供的匯入提示,並在儲存前核對結果。Import from Cloud JSON 是另一種匯入方式,不應將一般訂閱連結或任意文字當成對應檔案使用。欄位意義不清楚時,先查閱術語表,不要猜測驗證參數。
完成任一匯入方式後,返回 Home,在 SERVER 清單中選擇準備使用的伺服器,確認選取標記確實位於該項目上。此時只完成連線資料準備,尚未決定流量如何處理,也還沒有建立連線。下一步先檢查 Global Routing,避免連線後才發現模式與目標不一致。
STEP 02 / ROUTING
Global Routing:選擇流量處理模式
伺服器已出現在清單後,返回 Home 並開啟 Global Routing。這裡選擇的是流量處理方式,不是伺服器協定,也不是系統連線權限。三種模式分別為設定(Config)、代理(Proxy)、直連(Direct)。請先依照目前的需求選擇一種,再進行連線;不要把切換模式當成修復所有故障的通用方法。
設定(Config):依據目前設定比對規則
日常需要規則分流時,使用設定(Config)。App 會依據目前生效設定中的規則處理目標請求,符合的策略可能是 DIRECT、PROXY 或 REJECT。因此,即使連線已開啟,也不是每個請求都會經過所選伺服器。進入 Config,確認目前使用的是自己了解的設定;只在清單中看到某個檔案,並不能代替確認它是否生效。
官方截圖展示 Config 編輯頁中的 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 區段。首次連線不需要逐段修改,也不需要為了匯入訂閱而啟用所有功能。訂閱主要用於取得與更新伺服器清單,Config 則決定規則等設定內容,兩者並非同一項設定。若既有設定已符合需求,請先保留原內容,透過正常存取驗證後再微調。
代理(Proxy)與直連(Direct):用於確認連線路徑
代理(Proxy)會讓流量依照此模式透過所選代理處理,適合在排查時用來比對伺服器路徑。這無法保證伺服器端一定正常,也無法排除協定參數錯誤。直連(Direct)則用於直接連線,不會經過所選代理伺服器。如果目標是測試既有代理伺服器是否可用,在 Direct 模式下瀏覽網頁並不能證明該伺服器正常運作。
建議記下本次使用的模式:已有確認過的設定時先使用 Config;需要區分「伺服器問題」與「規則問題」時,可暫時使用 Proxy 比對,測試後恢復原模式。不要同時修改規則、更換伺服器及切換模式,否則難以判斷結果原因。規則比對順序與各策略的意義,請參閱官方訂閱管理手冊和規則術語表。確認模式後,再返回 Home 連線。
STEP 03 / CONNECT
Home:開啟開關並確認系統授權
返回 Home,先檢查兩項:SERVER 中選取的伺服器是否正確,以及 Global Routing 是否為上一步決定的模式。確認後,再開啟頁面頂端的連線開關。官方截圖中的 Not Connected 表示尚未連線;不要把「清單中有伺服器」或「測試有結果」當成連線已啟動的標誌。
首次連線時,系統可能會顯示新增 VPN 設定的確認視窗。這是 App 建立系統網路連線所需的授權流程。請先確認發起 App 是 Shadowrocket,閱讀提示後依照系統要求確認;裝置可能要求輸入鎖定畫面密碼或進行身分驗證。完成後返回 App,查看連線狀態是否變更。系統授權與伺服器帳號驗證不同,請勿在裝置鎖定畫面的密碼提示中輸入伺服器 Password。
如果先前取消授權,開關可能無法維持開啟。此時請重新發起連線並處理系統提示,不必重複匯入訂閱。裝置已有其他 VPN 連線或受到裝置管理政策限制時,也可能影響啟動;請先在系統設定中查看目前 VPN 狀態,並結束不需要同時執行的連線。由公司或學校管理的裝置,請遵循裝置管理要求,不要任意刪除管理描述檔。
開啟開關後,先稍候並觀察是否立即返回中斷狀態。若能維持連線,即可進行下一步驗證;若立即中斷,請記下錯誤提示或當時狀態,直接查看本頁的失敗原因排查,不要連續快速切換開關。系統顯示 VPN 狀態只能代表相關連線狀態,不等於每個目標請求都成功,也不能證明 Config 中所有規則都符合預期。
首次建立連線期間,請勿同時更換網路、修改 Type 或編輯規則。保留這組明確條件,之後才容易判斷結果原因。使用完畢時,可返回 Home 關閉開關,再確認連線狀態已停止。若曾啟用 On Demand,也要留意它可能依條件再次發起連線;首次排查時先了解目前設定,避免將自動重新連線誤認為開關失效。
STEP 04 / VERIFY
Connectivity Test:驗證連線與實際存取
連線狀態維持開啟後,在 Home 使用 Connectivity Test。此功能用於檢查對應測試目標的連線狀況,結果與測試方法、目前網路及目標回應有關。測試成功僅供參考,不代表所有網站、App 或協定都能使用;測試失敗也須配合目標是否能回應判斷,不能只憑單次結果認定整個訂閱失效。
- 先保留目前條件。記下選取的伺服器與 Global Routing 模式,執行一次 Connectivity Test,觀察是否有結果或逾時提示。測試期間不要同時更新訂閱或切換伺服器。
- 再開啟實際頁面。切換至瀏覽器,前往自己熟悉且正常提供服務的頁面,嘗試開啟新頁面或重新整理,不要只查看已快取的內容。舊頁面仍然顯示,不一定代表剛發出的連線請求成功。
- 最後比對預期路徑。在 Config 模式下,部分目標依規則直連是正常情況。若要判斷某個目標是否經過代理,應比對 App 中可見的連線記錄與命中策略,不能只看頁面能否開啟。
若測試有結果,但實際頁面無法載入,先確認問題是否只發生在單一目標,再檢查目標請求的規則與 DNS 狀況。若頁面可以正常存取,但測試持續失敗,請先查看所用的 Test Method 與測試目標,不要立即刪除所有設定。延遲數值只反映相應測試條件下的回應,不等於檔案下載速度,也不能單獨用來判斷長時間連線的穩定性。
首次驗證以「開關可維持、實際請求可完成、路由符合預期」作為完成條件。不必為了取得特定數值而不斷排序或切換。驗證通過後,保留目前可用的設定,再逐項調整個人需要的功能。若要加入 On Demand 或更複雜的規則,請先閱讀訂閱管理手冊,每次只修改一項設定,並重新執行本步驟比對。
STEP 05 / DIAGNOSE
Settings:依失敗階段逐項排查
遇到問題時,先說明「在哪個步驟失敗」,比籠統地說「連不上」更有助於排查。請保留目前設定,依照以下順序檢查。每完成一項,只重新執行相關步驟;若同時重新安裝、清空清單並更換網路,就會失去原本可用於定位的線索。
匯入後沒有項目:先檢查輸入與更新
先確認匯入的是訂閱連結還是單一伺服器分享連結,再核對 Type 與輸入位置。訂閱清單為空時,確認 URL 完整、沒有多餘空白,並檢查更新是否回報錯誤。伺服器資訊由使用者既有訂閱提供,App 無法自行補上缺少的欄位。訂閱位址包含憑證時,請勿公開連結;若要確認資料是否有效,可透過原有的資料管理管道確認。
開關無法維持:先檢查授權與系統狀態
確認已完成首次 VPN 授權,再查看系統目前的 VPN 狀態,以及是否受到裝置管理限制。若開關一開啟就關閉,請記下 App 顯示的錯誤,不要先修改 Method 或新增規則。只有在 App 確實能啟動連線後,測試伺服器網路路徑才有意義。重新啟動 App 或裝置可作為復原嘗試,但不能取代對具體錯誤的核對。
已連線但無法存取:先檢查伺服器,再檢查規則
手動填寫伺服器時,先核對 Type、Host、Port 與驗證欄位;匯入伺服器時,則確認目前選取的項目仍然有效。可在相同網路中暫時使用 Proxy 比對,再恢復原模式;若 Proxy 正常而 Config 異常,請優先檢查目前設定、目標命中策略與 DNS。若兩者都失敗,且條件允許,可切換一次 Wi-Fi 與行動網路,以區分本地網路影響。切換網路可能產生流量費用,操作前請留意裝置設定。
僅部分情境失敗:檢查測試方法與記錄
進入 Settings,可查看 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等設定。先確認 Test Method 是否適合目前測試,不要因一次失敗就同時修改 TCP 與 UDP 相關選項。只有特定 App 或目標出現異常時,請記錄發生條件、使用的模式與目標範圍;On Demand 造成的自動連線行為也應另外確認,避免與手動連線問題混淆。
需要進一步定位時,再使用 Diagnostics 檢視或收集相關記錄。分享記錄前,請確認其中是否包含訂閱 URL、伺服器位址、密碼或其他個人資訊,只保留重現問題所需的部分。其他問題請依分類查看問答與故障排查;涉及多個訂閱更新、重複項目、備份與還原時,請繼續閱讀訂閱管理手冊。排查完成後,還原暫時變更,並重新執行連線與驗證兩個步驟,完成整體檢查。