START-HERE

Shadowrocket 使用說明:從匯入到連線測試

本教學依照實際操作順序,介紹 iPhone 與 iPad 上的五個步驟:新增現有資料、選擇分流模式、連線、測試,再排查問題。介面位置可能隨應用程式更新而改變,請以目前應用程式中的文字為準。

ADD-SERVER

新增伺服器或匯入現有訂閱

先將現有資料匯入應用程式,再決定如何分流請求。伺服器資料和訂閱連結是兩種不同的匯入方式,同一份內容不必重複新增。

手動新增伺服器

開啟 Shadowrocket 的 Home,在 SERVER 區域找到 Add Server。進入後先查看 Type,這會決定接下來需要填寫哪些欄位。依照現有伺服器資料選擇相應類型,例如 Shadowsocks、VMess、VLESS、Trojan 或 WireGuard;不要只憑伺服器名稱猜測 Type。選好類型後,逐項填入服務提供者提供的 Host 與 Port,再填寫該類型要求的 Password、Method 或其他參數。不同 Type 的欄位不盡相同,截圖僅展示其中一種欄位組合,並非所有類型都需要填寫 Password 與 Method。

填寫時請特別留意複製的內容:Host 不應包含多餘空格,Port 應與原始資料一致;憑證中的大小寫與符號也必須原樣保留。儲存後返回 Home,確認新項目已出現在 SERVER 區域,並點選該筆記錄作為目前伺服器。清單中出現項目只代表資料已儲存,不表示連線已建立;接下來還要選擇 Global Routing,並開啟 Home 頂端的連線開關。

已有訂閱連結時

如果你已有服務提供者提供的訂閱 URL,可在新增入口選擇 Subscribe,將完整連結貼到訂閱網址欄位,儲存後執行更新。更新完成後返回 Home 查看匯入結果,並選取要使用的伺服器。訂閱 URL 與單一伺服器分享連結用途不同:前者用於取得及更新一組資料,後者通常只對應一筆伺服器記錄。請勿將伺服器分享連結當作訂閱網址反覆更新;若不確定資料類型,先查看來源提供的說明。

同一畫面底部也可能顯示 Scan QR Code 與 Import from Cloud JSON。這些是不同的匯入方式,請依照手邊資料的格式選用。若貼上連結後沒有出現預期項目,先檢查連結是否完整、目前網路能否連上來源,以及是否已完成儲存與更新;確認結果前,請勿連續建立多筆相同記錄。如需了解 Subscribe、分享連結與常見協定欄位的差異,請參閱術語表。

App Store 官方截圖:Shadowrocket Add Server 頁面,顯示 Type、Host、Port、Password 與 Method 等欄位
App Store 頁面展示的 Add Server 介面;實際欄位依所選 Type 而定。
RULE-SET

選擇 Global Routing 模式

先決定哪些請求要使用目前的伺服器,再開啟連線;否則容易混淆「已連線」與「分流符合預期」這兩件事。

返回 Home,開啟 Global Routing。常用的三種模式為設定檔(Config)、代理(Proxy)與直連(Direct)。選擇 Config 時,應用程式會依照目前設定檔中的規則判斷請求;選擇 Proxy 時,請求會依代理模式處理;選擇 Direct 時,請求會依直連模式處理。這些選項會改變請求的處理方式,不會替你修正伺服器地址或憑證。剛完成匯入時,先依照使用需求選擇模式,再透過後續步驟確認結果。

若選擇設定檔(Config),也要了解規則來源。進入 Config,找到目前啟用的設定檔,檢查 Rule 區域及最後的處理規則。規則通常由上而下比對:例如 DOMAIN-SUFFIX,example.com,PROXY 表示符合這個範例網域後使用 PROXY;FINAL,DIRECT 表示前面的規則都未符合時使用 DIRECT。此處的 example.com 僅用來說明語法,並非需要新增的實際目標。不要只看到一條 PROXY 規則,就認定所有請求都會經由代理;未符合規則的請求還要看 FINAL。

Config 編輯介面也可能列出 General、Hosts、URL Rewrite 與 HTTPS Decryption 等區段。初次連線不需要逐一修改這些設定,也不要為了測試連線而同時變更 DNS、重寫與規則。若使用現有設定檔,先確認目前選取的是預期檔案,再檢查 Rule 是否符合需求;需要新增規則時,確認比對條件與策略後再使用 Add Rule。如需了解 DOMAIN-SUFFIX、GEOIP、FINAL 及 PROXY、DIRECT、REJECT 的含義,請先參閱規則術語解說;如需系統性了解設定檔,請參閱完整手冊。

此時請確認:Home 上的 Global Routing 已顯示剛選擇的模式。若選擇 Config,也已確認目前設定檔及未符合規則時的處理方式。接著再進行連線;若測試結果不如預期,就能分辨是連線本身失敗,還是規則讓請求走了其他路徑。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
App Store 官方截圖:Shadowrocket Config 編輯頁面,顯示 General、Rule、Hosts 等區段
App Store 頁面展示的 Config 編輯介面;修改前請先確認目前使用的設定檔。
CONNECT

在 Home 開啟連線

選好資料並確認 Global Routing 後,再使用 Home 頂端的開關。

返回 Home,先確認 SERVER 區域目前選取的是剛才檢查過的伺服器,再確認 Global Routing 顯示預期的模式。接著開啟頁面頂端的連線開關。首次連線時,系統可能會要求授權新增 VPN 設定;閱讀系統提示後依指示確認,必要時完成裝置身分驗證。此權限用於在裝置上建立網路連線設定,不代表伺服器已可使用,也不能取代前面的資料核對。

