官方手冊 · 功能與設定

Shadowrocket 功能與設定

先確認 Global Routing,再檢查伺服器與 Config。依使用情境調整 On Demand、DNS 和測試方式,並透過 Data 與 Diagnostics 驗證結果。

  • Global Routing:Config / Proxy / Direct
  • 規則依序比對
  • 一次只變更一項設定

Global Routing:Config、Proxy 與 Direct

Global Routing 決定目前連線採用的路由方式。在 Home 開啟 Global Routing,可選擇 Config、Proxy 或 Direct。這項設定控制整體處理方式,並非伺服器協定或連線品質等級。更換伺服器後,仍應另外確認此處的選擇。

日常需要依網域或 IP 分流時,先在 Config 確認已選取的設定檔,再使用 Config。若要暫時判斷問題是否出在規則,可短暫切換至 Proxy 或 Direct,針對同一目標重複測試。測試完成後,請恢復原本模式,避免將暫時的排查設定留作日常使用。

模式 處理方式 適用時機 檢查項目
設定檔 · Config 依照目前 Config 的規則與策略處理連線。 日常依目標分流,或確認特定規則是否生效。 目前使用的 Config、規則順序,以及規則指定的策略。
代理 · Proxy 將由用戶端處理的連線交由目前選取的代理處理。 暫時確認目前伺服器能否連線至目標。 伺服器是否可用、協定參數及目標回應。
直連 · Direct 將由用戶端處理的連線直接傳送至目標。 檢查本機網路能否直接連線至目標。 本機網路、DNS 和目標服務是否正常。

Direct 不代表關閉連線開關,也不代表系統已移除 VPN 設定。Proxy 也不保證所有 App 的請求都能成功;伺服器出口、目標服務和目前網路都會影響結果。排查問題時,請分別記錄「開關狀態」、「Global Routing 模式」和「目標是否可連線」,不要將三者混為一談。

規則分流:比對條件、順序與策略

規則用來描述「哪些連線交由哪種策略處理」。在 Config 開啟目前使用的設定檔,檢查規則與策略定義;新增或修改後請儲存,並確認該檔案已選取。將檔案匯入清單,不代表它已套用於目前連線。Global Routing 也須設為 Config,才能依目前設定檔檢查規則分流。

比對條件與策略是兩個部分。DOMAIN、DOMAIN-SUFFIX 等關鍵字用來指定目標;DIRECT、REJECT 或設定檔中已有的代理策略名稱則用來指定處理方式。策略名稱必須與實際設定相符,不要只憑名稱猜測它指向哪台伺服器。規則通常由上而下比對,較精確的例外條件應放在範圍較廣的條件之前。

關鍵字 比對對象 設定注意事項
DOMAIN完整網域名稱。適用於只處理特定主機名稱的情況。
DOMAIN-SUFFIX網域後綴及其子網域。涵蓋範圍大於單一 DOMAIN。
DOMAIN-KEYWORD網域中包含的關鍵字。可能涵蓋額外目標,請先確認比對範圍。
IP-CIDR / IP-CIDR6IPv4 / IPv6 位址區段。確認位址類別、網段及解析方式。
GEOIP依 IP 地理資料庫分類的目標。分類依據是目標 IP 的地理資料庫記錄,而非網域後綴。
USER-AGENT可供規則辨識的 User-Agent 資訊。並非每種連線都會提供此資訊,不適合作為通用的預設規則。
FINAL未符合前置規則的連線。請放在最後,並確認預設策略可正常使用。

以下為規則語法範例,不能直接用來取代整份 Config。PROXY 代表代理策略,使用前請確認目前設定檔中的實際策略定義;example.com 僅為示範網域。

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

DIRECT 代表直接連線,REJECT 代表拒絕符合條件的連線。使用 REJECT 前,請先確認目標用途,避免登入、內容載入或背景請求一併失敗。若某個目標在 Proxy 下可連線、在 Config 下卻失敗,應優先檢查符合的規則與最終策略,而不是先增加更多涵蓋範圍過大的規則。

Config 也可能包含 DNS、策略群組和其他設定。調整規則時只修改相關部分,並保留原始檔案副本;連線期間的既有工作階段可能仍沿用先前路徑,驗證時請重新送出請求,必要時重新連線。規則基礎可搭配名詞解釋閱讀。

多種協定:依既有伺服器參數設定

Shadowrocket 支援多種連線協定,包括 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard,以及 HTTP、SOCKS5。協定規定用戶端與伺服器交換資料的方式,並非可任意替換的速度選項。請依自己已有的伺服器設定,在 Home 的 Add Server 選擇相應類型,或匯入包含這些參數的既有連結。

