官方手冊 · 首次設定
Shadowrocket 使用教學
從既有連線資料開始,依新增、模式選擇、連線、驗證與故障排除五個步驟完成首次設定。iPhone 與 iPad 的操作順序相同,實際畫面請以 App 目前顯示為準。
首次操作時,建議先確保目前的 Wi-Fi 或 Cellular 網路穩定,並備妥服務供應商提供的完整資料,再依序操作。訂閱連結通常含有帳戶憑證,請勿貼到公開留言、截圖或群組聊天中。修改既有設定前,請先保留可還原的副本;本頁旨在確認完整的連線路徑,不必一次調整所有進階設定。
01 · Add Server:新增伺服器或匯入訂閱
開啟 Shadowrocket 後,先停留在 Home。下方的 SERVER 分組用來查看伺服器項目,點選 Add Server 進入新增頁面。接著依手上的資料選擇方式:用來取得伺服器清單的訂閱連結,請選 Subscribe;若有明確的協定、位址、連接埠與驗證資料,則依實際協定手動填寫。兩種資料用途不同,請勿將訂閱網址當成伺服器的 Host。
已有訂閱連結:選擇 Subscribe
進入 Add Server 後,點選 Type 並在類型清單中選擇 Subscribe,再將完整訂閱連結填入對應的 URL 欄位。貼上後請檢查開頭、結尾及查詢參數是否完整,避免一併貼入說明文字、空格或換行。備註可填寫方便自己辨識的名稱,接著儲存並返回 Home。用戶端會嘗試讀取訂閱內容;成功後,應能在對應分組看到匯入的伺服器,而不只是備註名稱。
儲存後若沒有出現伺服器,請先查看是否有更新失敗的提示,再嘗試更新該訂閱。訂閱內容日後有變更時,也需要透過更新重新取得;只重新開啟連線開關並不會更新訂閱。請勿連續重複新增相同網址,以免產生多組重複項目,之後也難以判斷目前使用的是哪一組資料。
已有伺服器資料:依 Type 逐項填寫
手動新增時,先選擇服務供應商註明的 Type,再填寫 Host、Port,以及該協定所需的驗證與傳輸欄位。截圖中的 Password、Method 並非所有協定通用:若資料使用 Trojan,請依 Trojan 欄位填寫;若使用 Shadowsocks,才核對相應的 Method 與密碼。欄位名稱相似不代表內容可以互換;不確定的參數請向自己的服務供應商確認,不要只憑名稱猜測。
Host 通常填寫資料中的網域或位址,請勿自行加上網頁路徑;Port 則填寫伺服器實際使用的連接埠。若涉及 TLS、伺服器名稱或其他傳輸選項,請依伺服器資料設定,不要為了通過測試而任意降低驗證要求。若已有 QR Code,可使用 Scan QR Code 辨識後逐項確認;Import from Cloud JSON 僅適用於已備妥且格式相符的資料,不能取代一般訂閱匯入。
儲存後返回 SERVER 分組,點選準備使用的伺服器,將其設為目前選取項目。此時先別急著連線:新增項目只代表資料已輸入,接下來還要選擇 Global Routing,決定連線要求採用哪種路徑。
02 · Global Routing:選擇連線模式
返回 Home,點選 Global Routing 查看可選模式。本教學先介紹三種基本模式:設定檔(Config)、代理(Proxy)、直連(Direct)。它們決定要求如何選擇路徑,不會替你補齊伺服器資料,也不會自動修復失效的訂閱。變更模式後,請返回 Home 確認目前的選擇,再進行連線測試。
設定檔(Config):依設定檔規則比對
日常需要依規則分流時,請選擇 Config,但前提是已有合適的設定檔並將其設為目前使用的設定檔。點選底部的 Config 進入設定檔頁面,確認目前使用的檔案;如需檢查內容,請進入對應檔案的編輯頁面,查看 General、Rule、Hosts 等區段。截圖展示的是設定檔編輯介面,而非 Home 中的模式選擇清單,兩者用途不同。
Rule 中的項目會依序比對;前面的規則符合後,後續的兜底規則通常不會再決定該要求的路徑。以下片段僅供理解比對順序:apple.com 及其子網域選擇 DIRECT,其他未符合規則的要求則使用 PROXY。這不是完整設定檔,也不代表適用於所有人的連線需求;修改前請先儲存副本,並確認自己的設定檔確實使用這些策略。
[Rule]
DOMAIN-SUFFIX,apple.com,DIRECT
FINAL,PROXY
編輯頁面中的 Add Rule 用來新增規則。初次操作不建議一次加入大量項目,也不必為了連線而修改 HTTPS Decryption。請先確認目標網域是否符合前面的 DOMAIN、DOMAIN-SUFFIX 或其他規則,再查看最終策略。設定語法、策略群組與比對優先順序的詳細說明,請參閱規則與設定參考大全。
代理(Proxy)與直連(Direct):指定路徑或進行對照測試
Proxy 會將由用戶端處理的要求導向代理路徑,適合在排查時暫時排除規則因素;但目前使用的伺服器仍須正常運作。Direct 則是直接連線至目標,不適合用來判斷代理伺服器是否可用。切換到 Direct 後若能開啟某個網站,只能說明該目標可透過直連存取,不能據此認定代理設定正確。
首次建立基準時,可暫時選擇 Proxy 測試既有伺服器;確認可用後,再切回 Config 檢查分流。若已有明確可用的設定檔,也可直接使用 Config。每次對照測試後請恢復原模式,以免後續將測試狀態誤認為日常設定。遇到不熟悉的欄位或策略名稱,可先查閱名詞解釋,不必在這個步驟展開所有進階選項。
03 · Home:開啟連線並確認狀態
選好伺服器並設定 Global Routing 後,返回 Home。開啟開關前再檢查一次:SERVER 中選取的是剛才準備測試的伺服器;Global Routing 是預計使用的 Config 或 Proxy;若使用 Config,也已確認目前的設定檔。這樣可避免訂閱剛更新卻仍在測試舊項目,或誤將 Direct 狀態下的存取結果當成代理結果。
點選 Home 頂端的連線開關。首次建立連線時,系統可能會要求允許新增 VPN 設定,這是用戶端接管相關網路要求所需的系統授權。閱讀提示內容,確認這是目前操作所觸發後再繼續,並依系統要求完成裝置驗證。若選擇取消,返回 App 後連線可能仍未建立;此時應重新啟動連線並完成授權,而非反覆修改伺服器密碼。
完成授權後返回 Shadowrocket,確認頂端是否仍顯示 Not Connected,以及開關是否維持開啟。系統 VPN 狀態與 App 連線狀態有助於確認網路設定已啟用,但開關開啟不代表一定能存取目標網站。伺服器驗證、目標位址、DNS 與目前規則仍可能影響實際結果,下一步需要另外驗證。
若開啟開關後立即自動關閉,請先確認系統授權是否完成,記下 App 顯示的提示,再檢查是否有其他正在啟用的 VPN 設定影響目前連線。先處理授權與連線狀態問題,不要同時修改 Global Routing、伺服器協定與 DNS,否則難以判斷是哪個項目影響結果。尚未確認連線狀態前,也不要連續快速切換開關,以免混淆狀態變化與實際存取結果。
iPad 上可能顯示較寬的清單或分欄版面,但仍請依序確認 Home、伺服器選擇、Global Routing 與連線開關。裝置上顯示的 VPN 狀態標示可能因系統介面而異,請以 App 狀態及後續實際要求的驗證結果為準。暫時停止使用時,可返回 Home 關閉連線;若之後發生自動重新連線,再依第五步檢查 On Demand 條件。
04 · Connectivity Test:確認測試結果與實際連線
保持連線後,先在 Home 點選 Connectivity Test,依目前介面提供的方式執行測試。測試結果主要反映所選測試方法下的連線狀況,不代表所有目標或所有協定流量都會得到相同結果。單一測試失敗,不足以判定整條連線無法使用;請一併參考實際存取、App 記錄與目前網路狀況。
接著開啟瀏覽器,前往自己確實需要驗證的目標頁面,重新載入一次。請勿只查看已快取的舊頁面,也不要只憑頁面上的地區文字判斷連線路徑。若需確認出口位址,請使用自己信任且能顯示目前要求出口位址的服務,並留意:Config 可能讓不同目標採用不同策略,因此單次查詢結果不能代表裝置上的每一項要求。
返回 Shadowrocket,查看 Data 中目前可用的連線或要求記錄,尋找剛才存取的目標。若記錄中有比對規則、策略或伺服器資訊,請逐項確認是否符合預期。目標要求符合 DIRECT,通常表示依規則直接連線;符合 PROXY 後仍失敗,則還需檢查目前伺服器與目標本身。記錄內容可能因介面而異,請依實際顯示資訊判斷,不要將「沒有注意到記錄」直接等同於「完全沒有要求」。
若使用 Config 時失敗且原因不明,可暫時切換到 Proxy,對同一個目標重新送出要求。若 Proxy 可存取但 Config 不行,請優先檢查規則比對、策略引用與設定中的 DNS;若兩者都失敗,再檢查伺服器、協定參數與目前網路。比較時請維持目標、伺服器及本地網路不變,每次只調整模式,測試結果才有參考價值。
若只有某個 App 出現異常,請先完全結束該 App 目前的要求,再重新開啟進行對照。若只在 Wi-Fi 下失敗,切換至 Cellular 後恢復,應繼續排查本地網路,而非立即重建所有設定。切換網路可能產生流量費用,也可能觸發既有的 On Demand 條件,測試前請先確認相關設定。
05 · Settings:依故障階段逐項排查
遇到問題時,先確認卡在哪個步驟:訂閱尚未匯入、連線開關無法保持開啟、伺服器測試失敗,還是只有部分目標無法存取。不同階段對應不同的檢查項目。開啟 Settings 可查看 Test Method、On Demand 與 Diagnostics 等項目,但不必逐一修改所有選項;先記錄狀況,再做最小幅度的調整。
訂閱未建立項目或更新失敗
先返回訂閱設定,核對完整 URL,確認是否複製了管理頁面網址、漏掉查詢參數或多帶了字元。接著確認目前網路可以連線至該網址,並確認自己的訂閱仍有效。即使能在瀏覽器中看到訂閱網址的內容,也不代表回傳格式適用於目前的匯入方式;若出現登入頁面、錯誤說明或空白內容,請向自己的服務供應商確認網址與格式。保留仍可用的舊資料,確認新內容有效前,請勿清除所有伺服器。
伺服器已出現,但連線或測試失敗
手動新增的項目請優先核對 Type、Host、Port 與驗證欄位,特別留意密碼前後是否有空格、Method 是否相符,以及傳輸與 TLS 參數是否一致。訂閱項目請先更新,再選擇既有資料中另一個已知可用的伺服器進行比對。若所有項目都只在同一個網路下失敗,請檢查本地網路限制或暫時性異常;若只有一個項目失敗,應優先確認該伺服器的狀態與參數。
Settings 中的 Test Method 會影響連線測試採用的方式。部分服務不會回應某種探測方式,因此測試逾時時需要搭配實際存取結果判斷。請勿將測試結果直接視為完整的速度評估,也不要為了消除測試提示而同時修改 TCP、UDP 等選項;協定或傳輸細節應依既有伺服器的實際設定調整。
連線成功,但部分要求的路徑不如預期
先檢查 Global Routing 是否仍處於測試用的 Proxy 或 Direct,再確認 Config 中選取的檔案。接著依第四步尋找目標要求的記錄,查看是否符合前置規則。若涉及網域解析,請先確認問題能否在相同網路與相同目標下重現,再檢查 General 中的相關設定。修改規則後需要重新送出要求,既有連線可能不會立即套用新策略。
若手動關閉連線後又自動開啟,請查看 On Demand 中既有的觸發條件,確認是否因 Wi-Fi、Cellular 或其他條件而重新連線。排查時可暫時停用相應條件,完成比對後再恢復原設定。若需進一步定位,請進入 Diagnostics,依問題狀況收集必要的診斷資訊;分享前請先確認內容是否包含訂閱憑證、伺服器驗證資訊或個人存取記錄。
最後請簡要記錄目前網路、使用的伺服器、Global Routing、發生故障的目標、已做過的單項修改及結果。日後再次排查時,便能從明確狀態接續處理,不必重複嘗試。其他常見狀況請參閱問答與故障說明;需要逐條了解規則時,再閱讀設定大全。完成本頁操作後,應能區分「資料未匯入」、「連線未建立」與「要求未依預期路徑傳送」這三類問題。