步驟一:Add Server 新增與匯入訂閱
先確認手上的資料屬於哪一種:完整的訂閱連結、單一伺服器的分享內容,或由位址、連接埠與驗證參數組成的伺服器資訊。三者的匯入方式不同。請勿將訂閱連結直接當成伺服器位址填寫,也不要只憑伺服器名稱判斷協定。開啟 Shadowrocket 後進入 Home,點選右上角的加號進入 Add Server,再依下列兩種方式擇一操作。
已有訂閱連結:選擇 Subscribe
在 Add Server 中開啟 Type,選擇 Subscribe,將自己的完整訂閱連結填入 URL,並在備註欄填寫容易辨識的名稱,然後儲存。複製連結時應包含完整查詢參數;從聊天記錄或筆記複製後,尤其要檢查首尾空格、換行及是否誤帶中文標點。訂閱連結可能包含存取憑證,請勿貼到公開頁面,也不要向他人展示完整內容。
儲存後返回 Home,檢查是否已從訂閱載入伺服器清單。若只出現訂閱名稱卻沒有伺服器,先查看是否有錯誤提示,再從該訂閱的操作選單執行更新。訂閱網址需要透過目前網路存取;用戶端尚未連線時,若無法存取訂閱網址,也會導致首次更新失敗。這與「伺服器已匯入但連線失敗」是不同階段,應分別處理,請勿連續重複新增同一筆訂閱。
看到伺服器項目後,選取其中一個作為首次驗證對象。如果有多個群組,先記住這次選擇的訂閱和伺服器名稱,後續測試時保持不變。更新訂閱會重新讀取遠端內容,可能改變伺服器數量或參數;因此首次驗證期間不必反覆更新,也不要同時手動修改多個伺服器欄位。
已有單一伺服器資訊:依實際協定填寫
仍從 Home 的加號進入 Add Server,在 Type 中選擇與現有資訊相符的協定,例如 Shadowsocks、VMess、VLESS、Trojan 或 WireGuard。接著逐項填寫位址、連接埠,以及該協定要求的驗證與傳輸參數。不同協定的必填項目並不相同,密碼、UUID、金鑰、TLS 和傳輸設定也不能互相取代;應以持有的完整參數為準,而不是憑經驗補齊。
填寫完畢後儲存,返回 Home 檢查是否出現新增項目。若使用 QR Code,可透過 Scan QR Code 讀取已有的分享內容,辨識後仍需確認協定和必要欄位。任何匯入方式都只是將資訊寫入用戶端,並不代表伺服器目前可用。此階段的完成標準是「清單中有正確項目且可以選取」,接著再決定這些項目如何參與流量處理。
步驟二:選擇 Global Routing 模式
在 Home 點選 Global Routing,先確認目前選項,再決定是否切換。三種模式標示為設定(Config)/代理(Proxy)/直連(Direct)。它們決定連線的處理方式,不是三份伺服器清單,也不會為裝置建立新的訂閱。首次使用時,應先驗證伺服器是否能運作,再考慮更細的規則分流,避免將伺服器問題與設定問題混為一談。
代理(Proxy):先驗證所選伺服器
代理(Proxy)適合作為首次連線的對照條件:用戶端接管的連線會使用目前選取的代理,方便檢查剛匯入的伺服器能否完成實際請求。選好 Proxy 後返回 Home,再確認選取的是準備測試的伺服器。此時先不要同時修改 DNS、傳輸參數或設定規則;保持條件簡單,後續才容易解讀測試結果。
設定(Config):使用目前設定中的規則
設定(Config)會依目前啟用的設定規則處理連線。開啟 Config,確認選取的設定是準備使用的那一份,再返回 Home 選擇設定(Config)。規則可能將不同目標分別交由 PROXY、DIRECT 或其他已定義策略處理,因此「已連線」不代表每個請求都經過同一台伺服器。匯入訂閱是取得伺服器清單,Config 則負責規則與策略,兩者不可混為一談。
例如,以下規則表示符合相應網域後採用 PROXY 策略。此處僅供了解語法,不要求初次使用就將範例寫入設定;單獨複製一行也不能取代完整設定。
DOMAIN-SUFFIX,example.com,PROXY
直連(Direct):建立不經代理轉送的對照
直連(Direct)表示連線不經代理伺服器轉送,適合檢查基本網路是否可用,或與 Proxy 下的相同請求進行比較。這無法修復無效訂閱,也不能證明伺服器正常。請注意,在 App 內選擇 Direct 與徹底關閉連線開關是不同操作:前者仍是用戶端中的一種處理模式,後者則是停止目前連線。選好測試模式後,再進入下一步開啟連線。
步驟三:開啟開關並確認連線權限
返回 Home,先確認伺服器項目已選取,再檢查 Global Routing 是否仍是剛才決定的模式,最後開啟頂端的連線開關。操作順序很重要:若未確認伺服器和模式就直接開啟,後續即使存取成功,也可能無法判斷實際使用的是哪個項目或哪種處理方式。
首次連線時,系統會提示新增 VPN 設定。閱讀提示,確認這是剛才主動發起的 Shadowrocket 操作,再依系統要求允許,並使用裝置密碼或生物辨識完成確認。這裡的 VPN 設定是系統提供的網路連線權限,不是另一份訂閱。若取消此步驟,返回 App 後可能仍無法建立連線,需重新開啟開關並完成系統確認。
確認權限後返回 Shadowrocket,觀察開關與連線狀態是否維持開啟。部分裝置會在狀態列或控制中心顯示 VPN 標示,但標示只能表示系統連線狀態,無法單獨證明目標頁面已透過預期路徑存取。若開關立即關閉,優先檢查 App 顯示的錯誤與系統權限,而非先修改規則。若裝置正在使用其他 VPN 連線,應先停止不需要的連線,避免測試對象不明確。
本次手動驗證期間,可以先不設定 On Demand。它用於依條件觸發連線,與目前的手動開關不同。先完成「手動開啟後維持連線、目標可以存取」這項基本流程,再依實際需要了解隨選連線。到此仍只完成連線操作,下一步還需要透過測試和實際請求確認結果。
步驟四:透過 Connectivity Test 與實際存取進行驗證
先使用 Connectivity Test 檢查清單中的伺服器連通性,並留意測試方式。測試回傳的時間只反映本次測試目標與當時的網路狀況,不等同網頁下載速度,更不能保證所有 App 的請求都成功。某個項目有測試結果,可作為繼續驗證的依據;若發生逾時,代表需要進一步檢查,但不能只憑一次結果就判定是哪個參數有誤。
接著開啟瀏覽器,前往平常有權使用且了解正常狀況的頁面,發出新的請求。不要只看已載入的舊頁面,因為快取可能讓頁面在網路異常時仍然顯示。必要時重新整理頁面或重新開啟目標 App,再檢查文字、圖片及後續內容是否能持續載入。保持相同伺服器、相同模式與相同網路,先完成一輪穩定觀察。
接著返回 Shadowrocket,在 Data 查看測試期間是否有流量變化。流量變化表示有連線活動,但背景同步也可能產生資料,因此只能作為輔助證據,不能取代實際存取結果。同樣地,在設定(Config)下看到流量,不代表特定網域一定符合 PROXY;需要搭配目前規則和 App 中可見的連線記錄判斷。
若結果不明確,可採用單一變因對照:記錄目前伺服器與模式,先用代理(Proxy)測試相同目標,再切換直連(Direct)重新發出請求,其他設定保持不變。若 Proxy 成功而 Config 失敗,應優先檢查設定選擇和規則;若 Direct 也無法存取平常正常的頁面,應先確認 Wi-Fi 或行動網路本身。切換網路會改變條件,切換後要重新測試,不要將兩輪結果混在一起。
驗證通過後,再選擇日常所需的模式。有有效規則設定時可使用設定(Config),需要統一使用目前代理時再選擇代理(Proxy)。首次流程的完成標準不是某個圖示變色,而是伺服器選擇明確、模式符合預期、連線維持開啟,且目標 App 能完成實際請求。
步驟五:依問題階段檢查,不要同時修改多處
遇到問題時,先回答「卡在哪個步驟」,再決定檢查對象。保留原有可用資訊,每次只調整一個條件並重新測試。連續刪除訂閱、重建伺服器、切換模式和修改 DNS,會讓前後結果失去可比性;重複匯入相同內容也可能留下名稱相似的項目,增加選錯伺服器的機會。
匯入失敗或伺服器清單為空
先檢查連結是否完整、是否仍有效,以及目前基本網路能否存取訂閱網址。網頁網址、訂閱網址與單一伺服器分享內容並非相同資料,請返回 Add Server 檢查 Type 是否選為 Subscribe。若出現驗證、到期或內容格式提示,應向現有服務的提供者核對原始資料,不要反覆修改連結參數碰運氣。詳細說明請參閱常見問題中的訂閱與節點匯入分類。
項目已出現,但連線測試或實際請求失敗
手動新增的伺服器,先逐項核對協定、位址、連接埠和驗證參數;涉及 TLS 或其他傳輸選項時,也應與原始資料逐項比對。由訂閱產生的項目則優先確認訂閱更新結果,避免將暫時的手動修改當成長期修復。可以選用清單中另一個現有項目進行相同測試,但每次只更換伺服器,保持模式和目標不變。
連線開關無法維持開啟
返回系統設定檢查 VPN 設定是否已獲允許,並確認裝置沒有尚未處理的權限提示。受管理的裝置可能限制 VPN 設定,遇到明確的管理提示時應聯絡裝置管理員。不要將權限問題當成規則問題;在開關無法維持開啟的階段,修改 DOMAIN-SUFFIX 或其他規則通常無法解決連線權限本身。
Proxy 可用,Config 下部分目標失敗
先到 Config 確認目前啟用的設定,再檢查相關目標是否被規則分配到預期策略。規則順序、DIRECT 與 PROXY 的選擇,以及最後的預設規則都會影響結果。如果只有部分網域異常,還要搭配 DNS 和連線記錄繼續判斷,但不建議初次使用就同時替換整份設定與 DNS 設定。規則、DNS 及 Settings 的完整說明請參閱完整手冊。
測試偶爾成功,切換網路後又失敗
先在相同網路下重複實際請求,確認是否有可重現的條件,再分別記錄 Wi-Fi 與行動網路的狀況。測試數值低不代表持續傳輸一定穩定,單一頁面失敗也不代表所有連線都失效。需要進一步求助時,提供目前步驟、模式、協定類型和已隱去敏感資訊的錯誤提示即可;不要傳送完整訂閱連結、密碼或金鑰。
日常使用時,記住最簡單的檢查順序:先確認基本網路,再確認伺服器選擇,接著檢查 Global Routing,最後檢查設定與目標請求。更新訂閱或調整設定後,都依第四步重新驗證一次。較複雜的多訂閱維護和診斷可等基本流程穩定後再進行,避免讓首次連線受到太多變因影響。