先確認位址與連接埠,再檢查驗證資訊、傳輸方式及 TLS 相關欄位。不同協定所需欄位各異:有些使用密碼,有些使用 UUID;WireGuard 則涉及金鑰、位址和對端設定。不要將某種協定的參數套用至另一種類型,也不要為了暫時連線成功而任意關閉憑證驗證。

VMess、VLESS 等連線也可能需要搭配傳輸參數。位址相同不代表可以省略路徑、Host 或 Server Name。匯入後若發生逾時,請先逐項比對原始資訊,確認沒有遺漏額外參數。伺服器端也必須支援相同組合;只在用戶端切換協定名稱,無法完成伺服器端的轉換。

Shadowsocks VMess VLESS Trojan Hysteria2 WireGuard

訂閱與伺服器管理:匯入、選取與更新

Home 可查看伺服器與訂閱群組,並選取目前使用的伺服器。若已有單筆伺服器資訊,可透過 Add Server 選擇類型並填寫;若已有 QR Code,可使用 Scan QR Code 匯入並檢查解析結果。若已有訂閱連結,請在 Add Server 選擇 Subscribe,依介面填入連結和備註,再儲存並更新清單。

訂閱是大量取得伺服器項目的來源,不等同於包含規則的 Config 檔案。更新訂閱通常只會重新整理伺服器清單,不代表目前使用的 Config、DNS 或 Global Routing 也會一併依預期變更。匯入後請確認群組是否出現、欄位是否完整,並明確選取要使用的伺服器,再進行連線測試。

管理時,請為手動新增的項目和訂閱群組設定容易辨識的備註。手動修改由訂閱產生的項目,可能在下次更新時被覆寫;長期調整前,請先確認該項目由誰維護。更新失敗時,先檢查目前網路能否連線至訂閱網址,以及連結是否仍有效,再聯絡自己的服務供應商確認。不要反覆刪除群組,以免失去可供比較的舊資料。

訂閱網址、QR Code 和伺服器憑證都可能授予存取權限。請勿將完整連結放入公開截圖、日誌或求助內容。刪除群組前,先保留必要的原始資訊;大量更換伺服器後,請使用相同的 Test Method 再測一次,避免將不同測試方式的結果放在一起比較。

On Demand:依網路條件觸發連線

On Demand 可讓系統依指定條件處理 VPN 連線需求,減少每次手動切換的操作。它不是用來判斷伺服器是否正常的開關,也無法修復無效的憑證。請在 App 的 Settings 中尋找 On Demand,並依目前介面提供的網路條件進行設定;先確認手動連線正常,再啟用按需連線。

設定前,先確認希望在哪些網路下連線、哪些情況下不觸發,接著從一項條件開始測試。若設定涉及 Wi-Fi,請仔細確認網路名稱和比對範圍。儲存後依序切換測試網路、重新送出請求,並觀察系統 VPN 狀態和 App 顯示是否符合預期。不要只看開關顏色,就認定觸發規則已正確執行。

若遇到「剛中斷又重新連線」的情況,請優先檢查 On Demand 是否仍為啟用狀態。若需暫時停用連線,也應一併確認按需規則。切換 Wi-Fi 與行動網路後,系統行為還會受到目前網路、系統權限和既有 VPN 設定影響;每次只調整一項條件,並保留可重現的測試紀錄。

Data:查看流量與活動變化

Data 顯示用戶端記錄的流量統計,適合觀察連線期間上傳、下載及相關統計項目的變化。在 Data 中先確認目前頁面的統計範圍、時間區間和單位,再進行一項明確操作,例如開啟同一個網頁,並比較操作前後的變化。細項以目前介面顯示為準。

流量增加代表有資料經過相應的統計範圍,不代表目標頁面已完整載入,也無法直接證明某條規則比對正確。背景同步、媒體預先載入和 App 重試都可能產生流量。若某個 App 沒有開啟,統計數字仍持續增加,請先檢查背景活動,不要直接認定伺服器異常。

用戶端統計和服務供應商帳單可能採用不同的計算範圍、重設時間和單位,數值不一定完全相同。若需保留排查紀錄,請先記下統計時間和連線狀態,再使用介面提供的重設功能。Data 不應視為裝置所有網路流量的唯一帳本,也不適合單獨用來判斷伺服器速度。

Settings:DNS、測試、快速入口與同步

Settings 集中管理常用行為設定。進入後先確認各項功能,再決定是否修改。部分行為也可能由目前使用的 Config 控制,因此排查時應同時記錄 Settings 和 Config 中的相關設定。不要一次更換 DNS、測試方式和伺服器,否則結果改變後難以判斷原因。

DNS:檢查解析路徑與設定來源

