官方手冊 · 入門操作

Shadowrocket 使用教學

先匯入現有設定,再選擇路由、開啟連線,最後透過實際存取驗證結果。本頁依首次設定的操作順序說明,適用於 iPhone 和 iPad;先完成一條連線,再整理其他伺服器。

1. Add Server / Subscribe:匯入現有設定

先確認手上的資料類型,再選擇匯入方式。以 https:// 開頭、用來取得一組伺服器的網址,通常是訂閱連結;以 ss://、vmess://、vless:// 或 trojan:// 等開頭的內容,通常是單一分享連結。如果收到的是分開列出的位址、連接埠、密碼及協定參數,則應手動新增。僅憑連結前綴無法判斷內容是否有效,還需對照原始設定說明。

使用 Subscribe 匯入訂閱

開啟 Shadowrocket,進入 Home,點按右上角的新增入口,然後進入 Add Server。點按 Type,選擇 Subscribe,再將自己的完整訂閱連結填入 URL;如有備註欄位,可填寫方便辨識的名稱。確認後儲存並返回 Home,等待訂閱內容取得完成。不同顯示版面可能使入口位置略有不同,可依 Type、Subscribe 和 URL 等介面文字尋找。

貼上時不要只複製網域名稱。連結路徑及問號後方的參數可能都是辨識訂閱所需的資訊,少複製一段就可能無法更新。也不要將網頁標題、說明文字或連結兩端的引號一併填入。以下僅為無法用來連線的格式範例,不必複製到 App 中:

https://example.com/sub?token=xxxx

返回 Home 後,檢查訂閱群組中是否出現伺服器項目。儲存訂閱網址與成功取得伺服器清單是兩回事:若只看到群組名稱,沒有可選的伺服器,應先排除取得失敗的問題,而不是繼續開啟連線。首次匯入可先保留原有群組和名稱,方便之後對照項目與原始資料;完成連線驗證後,再調整排序或整理名稱。

使用 Add Server 手動填寫

若已有完整伺服器資料,請在 Add Server 中先選擇與資料相符的 Type,再填寫伺服器位址、連接埠及驗證欄位。Shadowsocks、VMess、VLESS、Trojan 等協定所需欄位不同,不可將某種協定的密碼或識別資料隨意填入另一種類型。位址欄通常只填主機名稱或 IP 位址,連接埠則填入對應欄位;不要將單一分享連結拆得不完整後塞進位址欄。

接著對照現有資料,檢查加密方式、TLS、Server Name、傳輸方式及相關路徑;只填寫目前協定實際需要的欄位。尤其要分清用於連線的伺服器位址與 TLS 驗證所用的名稱,兩者可能不同,但不可自行猜測。若不確定某個必要欄位,請回頭核對原始設定資料,避免反覆試填時同時更動多項條件。儲存後返回 Home,確認新增的項目已出現。

若已有 QR Code,可使用 Scan QR Code 掃描;若有單一分享連結,可依 App 顯示的剪貼簿匯入提示操作,並允許必要的相機或貼上權限。匯入後仍應開啟項目檢查協定與重要欄位;掃描或貼上只是輸入方式,不能驗證遠端服務一定可用。多個訂閱的整理、分享連結欄位及備份方式,請參閱訂閱與伺服器管理手冊。

完成本步的判斷方式:Home 中出現預期的伺服器,點按其中一項後可辨認目前的選取狀態。若訂閱群組中有多個項目,請先選定一項進行測試;不要將群組名稱誤認為已選取的特定伺服器。接著維持此選擇,設定 Global Routing。

2. Global Routing:選擇連線模式

在 Home 找到並開啟 Global Routing。這裡用來決定請求採用哪種路由方式,不是修改伺服器密碼的地方,也不等同於更換訂閱。初次操作時,請分清三種模式:設定 (Config)、代理 (Proxy)、直連 (Direct)。選定後返回 Home,確認 Global Routing 目前顯示的值,再繼續連線。

模式 處理方式 入門使用情境
設定 (Config) 依照目前設定中的規則與策略處理請求。 已有明確的規則設定,需依目標進行分流。
代理 (Proxy) 將一般代理流量交由所選伺服器處理;實際效果仍受系統及 App 的處理範圍限制。 初次驗證伺服器,或與 Config 進行對照測試。
直連 (Direct) 採用直連方式,不將目標請求交由所選的代理伺服器處理。 檢查基本網路,或確認直連存取情況。

若要先確認新匯入的伺服器是否可用,可先選擇代理 (Proxy),減少規則條件對排查的干擾。這只是驗證方式,不代表所有使用情境都應長期維持此模式。若已有明確的分流需求,請在連線驗證通過後切回設定 (Config),並確認 Config 頁面已選取預期的設定。

