官方手冊 · 操作入門
Shadowrocket 使用教學
訂閱匯入與連線驗證
先正確匯入現有資訊,再選擇路由模式並連線。依照以下五個步驟逐項確認結果;發生異常時,回到對應步驟檢查,不要同時變更多項設定。
步驟 01 · 先取得可選項目
Add Server:新增伺服器或匯入訂閱
開啟 Shadowrocket,停留在 Home。此時先不要開啟頂端的連線開關,請在頁面下方找到 Add Server。準備的資訊通常分為兩類:一類是單一伺服器的位址、連接埠及驗證參數,另一類是可回傳伺服器清單的訂閱連結。兩種資訊的填寫方式不同,不能將整段訂閱連結填入 Host,也不能只靠伺服器位址推斷其他參數。
已有單一伺服器資訊
點選 Add Server,先確認 Type,再填寫該類型要求的欄位。截圖中的 Host、Port、Password、Method 是該類型下的欄位範例;切換 Type 後顯示的內容可能有所不同。Host 填寫伺服器網域或位址,Port 填寫對方提供的連接埠;Password 與 Method 必須和現有資料完全一致。若有其他驗證、傳輸或 TLS 相關選項,請依原始參數填寫,不要將截圖中的預設值當成自己的連線參數。
如果取得的是 QR Code,可以使用頁面中的 Scan QR Code 讀取自己的伺服器資訊。讀取成功後仍須檢查 Type、Host 和 Port,再進行儲存。Import from Cloud JSON 用於匯入相應格式的資料,不是任何網頁或訂閱網址的通用入口。無法確認資料格式時,請先核對資訊說明,避免反覆嘗試不同入口而產生重複項目。
已有訂閱連結
若要匯入訂閱,請在 Add Server 的 Type 中選擇 Subscribe,找到 URL 輸入欄位,貼上完整的個人訂閱連結並儲存。複製時特別注意連結開頭、結尾及參數是否完整,避免混入換行、空格或說明文字。訂閱可能包含個人存取憑證,請勿將完整連結貼到公開頁面,也不要為了尋求協助而展示包含憑證的 QR Code。
儲存後回到 Home,等待清單載入;需要更新時,請對相應訂閱執行更新操作。只有出現可選的伺服器項目,才表示這個步驟已成功取得清單。訂閱名稱顯示在頁面上,不代表連結已回傳有效資料。若更新失敗,請先確認連結仍有效、目前網路可以連線至訂閱網址,並檢查是否回傳登入頁面或錯誤訊息;不要直接將匯入失敗判定為連線協定不相容。
本步驟完成標準:Home 的 SERVER 區域出現自己的伺服器,開啟項目後可確認預期的類型與位址。請暫時保留原始訂閱或參數,後續排錯時可用來比對,不必在此批次修改所有項目。
步驟 02 · 確認如何處理請求
Global Routing:選擇設定、代理或直連
清單準備完成後,回到 Home 開啟 Global Routing。這裡用來決定整體路由模式,不是新增伺服器的入口。三種模式分別是設定(Config)、代理(Proxy)、直連(Direct)。先了解其差異,再選擇適合本次驗證的模式,避免伺服器已正確新增,卻因路由模式與預期不一致而誤判。
設定(Config):依目前檔案中的規則處理
選擇設定(Config)後,請求會依目前設定檔中的規則處理,部分請求可能使用 PROXY,其他請求則可能使用 DIRECT。進入 Config,確認目前實際選取的檔案,再查看 Rule。設定檔中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 各有不同用途;初次使用只需確認選取的檔案和規則,不必為了連線而逐一修改所有區段。
訂閱和設定檔是不同類型的內容:訂閱通常用來提供伺服器清單,設定檔則用來描述分流等行為。匯入訂閱並不代表已選取適合自己的規則檔。同樣地,看到 Config 中有檔案,也不能證明其中引用的策略在目前環境下都有效。開始使用時請選擇自己了解的設定,修改前保留原始檔案,以便還原。
代理(Proxy)與直連(Direct):明確確認目前路徑
排查時可選擇代理(Proxy),觀察請求是否能透過選取的代理伺服器處理;直連(Direct)則用來觀察直接存取的結果。兩者不能簡單理解為「更快」或「更穩定」的模式,實際結果取決於目前網路、伺服器和存取目標。Global Routing 也不應視為所有系統流量路徑的絕對證明,最終仍須依實際請求判斷。
若已有明確的規則檔,日常使用可選擇設定(Config);若暫時只想區分伺服器連線問題與規則問題,可短暫切換到代理(Proxy),對同一目標進行比對測試。測試結束後請還原原本的選擇。一次測試中不要同時更換伺服器、切換模式並修改 DNS,否則即使結果有所改變,也很難判斷是哪項設定造成的。
本步驟完成標準:能說明目前選擇的 Global Routing 模式。若選擇設定(Config),也應知道目前使用哪個設定檔。若要逐條學習規則語法,可繼續閱讀規則關鍵字比對說明;本頁先完成連線流程。
步驟 03 · 建立連線
Home:選擇伺服器,再開啟頂端開關
完成匯入並選擇路由模式後,回到 Home。在 SERVER 區域選取這次要使用的伺服器,確認選取標記確實位於目標項目上。若有多個訂閱分組,請先確認項目所屬分組,避免選到名稱相似但參數不同的舊紀錄。接著再確認一次 Global Routing,確保仍是上一步決定的模式。
現在開啟 Home 頂端的連線開關。首次連線時,系統可能會要求新增 VPN 設定。請確認要求由 Shadowrocket 發起,再依系統提示操作;若系統要求裝置驗證,請直接在系統介面完成。此處需要的是裝置本身的授權,不要將裝置密碼填入伺服器欄位。若先前拒絕過要求,請重新發起連線並查看系統顯示的具體提示。
回到 App 後,觀察頂端狀態是否從 Not Connected 改變,同時留意是否出現錯誤訊息。不要只看開關是否短暫切換到開啟狀態:開關立即回落、持續停留在連線中,或顯示已連線但無法存取,都是不同階段的問題,應分別記錄。系統顯示 VPN 狀態,代表相關連線設定已生效,但不能據此認定所有請求都已依預期經過目標伺服器。
連線時,先暫停其他可能變更系統 VPN 設定的連線工作,維持單純的測試環境。若要切換伺服器,建議先中斷連線,確認已選取新項目後再重新連線,這樣更容易將現象與伺服器對應。首次驗證也可以先不設定 On Demand,待手動開關的結果穩定後,再決定是否啟用自動連線條件。
本步驟完成標準:已選取目標伺服器,頂端連線狀態能保持,且未持續出現授權或連線錯誤。即使狀態正常,仍請繼續下一步進行實際驗證;連線建立與目標頁面可否存取,並不是同一項結論。
步驟 04 · 分別檢查狀態與結果
Connectivity Test:驗證測試結果與實際存取
在 Home 找到 Connectivity Test,執行一次測試並等待結果。這有助於檢查清單中項目的回應情況,但結果會受到所選測試方法、測試目標及目前網路影響。項目有回應,不代表所有網站或 App 都能正常運作;某次測試失敗,也不能立即證明伺服器的所有功能都無法使用。請先記錄現象,再配合實際存取結果判斷。
先確認基本網路,再檢查目標請求
開啟瀏覽器,使用平時可正常瀏覽的頁面確認裝置確實已連上網路。若 Wi-Fi 需要登入或同意使用條款,請先完成網路本身的認證流程。接著在連線狀態下開啟這次要驗證的頁面,等待主要內容載入,不要只確認是否顯示快取標題或舊內容。必要時重新整理頁面,並留意是否只有圖片、登入或某個子頁面失敗。
使用設定(Config)時,同一個頁面可能會產生多個網域請求,各請求可能符合不同規則。因此,不能只因頁面成功開啟就認定所有流量都經過 PROXY,也不能只因某個頁面失敗就判斷用戶端完全沒有連線。若要確認分流情況,請查看 App 中可用的請求紀錄,確認目標、符合的規則和使用的策略,並特別檢查結果是否符合目前 Rule 的預期。
每次只進行一項比對
若結果不明確,請保留相同的目標與伺服器,只變更一項條件。例如,在目前網路下分別觀察直連(Direct)與代理(Proxy)的結果,或維持設定(Config)不變,只替換一個自己已有的伺服器。每次記錄目前模式和實際情況,測試後還原日常設定。避免同時開啟多個頁面、連續點選更新及快速切換開關,這些操作會讓結果混在一起。
本步驟完成標準:能同時確認「連線狀態保持」、「實際目標可存取」、「路由行為符合預期」三件事。若只符合其中一項,請依下一節所述的失敗階段繼續檢查,不必刪除所有設定重新開始。
步驟 05 · 回到最先發生問題的步驟
Settings 與常見問題排查
排錯應從「最早在哪個步驟不符合預期」開始。匯入後沒有伺服器、測試沒有回應、開關無法保持,或連線後只有部分頁面異常,各自需要檢查不同項目。請先回到本教學的對應錨點重新確認,不要直接重設所有設定。Settings 中的 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 是進一步檢查的入口,首次使用時不必逐項變更。
匯入失敗:檢查輸入內容與訂閱回傳資料
若 Home 沒有出現可選項目,請先回到新增與匯入。確認選擇正確的 Type、訂閱 URL 沒有截斷,且伺服器 Port 沒有混入文字。訂閱更新失敗時,確認目前網路能否連線至網址,以及連結是否已失效或需要重新產生。若只有某個項目缺失,請檢查訂閱實際回傳的資料,不要任意切換協定類型來補齊。
測試失敗:確認 Test Method 與伺服器參數
若項目存在但 Connectivity Test 結果異常,請在 Settings 查看 Test Method,了解目前測試的內容。不同方法可能得到不同結果,不要只依一個數值選擇日常使用的伺服器。接著對照原始資訊檢查位址、連接埠、驗證欄位和傳輸設定;欄位多了一個空格或使用舊參數,都可能造成失敗。若涉及 TLS,也請確認裝置日期與時間正確,避免因時間偏差造成憑證驗證失敗。
開關回落:先檢查授權與系統連線狀態
若頂端開關無法保持開啟,請確認系統 VPN 設定要求已完成處理,再檢查是否有其他連線工作正在變更系統設定。暫時關閉 On Demand,手動連線一次,觀察是否仍發生相同現象。若要查看 Diagnostics,請先記下這次失敗的時間與操作,再檢視附近的錯誤訊息;不要將與這次操作無關的舊紀錄當成目前原因。
已連線但部分功能失敗:區分規則、DNS 與伺服器能力
若只有某類目標異常,請先確認 Global Routing,再檢查目前 Config 的規則順序、使用策略和 DNS 設定。保留原始檔案後,可使用同一台伺服器進行一次代理(Proxy)比對:若比對正常但設定(Config)異常,優先檢查規則與相關設定;若兩者皆失敗,再檢查伺服器和目前網路。此方法用於縮小排查範圍,不代表應長期以任何一種模式取代另一種。
只有即時通訊、特定 App 或部分內容異常時,也應依實際用途檢查 TCP、UDP 等相關設定及伺服器支援情況。不要只根據「網頁能開啟」就判定所有傳輸都正常。調整 DNS 時一次只變更一項,並記錄原始值,失敗後再還原。不熟悉的進階選項請先維持原狀,比起同時更換多個參數,這樣更容易找出原因。
本步驟完成標準:能將問題定位在輸入、基本網路、連線授權、伺服器或規則設定中的某個層面,並保留可重現的操作步驟。App Store 取得、帳號與回復購買問題不屬於連線排錯,請參閱正版指南;若已確認問題出在規則順序,可繼續閱讀規則比對說明。