設定參考 · 官方手冊

Shadowrocket 功能與設定

先選擇 Global Routing，再確認 Config 與伺服器。依序設定 Home、Data、Settings 的相關項目，每次只變更一個條件。

查看模式比較 查看首次連線指南
  • Home · 連線與選擇
  • Config · 設定檔
  • Settings · 偏好設定與診斷

Home / Global Routing

Global Routing：設定、代理與直連

Global Routing 決定連線啟用後如何選擇流量路徑，不負責匯入伺服器，也不能取代連線開關。日常需要依網域或位址分流時，使用 Config 設定模式；需要暫時測試目前伺服器時，可使用 Proxy 代理模式；需要確認本地網路是否正常時，可使用 Direct 直連模式。這些模式名稱相近，但適用範圍不同，切換前請先確認測試目的。

在哪個畫面選擇

在 Home 開啟 Global Routing，選擇 Config、Proxy 或 Direct，再返回 Home 確認目前伺服器與連線狀態。此處的 Config 是路由模式；底部導覽列的 Config 則用來管理設定檔。選擇 Config 模式後，還要前往 Config 頁面確認實際啟用的檔案，不能只看到模式名稱，就認定所需規則已生效。

Global Routing 三種模式的用途與檢查項目
模式 路徑選擇 適用情境 檢查項目
設定 · Config 依據目前設定檔中的規則與策略處理請求。 日常連線需要讓不同網域或位址套用不同策略。 已啟用的檔案、Rule 順序、最終規則與策略目標。
代理 · Proxy 以代理作為全域路由方向，仍須留意系統與設定中的略過項目。 暫時確認目前伺服器能否連線至目標。 已選取的伺服器、連線參數、目標本身與網路環境。
直連 · Direct 以本地網路直接存取作為全域路由方向。 確認本地網路狀況，或判斷問題是否與代理路徑有關。 本地網路是否可連線，以及是否有其他設定影響請求。

切換模式時的注意事項

Proxy 不代表所有 App 的每一項系統請求都會經過相同路徑；Direct 也不等於關閉系統中的 VPN 設定。疑難排解時，請分別記錄模式與連線開關，避免混為一談。若 Config 模式下無法正常存取、Proxy 模式下卻正常，請優先檢查規則與策略；若兩者都失敗，先檢查伺服器參數與網路連線。完成測試後請還原原本模式，不要將暫時測試狀態當成長期設定。

Config / Rule

規則分流：先比對條件，再套用策略

規則分流會分別處理「請求內容」與「請求路徑」。DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 用於不同範圍的網域比對；IP-CIDR 與 IP-CIDR6 用於比對位址範圍；GEOIP 依據位址歸屬資料判斷；USER-AGENT 則取決於是否能讀取請求資訊。策略 PROXY、DIRECT、REJECT 分別代表代理、直接連線與拒絕處理。協定名稱不等於策略名稱，伺服器使用 Trojan 或 WireGuard，不會自動決定網域符合哪一條規則。

在哪個畫面修改

進入 Config，先確認目前啟用的設定檔，再開啟檔案的編輯入口檢查 Rule 區段。修改前請保留可用的副本，之後一次只調整一條規則，並確認修改後的檔案仍是目前使用的檔案。新增規則通常應放在較廣泛的比對條件之前；FINAL 放在末尾，處理前面的規則都未符合的請求。

[Rule]
DOMAIN,example.com,DIRECT
DOMAIN-SUFFIX,example.net,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
  • DOMAIN,example.com,DIRECT：精確比對 example.com，並使用 DIRECT；不會因此涵蓋其所有子網域。
  • DOMAIN-SUFFIX,example.net,PROXY：比對 example.net 及其子網域，並交由 PROXY 處理。
  • IP-CIDR,192.168.0.0/16,DIRECT：目標位址落在此私有位址範圍時使用 DIRECT，不代表其他私有位址範圍也包含在內。
  • FINAL,PROXY：前面的規則都未符合時，請求使用 PROXY；請先確認代理目標可正常使用。

比對順序與可讀取資訊的限制

Rule 區段會依序由上往下檢查，最先符合的規則會決定後續策略。若將範圍較廣的規則放在前面，後續較精確的規則可能無法執行。位址比對也可能涉及網域解析，不能只看規則文字順序而忽略 DNS 結果。USER-AGENT 並非所有加密請求都能直接讀取，不能將它視為通用的 App 識別方式。

以上片段僅用於說明規則語法，並非完整設定檔。實際檔案中的 PROXY 必須對應可用的代理目標；若檔案使用自訂策略名稱，也要確認名稱與引用一致。若要進一步了解 General、Host、URL Rewrite 與規則優先順序，請參閱規則與設定參考。

