官方手冊 · 入門操作

Shadowrocket
匯入與連線教學

先新增現有資訊,再選擇 Global Routing;連線後以實際請求驗證,不要只看開關狀態。

Add Server Global Routing Connectivity Test

本次操作流程

  1. 新增Add Server
  2. 選擇模式Global Routing
  3. 連線與驗證Home → Connectivity Test

適用於 iPhone / iPad。截圖供核對頁面位置,實際欄位請以 App 內顯示為準。

準備 SERVER 記錄

Add Server:新增伺服器或匯入訂閱

開啟 Shadowrocket 後進入 Home,找到下方 SERVER 分組中的 Add Server,點選進入新增頁面。先確認手上的資料類型:服務商提供、用來取得伺服器清單的完整連結,通常應以訂閱方式匯入;若資料包含位址、連接埠、密碼及協定參數,則應新增單台伺服器。兩種方式擇一即可,請勿將訂閱網址填入伺服器的 Host 欄位。

已有訂閱連結:先選擇 Subscribe

在 Add Server 中點選 Type,選擇 Subscribe,再將完整訂閱連結貼到對應的 URL 欄位。儲存前確認連結首尾與查詢參數完整,並留意複製時是否多了空格、換行或全形標點。訂閱連結可能包含存取憑證,請只在自己的裝置上使用,勿將完整連結貼到公開截圖或討論中。

儲存後返回 Home,確認訂閱是否已取得伺服器項目。若只看到訂閱記錄,卻沒有可選擇的伺服器,請先確認是否需要更新訂閱,以及更新時是否出現錯誤,不要立即反覆開啟連線開關。訂閱名稱只是辨識標籤,改名無法修復連結;能否取得內容取決於網址、服務狀態與目前網路。

已有伺服器資訊:依協定逐項填寫

若取得的是單台伺服器參數,請在 Type 中選擇與資料相符的協定,再填寫對應欄位。官方截圖中的 Host / Port / Password / Method 可供核對欄位位置;不同 Type 的參數不盡相同,請勿將某種協定的欄位直接套用到另一種協定。Host 通常填寫主機名稱或位址,不要自行加上網頁路徑;Port、Password 與 Method 請逐項對照原始資料。

已有 QR Code 時,可使用 Scan QR Code;匯入後仍須確認協定與欄位。Import from Cloud JSON 是另一種匯入方式,與 Subscribe 不同;只有資料明確適用時才使用。儲存完成並在 SERVER 中看到記錄後,再進行下一步。訂閱、伺服器與設定檔之間的差異,請參閱術語表;首次連線不必同時熟悉所有協定參數。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method 與底部的匯入入口
Add Server:先確認 Type,再填寫對應欄位。圖中欄位供位置核對;選擇 Subscribe 後的頁面請以 App 內顯示為準。

繼續前請確認:Home 的 SERVER 分組中已出現可選擇的伺服器,而不只是尚未取得內容的訂閱名稱。

確認請求處理方式

Global Routing:Config、Proxy 與 Direct

新增伺服器後返回 Home,點選 Global Routing 查看目前模式。此處用來決定如何處理請求,不負責新增伺服器,也不會補上缺少的伺服器參數。首次設定前,先確認要驗證的是現有伺服器能否運作,還是設定檔是否依規則分流。目標不同,檢查結果的方式也不同。

Config:依目前設定檔處理請求

Config 會依目前啟用的設定檔決定請求處理方式。進入 Config,確認目前使用的檔案,再開啟查看內容。官方截圖中的 General / Rule / Hosts / URL Rewrite / HTTPS Decryption 是設定編輯器中的不同區段,入門時不必逐一修改。此時請著重查看 Rule 中的規則及其順序,確認設定檔來源與用途;不要為了完成首次連線而任意啟用其他功能。

規則通常依序比對,前面的規則可能先決定請求走 DIRECT 或 PROXY;最後的 FINAL 則處理未符合前面規則的請求。因此,選擇 Config 不代表所有請求都會經過所選伺服器。伺服器訂閱與設定檔也是兩種不同資料:透過 Subscribe 匯入伺服器清單,不代表已切換至相應的規則設定檔。