Home 中匯入的伺服器清單與 Config 中的規則設定各有不同用途:前者提供可選的連線對象,後者決定哪些請求採用 DIRECT、PROXY 或其他已定義的策略。匯入訂閱不代表已選好適合自己的規則檔。在設定 (Config) 模式下,某個頁面即使能正常開啟,也可能是因為符合 DIRECT 規則;這不足以單獨證明代理伺服器可用。

直連 (Direct) 也需要正確理解。它是一種路由選擇,不代表刪除伺服器,也不代表清除 App 資料。排查時可用它與其他模式比較,但若目標原本應經由代理處理,維持在直連 (Direct) 就不會使用預期路徑。不要把「開關已開啟」和「所有請求都經由所選伺服器」視為同一回事。

完成本步的判斷方式:能說明目前採用哪種模式,以及選擇它的原因。初次測試可先記下「伺服器名稱 + 代理 (Proxy)」這組設定;下一步只開啟連線,不要同時更換設定檔或伺服器。

3. Home:開啟連線並確認系統授權

返回 Home,再次確認選取的伺服器和 Global Routing。確認無誤後,開啟頂端的連線開關。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定;請閱讀提示,確認是由目前的操作觸發,再依系統要求完成裝置密碼或生物辨識驗證。此授權用於建立系統網路通道,不是新的 App 購買步驟。

若先前拒絕授權,連線可能無法繼續。可先關閉開關再試一次,並留意系統提示是否再次出現;必要時到裝置的 Settings 搜尋 VPN,檢查 Shadowrocket 對應的設定狀態。不要為了重試而刪除不熟悉的裝置管理項目。若裝置由組織管理,相關設定無法修改,請先確認管理限制,不要反覆重置網路。

完成授權後返回 Home,確認連線開關是否維持開啟,以及 App 是否顯示錯誤提示。系統狀態列或控制中心可能會顯示 VPN 狀態,實際位置會因裝置版面而異。此標記只能協助確認系統通道狀態,無法證明遠端驗證、DNS 解析及每個目標頁面都已成功;完整驗證請進行下一步。

測試期間,避免同時啟用另一個系統 VPN 連線。若先前已設定 On Demand,自動觸發條件也可能讓手動中斷的連線再次啟動;請先記錄現有設定,初次排查時盡量減少這些自動觸發因素。完成基本驗證後,再依實際網路環境設定 On Demand,方便分辨手動操作與自動連線各自造成的變化。

若開關立刻退回關閉,請先記下錯誤訊息和發生階段:是在系統授權前退出,還是授權後嘗試連線失敗。前者優先檢查授權狀態;後者則還需檢查伺服器參數與目前網路。此時不要急著重新匯入所有訂閱,也不要一次修改多個協定欄位;保留原始項目才方便對照。

完成本步的判斷方式:連線開關維持開啟,系統授權已完成,App 未立即顯示連線錯誤。維持目前設定,接著透過測試與實際存取確認是否符合預期。

4. Connectivity Test:驗證連線結果

驗證時應同時檢查三個層面:裝置的基本網路、所選伺服器的測試結果,以及目標頁面的實際存取情況。先確認目前的 Wi-Fi 或行動網路可正常使用;若 Wi-Fi 需要網頁認證,請先完成該網路的認證程序。基本網路尚未連通時,訂閱更新和伺服器連線都可能失敗,單獨調整 App 參數通常無法解決。

返回 Shadowrocket,在 Home 的測試入口找到 Connectivity Test,並對選取的項目執行測試。測試方式及顯示項目以 App 目前的介面為準。若項目旁顯示測試結果,應將其視為該測試方式下的連線可達性回報,而非對所有網站和所有協定行為的完整驗證。測試成功不代表目標頁面一定能開啟;測試失敗時,仍需結合下一步的實際存取情況判斷。

保持連線開啟,切換至瀏覽器,開啟一個自己有權存取且平時可正常使用的頁面。必要時重新載入,避免將先前保留的頁面內容誤當成新請求的結果。接著檢查實際要使用的 App 或頁面,確認是否能完成載入,而非只看首頁文字是否出現。若只有單一目標異常,先排除該目標本身的問題,不要直接歸因於整條連線。

若目前使用設定 (Config),可查看 App 中可見的請求記錄或診斷資訊,核對目標網域、符合的規則及最終策略。實際記錄內容取決於目前設定。符合 DIRECT 表示該請求採用直連;符合 PROXY 時,才需進一步依相關伺服器狀況判斷。不要因連線開關已開啟,就忽略規則選擇造成的路徑差異。

