官方手冊 · 初始設定

Shadowrocket 使用指南

從既有訂閱開始,依序完成新增、分流、連線與驗證。首次設定先確認一條連線正常,再調整規則與自動連線條件。

已有伺服器項目可從第 02 步開始;開關已開啟但存取異常,可直接查看第 04、05 步。

STEP 01 / IMPORT

新增伺服器與匯入訂閱

開啟 Shadowrocket 後,先停留在 Home。下方的 SERVER 群組用來列出伺服器;剛開始沒有項目時,先點選 Add Server。進入新增頁面後,第一個項目 Type 會決定接下來要填寫的欄位。訂閱連結與單台伺服器參數是兩種不同的輸入內容,不要將訂閱網址直接填入 Host,也不要將某台伺服器的位址當成訂閱連結提交。

已有訂閱連結:選擇 Subscribe

如果取得的是訂閱網址,請進入 Type 選擇 Subscribe,再將完整連結填入 URL。連結應向你的服務商取得,複製時保留問號後的所有內容;開頭或結尾多出的空格、換行也應清除。填入方便辨識的名稱後儲存,等待用戶端取得訂閱內容,再返回 Home 檢查是否出現相應群組與伺服器項目。

訂閱是一份可更新的伺服器清單,不等同於 Config 中的規則檔案。清單出現項目只代表這次匯入取得了項目,無法證明每個項目都能連線。如果儲存後群組仍是空的,先確認連結是否完整、是否仍有效,以及目前網路能否取得內容;不要以連續新增多個重複群組來代替排查。訂閱連結通常包含存取憑證,向他人說明問題時不要直接展示完整連結。

已有伺服器參數:依 Type 逐項填寫

手動新增時,先將 Type 設為服務商提供的協定,再填寫 Host 和 Port。截圖展示的是包含 Password、Method 的新增表單;切換協定後,實際欄位會有所不同。Shadowsocks 需要核對 Method 與 Password;VMess、VLESS 需要核對 UUID 以及傳輸相關參數;啟用 TLS 時也應核對相應的伺服器名稱等設定。不要只憑連接埠猜測協定,也不要自行填入未提供的常見參數值。

如果取得的是 QR Code,可以使用 Scan QR Code;Import from Cloud JSON 則用於相應格式的設定輸入,並非適用於任意訂閱網址的通用匯入按鈕。儲存後返回 Home,確認名稱、協定和群組符合預期。此時先不要急著開啟開關,下一步先確認 Global Routing,讓後續驗證有明確的判斷標準。

Shadowrocket Add Server 官方截圖,包含 Type、Host、Port、Password、Method 及底部匯入入口
Add Server:先選擇 Type,再依既有資訊填寫欄位。不同協定的欄位會有所不同。

STEP 02 / ROUTING

選擇 Global Routing

返回 Home,點選 Global Routing 查看目前模式。這裡控制連線如何選擇策略,不會補齊伺服器參數。三種模式分別是設定(Config)/代理(Proxy)/直連(Direct)。先確認目前的選擇,再進行連線測試,可避免將規則導致的直連誤認為伺服器沒有運作。

設定(Config):依規則決定連線方向

日常需要依規則分流時,請選擇 Config。接著開啟底部的 Config,確認已選取要使用的設定檔,而不是只確認它出現在清單中。進入檔案後可以看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。首次連線只需確認現有 Rule 與策略是否相符,不必為了完成基本連線而同時調整每個區段,也不需要啟用 HTTPS Decryption。

Rule 中的規則通常依由上而下的順序比對,第一條命中的規則會決定本次連線的策略。DOMAIN-SUFFIX 可依網域後綴比對,IP-CIDR 可比對位址範圍,FINAL 用於前面的規則都未命中的情況。PROXY 與 DIRECT 分別代表代理和直連方向。使用 Add Rule 前先查看既有規則的位置與策略名稱,避免將範圍過廣的規則放在前面,遮蔽後續的特定規則。

代理(Proxy)與直連(Direct):用來區分連線路徑