Proxy 與 Direct:用於明確比對

Proxy 會透過所選伺服器處理請求,可在排查時暫作對照,協助判斷問題來自伺服器還是設定規則;但無法修正錯誤的位址、密碼或協定設定。Direct 則是直接連線,不要因為此模式下網頁能開啟,就認定伺服器已驗證成功。切換模式後返回 Home,確認 Global Routing 顯示的選項符合預期。

若暫時不確定設定規則的用途,請保留原始檔案作為對照,每次只修改一個條件。不要同時更換設定檔、編輯規則並切換伺服器,否則發生問題時難以判斷原因。規則關鍵字的說明請參閱術語表;模式選擇與流量分流的常見疑問,請參閱常見問題。確認模式後,再完成系統授權並連線。

Shadowrocket Config 官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:截圖呈現設定檔編輯區段。Global Routing 模式需在 Home 選擇,不是在這些區段中切換。

繼續前請確認:能辨別目前使用的是 Config、Proxy 還是 Direct,並清楚知道這次要驗證伺服器或規則。

完成選擇並進行系統授權

Home:開啟連線開關

返回 Home,在 SERVER 分組中點選要使用的伺服器,確認目前選取的項目,而不只是查看訂閱分組名稱。接著再次確認 Global Routing。這兩項設定應一起核對:伺服器決定 Proxy 請求使用的連線資訊,Global Routing 則決定請求的處理方式。清單中若有多個項目,請以實際選取狀態為準,不要只依排列位置判斷。

點選 Home 上方的開關開始連線。官方截圖中的 Not Connected 表示截圖拍攝時尚未連線,僅供辨識開關位置,並非要求維持此狀態。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定。請先閱讀提示,確認操作由目前的 App 發起,再依系統指示完成授權;若系統要求裝置驗證,請直接在系統介面操作,不要將裝置密碼填入伺服器欄位。

完成授權後返回 Shadowrocket,確認上方開關與連線狀態是否維持正常。若剛開啟就立即關閉,請先處理授權、設定或連線錯誤,不要繼續修改規則。若先前在系統提示中取消授權,再次連線時請留意提示是否重新出現。若系統設定中已有其他 VPN 設定,也請確認目前實際啟用的是要測試的設定,避免將其他連線的狀態誤認為測試結果。

連線開關保持開啟,只能表示連線流程已進行到相應狀態,不能單獨證明伺服器能處理所有目標請求。連線後立即進行下一步,使用 Connectivity Test 與實際瀏覽結果檢查。此時請維持相同網路、伺服器與模式,不要立刻反覆切換多項設定,以保留可比較的基準。

Shadowrocket Home 官方截圖,上方為 Not Connected 開關,下方顯示 Global Routing、Connectivity Test、SERVER 與 Add Server
Home:連線前依序確認 SERVER 選擇與 Global Routing,再操作上方開關;連線後使用 Connectivity Test。

繼續前請確認:已完成系統授權,且返回 Home 後連線狀態沒有立即恢復原狀,再開始測試。

分開檢查開關狀態與實際結果

Connectivity Test:確認連線是否生效

在 Home 點選 Connectivity Test,等待測試完成並查看結果。測試只能提供目前條件下的連線線索,不保證所有網站與協定請求都能正常運作。伺服器清單中的延遲測試也與實際目標連線不同:測試有回應,不代表驗證參數一定正確;測試逾時時,也須一併考量測試方式、目前網路與伺服器狀態。

接著開啟實際要使用的 App 或頁面,重新發出請求。請盡量選擇明確且可重複的操作,例如重新載入同一頁面,而非只查看已快取的內容。觀察頁面是否完整載入,是否只有文字顯示而圖片或後續請求失敗。記錄「哪個目標、執行什麼操作、出現什麼結果」,比只寫「可以用」或「不能用」更有助於後續排查。

若使用 Config,請搭配 App 內可查看的請求記錄,確認目標請求符合哪條規則及其策略。符合 DIRECT 的請求會直接連線;符合 PROXY 的請求則會使用相應的代理策略。部分請求走直連,不代表設定檔失效。Data 中的流量變化可協助觀察是否有資料傳輸,但僅憑流量增加,無法證明指定目標符合預期規則。

