官方手冊首次設定流程

Shadowrocket 使用教學
匯入訂閱與測試連線

適用於 iPad 與 iPhone。依照「新增 → 選擇模式 → 連線 → 驗證 → 排除問題」的順序完成首次設定;先確認連線正常,再調整規則與自動連線條件。

官方截圖可用來辨認頁面與欄位,實際畫面請以裝置目前顯示為準。截圖中的伺服器項目不是可供填寫的連線資料;操作時請使用自己的資料,不要照抄圖片內容。

01 / ADD SERVER · SUBSCRIBE

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

兩種方式擇一:匯入訂閱可新增一組項目,手動新增則會儲存一台伺服器。

開啟 Shadowrocket 後進入 Home,在下方找到 SERVER 區塊與 Add Server。先確認手邊資料的類型:可用來更新一組伺服器的完整網址是訂閱連結;包含協定、伺服器位址、連接埠與驗證參數的一組欄位,則用於手動新增。兩種資料不能只因「都是一段文字」就互換;匯入失敗時應先確認類型,不要反覆儲存。

已有訂閱:選擇 Subscribe

點按 Add Server,進入新增頁面後點按 Type,選擇 Subscribe。在對應的網址欄貼上自己的完整訂閱連結;若有備註欄位,可填入方便辨識的名稱。貼上後檢查開頭與結尾是否完整,尤其留意從通訊軟體複製時可能附帶的空格、換行或說明文字。網址中的參數可能用於身分驗證,請勿自行刪除,也不要將完整網址公開分享。

儲存後返回 Home,等候訂閱內容載入,再確認 SERVER 下方是否出現相應的分組與伺服器項目。只儲存訂閱名稱,不代表已成功取得內容。若清單仍是空的,先確認目前網路能否連上訂閱網址,再檢查網址是否有效;需要更新時,從該訂閱項目的操作選單執行即可,不必重複建立多個同名訂閱。

已有伺服器資料:依 Type 填寫欄位

手動新增時,在 Add Server 的 Type 中選擇與資料相符的協定,再填寫 Host、Port 及該協定要求的驗證欄位。截圖中的 Password、Method 僅是相應類型的欄位範例;切換協定後欄位也會不同,請以自己的伺服器資料為準。Host 通常只填主機名稱或 IP,不要填入整個網頁網址;逐一確認連接埠與密碼的大小寫及字元。

若取得的是 QR Code,可使用 Scan QR Code;Import from Cloud JSON 僅適用於符合該入口格式的既有資料。儲存後返回 SERVER,確認名稱、類型與位址相符。先保留一個清楚易辨識的測試項目,再進入下一步選擇 Global Routing;不要同時修改協定、訂閱與規則,以免出錯時難以找出原因。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method 與匯入入口
Add Server:先選擇 Type,再填寫對應欄位;匯入訂閱時選擇 Subscribe。

02 / GLOBAL ROUTING · CONFIG

選擇 Global Routing 模式

伺服器決定可用的連線目標;Global Routing 則決定流量的處理方式。

新增完成後返回 Home,點按 Global Routing。首次操作時,請明確區分三種模式:設定檔(Config)、代理(Proxy)、直連(Direct)。它們不是伺服器的協定類型,也不是三份訂閱;同一台伺服器在不同模式下,處理的請求範圍可能不同。

  • 設定檔(Config):依照目前啟用設定檔中的規則選擇處理策略。部分請求可能使用 PROXY,其他請求則可能使用 DIRECT 或 REJECT,實際結果取決於規則條件與順序。
  • 代理(Proxy):讓此模式處理的流量使用所選代理,適合暫時確認問題是否與分流規則有關;但不代表所有系統請求都必定經過同一條連線。
  • 直連(Direct):用於直接連線。即使連線開關已開啟,選擇 Direct 也不代表正在透過所選伺服器轉送請求。

準備使用規則分流時,先進入底部的 Config,確認目前啟用的設定檔,再開啟並檢查其中規則。伺服器訂閱與設定檔的用途不同:訂閱主要用來管理伺服器資料,設定檔則包含通用參數、規則與相關設定。成功匯入訂閱,不代表已啟用符合需求的分流設定檔。

