官方手冊 / 首次連線

Shadowrocket 使用教學

匯入既有訂閱、設定 Global Routing 與驗證連線

依五個步驟完成 iPhone / iPad 的基本設定。先備妥連線資料,再選擇路由模式;確認連線狀態後,接著檢查請求是否依預期處理。

匯入 選擇模式 連線 驗證 排解問題

Add Server:新增伺服器或訂閱

開啟 Shadowrocket,進入 Home。先確認手上的資料屬於哪一種:用來更新伺服器清單的訂閱連結,或包含協定、位址、連接埠與驗證資訊的單一伺服器資料。兩種資料的填寫位置不同,不要把整段訂閱連結貼到 Host,也不要把伺服器位址當成 Subscribe 連結。

已有訂閱連結:使用 Subscribe

在 Home 點選 Add Server,或使用相應的新增入口。進入新增頁面後點選 Type,選擇 Subscribe。將自己的完整訂閱連結填入 URL 欄位後儲存。複製時請確認開頭和結尾沒有混入空格、換行或說明文字;連結中的查詢參數也是內容的一部分,不要自行刪改。備註可填寫方便自己辨識的名稱,不會影響連線資料。

儲存並完成訂閱取得後,返回 Home,查看 SERVER 分組是否出現伺服器項目。訂閱名稱不一定與實際伺服器名稱相同,請展開或查看項目後再選取。若只看到訂閱記錄,卻沒有可選的伺服器,請先確認取得作業是否完成、連結是否有效,以及目前網路能否連上訂閱網址;反覆新增相同訂閱通常無法解決來源網址的問題。

已有單一伺服器資料:依 Type 填寫

同樣從 Add Server 進入,先依自己的資料選擇 Type。不同協定所需欄位不盡相同:截圖中的 Host、Port、Password、Method 是目前示例類型的欄位,不能一概套用於所有協定。Host 填寫伺服器主機名稱或位址,Port 填寫提供的連接埠;驗證資訊、加密方式及 TLS 相關欄位,請逐項核對原始資料,大小寫與特殊字元也須完全一致。

若已有相應的 QR Code,可使用 Scan QR Code 掃描並檢查欄位;Import from Cloud JSON 僅適用於相應格式的既有資料,不可填入任意網頁網址。儲存後返回 Home,點選要使用的伺服器。名稱只是備註,選取項目才會決定後續代理請求使用的目標。完成後應有一筆容易辨識且資料完整的伺服器記錄;接下來再決定哪些請求要交由它處理。

訂閱連結可能包含存取憑證,請比照密碼妥善保管。不要將完整連結、QR Code 或含驗證欄位的截圖公開。更新訂閱主要是更新伺服器清單,不代表同時安裝了分流規則;Config 仍須另外確認。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method 與匯入入口
Add Server:先選擇 Type,再填寫相應欄位。截圖中的欄位僅適用於示例類型。

Global Routing:選擇規則與模式

伺服器出現在 Home 後,開啟 Global Routing。這裡用來決定如何處理請求,而不是重新填寫伺服器。三種基本模式分別為設定檔(Config)、代理(Proxy)與直連(Direct)。首次操作時,請先確認目標:要測試所選伺服器是否可用,或依既有設定檔進行分流;兩種目標的檢查方式也不同。

設定檔(Config):依目前設定檔分流

要依規則分流時,請使用設定檔(Config)。先進入 Config,確認已選取要使用的設定檔,再查看其中的規則內容。訂閱提供伺服器,設定檔則描述處理規則,兩者不能互相取代。只匯入 Subscribe 後直接選擇 Config,並不代表規則已符合自己的需求。

官方截圖中的設定編輯頁分為 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區塊。初次使用時先查看 Rule 及其引用的策略即可,不必為了連線而逐一啟用其他區塊。Add Rule 用於新增規則;若使用既有設定檔,請先看清目前的規則順序與最終處理方式,再決定是否修改。尤其不要為了排查一般連線問題而隨意調整 HTTPS Decryption。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