Proxy 會將由用戶端處理的連線交由所選代理路徑處理,適合在排查時減少規則差異造成的干擾;它不會自動修復失效的伺服器。Direct 使用直連路徑,不應用來證明代理伺服器可用。如果目前網路原本就能存取某個網站,即使選擇 Direct,該網站也可能正常開啟。

本次先使用既有設定選擇 Config,並記住目前模式。之後若要暫時切換 Proxy 進行對照,請在測試完成後還原原設定。最後仍需根據實際連線記錄判斷規則是否有效,不能只因 Config 檔案存在就認定分流正確。接著返回 Home,選擇預設伺服器並建立連線。

Shadowrocket Config 官方截圖,展示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:檢查已選取檔案中的 Rule;設定檔編輯頁與 Home 的 Global Routing 選擇位於不同操作位置。

STEP 03 / CONNECT

選擇預設伺服器並開啟連線

返回 Home,在 SERVER 群組中選取準備使用的伺服器。已選取的項目會顯示圓點標記,請用它確認預設伺服器,不要只看清單中哪個項目排在最上方。點入項目詳細資料與選取項目並非同一件事;檢查參數後返回清單,再確認圓點仍標示本次要測試的伺服器。

確認預設伺服器後,開啟 Home 頂端的開關。首次啟用時,系統會詢問是否允許新增 VPN 設定。確認請求來自 Shadowrocket 後允許,並依系統要求完成裝置驗證。這項授權可讓用戶端接管相應的網路流量,不會替你建立伺服器,也不會讓已到期的訂閱恢復服務。

完成授權後返回 Shadowrocket,查看頂端是否仍顯示 Not Connected。如果開關立即關閉,先處理系統授權或設定建立失敗的問題,不要立刻修改 DNS。如果連線狀態已建立,再繼續下一步測試。系統中的 VPN 標示僅代表相關連線已啟用,不能單獨證明遠端伺服器、DNS 與目標網站都正常。

首次驗證期間建議先不要設定複雜的 On Demand 條件,也不要同時啟用多個接管網路的 VPN 設定。先確認手動連線結果穩定,再逐項加入自動化條件。如果需要切換至另一台伺服器,先記下目前項目和測試結果,切換後重複相同測試,避免在目標網站、網路與伺服器都改變的情況下比較結果。

如果在系統授權時選擇取消,可返回 Home 再次操作開關,並留意系統提示。若裝置受到管理政策限制,應檢查裝置本身允許的 VPN 設定。建立基本連線後保持目前網路不變,接著使用 Connectivity Test 和實際瀏覽共同確認結果。

Shadowrocket Home 官方截圖,展示 Not Connected 開關、Global Routing、Connectivity Test、SERVER 群組與 Add Server
Home:先確認伺服器的圓點標記,再開啟頂端開關,最後執行 Connectivity Test。

STEP 04 / VERIFY

透過實際請求驗證是否生效

在 Home 點選 Connectivity Test,觀察用戶端是否回傳測試結果。測試方式會影響結果的意義,因此不同 Test Method 的數值不能直接比較。測試成功表示在相應的探測條件下收到回應,不代表所有網站都能存取;顯示的耗時也不是下載速度,不能將它視為頻寬數值。

接著開啟瀏覽器,造訪已知可正常使用、且能明確判斷載入結果的目標。不要同時開啟許多頁面,也不要只確認已快取的頁面是否仍能顯示。可以重新整理一次目標,確認有新請求發生,再返回 Shadowrocket 檢查狀態。如果測試成功但單一網站失敗,需繼續區分網域解析、規則方向與網站本身的回應,不要直接刪除所有設定。

使用 Config 時,也應在 Data 中查看剛才的連線記錄。依存取時間找到相應目標,核對網域或位址、命中規則及最終策略;具體資訊以目前介面顯示為準。如果結果為 DIRECT,先確認是否原本就有規則要求直連。如果預期使用 PROXY,卻命中前面的範圍過廣規則,調整規則順序才是相應的處理方式。