若要進一步判斷,請維持相同伺服器與目標,只將 Global Routing 從 Config 切換至 Proxy 後重新測試。若 Proxy 正常、Config 異常,請優先檢查設定檔與規則;若兩者都失敗,請先檢查伺服器參數與網路狀況。比對完成後,請恢復原本需要的模式,避免將臨時排錯設定留作日常設定。

第一次驗證成功後,可切換至另一個日常使用的網路環境,再次檢查連線與目標瀏覽結果。請分別記錄切換網路前後的結果,不要將單次成功視為所有環境都相同。只要「已選伺服器、目前模式、測試結果、實際瀏覽」四項能互相對應,就完成本頁的基本驗證;若要深入判斷流量分流,請參閱規則分流常見問題。

完成標準:不只確認開關已開啟,也能重現目標瀏覽結果,並說明目前請求為何使用 DIRECT 或 PROXY。

每次只檢查一項條件

Settings:常見問題排查順序

若前面的步驟失敗,請先確認問題發生在哪個階段:訂閱沒有取得項目、已有項目卻無法連線、開關已開啟但測試失敗,或只有部分目標異常。不同階段需要查看的項目也不同。請先保留目前的設定與錯誤資訊,不要以反覆刪除、重新安裝或同時修改多項參數取代問題定位。以下依序從資料完整性開始,再檢查連線與設定。

  1. 訂閱匯入失敗:返回該訂閱,確認連結是否完整、存取憑證是否仍有效,以及目前網路能否取得訂閱內容。若連結可正常存取卻沒有伺服器,還須確認回傳內容是否為 App 可辨識的訂閱格式。不要把含有錯誤訊息的網頁內容當成匯入成功;服務是否有效,請向你使用的服務商確認。
  2. 單台伺服器無法連線:重新開啟該項目的編輯頁面,逐項比對 Type、Host、Port,以及該協定要求的驗證、加密與傳輸參數。名稱相似的協定也不能互換。不要為了嘗試而隨意更改 Method 或其他欄位;先確認資料與輸入內容一致,再測試同一筆記錄。
  3. 測試與實際瀏覽結果不一致:在 Settings 中確認 Test Method,並記下本次使用的測試方式。測試方式不同,結果代表的意義也不同,請在相同條件下比較。接著返回 Home 確認實際選取的伺服器與 Global Routing,排除測試一筆記錄、實際使用另一筆記錄的情況。
  4. 連線立即中斷或反覆啟動:確認系統授權已完成,並在 Settings 查看 On Demand 是否設定了觸發條件。排查手動連線時,先確認這些條件是否影響目前狀態;不要將條件觸發後重新連線,誤認為上方開關沒有反應。也請確認裝置系統時間正確,必要時依系統提供的自動設定方式校時。
  5. 僅特定網路或目標失敗:保持伺服器與設定檔不變,改用另一個自己可使用的網路測試相同目標。若問題只隨網路變化,請優先記錄網路差異;若只在某台伺服器發生,請優先檢查該項目。必要時使用 Diagnostics 收集線索,不要立即修改與問題無關的 TCP、UDP 等設定。

整理診斷資訊時,只保留描述問題所需的欄位名稱、錯誤現象與操作順序。分享前請遮蔽完整訂閱連結、密碼及其他驗證資料。若需要進一步求助,請說明失敗階段、目前模式、網路環境、測試方式與已完成的單項比對,通常比提供一張缺少情境說明的截圖更有幫助。

完成一項修正後,依「連線 → Connectivity Test → 實際瀏覽」的順序重新驗證;只有結果改變,才繼續判斷該項是否相關。若仍無法定位,請到常見問題依現象查找;若不熟悉 Settings 或協定欄位,請先參閱術語表。若問題發生在 App Store 購買、App 顯示或已購項目重新下載階段,請返回取得指南,無須繼續調整連線參數。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:排錯時先確認 Test Method 與 On Demand;Diagnostics 可用來取得進一步線索,不必逐一修改所有設定。

結束前請再次確認:恢復暫時切換的 Global Routing,保留已驗證可用的伺服器與設定檔,並確認實際目標仍能依預期瀏覽。