官方手冊 · 首次連線

Shadowrocket 使用教學

從既有訂閱或伺服器資訊開始,依序完成匯入、選擇 Global Routing、開啟連線、驗證存取與找出問題。首次操作可預留約十分鐘;遇到錯誤時,停在對應步驟核對,不必從頭重設。

操作前請保留原始訂閱或參數。訂閱連結通常含有身分憑證,請勿公開貼上,也不要使用包含完整連結的截圖尋求協助。

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

開啟 Shadowrocket,進入 Home,先分辨手邊資訊的類型。訂閱連結通常可回傳多筆伺服器記錄;手動參數則包含協定、伺服器位址、連接埠與驗證欄位。兩者不是相同的輸入內容:不要將整條訂閱連結填入伺服器位址,也不要把管理帳戶的網頁位址當成訂閱 URL。

使用 Subscribe 匯入既有訂閱

在 Home 點選右上角的新增按鈕,進入 Add Server。點開 Type,選擇 Subscribe,再將從自己的服務商取得的完整訂閱連結填入 URL。可在備註中填寫方便自己辨識的名稱,例如「個人訂閱」,接著點選右上角的完成按鈕儲存。複製連結時請檢查前後空格、換行與截斷情形;連結中的查詢參數屬於位址的一部分,請勿為了縮短顯示而刪除。

儲存後返回 Home,等待訂閱內容載入。確認訂閱群組下方出現伺服器項目,不要只看到一個名稱就認為匯入完成。如果目前介面提供訂閱更新操作,可手動更新一次並查看是否回傳錯誤。匯入失敗時,先保留提示文字,再檢查連結是否仍有效、回傳內容是否為用戶端可識別的訂閱格式;一般網頁、登入頁面或錯誤頁面都不能當作有效的伺服器清單。

使用 Add Server 手動填寫參數

如果已有的是單一伺服器參數,同樣從 Home 的新增按鈕進入 Add Server,但在 Type 中選擇對應參數的協定。依原始資訊逐項填寫位址、連接埠與驗證內容;不同協定可能使用密碼或 UUID 等不同欄位。若涉及 TLS、Server Name、傳輸方式或路徑,也要與原始參數一致。介面未要求的欄位不必憑經驗補齊,也不能只因兩種協定都能填寫位址與連接埠就互相替換。

儲存後返回 Home,點選準備使用的伺服器,確認選取標記已出現在該項目上。首次測試盡量固定使用一台伺服器,避免一邊切換項目、一邊修改設定。清單中出現伺服器只代表資訊已儲存,不代表遠端一定可連線,也不代表帳戶仍有效。若不清楚協定欄位,請先閱讀概念速查,再向自己的服務商確認參數含義。

本步完成標準:Home 中看得到實際伺服器項目,且已明確選取一項。接著先選擇流量處理方式,再開啟連線開關。

02 · Global Routing:選擇流量處理模式

在 Home 找到 Global Routing 並開啟。這裡決定連線採用哪一種整體處理方式,不是訂閱更新按鈕,也不是伺服器選擇器。本文將三種模式寫作設定(Config) / 代理(Proxy) / 直連(Direct)。選對伺服器後,仍需確認這個選項;否則即使已開啟開關,也可能得到與預期不同的存取結果。

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

日常需要依規則處理請求時,選擇 Config,再前往 Config 頁面確認目前使用的是哪一份設定。設定檔中的規則會決定哪些請求使用 PROXY、DIRECT 或 REJECT 等策略。匯入訂閱與設定規則是兩件事:伺服器清單更新成功,不代表已安裝某份規則檔。請勿為了讓頁面「看起來完整」而匯入來源不明的遠端設定;使用既有設定前應先確認用途。

Config 下的異常需配合具體目標判斷。例如某個網域依規則走 DIRECT,但你預期它經過所選伺服器,這屬於規則或策略選擇問題,不一定是伺服器無法使用。初次使用只需了解「目前使用哪份設定、目前目標應採用哪種策略」,暫時不必改寫完整規則。匹配順序與策略參照可在使用手冊中繼續閱讀。