官方截圖中的設定檔編輯頁分為 General、Rule、Hosts、URL Rewrite 等區塊,Add Rule 可用來新增規則。首次連線不必逐一修改這些區塊,也不需要為基本連線啟用 HTTPS Decryption。可先保留既有設定;需要編輯時,先儲存副本,避免排查問題時直接改動長期使用的設定。

檢查 Rule 時,請特別留意具體條件是否排在較廣泛的條件之前,以及末尾的 FINAL 指向哪種策略。PROXY 代表透過代理處理,DIRECT 代表直接連線,REJECT 代表拒絕;若規則引用自訂策略名稱,也要確認該策略確實存在。詳細語法與比對順序請參考規則與設定參考;此處先完成模式選擇,不深入重寫整份設定。

若暫時無法判斷既有規則,可先記下目前模式,短暫選擇 Proxy 測試連線;確認伺服器正常後,再切回 Config 檢查規則。如此可分辨「伺服器本身連線失敗」與「規則將請求導向不同策略」。選擇完成後返回 Home,再開啟連線開關。

Shadowrocket Config 官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:確認目前啟用的設定檔與 Rule;Global Routing 模式請在 Home 選擇。

03 / HOME · VPN

選取伺服器並開啟連線

先確認目前的選擇,再依系統提示授權 VPN 設定。

返回 Home,在 SERVER 區塊點按要使用的伺服器,確認選取標示位於正確項目上。若剛更新訂閱,請重新確認目前的選擇,因為清單名稱、順序或可用項目可能已有變動。接著確認 Global Routing 仍是上一步選定的模式,避免在 Direct 下誤以為正在測試代理連線。

點按頂端 Not Connected 旁的連線開關。首次連線時,系統可能會跳出新增 VPN 設定的確認視窗;確認提示內容後允許新增,並依裝置要求完成密碼或生物辨識驗證。此步驟是在系統中登錄網路連線設定,不是匯入訂閱,也不會取代伺服器驗證。若先前取消授權,請返回 Home 再次嘗試連線,並留意是否仍有系統提示待處理。

完成授權後返回 Shadowrocket,確認頂端連線狀態與開關是否維持開啟。iPad 與 iPhone 的版面寬度及系統狀態標示可能不同,但檢查順序相同:已選取伺服器、已確認 Global Routing、已完成系統授權、App 狀態已變更。不要只憑狀態列是否出現 VPN 字樣判斷失敗;不同裝置與顯示位置可能影響標示是否可見。

若開關立即恢復關閉,先處理系統授權或連線啟動問題,不要急著修改所有規則。若開關能維持開啟,請繼續測試實際請求。連線狀態只代表網路設定已啟動,無法單獨證明伺服器驗證、目標網站瀏覽、DNS 與分流結果都正常。

Shadowrocket Home 官方截圖,頂端顯示 Not Connected、Global Routing 與 Connectivity Test,下方為 SERVER 與 Add Server
Home:依序選取 SERVER、確認 Global Routing,再開啟頂端開關。

04 / CONNECTIVITY TEST · DATA

確認連線與分流是否正常

開啟連線後,先在 Home 執行 Connectivity Test,查看所選伺服器的測試結果。測試成功表示相應的測試方法已收到回應;測試失敗則代表需要進一步檢查,但兩者都不能取代實際瀏覽。不同測試方法使用的目標與連線路徑不同,延遲數字也不能代表所有 App 的速度;不要為了追求較低數值而頻繁更改目前設定。

接著開啟 Safari,瀏覽原本預計使用的頁面,等待完整載入一次。若頁面先前已開啟,可重新整理或開啟新頁面,減少快取造成的影響。先測試一個目標,再測試另一個用途不同的目標;記下「已建立連線但頁面載入緩慢」、「某個頁面無法開啟」或「所有頁面都無法開啟」等具體狀況,比籠統地說「不能用」更有助於找出問題。

透過 Data 確認實際處理路徑