以上僅為方便理解的規則示例,不是完整設定檔,也不需要直接貼上。DOMAIN-SUFFIX 範例會比對相應網域並使用 PROXY;GEOIP 範例會對符合條件的位址使用 DIRECT;FINAL 則處理此前未符合的請求。規則通常依序比對,較前面的寬泛規則可能使後面的細項規則無法符合;實際行為也取決於完整設定檔及其策略定義。

代理(Proxy)與直連(Direct):確認測試目的

代理(Proxy)會將依此模式處理的請求交由所選代理伺服器處理,有助於分辨「伺服器本身無法使用」與「設定檔分流不如預期」。直連(Direct)則直接連線,不應用來驗證代理路徑。暫時切換至 Proxy 完成比較後,若原本目標是依規則分流,請切回設定檔(Config)再驗證規則,不要把一次連線測試當成最終設定。

此步驟只需確認目前模式、所選設定檔與伺服器三者一致。設定檔來源、複雜規則與還原修改的細節,請參閱疑難排解;購買與帳號問題則請查看App Store 取得指南,首次連線時不必一併處理。

Shadowrocket Config 官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:查看目前設定檔的 Rule。Global Routing 入口位於 Home,設定編輯頁則用來核對具體規則。

Home:開始連線並授權 VPN

返回 Home,先確認 SERVER 中選取的伺服器,再查看 Global Routing 是否仍為剛才決定的模式。若要使用 Config,也請確認已啟用預定的設定檔。確認這兩項後,開啟頁面頂端的連線開關。尚未連線時,頂端會顯示 Not Connected;開關與狀態區是判斷本機連線流程是否啟動的第一個位置。

首次連線時,系統可能會提示新增 VPN 設定。這是允許 Shadowrocket 建立系統網路連線所需的授權,不是再次購買 App,也不是替伺服器重新設定密碼。閱讀提示並確認發起者後,允許操作,再依系統要求完成裝置驗證,接著返回 Shadowrocket 等待狀態變化。若先前曾取消授權,可再次開啟開關,讓系統重新啟動所需流程。

建立連線後,系統可能顯示 VPN 標示;不同裝置與顯示位置可能有所差異,不要只憑狀態列是否顯示字樣判斷成功。更重要的是返回 Home,查看狀態是否穩定,並確認下一步能否完成實際請求。連線開關維持開啟,只代表本機連線正在運作,不代表遠端伺服器驗證、DNS 解析與每個目標網站都已通過檢查。

若開啟開關後立即關閉,請先記錄系統提示或 App 錯誤,再檢查是否有其他正在使用的 VPN 設定、裝置管理限制或尚未完成的授權。不要快速連續切換開關,也不要一開始就刪除所有系統網路設定。可在系統設定中與 VPN 和裝置管理相關的位置確認 VPN 設定;若找不到相應項目或需要重建,請依照疑難排解中的 VPN 權限說明逐步處理。

iPad 的寬螢幕版面可能會同時顯示清單與詳細資訊,但操作方式相同:選擇伺服器、確認 Global Routing、開啟連線。在另一部裝置上可使用 App,不代表這部裝置已有相同的訂閱與設定,請在目前裝置逐項確認。完成授權後保留目前選擇,進入下一步驗證,不要同時修改規則或更換伺服器。

Shadowrocket Home 官方截圖,顯示 Not Connected 開關、Global Routing、Connectivity Test、SERVER 與 Add Server
Home:確認伺服器與 Global Routing 後,開啟頂端開關,再使用 Connectivity Test 輔助檢查。

Connectivity Test:確認連線是否正常

驗證時要分別確認兩件事:所選伺服器能否回應,以及實際請求是否走預期路徑。在 Home 執行 Connectivity Test,查看所選項目的測試結果。這項測試適合初步檢查完全沒有回應的目標,但測試方法與目標不一定和實際瀏覽相同;測試有回應,不代表所有網頁、協定或規則都正常。

保持目前連線,開啟瀏覽器前往一個自己熟悉且獲准存取的頁面,再開啟另一個正常可用的頁面比較。盡量送出新的請求,避免只查看快取內容。記錄是頁面完全無法開啟、部分資源載入失敗,還是只有單一目標發生問題;這些區別比一再表示「連不上」更有助於找出原因。