代理(Proxy):對照檢查代理路徑

Proxy 可用來減少規則分流帶來的變數,檢查目前代理路徑是否能完成目標請求。如果 Proxy 下可以存取目標,而 Config 下無法存取,應優先檢查目前設定中的規則與策略,而非立即刪除訂閱。Proxy 的測試結果仍取決於伺服器狀態、服務權限、目標網站與網路條件,不能將切換模式當成解決所有問題的方法。

直連(Direct):對照檢查原有網路

Direct 會讓請求採用直連方式,可用來比較原有網路能否存取相同目標。選擇 Direct 後仍顯示連線狀態,不代表請求正經過代理伺服器。完成對照測試後,請切回實際需要的模式。為避免後續判斷混亂,先記下目前伺服器與 Global Routing 的組合,再進行下一步。

03 · Home:開啟連線並確認系統權限

返回 Home,再次檢查所選伺服器與 Global Routing,接著開啟頂端的連線開關。首次使用時,系統可能會要求允許新增 VPN 設定。閱讀系統提示,確認正在為 Shadowrocket 新增設定,再由裝置持有人透過裝置密碼或系統提供的驗證方式完成授權。請勿將伺服器密碼或訂閱中的驗證資訊填入裝置解鎖提示。

完成授權後返回 Shadowrocket,查看開關與連線狀態是否維持。不同系統顯示 VPN 狀態的位置可能不同,因此請同時依據 App 狀態與後續實際存取結果判斷,不必只看狀態列圖示。系統需求與相容範圍以 App Store 頁面標示為準;若介面入口與本文所述位置略有不同,請先核對英文項目名稱,再進行操作。

如果開關立即回落或出現錯誤提示,先記下原文。返回系統設定,檢查是否有待處理的 VPN 授權,或裝置是否受組織管理政策限制。若已有其他 VPN 連線,請先中斷其他連線,再單獨測試 Shadowrocket,以免多個連線條件影響判斷。受管理的裝置應遵循管理要求,請勿透過刪除管理設定嘗試解決問題。

此時不建議同時啟用或修改 On Demand。先建立一次可手動重複的連線,再考慮日常的條件式連線設定。On Demand 影響何時連線,Global Routing 則影響連線後如何處理請求,兩者解決的問題不同。分開設定,能在連線失敗時更快找出原因。

本步完成標準:完成系統授權後,Home 的連線狀態能維持,且沒有持續出現錯誤。這只表示連線流程已啟動;伺服器能否處理請求、規則是否符合預期,還需要在下一步驗證。

04 · Connectivity Test:驗證連線與實際存取

先在 Home 使用 Connectivity Test,查看所選伺服器是否有測試結果。測試失敗時可以重新執行一次,以排除短暫波動,但不要快速連續切換所有設定。測試回傳的耗時只描述當下測試目標與測試方式的結果,不等同於網頁載入速度或檔案傳輸速度,也不能證明所有 App 都已依規則運作。

接著開啟瀏覽器,存取自己原本需要使用的特定目標,完成一次實際操作,例如開啟頁面並進入內頁。只看到先前快取的首頁不足以確認連線有效;可以重新整理頁面,或使用新的瀏覽器分頁重試。如果瀏覽器可以使用,但某個 App 無法使用,應分別檢查該 App 的目標網域、帳戶狀態與錯誤提示,不能直接推斷整個連線失效。

使用相同目標進行模式對照

結果不明確時,保持伺服器不變,依序使用 Direct、Proxy、Config 對相同目標進行比較。每次切換後重新送出請求,必要時關閉舊頁面再開啟,避免沿用既有連線影響判斷。若 Direct 原本就能存取該目標,僅憑「開啟成功」不能證明代理路徑已生效;Proxy 成功但 Config 失敗時,則更應檢查目前設定。