需要確認 Config 分流時,返回 Shadowrocket 的 Data 查看相關請求記錄;在目前的記錄功能可用時,依據請求網域、命中規則與目標策略判斷實際路徑。若預期透過代理的請求命中 DIRECT,應檢查規則與 Global Routing,而不是先更換伺服器。若請求已導向 PROXY 仍然失敗,則進一步檢查伺服器參數、目標服務與目前網路。

每次只變更一個條件。例如,維持相同伺服器與網路,比較 Config 和 Proxy;或維持模式不變,只將 Wi-Fi 切換至另一個可用網路。每次調整後重新送出請求並記錄結果。如此取得的資料才可供比較,不會因多項設定同時變動而只得到偶然成功的結果。

確認結果後,請恢復預計長期使用的 Global Routing 模式。之後若需要自動連線,再另外設定 On Demand;先完成手動連線的完整測試,才能分辨自動觸發條件與伺服器連線本身的問題。

05 / SETTINGS · DIAGNOSTICS

依問題發生的位置檢查設定

保留可重現問題的條件,逐層檢查,不要以反覆重新安裝取代問題排查。

匯入失敗或 SERVER 清單為空

先返回 Add Server 確認 Type。訂閱連結應選擇 Subscribe,單台伺服器資料則應依相應協定填寫。確認完整網址未被截斷、目前網路能取得內容,並檢查既有服務是否仍在有效期內。若訂閱網址可以連線但沒有項目,請確認回傳內容確實是相容的訂閱資料;登入頁面、提示文字或錯誤頁面不能只因「開得出來」就視為有效訂閱。

開關無法維持開啟

確認是否已完成系統 VPN 設定授權,以及目前是否有其他 VPN 連線正在使用。先中斷其他正在使用的 VPN 連線,再返回 Home 重試;若裝置受管理政策限制,無法新增 VPN 設定,請向裝置管理人員確認。不要一開始就刪除既有設定;刪除前請確認仍保有訂閱與伺服器資料,以免遺失必要資訊。

開關已開啟,但測試或瀏覽失敗

先確認所選伺服器的 Host、Port、協定與驗證欄位。使用訂閱時可更新一次,再確認目前選取的項目。在 Settings 查看 Test Method,了解目前的測試方法後再解讀 Connectivity Test 結果。若某種測試失敗,但實際頁面可以瀏覽,應先確認測試目標與方法,不要將單一測試結果直接視為整體連線失敗。

若在 Proxy 下可以瀏覽、切換至 Config 後失敗,請優先檢查目前設定檔的 Rule、FINAL 與策略引用。若兩種模式都失敗,在維持伺服器與模式不變的情況下,改用另一個可用網路測試,以分辨網路環境與伺服器問題。若只有特定目標無法瀏覽,也要考慮目標服務本身的狀態;反覆更新訂閱無法解決所有瀏覽問題。

檢查 On Demand 與 Diagnostics

On Demand 可依條件觸發連線。首次排查時,可先記下原有設定,再暫時關閉並使用手動開關重現問題;否則自動重新連線可能讓「剛關閉又開啟」的情況干擾判斷。手動連線穩定後,再恢復設定並逐一驗證觸發條件。Settings 中的 Proxy、TCP、UDP 等選項也應依實際需求調整,不要只因看到欄位就全部變更。

若需要進一步找出問題,可使用 Diagnostics 查看診斷資訊,記錄問題發生的步驟、使用的網路、所選 Global Routing 模式,以及測試與網頁瀏覽各自的結果。分享記錄或截圖前,請遮蔽完整訂閱網址、密碼、驗證參數及可辨識個人身分的資訊;只保留重現問題所需的欄位與錯誤描述。

問題仍未解決時,請前往常見問題與故障排除依症狀繼續檢查;需要了解設定區段、規則優先順序與策略含義時,請參閱規則與設定參考。日常維護時,請更新自己已有的訂閱;App 更新則透過 App Store 進行,兩者是不同操作。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:排查問題時優先確認 Test Method、On Demand 與 Diagnostics;其他選項應有依據再調整。