官方手冊 · 入門操作

Shadowrocket 使用教學

以 iPhone / iPad 介面為例,依序完成匯入、選擇分流、連線與驗證。首次使用請先完成手動連線流程,再調整自動化設定。

以下步驟將「資料是否匯入成功」、「伺服器是否能連線」和「請求是否依規則處理」分開檢查。不要一開始就同時修改 DNS、規則與 On Demand,否則即使恢復正常,也很難判斷是哪個設定發揮作用。介面中的協定類型與參數,請以自己的實際資料為準;不同類型會出現不同欄位,不必為了符合範例而勉強填寫。

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

開啟 Shadowrocket,進入 Home。先確認手上的資料是「訂閱連結」還是「單一伺服器參數」:前者通常用來取得並更新一組伺服器,後者則是一組明確的位址、連接埠、協定與驗證資料。兩者的輸入方式不同;不要將訂閱連結當成伺服器位址填寫,也不要把單一伺服器分享內容直接當成訂閱更新網址。

已有訂閱連結:選擇 Subscribe

在 Home 點選右上角的新增按鈕進入 Add Server,開啟 Type 並選擇 Subscribe。在 URL 中貼上自己的完整訂閱連結,必要時填寫方便辨識的備註,然後儲存。貼上前後請檢查連結是否遭通訊軟體截斷、前後是否多出空格,以及查詢參數是否完整。訂閱連結可能包含存取憑證,不應貼到公開留言區,也不要放進可公開存取的筆記。

儲存後返回 Home,等待訂閱內容讀取完成,查看訂閱群組下是否出現伺服器項目。如果只看到群組名稱而沒有項目,先確認是否仍在載入,再更新該訂閱。更新失敗時請保留錯誤提示,並確認裝置目前的網路可連至訂閱網址;反覆刪除並重新加入相同連結,通常無法解決連結失效或回傳內容無法解析的問題。

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

如果取得的是手動參數,請在 Add Server 中選擇與資料相符的 Type,再逐項填寫 Address、Port 以及該協定要求的驗證欄位。Shadowsocks、VMess、VLESS、Trojan 等協定所需參數各不相同,不能只憑連接埠或名稱猜測。若涉及 TLS、伺服器名稱或傳輸參數,也應與原始資料一致;Address 與 TLS 使用的名稱不一定相同。

儲存後返回 Home,點選準備使用的伺服器,確認選取標記位於目標項目上。匯入成功只代表用戶端已讀取資料,不代表遠端服務一定可用。此時先不要調整複雜參數,繼續下一步選擇 Global Routing。若不清楚某個協定欄位的意思,可參閱協定參考,不要透過更換協定類型來嘗試排錯。

02 · Global Routing:選擇處理模式

在 Home 開啟 Global Routing。這裡決定連線採用哪種處理方式,不會替換伺服器位址和密碼。三種模式為 Config、Proxy、Direct。先了解各自用途,再選擇符合目前測試目標的項目,避免將「已開啟連線開關」等同於「所有請求都經過 Proxy」。

Config:依目前設定中的規則處理

日常使用既有分流設定時,請選擇 Config。接著進入 Config,確認目前使用的是預期檔案,而不只是將檔案加入清單。設定中的具體規則通常由上而下比對,命中後採用對應策略;如果規則將目標交給 DIRECT,該目標直接連線就是預期結果。規則使用 PROXY 時,也要確認對應策略選取的伺服器正確。

以下僅為規則順序範例,不代表需要立即取代目前的設定。第一條將範例網域交給 PROXY,第二條將指定私有位址範圍交給 DIRECT,FINAL 則處理前面未命中的請求。範例不代表所有服務都適合這樣安排,初次使用時應先了解目前使用的檔案。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

Proxy 與 Direct:用於特定用途或比對

Proxy 會將納入用戶端處理範圍的請求交由代理路徑處理,可用於暫時判斷問題是否與分流規則有關,但無法修正錯誤的伺服器參數,也不代表裝置的所有系統流量必然採用相同路徑。Direct 則使用直接連線方式,適合檢查目標在基本網路下的狀況;它不會自動中斷系統中的 VPN 設定。

初次設定可先選擇 Config。如果之後發現只有特定目標異常,再暫時切換模式進行比對,測試完成後恢復原本的選擇。記錄切換前的狀態很重要,否則排查後可能留下不符合日常需求的設定。如果仍不清楚目前檔案或規則順序,請先參閱常見問題中的分流說明,不必在入門階段重寫整份設定。

03 · Home:開啟連線並完成授權

返回 Home,再次檢查已選取的伺服器與 Global Routing。準備就緒後,開啟頁面上的連線開關。首次啟用時,系統會顯示新增 VPN 設定的授權提示;閱讀提示並允許後,依系統要求完成裝置驗證。這裡授權的是系統網路設定,不是輸入伺服器密碼;伺服器驗證資料應在先前的 Add Server 中填寫。

完成系統提示後返回 Shadowrocket,確認開關是否維持開啟,以及是否出現連線錯誤。如果開關立刻關閉,先記下提示文字,不要快速連續點擊。可以到系統 Settings 查看 VPN 設定是否已建立;裝置受組織管理、系統限制或已有其他 VPN 連線占用時,狀況可能不同,請先確認目前裝置允許新增並啟用該設定。