若要驗證分流,可分別造訪一個預期直連的目標和一個預期代理的目標,再分別檢查記錄。只看網頁是否開啟,無法區分兩條路徑,因為同一目標可能在不同路徑下都能存取。記錄中出現請求也不代表請求最終成功,還需搭配實際頁面顯示與錯誤訊息判斷。

完成一輪後,記下四項資訊:本機使用 Wi-Fi 還是行動網路、目前預設伺服器、Global Routing 模式、實際失敗的目標。之後每次只變更其中一個條件。若要進一步了解首次測試的觀察順序,可閱讀首次連線與 Connectivity Test 說明;如果本輪一切正常,基本入門流程便已完成。

STEP 05 / DIAGNOSE

分層檢查常見問題

遇到問題時先保留目前設定,記錄錯誤發生在哪個步驟。匯入失敗、開關無法保持開啟、測試逾時與個別網站異常是不同問題,處理方式也不同。依照下列順序檢查,每完成一項就對相同目標重複測試,通常比同時修改伺服器、DNS 和規則更容易找出原因。

先檢查本機網路與輸入內容

先中斷 Shadowrocket 連線,確認目前網路本身能正常存取;公共 Wi-Fi 若需要登入,應先完成登入。如果只有某個網路失敗,可以改用自己的另一種網路進行對照。更換網路後恢復正常,代表還需檢查原網路條件,不宜立刻重寫整份 Config。

如果訂閱無法更新,核對完整連結、有效期限與目前網路的連線狀況。訂閱更新失敗不一定會刪除先前已有的項目,也不代表這些項目全部失效。如果匯入後某台伺服器無法使用,返回它的參數頁,依序比對 Type、Host、Port、驗證資訊與 TLS、傳輸層設定。向服務商確認時請說明具體錯誤,不要公開連結或驗證資訊。

再區分伺服器問題與規則問題

如果所有目標都失敗,先確認是否選對預設伺服器,並改用自己已有的另一台伺服器進行對照。如果使用 Proxy 時可以存取,恢復 Config 後卻失敗,再檢查 Rule 的比對順序、指定策略與 DNS 相關設定。如果只有個別網域異常,優先檢查該網域的記錄,不要因為一個目標失敗就推斷整個連線中斷。

進入 Settings 後,可以核對 Test Method,讓前後測試採用相同方式;需要補充錯誤資訊時可使用 Diagnostics。診斷記錄可能包含網域、位址和設定細節,分享前應移除個人資訊。On Demand 會依條件影響連線行為;如果手動中斷後又重新連線,或切換網路後狀態改變,也要檢查是否啟用了相關條件。

最後回到最簡可驗證設定

修改 DNS 前先記錄原值,每次只改一項設定,並重新發出請求。測試結束後還原用於對照的暫時修改,避免留下用途不明的設定。完整記錄應能說明「使用哪個網路、哪台伺服器、哪種模式、哪個目標、出現什麼現象」。如此才能區分本機網路、伺服器端參數和規則比對問題。

商店地區、恢復購買等取得問題可查看App Store 取得完整指南;能連線但速度緩慢時,可繼續閱讀速度緩慢的分層檢查。需要重新確認完整操作順序時,請從本指南第 01 步重新操作,而不是反覆匯入相同訂閱。

Shadowrocket Settings 官方截圖,展示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:排查時留意 Test Method、On Demand 與 Diagnostics,每次只調整一項。

其他裝置的取得管道

本頁操作位置以 iPhone / iPad 為例。iPhone / iPad 版在 App Store 售價 $2.99,一次性付費;Mac(Apple 晶片與 Intel)/ Windows / Android / Linux 版免費。電腦與 Android 安裝套件可透過本站下載頁取得,安裝套件由本站 /dl/ 提供。

首次開啟遇到系統封鎖時,先確認下載來源,再依安裝允許說明操作:macOS 查看「隱私權與安全性」,Windows 查看 SmartScreen 的「更多資訊」,Android 確認「允許安裝未知應用程式」,Linux 依套件格式處理安裝權限。不要忽略提示後反覆下載。

用戶端一次性買斷 ≠ 線路方案。訂閱連結與伺服器資訊請向你的服務商取得。