Home / Add Server / Subscribe

訂閱與伺服器管理：分別檢查參數與規則

伺服器記錄會保存連線至特定伺服器所需的位址、連接埠、協定與驗證參數；訂閱則用於集中取得及更新一組記錄。兩者都不等於分流設定檔。本網站以使用者已有自己的訂閱或伺服器資訊為前提，僅說明匯入與管理方式，不提供、販售或推薦節點或訂閱。

在哪個畫面新增

在 Home 使用新增入口進入 Add Server。若已有訂閱，請依照 App 提供的 Subscribe 類型填入自己的訂閱網址，並設定方便辨識的名稱；若已有單一伺服器資訊，請選擇對應協定並逐項填寫。使用 Scan QR Code 前，先確認 QR Code 來自自己的設定資料；匯入後仍要檢查記錄類型、位址與連接埠，不要把掃描成功當成連線成功。

Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定的欄位各不相同。填寫時請以資料內容及目前畫面顯示的欄位為準，不要將某種協定的密碼、識別碼或傳輸參數直接套用至另一種協定。TLS 相關欄位尤其需要確認伺服器名稱與憑證設定，不應為了避開錯誤而任意變更驗證設定。

更新、測試與刪除注意事項

更新訂閱後，先確認群組中的記錄是否有變化，再重新確認目前選取的伺服器。訂閱來源可能會調整記錄名稱或內容，因此若曾在本地修改訂閱產生的項目，請留意下次更新是否會覆寫修改。刪除前也要分清楚是刪除單筆記錄，還是移除整個訂閱群組。

Connectivity Test 用於檢查目前測試條件下的回應，不代表網頁、影片或所有協定流量都能正常傳輸。測試有結果但實際存取失敗時，請繼續檢查目標網域、Global Routing、DNS 與規則符合情況。測試沒有結果時，也要配合 Test Method 判斷，不能只憑單次結果認定記錄已失效。

Settings / On Demand

On Demand：依條件觸發連線

On Demand 會依據設定的網路條件按需觸發連線，與 Global Routing 的功能不同：前者決定何時建立連線，後者決定連線建立後的流量路徑。開啟 On Demand 無法修復伺服器參數，也不會自動取代已失效的設定資料。

在哪個畫面設定

在 Settings 檢查 On Demand 相關入口，先閱讀目前畫面提供的網路條件與動作，再依自己的使用情境啟用。若要區分 Wi-Fi 或行動網路的行為，請逐項確認相應條件；若設定涉及特定 Wi-Fi 名稱，請確認名稱正確。可選項目以 App 目前顯示為準，不要照搬其他裝置的選項而省略確認步驟。

首次設定前，先在手動連線狀態下確認同一份伺服器資料可正常使用，再啟用 On Demand。之後分別在預期會連線與不會連線的網路條件下測試。這樣才能分辨是連線條件未觸發，還是觸發後伺服器無法使用。

手動中斷後又重新連線，先檢查什麼

若手動中斷後又出現連線，請先檢查 On Demand 及其條件，再查看系統中的 VPN 狀態。從 Wi-Fi 切換至行動網路時，也應重新確認狀態，不要只根據 Home 某次顯示判斷整個切換過程。若要長時間停止按需連線，請明確停用相關設定並確認狀態，不要反覆操作連線開關。

Data

Data：查看客戶端統計，不取代伺服器端帳單

Data 可查看 App 記錄的流量資訊，協助了解上傳、下載及目前統計範圍內的使用情況。這些資訊可作為連線後是否有流量通過的參考，但統計數值本身無法證明特定網頁已完整載入，也不能證明請求使用了預期策略。

在哪個畫面查看

進入 Data 後，先確認頁面目前顯示的統計對象與範圍，再分辨上傳和下載方向。進行短時間測試時，可先記下目前數值，只執行一次明確操作，再返回比較變化。若頁面提供重設入口，使用前請確認是否仍需保留原有記錄；重設後便無法根據這組數值回溯先前的使用情況。

如何理解統計差異

客戶端與伺服器端可能採用不同的計量範圍、時間區間及協定開銷計算方式，因此 Data 的數值不應直接等同於訂閱資料所顯示的額度。訂閱額度也不等於目前裝置的累計用量。若要確認伺服器端計量，請查看自己使用的服務資訊；若要判斷客戶端請求路徑，應一併檢查模式、規則與診斷記錄，而非只看累計流量。

Settings / Config

Settings 常用項目：依用途調整