若使用設定檔(Config),還要核對目標對應的規則與實際連線記錄。預期使用 PROXY 的請求,應與相應策略及伺服器選擇一致;預期使用 DIRECT 的請求,則不能只因 App 顯示已連線,就認定它經過代理。Data 中上傳與下載數值的變化可協助判斷是否有流量,但裝置的背景請求也會影響數值,不能只憑總量增加就證明某個網域符合哪一條規則。

需要比較不同模式時,維持伺服器不變,暫時在 Proxy 與 Config 之間切換,並重新送出相同請求。若 Proxy 正常、Config 異常,優先檢查規則順序、策略目標與解析相關設定;若兩種模式都失敗,則先檢查伺服器資料與基礎網路。每次只變更一項,完成比較後還原原先模式。如此才能釐清因果,避免混淆多項變更的影響。

此步驟的完成標準不是某個測試數值,而是能清楚說明「目前選取哪台伺服器、使用哪種模式,以及實際請求的結果」。確認後即可依日常需求使用;若仍有問題,請保留這些結果,再依照下方順序檢查。

Settings:檢查常見故障原因

排查時從最前面的條件開始。先關閉連線,確認目前的 Wi-Fi 或行動網路能正常瀏覽;若網路需要登入,也請先完成登入。接著重新連線並重現一次問題。若基礎網路本身無法使用,修改規則、密碼或測試方法只會增加變因,不能取代網路連線。

清單空白、測試失敗或連線後無法開啟網頁

若更新訂閱後清單仍是空的,請確認自己的訂閱連結是否完整、服務是否仍有效,以及更新時是否出現明確錯誤。不要混淆訂閱更新失敗與伺服器連線失敗。若清單已有項目但測試失敗,請檢查所選項目的 Host、Port、協定與驗證資料;若連線需要額外 TLS 參數,也要逐項核對既有資料,不要嘗試關閉憑證驗證來略過錯誤。

若狀態顯示已連線但網頁無法開啟,先確認是否誤選直連(Direct),再確認設定檔(Config)使用的檔案與策略確實存在。若只有一個目標異常,請檢查相關規則與解析設定;若所有目標都異常,再檢查伺服器驗證、基礎網路與 VPN 狀態。先釐清問題範圍再修改,可減少與故障無關的操作。

Test Method、On Demand 與 Diagnostics

進入 Settings 後,可看到 Test Method、On Demand、Diagnostics 等項目。Test Method 會影響測試結果的意義;比較兩台伺服器或兩次測試結果前,請確認使用相同的測試方法與網路條件。不要只依據一次回應速度判斷長期可用性,也不要把測試方法不同造成的結果差異,誤認為伺服器突然改變。

若手動關閉後又開始連線,請檢查 On Demand 的條件是否正在生效。初次使用時可先記錄目前狀態,確認有需要後再暫停按需連線,完成手動連線驗證後再恢復。Proxy、TCP、UDP 等設定應在了解影響範圍後再調整,不必為了基本連線而逐一嘗試。Language 只會影響介面顯示,無法修復伺服器資料。

Diagnostics 可協助蒐集問題線索。記錄錯誤類型、問題發生於授權或連線階段、所選模式與目前網路即可;分享記錄前,請遮蔽訂閱網址、驗證欄位與個人存取的目標。不要直接公開整份設定檔。若已修改設定,請先還原至可確認的狀態再測試,避免在未知狀態下繼續疊加變更。

仍無法找出原因時,請前往疑難排解,依照「首次開啟與 VPN 權限」、「訂閱與節點匯入」、「規則分流與疑難排解」繼續檢查。至此,基本操作流程應已清楚:匯入既有資料、選取伺服器、確認 Global Routing 與設定檔一致、完成 VPN 授權,並以實際請求驗證結果。後續調整時,依照這個流程逐項檢查即可。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:依問題檢查 Test Method、On Demand 與 Diagnostics,避免同時變更多項設定。
下載 Shadowrocket