授權後返回 Home,查看頂端狀態是否從 Not Connected 變為已連線。如果仍顯示 Not Connected,先停在這裡,不要立即輪流修改所有設定:確認系統權限流程是否已完成、是否已選取伺服器,以及輸入資料是否已儲存。若狀態短暫改變後又中斷,也請記下發生時間,留待最後一步逐項排查。Home 的 Connectivity Test 位於連線控制附近,下一步會用它輔助確認,不應只憑開關外觀下結論。

在 iPad 上,各區塊可能因螢幕寬度而出現在不同位置,但操作順序相同:在 Home 選擇伺服器、確認 Global Routing,最後開啟連線。請依照應用程式目前顯示的英文介面文字尋找,不必按截圖中的像素位置找按鈕。系統需求與裝置相容性請以 App Store 頁面標示為準;若尚未確認購買與安裝記錄,可返回iPad 取得說明或iPhone 取得說明。

App Store 官方截圖:Shadowrocket Home 頁面,顯示 Not Connected 開關、Global Routing、Connectivity Test 與 SERVER 區域
App Store 頁面展示的 Home 介面;截圖中的 Not Connected 是拍攝當時的狀態。
VERIFY

使用 Connectivity Test 確認結果

連線狀態穩定後,返回 Home 使用 Connectivity Test。先查看測試是否有結果,再與實際瀏覽情況對照:測試有助於判斷目前連線是否可用,但單次測試無法說明某個特定請求命中了哪條規則。若選擇 Proxy,可先確認目標請求在目前連線下是否正常;若選擇 Direct,應依直連模式解讀結果;若選擇 Config,還要查看目前設定檔的 Rule 與 FINAL,判斷目標請求預期會使用 PROXY、DIRECT 還是 REJECT。

測試時一次只選定一個明確目標及一種 Global Routing 模式。假設同一目標在 Proxy 下正常、在 Config 下表現不同,先檢查 Config 的規則及其順序,而不是立刻重新填寫 Host 與 Port。反之,若兩種模式下連線都無法維持,則先回頭檢查伺服器資料與權限。這樣比較能縮小問題範圍,也可避免同時修改多項設定而無從判斷。

也可以開啟 Data 查看應用程式記錄的流量資訊,協助確認測試期間是否有產生請求。流量數值只能反映記錄範圍內的活動,不能單獨證明某個網站一定依指定策略處理;請結合連線狀態、測試結果與規則一併判斷。若已啟用 On Demand,切換網路環境後,連線狀態可能依已設定的條件改變;測試前請先記下目前網路與開關狀態。如需深入了解 Data、規則命中及診斷資訊,請繼續閱讀完整手冊。

到這裡,如果 Home 維持連線、Connectivity Test 的結果符合預期,且實際請求也符合所選模式,基本操作就完成了。若其中任何一項不符,請保留目前設定,依照下一節的順序逐項排查。不要將「已開啟連線開關」、「測試有回應」與「所有請求都依預期分流」視為同一件事。

DIAGNOSE

依序排查常見問題

每次只變更一個條件,重新連線並重複同一項測試,才能判斷是哪項調整產生影響。

先分辨是連線失敗還是分流不符

如果 Home 持續顯示 Not Connected,先確認連線開關、系統 VPN 設定權限及 SERVER 區域目前選取的項目。接著開啟該筆記錄,逐項核對現有資料中的 Type、Host、Port 與相應憑證。手動填寫資料時,類型不符或多貼了字元都可能影響結果。使用 Subscribe 時,先檢查連結是否完整、訂閱是否成功更新,以及更新後的項目是否確實已選取;不要只因訂閱名稱存在,就認定其中每筆資料都能連線。

如果 Home 顯示已連線,但瀏覽結果不如預期,優先重新確認 Global Routing。在 Config 下查看目前檔案、Rule 的比對條件與 FINAL;在 Proxy 和 Direct 下,則分別依所選模式測試同一個目標。請特別留意,REJECT 是一種規則策略:符合該規則的請求會遭拒絕,這與伺服器故障是兩種不同情況。若要暫時切換到其他模式進行比較,請先記下原本設定,測試結束後視需要還原。

最後查看 Settings 中的診斷項目

仍找不到原因時,請進入 Settings 查看 Test Method、On Demand 與 Diagnostics。Test Method 會影響測試結果的判讀方式;On Demand 的條件可能讓連線隨網路環境切換;Diagnostics 則可提供更多排查線索。請先記錄目前選項,再有目的地調整一項,並返回 Home 重新測試。Settings 中也可能出現 Language、Today Widget、Proxy、TCP、UDP 等項目,這些並非初次連線時需要逐一修改的清單。不要看到某項設定就認定它是這次問題的原因。

若問題只在切換網路後發生,先記錄切換前後的 Home 狀態,再核對 On Demand 條件;若問題只在訂閱更新後發生,則比較更新前後選取的伺服器及資料來源。若 Connectivity Test 與實際瀏覽情況不一致,請記錄測試目標、Global Routing 模式、目前設定檔及發生時間,再參閱完整手冊中的連線與維護章節。需要了解 Diagnostics、DNS 或規則欄位時,可使用術語表查詢。

App Store 官方截圖:Shadowrocket Settings 頁面,顯示 Test Method、On Demand、Diagnostics 等設定
App Store 頁面展示的 Settings 介面;先記錄現有選項,再逐項排查。
NEXT-READ

完成基本操作後,繼續閱讀

本頁僅涵蓋從匯入現有資料到首次測試的操作流程。如需系統性了解 Config、Data、Settings 與日常維護,請閱讀Shadowrocket 完整手冊;如需查詢英文介面文字、協定名稱或規則關鍵字,請閱讀術語表。應用程式取得、已購項目還原及商店資訊核對,請參閱App Store 正版核對頁。