官方手冊 / 首次連線
Shadowrocket 使用教學
依序完成匯入、路由、連線與測試,設定好 Shadowrocket。本文以 iPhone 和 iPad 為操作對象,先建立可驗證的連線,再設定規則與日常使用。
建議先保留 App 預設設定,暫不加入 On Demand 或複雜規則。若畫面上的選單排列與本文不同,請依目前 App 顯示的英文設定名稱辨識,不要只憑按鈕位置操作。
步驟 01 / 準備 SERVER 清單
新增伺服器或匯入 Subscribe
開啟 Shadowrocket 後進入 Home。初次使用時,SERVER 區域可能尚無伺服器;這表示尚未新增連線資料,不代表安裝失敗。先確認手上的資料是哪一種:可取得一組伺服器資料的訂閱連結,或包含協定、位址、連接埠與驗證資料的單一伺服器參數。選擇其中一種方式即可,不必重複新增同一份資料。
已有訂閱連結:使用 Subscribe
在 Home 點選右上角的加號,進入 Add Server,開啟 Type 並選擇 Subscribe。在 URL 欄位貼上向服務商取得的完整訂閱連結;若畫面提供 Remark 欄位,可輸入方便辨識的名稱。儲存前檢查連結的開頭、結尾與查詢參數,特別留意複製時是否混入空格、換行或聊天文字。請勿將登入管理頁面的網址當成訂閱連結。
確認後點選 Done 儲存,等待取得訂閱內容,再返回 Home 查看結果。匯入成功後應出現訂閱群組及其伺服器項目,而不只是新增一個名稱。若群組已建立但沒有伺服器,請先確認網路能否連線至訂閱網址、連結是否仍有效,以及回傳內容是否為 App 支援的訂閱格式。重複點選上方的連線開關無法補上訂閱內容,應先排除匯入問題。
訂閱連結可能包含存取憑證,請當作帳戶資料妥善保管。不要公開完整連結,也不要貼到不明網站進行轉換。之後需要更新時,直接更新現有訂閱即可;重複新增相同連結可能產生重複群組,讓目前選取的伺服器與實際管理的群組難以分辨。
已有單一伺服器資料:依 Type 填寫參數
若手上是單一伺服器資料,同樣從加號進入 Add Server,先選擇正確的 Type,再填寫對應欄位。Shadowsocks、VMess、VLESS、Trojan 等協定使用的驗證與傳輸參數各不相同,不能只填 Address 和 Port 就認為設定完成。位址、連接埠、密碼或 UUID,以及 TLS、Server Name、傳輸方式等項目,都應與現有伺服器資料逐一核對;服務商未說明的選項請勿自行猜測修改。
儲存後返回 Home,確認目標項目已出現在 SERVER 清單中。若有可辨識的 QR Code,可使用 Scan QR Code 匯入;掃描後仍須檢查 Type、位址與重要參數是否符合資料,不能只憑名稱判斷。此時僅完成資料輸入,尚未開始連線。下一步先選擇 Global Routing,避免將路由設定問題誤判為伺服器無法使用。
步驟 02 / 決定請求路徑
選擇 Global Routing 的三種模式
返回 Home,點選 Global Routing,查看目前選取的模式。此處決定請求如何分流,不會提供伺服器,也不能取代伺服器驗證。本文統一使用設定檔(Config)、代理(Proxy)、直連(Direct)這三種說法;操作時請以介面中的 Config、Proxy、Direct 為準。選擇後返回 Home,再查看 Global Routing 目前的值,確認變更已生效。
| 模式 | 請求處理方式 | 初次使用時的檢查項目 |
|---|---|---|
| 設定檔(Config) | 依目前生效設定中的規則選擇策略。 | 確認已有生效的設定檔,且規則引用的策略能找到對應伺服器。 |
| 代理(Proxy) | 通常將連線交由目前的代理策略處理。 | 確認已選取正確的伺服器,用於先測試伺服器連線。 |
| 直連(Direct) | 直接連線至目標,不經由目前的代理伺服器轉送。 | 適合用來對照基礎網路狀態,不能證明代理伺服器已可使用。 |
首次測試可先選 Proxy
尚未準備好規則設定檔時,可以暫時選擇代理(Proxy),先確認目前的伺服器能否成功連線。這是排查問題的步驟,不代表日常使用時必須維持此模式。即使選用 Proxy,也應依實際請求測試結果判斷,不要以為所有系統流量在任何情況下都會採用完全相同的路徑。
若已有可用設定檔,且想依網域或位址分流,請選擇設定檔(Config)。請分清兩個名稱相近、用途不同的項目:Global Routing 中的 Config 是路由模式,App 中的 Config 頁面則用來管理設定檔。匯入 Subscribe 後取得伺服器清單,不代表已有符合需求的規則設定檔;兩者應分別確認。
使用 Config 時確認生效設定檔
進入 Config 頁面,確認準備使用的設定檔已設為目前設定,再返回 Home 選擇 Config。規則會依序比對,請求命中哪一條規則、該規則引用何種策略,都會影響最終路徑。首次連線時不要大量貼上不熟悉的規則。規則順序、策略引用與 DNS 的完整說明,請見完整手冊;本頁先完成可重複的連線測試。
直連(Direct)可用來對照基礎網路狀態:若切換至 Direct 後,原本可直接連線的網頁仍無法開啟,應先檢查裝置網路,而不是繼續修改伺服器參數。選好模式後,進入下一步選擇伺服器並開啟連線。
步驟 03 / 選擇與授權
選取 SERVER 項目,再開啟連線
在 Home 的 SERVER 清單中找到準備測試的伺服器,點選項目前方的圓點,確認選取標記位於目標項目上。伺服器名稱只是備註,無法證明參數正確、伺服器可用或實際連線路徑。首次測試最好固定使用一筆資料完整的伺服器,不要在未記錄的情況下連續切換多台,否則很難判斷每次設定對應的測試結果。
先選取項目,再啟用連線
檢查 Global Routing 與選取的伺服器後,開啟 Home 上方的連線開關。尚未連線時,畫面可能顯示 Not Connected 等狀態;啟用後請等待狀態更新,並確認連線能否維持。開啟伺服器詳細資料以修改參數,與點選前方圓點以選取目前伺服器,是兩種不同操作。若剛才只進入詳細資料頁查看,卻沒有選取項目,實際連線可能仍使用先前的伺服器。
使用設定檔(Config)時,也要留意規則可能引用特定策略或策略群組,不一定所有請求都會使用 Home 中剛選取的項目。若要單獨測試這台伺服器,請先暫時使用代理(Proxy)進行對照,再切回 Config 檢查分流。連線期間不要同時修改伺服器參數、設定檔與 DNS,以免一次變更帶來多個不確定因素。
了解新增 VPN 設定的系統提示
首次啟用時,系統可能詢問是否允許 Shadowrocket 新增 VPN 設定。這項連線授權讓 App 透過系統網路機制處理流量,與使用者已有的訂閱資料無關。確認提示是由目前主動執行的操作觸發,且 App 名稱為 Shadowrocket 後,請選擇允許,並依系統要求完成裝置認證。授權完成後返回 App,確認上方開關與連線狀態是否穩定。
若先前取消了系統提示,不要靠重複匯入訂閱來解決;伺服器資料與系統權限是不同環節。可以再次嘗試開啟連線,並依系統提示檢查 VPN 設定與權限。若裝置受到管理政策限制,請先確認相關管理要求。也要避免其他 VPN 連線同時占用系統通道,測試期間僅保留本次需要的連線。
系統顯示 VPN 狀態圖示,或 App 開關維持開啟,只能表示連線通道已啟動,不能單獨證明目標網站可連線、驗證正確或規則命中符合預期。完成授權後先不要新增規則,直接進入測試步驟,以實際請求確認結果。
步驟 04 / 檢查實際結果
執行 Connectivity Test 並確認分流
連線狀態穩定後,在 Home 點選 Connectivity Test,等待測試完成並查看畫面結果。此測試反映特定測試目標與當下網路條件下的狀況,可協助辨識明顯的連線問題,但不代表所有網站、協定或 App 都已正常運作。測試成功後仍須實際開啟服務確認;測試失敗時,也應根據受影響的範圍判斷原因。
使用相同目標對照連線前後狀況
開啟瀏覽器,前往本次確實需要使用且網址已確認正確的網頁,觀察頁面內容與必要資源是否能載入。若畫面只顯示舊頁面,可能是讀取快取,不能作為新的連線證據。可重新載入頁面,或進入同一服務中的新頁面,確認確實送出了請求。若服務需要登入,也要區分網路請求失敗與帳戶權限提示。
建議固定網路、伺服器與測試目標,每次只變更一項設定。例如使用同一台伺服器比較 Proxy 與 Config,或維持 Proxy 不變,改用另一台現有伺服器。這樣的對照才有助於定位問題。不要同時切換 Wi-Fi、更換伺服器、修改 TLS 並更新設定檔,再試圖從單次結果判斷故障原因。
驗證 Config 時檢查規則與策略
若打算日常使用設定檔(Config),基礎連線正常後請切回此模式,再重複相同的連線測試。進入 App 提供的請求紀錄或診斷頁面,檢查目標網域、命中規則與最終策略是否符合預期。網頁能開啟,不代表一定經過代理;也可能依規則使用 DIRECT。反過來說,規則寫了 PROXY,也要確認該策略確實引用可用的伺服器。
Data 頁面的上行、下行流量可作為輔助參考,但讀數增加不代表某個特定請求已按預期分流,背景活動也會產生流量。較可靠的做法是對照操作時間、測試目標與相關紀錄,再查看該筆請求的處理路徑。若要分析規則細節,請參閱完整手冊;初次使用時不必同時調整所有統計與診斷設定。
若 Connectivity Test、實際連線與預期分流都已確認正常,可以保留目前設定。之後修改前,先記下這組可用條件:使用的網路、伺服器備註、Global Routing 模式與目前設定檔。若仍有問題,請依下列順序排查,不要一開始就刪除所有設定重來。
步驟 05 / 每次只排除一個變數
依故障環節檢查常見問題
先確認問題發生在哪個環節:訂閱未匯入、連線開關無法維持、測試失敗,還是只有部分網頁異常。不同狀況對應不同檢查項目。排查時保留原有的有效資料,每次只變更一項,再重複相同測試。即使問題尚未解決,也能藉此確認剛才的修改是否造成影響。
匯入後沒有伺服器:先檢查訂閱內容
若 SERVER 清單是空的,請返回訂閱設定,確認 URL 是否完整,以及是否誤用了帳戶管理頁面的網址。確認裝置的基礎網路正常後,再更新現有訂閱。訂閱網址可能有效,但回傳的是錯誤提示頁面;也可能需要請服務商確認存取狀態或格式。App 購買紀錄、VPN 權限與訂閱回傳內容彼此不能取代;此時不應透過調整 Global Routing 解決清單為空的問題。
開關無法維持:先檢查權限與參數
若開啟後立即停止,先查看 App 提示,再確認是否已完成系統 VPN 設定授權、裝置管理是否有限制,以及是否有其他 VPN 連線正在使用。接著核對目前伺服器的 Type、Address、Port 與驗證資料。只有在資料明確要求時,才填寫 TLS、Server Name、傳輸路徑等項目;留白與填錯並不相同。若裝置日期與時間明顯錯誤,也可能影響憑證驗證,請先校正時間。
已連線但測試失敗:分別檢查網路與伺服器
先停止連線,確認裝置的基礎網路可正常開啟已知可連線的網頁。若 Wi-Fi 需要網頁認證,請先完成認證。確認基礎網路正常後重新連線,保持 Proxy 與測試目標不變,再觀察結果。若還有其他伺服器,可在其他條件不變時改用另一個項目對照;不要只憑一次失敗就認定所有伺服器資料都需要重建。
若紀錄中出現驗證、連線逾時或憑證相關訊息,請對照現有參數檢查。不要為了消除提示而任意關閉憑證驗證或降低安全設定。若不確定伺服器端的要求,請向服務商索取正確說明,再修改對應欄位。
Proxy 可用但 Config 異常:先檢查分流
在相同網路、伺服器與測試目標下,若 Proxy 可用但 Config 不通,通常應優先檢查目前設定檔、規則順序、策略引用與 DNS,而不是重新購買 App。先確認 Config 頁面選取的是預期檔案,再查看異常請求命中了哪一條規則,以及是否被送往 DIRECT、REJECT 或不可用的策略。檢查規則時,從實際命中的項目著手,不要大量刪除看不懂的行。
若只有一項服務異常,還要確認它是否使用多個網域、是否有獨立登入介面,以及是否受到帳戶狀態影響。DNS 設定不一致也可能造成網域解析與連線結果不同,但初次排查不宜同時加入多套 DNS 方案。更多依狀況分類的說明請見FAQ;若要完整了解設定檔與日常維護,請接著閱讀完整手冊。
至此,首次設定已完成一個完整流程:SERVER 中有有效項目、Global Routing 與目標相符、系統授權已完成、連線穩定,且實際請求通過測試。日後遇到問題時,依相同順序逐項檢查,通常比反覆刪除並重新匯入更容易找出變化所在。