Settings 集中管理 App 偏好設定、測試方式及相關工具，但並非所有行為都由此處決定。設定檔中的 General 區段也會影響連線與解析。檢查設定時，請一併記下目前使用的設定檔；若入口位置或可選項有所不同，請以 App 目前實際顯示為準。

DNS：先檢查設定檔，再變更解析方式

DNS 會將網域解析為位址，影響網域存取及部分位址規則的判斷。請先在 Config 檢查目前檔案的 General 區段與 DNS 相關設定；若 Settings 中也有相關選項，請一併確認，避免只修改一處就認為所有設定都已生效。

[General]
dns-server = system

dns-server = system 表示使用系統 DNS，是用來說明解析來源的範例，並非適用於所有網路的通用設定。若要使用自訂 DNS 或 DNS over HTTPS，請先確認目前網路可連線至目標解析服務，再修改設定並重新測試同一個網域。請勿一次同時調整 DNS、伺服器與 Global Routing，否則難以判斷是哪項變更造成影響。

Test Method：測試結果必須連同測試條件解讀

在 Settings 找到 Test Method，依照目前提供的方式選擇測試方法，再返回 Home 執行 Connectivity Test。不同方法可能測試不同層面的回應，因此切換方法後的數值不宜直接比較。比較多筆記錄時，請盡量維持測試方法、網路與測試時段一致；測試完成後仍須透過實際存取確認，不能將較短的回應時間視為較高的傳輸量。

Today Widget：方便查看與操作

Today Widget 相關設定可配合系統的小工具入口，方便查看狀態或使用提供的快捷操作。先在 Settings 檢查 Today Widget 的可選項，再於系統允許的位置加入相應小工具。是否能顯示及提供哪些操作，取決於裝置系統與 App 支援情況，請以實際畫面為準。

小工具可能會延遲更新；需要確認連線狀態時，請返回 Home 並檢查系統 VPN 狀態。快捷入口也無法略過首次連線所需的系統授權。若小工具未顯示記錄，請先檢查小工具設定與 App 狀態，不要重複匯入同一份資料。

iCloud：同步前先區分本機與雲端資料

使用 iCloud 相關同步功能前，請確認裝置已登入所需帳號、系統允許 App 使用 iCloud，並在 Settings 的相關入口查看實際可同步的內容。先保留目前可用的設定，再啟用或還原同步；之後確認另一部裝置是否收到預期資料，不要假設所有偏好設定與執行狀態都會一併移轉。

訂閱網址、驗證欄位與設定檔可能包含敏感資訊，同步前請先了解將儲存哪些內容。iCloud 同步不等於還原 App 購買記錄，也不代表原裝置上的系統 VPN 授權會直接移轉至新裝置。更換裝置後仍須逐項檢查伺服器、設定檔與首次連線授權。

Diagnostics：針對單次故障收集資訊

發生問題時，請在 Settings 的 Diagnostics 相關入口查看目前提供的診斷工具。先記錄問題發生時的網路、Global Routing 模式、伺服器與設定檔，再重現一次故障。診斷內容應對應同一次操作，避免拼湊不同網路環境下的結果來判斷。

分享診斷資料前，請檢查其中是否包含訂閱網址、驗證資訊、存取網域或其他個人資料，並先妥善處理。若診斷提示與實際存取狀況不一致，請返回 Home 確認目前選擇與連線狀態，再檢查 DNS 和 Rule；不要以反覆匯入資料取代問題排查。

Settings checklist

設定檢查順序：先連線，再分流，最後設定自動化

  1. 確認資料。在 Home 檢查自己已有的伺服器或訂閱記錄，確認協定與必要參數完整，並選取本次要測試的伺服器。
  2. 確認模式。在 Global Routing 查看目前使用的是 Config、Proxy 還是 Direct，並記下本次要測試的是代理路徑還是規則行為。
  3. 確認檔案。使用 Config 模式時，進入 Config 檢查啟用的檔案、Rule 順序與 FINAL，特別留意自訂策略的引用。
  4. 確認實際請求。先執行 Connectivity Test，再存取一個明確的目標；必要時搭配 Data 與 Diagnostics，判斷是否有相應請求。
  5. 最後啟用自動化。手動連線與規則測試正常後，再設定 On Demand、Today Widget 或 iCloud，並分別確認結果。

若變更後無法判斷原因，請還原至先前保留的可用設定，逐項恢復，而不是一次啟用更多選項。首次匯入與連線的完整步驟請參閱入門指南；不清楚相關概念時，可查閱概念速查；遇到特定問題時，可依照疑難排解逐項檢查。