需要比較時,維持同一台伺服器,先用代理 (Proxy) 存取一次,再切換到設定 (Config) 對同一目標重複測試。Proxy 正常而 Config 異常時,優先檢查目前設定、規則順序和 DNS,不要立即更換伺服器。兩種模式都異常時,再檢查伺服器資料與網路環境。每次切換後都發出新的請求,並盡量維持其他條件不變。

不必追求單一測試數值。一次回報會受測試方式、目前網路及遠端回應影響,不能據此斷言長期狀況。初次使用更重要的是確認「能連線、能存取、路徑符合目的」。測試連結、訂閱內容和診斷記錄可能包含個人設定,向他人描述問題時,應遮蔽完整訂閱網址、驗證資訊及不必要的存取記錄。

完成本步的判斷方式:實際目標可正常載入,且目前的連線模式符合使用目的。若還要整理多個訂閱,請參閱伺服器管理;若驗證未通過,請依下方列出的失敗階段繼續檢查。

5. 常見問題:依操作階段排查

先找出問題發生在哪個步驟,再處理相應條件。將問題簡單記為「匯入失敗」、「未能建立連線」或「連線後存取異常」,通常比同時更新訂閱、更換伺服器和修改規則更容易找出原因。每次只調整一項條件,並重複相同測試;確認成功後,再逐項恢復日常設定。

匯入失敗:檢查完整連結與內容類型

訂閱儲存後沒有伺服器,請先重新確認 URL 是否完整、是否含多餘空格或換行,再確認它確實是用來取得訂閱內容的網址,而非帳戶網頁或說明頁。連結是否仍有效,應依自己現有訂閱的狀態確認。更新會重新取得遠端內容,無法修復已失效的網址。若錯誤提示與格式有關,請確認 Subscribe 能否識別該內容,而不是直接修改驗證參數。

單一分享連結無法匯入時,請檢查是否只複製了部分內容,或連結是否被聊天文字或換行截斷。手動新增的項目可以儲存但無法連線時,請逐項對照原始資料,檢查 Type、位址、連接埠及驗證欄位。儲存成功只代表項目已寫入 App,不代表遠端驗證已通過。

連線失敗:分辨授權、參數與網路問題

若尚未完成系統授權,請先處理 VPN 設定提示;若已有設定但開關無法維持開啟,請記錄 App 顯示的錯誤,再檢查協定與欄位。位址無法解析、連接埠無法連線、驗證資料不符、TLS 名稱不一致,可能分別發生在不同階段,不應一律透過重新安裝 App 處理。也不要為了消除提示而任意降低憑證驗證要求,請先修正設定中與原始資料不符的項目。

若在 Wi-Fi 下連線失敗,可在條件允許時切換至行動網路,維持相同伺服器和連線模式再測試;也可反向比較。若只有某種網路環境異常,請先檢查該網路的認證、連線限制或解析狀況。這種比較有助縮小問題範圍,但不能單憑一次結果判斷遠端服務的長期狀態。

已連線但存取異常:比較路由與 DNS

先回到 Home,確認仍選取預期的伺服器,再檢查 Global Routing 是否誤留在直連 (Direct)。若代理 (Proxy) 可以存取而設定 (Config) 不行,請進入 Config 確認選取的設定,並檢查目標是否符合預期規則。DNS 解析結果、規則順序及最終策略都可能影響使用情況;不要一次修改整套設定,先針對同一目標重現問題。

若只有某個 App 異常,而瀏覽器中的同一目標正常,也應考慮該 App 自身的快取、工作階段及連線重用。可結束該 App 目前的工作後重新存取,再觀察結果,不必先清除 Shadowrocket 資料。若切換模式後狀況沒有立即改變,也應等待舊連線結束或重新發出請求,再做判斷。

保留排查結果

記錄裝置使用的網路類型、目前模式、伺服器的自訂名稱、問題發生的步驟,以及已遮蔽敏感資訊的錯誤文字即可。不要公開訂閱連結和密碼,也不要將完整設定當作一般截圖分享。原有項目仍可使用時,請優先保留備份,再決定是否刪除或重新匯入,避免排查過程反而遺失必要資料。

更詳細的購買復原、權限與規則問題,請前往FAQ;訂閱更新、多訂閱整理、延遲測試與備份,可繼續閱讀訂閱與伺服器管理手冊。完成一次可重複的成功驗證後,再增加伺服器或設定自動連線;每新增一項都重新檢查實際存取,日後出現變化時便能依相同順序找出問題。