DNS 會將網域名稱解析為位址;解析失敗時,可能出現伺服器似乎已連線、目標卻無法開啟的情況。請檢查 Settings 中與 DNS 相關的選項及目前使用的 Config,先確認實際採用的設定來源,再修改對應項目。DNS 位址本身也必須能透過目前網路路徑連線,不要只因名稱熟悉就直接替換。

測試時請區分網域解析失敗與目標連線失敗,並留意 IPv4、IPv6 的結果是否不同。若設定使用加密傳輸的解析方式,也應確認網域、憑證驗證和連線路徑。保留原始設定,每次變更後重新送出相同請求;不要把清除所有 DNS 設定當成固定的修復步驟。

Test Method 與 Connectivity Test:統一比較基準

Test Method 決定連線測試採用的方式。在 Settings 選擇目前介面提供的測試方法,再回到 Home 執行 Connectivity Test。不同方式測量的環節各異,結果不能直接比較;測試失敗也不一定代表伺服器完全無法使用,請搭配實際連線和日誌判斷。

比較伺服器時,請保持網路、測試方法和測試目標一致,並盡量在相近時間重複測試。延遲較低不代表持續傳輸一定較快,測試通過也不代表所有目標服務都能正常運作。若發生逾時,可依伺服器逾時排查流程繼續檢查。

Today Widget:設定快速查看與操作入口

Today Widget 可用來快速查看或操作相關狀態。先在 Settings 檢查 Today Widget 的可用設定,再到系統的小工具介面新增裝置目前提供的項目。小工具形式和可用操作會受系統及 App 支援情況影響,實際名稱與顯示方式請以裝置介面為準。

快速入口不能取代完整的設定檢查。透過小工具操作後,仍應在 App 內確認目前伺服器、Global Routing 和連線狀態;若需修改規則或確認失敗原因,請回到 Home、Config 或 Diagnostics,不要反覆觸發同一個快速操作。

iCloud 同步:先保留本機副本

iCloud 同步可在符合條件的裝置間同步 App 支援的資料。請在 Settings 的 iCloud 相關項目中確認開關,並檢查系統是否允許該 App 使用 iCloud。兩台裝置須使用適當的 iCloud 帳號及權限;App Store 購買帳號和 iCloud 同步帳號用途不同,請勿混淆。

啟用前請儲存重要的 Config 和必要資訊,並閱讀目前介面標示的同步範圍;不要假設所有設定、統計或連線狀態都會同步。同步不等於歷史備份,刪除或覆寫操作可能同步至其他裝置。更換裝置後,先確認資料完整再連線;請勿在兩台裝置上同時大量編輯同一份設定檔。

Diagnostics:以最小重現紀錄定位問題

Diagnostics 可用來收集連線問題相關的診斷資訊。在 Settings 開啟相應項目,依介面提供的選項進行檢查;若需重現問題,請記錄網路類型、伺服器、Global Routing、目前使用的 Config 和錯誤發生時間,再重做一次失敗操作。實際日誌範圍以目前介面為準。

檢視資訊時,先區分解析錯誤、連線逾時、驗證失敗和目標回傳錯誤,再回到相關設定檢查。對外提供診斷資訊前,請移除訂閱網址、密碼、金鑰及可辨識個人身分的資訊,只保留解決問題所需的內容。問題排除後,請還原暫時開啟的額外記錄設定。

設定檢查順序:從連線成功到依規則使用

將設定流程分為三個階段:先確認伺服器,再確認分流,最後設定自動化與同步。每個階段都使用相同的測試目標,確認結果後再進行下一步。如此可避免在一次失敗中同時懷疑協定、DNS、規則和 On Demand。

  1. 確認基本網路。先檢查裝置本身的網路是否正常,並記錄目前使用 Wi-Fi 或行動網路。若網路需要登入,請先完成該網路要求的操作。
  2. 確認既有伺服器。在 Home 選取明確的項目,確認協定參數,使用一致的 Test Method 執行 Connectivity Test,再確認能否連線至實際目標。
  3. 確認目前使用的設定檔。在 Config 選取預期的檔案,將 Global Routing 設為 Config,檢查目標符合的規則與策略,並保留可正常運作的檔案副本。
  4. 逐項加入設定。依需求調整 DNS、On Demand、Today Widget 或 iCloud 同步。每次變更一項後都重新測試,並記錄與先前結果的差異。
  5. 使用資料驗證。透過 Data 觀察活動變化,必要時使用 Diagnostics 重現錯誤。若新設定造成問題,先還原上一項設定,再判斷是否需要繼續調整。

首次設定可依教學逐步操作;若已連線但無法存取目標,請前往問題診斷依症狀排查。購買、重新下載和裝置相容性請至App Store 正版資訊確認頁查看,連線問題不需要重新購買用戶端。