在 App 提供的請求記錄中找到剛才送出的目標,核對採用的策略與命中規則。看到 DIRECT 時,請判斷這是否符合設定要求;看到 REJECT 時,檢查是否有規則主動拒絕該目標;看到 PROXY 但仍失敗,則繼續核對所選伺服器、遠端回應與目標本身的狀態。記錄只能說明實際發生的情況,不應將所有 DIRECT 都視為錯誤。

Data 中的流量變化可作為輔助觀察,但流量增加可能來自背景請求,不能單獨作為目標存取成功的證據。完整驗證應同時包含:連線狀態維持、實際目標請求完成、處理策略符合預期。確認這三項後,再恢復日常需要的 Config,並保留目前可用的設定,作為後續排查的參照。

05 · 常見問題:依發生階段檢查

排查時先確認「卡在哪個步驟」,再調整對應設定。每次只修改一個條件,並重新測試相同目標。直接重新安裝可能會遺失尚未備份的資訊,也會抹除有用的現場狀況;通常應先記錄錯誤、檢查參數與目前設定,再決定是否需要重新匯入。

已儲存訂閱,但沒有伺服器

返回訂閱項目檢查 URL 是否完整、是否複製到管理網頁而不是訂閱位址,以及連結是否已過期或遭伺服器重設。執行更新後,分辨錯誤發生在下載內容之前,還是在解析內容時。前者優先檢查目前網路與連結是否可連線,後者優先核對訂閱格式。需要服務商協助時,只需提供錯誤文字與發生階段,請勿公開完整 URL。

伺服器已存在,但測試逾時

先關閉連線,確認裝置原有的 Wi-Fi 或行動網路能正常連線;需要網頁登入的網路,應先完成登入。接著核對位址、連接埠、協定、驗證及 TLS 相關欄位,確認手動輸入沒有遺漏。如果既有訂閱中有其他已知可用的項目,可在不修改規則的情況下改用另一項測試,以區分單一伺服器問題與本機網路問題。測試逾時本身無法判定是哪個項目出錯。

Proxy 可以存取,Config 不符合預期

檢查 Config 頁面目前實際使用的檔案,不要只看檔案清單中是否有某個名稱。再根據剛才的請求記錄查看命中規則與策略,確認是否有更前面的規則先匹配到目標。修改前先備份;不確定時,請勿一次替換整批 DNS、規則與策略設定。關於 DOMAIN-SUFFIX、IP-CIDR 和 FINAL 的詳細邏輯,請前往使用手冊按章節閱讀。

連線後部分目標失敗,或切換網路後中斷

記下問題發生於 Wi-Fi、行動網路或兩者皆有,並在每次切換後重新建立連線、重新送出目標請求。只有部分目標失敗時,請分別檢查目標本身的狀態、規則處理方式與 DNS 相關錯誤;不要只憑一次逾時就修改所有 DNS 設定。如果使用 On Demand,請先切回手動連線測試,確認基本路徑可用後再逐項恢復連線條件。

仍無法找出原因時,整理四項資訊:所選伺服器類型、Global Routing 模式、失敗目標與錯誤原文、已進行的單項比較。分享前請隱藏訂閱 URL、密碼、UUID 和私人伺服器位址。更多權限、帳戶與連線問題請見FAQ;介面詞彙的含義請見概念速查。

確認連線後:保留可用設定

完成首次驗證後,記下目前選取的 Config 與伺服器,並依自己的維護方式備份設定。之後更新訂閱、修改規則或調整 On Demand 時,請先儲存原有設定,再逐項測試。更新訂閱可能會變更清單項目,更新後應重新確認所選伺服器,不要只憑名稱相近就認為仍是原本的連線。

本文完成的是一次可驗證的手動連線。準備繼續設定時,請前往Shadowrocket 使用手冊,依需求閱讀 Config、On Demand、Data 與日常維護章節。

Shadowrocket 全平台下載