官方手冊 · 首次連線流程
Shadowrocket 使用教學訂閱匯入、模式選擇與連線驗證
以 iPhone / iPad 介面為例,從既有資料開始,依序完成加入與連線。先確認每個步驟的結果,再進行下一步,避免同時調整多項設定。
01加入資料02選擇模式03連線04–05驗證與排錯
先將資料準備在方便核對的位置,再開啟應用程式。訂閱連結與單一伺服器參數是兩種不同的輸入:前者通常用來取得並更新一組項目,後者則描述某台伺服器的協定、位址與驗證方式。請勿將訂閱位址直接填入 Host,也不要把一般網頁位址當成訂閱。以下兩種加入方式擇一即可,不必重複匯入。
截圖用於辨認頁面與欄位,實際顯示的選項可能因協定或系統而異;截圖中的項目不是可用的伺服器資料。遇到介面差異時,請依目前應用程式顯示的英文項目名稱查找。
STEP 01 · Add Server / Subscribe
加入伺服器或匯入既有訂閱
開啟 Shadowrocket,進入 Home,在 SERVER 群組找到 Add Server。進入加入頁面後,先查看 Type,不要急著填寫其他欄位:Type 會決定目前項目的類型,以及後續需要提供哪些參數。若已有完整的訂閱連結,請使用 Subscribe;若取得的是伺服器位址、連接埠與驗證資訊,請手動加入。
已有訂閱:選擇 Subscribe
在 Add Server 中開啟 Type,選擇 Subscribe,返回後將完整訂閱連結貼到 URL 欄位,並填寫方便辨識的備註。複製時請留意開頭與結尾是否完整,尤其不要連同聊天訊息中的標點、換行或說明文字一起貼上。連結中的查詢參數也是位址的一部分,不應自行刪改;若服務商提供的內容不是訂閱,請先確認資料類型。
儲存後返回 Home,等待訂閱內容載入,檢查是否出現對應的群組與伺服器項目。儲存成功只代表新增了記錄,仍須確認內容已成功取得。若清單是空的,先檢查原始連結,再嘗試更新該訂閱;不要連續建立多個相同訂閱,以免後續難以分辨需要維護哪一組資料。項目出現後,先保留原有群組,再進行下一步。
已有伺服器參數:依 Type 填寫
手動加入時,依資料選擇 Shadowsocks、VMess、VLESS、Trojan 或其他相符的協定。Host 填寫伺服器網域名稱或 IP,Port 填寫連接埠;Password、Method 及其他驗證或傳輸欄位則依原始資料填寫。以 Shadowsocks 為例,Method 與 Password 必須和伺服器設定一致,不能只靠位址和連接埠完成連線。不同 Type 的欄位並不相同,請勿將某種協定的填寫方式套用到其他協定。
如果資料要求 TLS、特定傳輸方式或伺服器名稱,也請逐項核對。Host 通常不是含有路徑的網頁 URL,不應額外加入網頁路徑。QR Code 資料可透過 Scan QR Code 讀取;Import from Cloud JSON 僅適用於符合該格式的資料,並非所有連結的通用匯入入口。讀取後仍應檢查 Type 與重要參數,再儲存並返回 Home。
訂閱連結可能包含存取憑證,請勿公開完整位址,也不要直接傳送含有完整連結的截圖。若加入後顯示解析失敗,可先依問答頁中的訂閱排查說明核對格式;確認清單有內容後,再選擇如何處理流量。
STEP 02 · Global Routing / Config
選擇 Global Routing 模式
準備好伺服器項目後,返回 Home,點選 Global Routing。這裡決定如何處理請求,不會修改伺服器密碼,也不會更新訂閱。首次使用建議先了解三個選項,再依需求選擇:設定(Config)、代理(Proxy)、直連(Direct)。切換後返回 Home,確認 Global Routing 一列顯示剛才選擇的模式。
設定(Config):依目前設定檔的規則分流
設定(Config)會依據目前啟用的設定檔進行比對。前往 Config,先確認正在使用哪個檔案,再查看其中的規則。官方截圖展示設定檔編輯頁面,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段;一般首次連線不需要逐段修改,也不需要為了連線而啟用所有功能。
規則會依序判斷,最先符合的規則決定該請求的處理方式,最後通常由 FINAL 處理未符合前面規則的請求。以下僅為語法範例,不是要整段取代現有設定。使用自己的設定時,應確認規則目標能在目前設定中正確解析,避免因照抄範例而覆蓋原有設定。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
範例中,符合 example.com 及其子網域的請求會使用 PROXY,其他未符合規則的請求則由 FINAL 指向 DIRECT。DIRECT 代表直接連線,PROXY 代表交由代理處理,REJECT 代表拒絕。若某個網站無法開啟,請先確認實際符合哪種處理方式,不要直接認定所有伺服器都已失效。
代理(Proxy)與直連(Direct):用於明確對照
代理(Proxy)會將通常受此模式控制的請求交由所選代理處理,適合暫時對照 Config 的結果。若 Proxy 可以存取而 Config 不行,請優先檢查規則、策略選擇或 DNS 相關設定。此選項無法修正錯誤的驗證資訊,也無法保證所有應用程式請求都會得到相同結果。
直連(Direct)會以直接連線方式處理請求,適合觀察目前基礎網路是否正常。選擇 Direct 後能開啟網頁,不代表剛匯入的伺服器已可使用。完成對照測試後,應恢復預定的日常模式,並記下目前的設定檔。需要調整複雜的比對順序或策略時,請參閱完整使用手冊;本頁僅保留首次連線所需的判斷方式。
STEP 03 · Home / SERVER
選擇伺服器並開啟連線開關
選定模式後返回 Home,在 SERVER 群組中點選本次要使用的伺服器。若有多個訂閱,請確認選取標記對應的具體項目;訂閱群組名稱只是管理入口,不代表已選定其中某台伺服器。首次驗證選擇一台即可,暫時不要連續切換,方便將測試結果對應到目前設定。
確認 Global Routing 後,開啟 Home 頂端的開關。尚未連線時會顯示 Not Connected。首次啟用時,系統可能會要求新增 VPN 設定;確認要求來自目前開啟的 Shadowrocket 後,依系統提示同意,並在需要時完成裝置驗證。若拒絕設定要求,應先處理這項權限,應用程式無法只靠重複匯入訂閱建立系統連線。
返回 Home,觀察頂端連線狀態是否改變,以及開關是否維持開啟。系統中的 VPN 標示可協助判斷通道狀態,但不同裝置的狀態列顯示方式不完全相同,應一併確認應用程式畫面與系統 VPN 設定。若開關立即關閉,先不要修改規則檔案,下一步應檢查系統授權、既有 VPN 設定及應用程式回報的錯誤。
若裝置上已有其他 VPN 連線或系統管理設定,可能會影響此次連線。先確認目前啟用的是哪一項;受公司或學校管理的裝置,應遵守管理規定,不要刪除用途不明的設定。基礎網路也必須先能使用,例如需要登入確認的 Wi-Fi,應先完成網路接入頁面上的操作。
首次建立連線後先稍候片刻,再進行測試。不要同時更新訂閱、更換設定與切換網路,否則出現差異時難以判斷是哪項變更造成。若要中斷連線,返回 Home 關閉頂端開關即可;之後再次使用時,仍應確認伺服器選擇與 Global Routing 未受先前的排查操作影響。
STEP 04 · Connectivity Test / Data
分別驗證連線狀態與實際瀏覽
連線開關維持開啟後,先在 Home 執行 Connectivity Test。測試用來觀察目前測試方法下的連通結果,並非所有網站、所有協定或所有應用程式的通用結論。單次結果也會受到測試目標、網路變化與測試方法影響,不宜只根據一個數值判斷設定是否正確,也不必直接比較不同方法測得的數值。
接著開啟瀏覽器,前往平常可確認內容的目標頁面,並實際重新整理。瀏覽器快取可能讓舊頁面在網路變更後仍然顯示,因此「頁面還開著」不代表這次請求成功。建議分別驗證預期經由代理與預期直接連線的目標,同時確認目前的 Global Routing,確保測試條件符合預定的日常模式。
利用 Data 輔助觀察,不把累積值當成立即結論
返回 Shadowrocket 查看 Data,觀察與此次瀏覽對應的流量變化。統計資料通常也會包含統計範圍內的其他請求,背景同步也可能產生流量,因此不能把某個累積數字當成剛才單一頁面的精確用量。若目前畫面可依伺服器查看,請搭配所選伺服器判斷;若要確認實際命中的規則,再查看相關記錄與診斷資訊。
請將三個問題分開判斷:系統連線是否建立、目標請求是否完成、處理方式是否符合規則。前兩項正常,第三項仍可能有誤差。例如 Config 下某個目標正常開啟,實際上卻可能符合 DIRECT;反過來,Proxy 可用而 Config 失敗,也應優先檢查分流路徑,而不是反覆重新加入同一台伺服器。
- Connectivity Test 有結果、實際頁面失敗:核對具體目標、DNS 與規則,不要直接判定整體可用。
- 實際瀏覽正常、測試失敗:檢查測試方法與目標是否適合目前網路,不要為了一項測試而修改整份設定。
- 切換 Wi-Fi 與行動網路後結果不同:使用相同伺服器與模式進行對照,排除同時變更設定造成的干擾。
完成首次驗證後,記下可用伺服器、目前模式與設定檔名稱。之後發生問題時,這些資訊就是還原基準。不要為了追求某個測試數值而頻繁修改已驗證可用的參數;若使用上仍有問題,再依下方說明逐項排查。
STEP 05 · Settings / Diagnostics
依問題發生位置排查,不要一次重設所有設定
先描述問題出在哪一層,再決定要查看哪個頁面。若將「訂閱無法載入」「頂端開關無法維持開啟」「某個網站無法開啟」全都歸類為連線失敗,會讓檢查方向混亂。每次只變更一個項目,修改後重做第四步的驗證;若沒有改善,先還原原值再檢查下一項,避免越改越難追查。
清單為空或更新失敗:檢查訂閱資料
先確認連結完整、類型為 Subscribe,並檢查目前的基礎網路能否完成更新。成功取得訂閱與其中的伺服器能否連線是兩回事;若連結已失效,修改 Global Routing 並無幫助。連續更新也無法修復服務商端失效的資料,請向自己的服務商確認連結狀態、內容格式與相關使用狀態。聯絡時不要在公開頁面貼出完整憑證。
已有項目但連線失敗:核對參數與系統狀態
手動加入的項目,優先核對 Type、Host、Port、驗證資訊,以及資料要求的 TLS 和傳輸設定。訂閱項目先更新一次,再選擇一台已知適用於目前用途的伺服器進行測試。若開關立即關閉,請檢查系統 VPN 授權與其他已啟用的設定;若開關維持開啟但無法瀏覽,再區分伺服器連通、規則與目標存取問題,不要直接刪除所有資料。
測試與瀏覽結果不一致:查看 Test Method
進入 Settings,查看 Test Method,確認目前使用哪種測試方式。不同方式檢查的層面不同,能取得測試結果不代表已驗證目標網站的完整請求。保留原設定後再逐項對照,並搭配實際瀏覽判斷。若只有某個目標異常,記錄其網域、發生時間、目前模式與錯誤現象,比只記下「不能用」更有助於定位。
自動連線或切換網路異常:檢查 On Demand
Settings 中的 On Demand 與隨選連線條件有關。如果手動關閉後又重新連線,或切換網路後行為不同,請先檢查是否設定了相應條件。首次使用可先確認手動連線流程正常,再設定隨選行為。不要將 On Demand 當成修復伺服器驗證失敗的開關;它決定何時嘗試連線,不能取代可用的伺服器資料。
需要進一步定位時,查看 Diagnostics,先確認記錄對應本次操作,再找出錯誤類別。分享記錄前,請遮蔽訂閱 URL、密碼、驗證識別資料與其他敏感資訊。Settings 中的 Proxy、TCP、UDP 等項目涉及不同網路行為,不建議只憑名稱逐一切換;詳細說明請參閱完整使用手冊,常見症狀與處理方式請見問答頁。