首次驗證建議暫時關閉 On Demand,先完成一次可重複的手動連線。On Demand 會依條件觸發連線,在手動測試期間可能讓連線重新開啟,造成「關閉後又自動連線」的誤解。手動流程確認正常後,再另外設定按需條件;不要透過新增自動觸發條件來處理伺服器本身無法連線的問題。

連線維持開啟後,不必繼續反覆切換開關。系統顯示 VPN 狀態,只能表示相關網路設定處於連線狀態,無法單獨證明訂閱中的每台伺服器或每個目標網站都可用。接下來需要同時檢查伺服器連線能力與實際存取結果,才能確認設定完成。

04 · Connectivity Test:確認是否生效

在 Home 使用 Connectivity Test 檢查伺服器連線。測試前請確認目前選取的測試方式,並在相同網路下對相同伺服器重複觀察。不同測試方式的檢查範圍不同;能取得測試結果不代表目標服務的完整業務請求一定成功。反過來說,某種探測逾時也不能直接證明所有存取都失敗。

接著開啟瀏覽器,存取自己有權使用,且知道在正常情況下能開啟的目標服務。不要只查看已載入的舊頁面,請重新整理並等待新請求完成。先測試一般頁面,再嘗試實際需要使用的功能,例如登入後的頁面或檔案請求。若頁面主體正常顯示,但圖片、登入或其他功能失敗,可能是因為它們存取不同網域,需分別判斷。

如果使用 Config,請搭配目前設定檢查目標應命中的規則與策略。一個目標走 DIRECT、另一個走 PROXY,可能是正常的分流結果。必要時查看 App 中的連線記錄,搜尋目標網域對應的請求,核對命中的規則與處理策略;不要只因出口位址沒有改變,就判定所有規則都未生效。

需要比對時,每次只變更一項:維持相同目標和相同伺服器,暫時切換到 Proxy 再試一次,之後恢復 Config。如果前者正常、後者異常,請優先檢查目前設定及策略選取。如果兩種模式都異常,再繼續檢查伺服器與基本網路。也請記錄 Direct 的比對結果,以利區分目標本身無法使用與代理路徑異常。

Data 中的流量讀數有助於確認是否有資料活動,但統計範圍、App 快取和背景請求都會影響讀數,不宜將某個瞬間數值視為唯一結論。成功驗證一次後,記下可用的伺服器、模式和網路環境即可,不必為了取得更小的測試數值而連續更改設定。

05 · 常見問題:從基本網路逐層排查

發生異常時,先判斷問題出在哪一層:訂閱無法讀取、伺服器測試不通、開關無法維持,還是只有某個目標無法存取。先分類錯誤再進行操作,比同時更新訂閱、切換 DNS 和修改規則更容易得到有效結論。以下依影響範圍由大到小檢查。

先確認裝置本身可以連上網路

暫時關閉連線開關;如果啟用了 On Demand,也先將它停用,再檢查 Wi-Fi 或行動網路是否正常。公共 Wi-Fi 可能需要先完成網路登入;基本網路未連通時,讀取訂閱和測試伺服器都可能失敗。可以改用另一種可用網路重複相同測試,但不要同時切換網路並修改伺服器參數,否則無法比較結果。

分辨訂閱更新失敗與伺服器連線失敗

訂閱更新失敗時,請檢查連結是否完整、是否仍在有效期間及回傳內容,必要時向自己的服務供應商確認原始資料。訂閱可以更新但伺服器無法連線時,請核對選取的具體項目,檢查 Address、Port、驗證資料、TLS 與傳輸欄位。更新後伺服器清單可能改變,請再次確認目前選取的項目,不要只因群組名稱相同,就認為選擇沒有變動。

單一伺服器持續逾時、其他已有伺服器則正常時,問題範圍通常已縮小,不宜重設整個用戶端。如果所有項目都失敗,再回頭檢查目前網路、裝置時間和系統權限。測試結果只能協助定位,不能取代對實際參數和遠端服務狀態的確認。

分別處理開關異常與部分目標無法存取

開啟開關後立刻關閉時,先確認是否完成系統授權、VPN 設定是否允許啟用,以及目前是否與其他網路設定衝突。開關維持開啟但只有部分目標異常時,請優先核對 Global Routing、Config 目前使用的檔案、規則順序和相關策略。不要將「刪除所有設定」當成第一步;修改前請保留原始檔案,以便還原。

如果錯誤提示與網域解析或憑證有關,也請檢查 DNS 設定與系統時間。裝置日期明顯錯誤可能影響 TLS 驗證;出現憑證錯誤時,不應直接關閉驗證來掩蓋問題。請先將時間調整正確,確認伺服器名稱等欄位後再測試。更深入的參數說明請參閱協定參考;常見連線狀況可繼續查看連線排查問答。

已有伺服器能正常存取目標、Config 下的分流符合預期,且中斷連線後能恢復基本網路,就完成入門流程。之後再依實際需要設定 On Demand 或整理多個設定;這些操作應以手動連線已確認正常為前提,不必在首次使用時一次完成。