官方手冊 · 首次使用
Shadowrocket 使用指南
匯入訂閱與首次連線
依序完成匯入、路由、連線與驗證。先讓一個既有伺服器連線正常,再調整規則與自動連線條件,方便判斷每個步驟的結果。
01 · Add Server:新增伺服器或匯入訂閱
開啟 Shadowrocket 後,先停留在 Home,暫時不要開啟連線開關。確認手上的資訊屬於哪一種:訂閱連結通常用來取得並更新一組伺服器;單一分享連結只描述一個伺服器;手動填寫則需要完整的協定與連線參數。這三種資料用途不同,不宜把單一伺服器連結當作 Subscribe 網址使用,也不要把設定檔網址填進伺服器位址欄。
已有訂閱連結:選擇 Subscribe
在 Home 點選右上角的新增按鈕,進入 Add Server。開啟 Type,選擇 Subscribe,再將自己的完整訂閱連結貼到 URL。Remarks 可填寫方便辨識的名稱,例如「日常設定」,不要把存取憑證寫進備註。檢查連結前後是否多了空格或換行,再點選 Done 儲存。返回 Home 後等待讀取訂閱;若清單尚未出現伺服器,可在該訂閱的操作選單中執行更新。
讀取成功後,Home 應會出現訂閱群組及其中的伺服器項目。先確認有可選擇的具體伺服器,再進行下一步。只有訂閱名稱而沒有伺服器,並不代表匯入完成:可能是請求尚未結束、回傳內容為空,或無法辨識訂閱內容。此時先檢查更新結果,不要反覆建立同名訂閱,以免之後無法分辨目前使用的是哪一份。
更新訂閱會重新取得遠端內容。若需要保留手動調整,請先記下修改項目,再確認下次更新是否會覆寫這些內容。訂閱網址可能包含存取憑證,應只貼到用戶端要求的位置;向他人描述問題時,不要直接傳送完整網址或包含網址的畫面。
已有單一伺服器:依協定填寫
如果取得的是伺服器位址、連接埠和驗證資訊,一樣從 Add Server 開始,在 Type 選擇資料指定的協定,再逐項填寫。Shadowsocks、VMess、VLESS、Trojan 等協定的欄位並不相同;密碼、使用者識別碼、加密方式與傳輸參數都應依照原始資料填寫。Address 應填伺服器網域或 IP,而不是訂閱頁面,也不是在瀏覽器中開啟的說明頁面。
若涉及 TLS 或特定傳輸方式,也要核對伺服器資料中的相關選項,不能只填位址與連接埠就結束。若資料提供 QR code,可使用 Scan QR Code 讀取,再核對辨識出的 Type 與 Address。無論採用哪種方式,儲存後都要返回 Home,點選一個具體伺服器;若要了解欄位與分享連結的差異,可先查閱術語表,首次連線時不必修改尚未了解的參數。
本節的完成標準是:Home 中有明確的伺服器項目,可以選取,且連線資料來源清楚。到這一步仍未驗證伺服器是否可用,下一步先確認流量應採用哪種處理方式。
02 · Global Routing:選擇設定、代理或直連
在 Home 點選 Global Routing,依目前用途選擇設定(Config)/代理(Proxy)/直連(Direct)。三種模式會改變流量處理方式,不會補齊缺漏的伺服器參數,也不會讓無法連線的伺服器變得可用。首次設定時應記下目前選項,方便驗證時進行有條件的比較。
設定(Config):依目前設定中的規則處理
如果已經有自己確認過的規則設定,通常從設定(Config)開始。在 Config 中查看目前啟用的設定,確認它是準備使用的那一份。匯入伺服器與啟用規則設定是兩個不同的操作:Home 中出現伺服器,並不表示 Config 已經切換到某個規則檔案。規則會決定目標請求採用 PROXY、DIRECT 或 REJECT 等策略,實際結果也取決於規則順序與策略設定。
初次使用不必立刻編輯整份規則。先保留已知設定,完成一次連線與瀏覽測試。之後若需要調整特定網域的處理方式,再備份設定並逐項修改。DOMAIN-SUFFIX、IP-CIDR、GEOIP 等關鍵字的含義請參閱規則術語說明;規則比對異常的系統化檢查方式請參閱疑難排解手冊。
代理(Proxy):對照所選伺服器的連線路徑
若要確認所選伺服器能否正常處理請求,可暫時切換至代理(Proxy),減少一般分流規則對測試結果的影響。保持伺服器、網路和測試頁面不變,只變更 Global Routing。若 Proxy 下可以瀏覽,而 Config 下同一頁面失敗,應優先檢查設定規則與策略指向,而不是立刻重新匯入訂閱。測試結束後,恢復原本需要的模式。
直連(Direct):檢查目前網路的直接連線
直連(Direct)會透過目前網路直接建立連線,不能用來證明所選代理伺服器可用。若要判斷基本網路是否已中斷,更清楚的做法是先關閉 Shadowrocket 連線,再開啟熟悉的頁面;確認 Wi-Fi 或行動網路正常後,返回 Home 繼續操作。確定路由模式後,就可以進行首次連線授權。
03 · Home:開啟開關並完成系統授權
返回 Home,再次確認已選取準備使用的伺服器,同時檢查 Global Routing 與上一節選擇的模式一致。接著開啟頂端的連線開關。首次建立連線時,系統可能會提示允許新增 VPN 設定;這是建立系統網路連線所需的授權。閱讀提示後允許,並依裝置要求完成密碼或生物辨識驗證,再返回 Shadowrocket。
完成授權後,查看 Home 中的連線開關是否維持開啟,以及系統是否顯示相應的連線狀態。系統授權尚未完成時,不要連續反覆點選開關;重複操作可能使連線與中斷請求交錯,也不利於判斷剛才是哪個步驟失敗。若點選後立即回到關閉狀態,先確認是否取消了系統提示,再檢查是否有裝置管理限制。
如果裝置同時啟用了其他會接管網路連線的工具,請先暫停這些工具,再單獨測試 Shadowrocket,以減少連線設定衝突。受管理的工作或學校裝置可能限制 VPN 設定變更,這類限制應依照裝置管理規定處理,不應反覆刪除設定嘗試規避。
首次測試期間,先保持 On Demand 關閉,避免自動連線條件與手動操作同時影響結果。手動連線與瀏覽驗證都正常後,再考慮依網路條件啟用 On Demand。它處理的是何時發起連線,無法修復訂閱內容、伺服器參數或規則錯誤。
開關維持開啟,只代表連線流程已進入相應狀態,不代表每個目標頁面都能瀏覽。不要在這裡結束檢查;接下來需要綜合伺服器測試、瀏覽器存取與路由結果進行判斷。
04 · Connectivity Test:驗證連線與實際瀏覽
先在 Home 使用 Connectivity Test 檢查既有伺服器是否可連線,再選擇其中一個進行瀏覽測試。測試結果可協助判斷某次請求是否得到回應,但延遲數字不等於下載速度,也不保證所有 App 和頁面都能正常使用。不要只憑一個較小的數字,就判定整套設定已完成。
使用相同網路與頁面重複驗證
保持目前的 Wi-Fi 或行動網路不變,開啟瀏覽器,造訪一個熟悉且能判斷載入結果的頁面。先查看頁面主體是否出現,再觀察圖片或其他資源是否載入。若只有部分內容失敗,記下失敗的具體範圍;這與整個頁面都無法開啟的排查方向不同。舊頁面可能直接顯示快取內容,驗證時應重新載入,而不是只查看已開啟的分頁。
接著返回用戶端查看連線記錄,核對請求目標與對應策略。使用設定(Config)時,應注意目標請求是否依預期採用 PROXY 或 DIRECT、是否遭到 REJECT,以及策略是否指向目前可用的伺服器。系統連線標示與瀏覽器中單一頁面的成功,都不能單獨證明所有規則正確。
每次只變更一個條件,比較差異
若伺服器測試有回應,但實際頁面無法瀏覽,可保持伺服器不變,暫時將 Global Routing 從 Config 切換為 Proxy,再重複相同的瀏覽測試。若結果隨模式而改變,優先檢查規則與目前的 Config;若兩種模式都失敗,再核對伺服器參數、網路條件及 DNS。每次只變更一項,才能將變化與結果對應起來。
驗證結束後,恢復預計長期使用的模式,並重新測試一次。建議簡單記錄「網路類型、所選伺服器、Global Routing、失敗頁面、顯示的錯誤」,不要記錄或公開驗證資訊。這類記錄比「開關開了但不能用」更有助於找出問題,也方便之後確認修改是否有效。
05 · 常見問題:從失敗環節開始檢查
發生異常時,先關閉連線,確認裝置本身可以連上網路;再依照匯入、授權、伺服器連線、規則處理的順序檢查。不要一次刪除所有伺服器、替換 Config 並修改 DNS,否則即使暫時恢復,也無法知道是哪個項目造成問題。以下只列出初次使用最常見的檢查方式,詳細分支請參閱Shadowrocket 疑難排解手冊。
儲存 Subscribe 後沒有伺服器
返回訂閱項目,核對 URL 是否完整,是否多複製了說明文字、空格或換行;確認取得的是訂閱網址,而不是帳戶頁面或單一伺服器分享連結。基本網路正常後再更新一次,並查看具體錯誤。若網址已失效、存取憑證已變更或回傳內容異常,請向自己的服務供應商確認,不要憑猜測修改網址中的字元。
開關無法開啟,或開啟後立即關閉
先確認已允許首次系統授權,且已完成裝置驗證。接著檢查是否有其他網路連線工具正在使用、是否受裝置管理政策限制,並記下用戶端顯示的提示。若最近修改過系統網路設定,先恢復至可說明的狀態再測試。刪除系統連線設定會觸發重新授權,應在確認原因後再進行,不要把它當成每次發生問題時的第一步。
Connectivity Test 逾時
先重試目前的伺服器,再從自己的既有清單中選擇另一個伺服器進行比較。若只有一個伺服器持續失敗,優先核對其位址、連接埠、驗證資訊及協定參數;若多個伺服器都失敗,再比較 Wi-Fi 與行動網路,並檢查基本網路。切換網路時,其他條件保持不變。不要以關閉 TLS 驗證取代參數核對,也不要直接將逾時解讀為 App 安裝失敗。
Proxy 可用,Config 下部分頁面失敗
返回 Config 確認目前啟用的檔案,檢查失敗目標所比對的規則與策略。修改規則前先備份,修改後儲存並重新載入同一頁面。若某個策略需要選擇伺服器,請確認它沒有指向已失效的項目。規則會依照設定邏輯處理目標,只有檢查實際比對結果,才能分辨是路由選擇錯誤,還是伺服器本身無法使用。
連線正常,但發生網域解析錯誤
先確認裝置日期與時間正確,再查看問題是否集中在網域解析階段。記下目前的 DNS 設定後,每次只調整一項,不要同時更換解析方式與規則檔案。直接輸入 IP 開啟網站未必是有效的對照,因為 HTTPS 也涉及網域與憑證是否相符。若錯誤持續,請帶著具體錯誤提示參閱疑難排解手冊中的 DNS 相關章節,不要不斷改填來源不明的位址。
在 iPad 上找不到相同位置
iPad 在不同方向與視窗寬度下可能採用分欄版面,Home、Config 等入口的位置可能不同,但操作項目仍以介面文字為準。先找到相同名稱的頁面,再執行對應步驟。瀏覽器記錄、系統授權及裝置網路設定都應在目前的 iPad 上重新驗證,不能直接以另一部裝置的成功結果認定本機已設定完成。