官方手冊 · 設定

Shadowrocket
功能與常用設定

先分清請求的路由方式與連線啟動時機,再檢查伺服器、DNS 和統計資料。每次只調整一類設定,並保留可還原的設定副本。

  • Config / Proxy / Direct
  • On Demand
  • Data
  • Settings
01 · 請求路徑

Global Routing:設定、代理與直連

Global Routing 決定請求採用哪種路由方式,不會判斷伺服器是否有效。前往 Home → Global Routing,選擇 Config、Proxy 或 Direct,再回到 Home 確認連線狀態。

模式 請求處理方式 適用情境 優先檢查
設定 Config 依照目前啟用設定中的規則與策略決定路徑。 日常依網域、位址或其他條件分流。 設定是否已啟用、規則順序及最終策略。
代理 Proxy 通常會將請求交由目前選取的代理伺服器處理;仍須留意系統與應用程式的處理範圍。 暫時確認伺服器連線是否正常,或比對排查分流規則。 伺服器參數、選取的伺服器及網路連線狀況。
直連 Direct 請求透過目前的網路直接連線至目標,不經選取的代理伺服器轉送。 建立目前網路的連線基準,或暫時檢查直連結果。 目前網路能否連線至目標,以及 DNS 是否正常。

如何選擇:日常使用 Config,排查時交叉比對

已有完整設定時,先選擇 Config,並在 Config 頁面確認實際啟用的檔案。需要確認伺服器時,可暫時切換至 Proxy,使用相同目標重複測試。如果 Proxy 可用、Config 不可用,應繼續檢查規則比對結果與策略指向,不要立刻修改伺服器參數。測試完成後,請切回日常模式,避免長期保留暫時的排查設定。

Direct 不等於關閉連線。用戶端可能仍讓系統 VPN 設定保持連線,但請求採用直連路徑。若要完全停止目前的連線,請回到 Home 關閉連線開關;若 On Demand 隨後再次觸發連線,也要檢查按需連線條件。路由模式、連線狀態與觸發條件是三個不同層面,不能只憑狀態列圖示判斷請求一定經過代理。

02 · 比對條件

規則分流:條件比對與策略執行

規則決定哪些請求採用哪種策略,位置在 Config 目前啟用的設定中。每條規則通常包含規則類型、比對值與策略。常見策略包括 DIRECT、PROXY、REJECT,也可能指向設定中已定義的策略群組。策略群組名稱不是協定名稱,新增規則前應確認指定的目標確實存在。

DOMAIN 對應完整網域名稱,DOMAIN-SUFFIX 對應網域後綴,DOMAIN-KEYWORD 依網域中的關鍵字比對;IP-CIDR 與 IP-CIDR6 分別表示位址範圍,GEOIP 則依 IP 位址歸屬資料比對。USER-AGENT 仰賴用戶端取得相應的請求資訊,並非適用於所有流量,不能視為通用的應用程式識別方式。

如何設定:具體條件在前,並檢查 FINAL

設定中的規則通常由上而下比對,第一條符合的規則會決定處理方式。新增特定網域的規則時,請確認前面是否已有範圍較廣的條件;FINAL 用於處理前面規則都未符合的請求,通常放在規則清單末尾。編輯前先儲存副本,啟用後只連線至一個明確的目標,再查看連線記錄確認結果。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

以上片段僅用於說明語法,不能直接取代完整設定。第一條依網域後綴使用 PROXY,第二條讓指定的私人位址範圍使用 DIRECT,最後一條則處理其餘請求。實際的區域網路連線也會受到系統路由、網路權限與設定選項影響;規則結果不如預期時,請先查看比對記錄,再確認是否與解析階段或位址比對條件有關。

更新設定檔也可能改變規則內容。若遠端設定更新後行為有所變化,請比對更新前後的規則順序、策略名稱與 DNS 設定,不要只看檔名。想了解欄位與協定參數,請參閱協定參考;首次建立連線則可依照使用指南逐步操作。

03 · 連線資料

Subscribe 與 SERVER:更新來源,確認目前選擇

伺服器是單筆連線資料,訂閱則是更新這些資料的來源。本節假設你已有自己的訂閱或伺服器資訊。請在 Home 的 SERVER 清單中確認伺服器;手動輸入時,前往 Add Server,先選擇 Type,再填入服務提供者提供的位址、連接埠、驗證與傳輸參數。若要匯入現有訂閱,請在 Add Server 中選擇 Subscribe,輸入自己的訂閱網址並儲存,接著等待清單載入。

如何設定:先確認類型,再檢查參數

Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2 所需欄位各不相同。不能只填妥位址與連接埠就認定設定完整;還應檢查驗證方式、TLS、伺服器名稱與傳輸設定。若有 QR Code 或分享連結,可使用相應的匯入入口;匯入後仍應確認 Type 與重要欄位是否和原始資料一致。

訂閱更新成功只代表資料已取得並完成解析,不表示其中每台伺服器目前都能連線。更新後請回到 SERVER 檢查數量、名稱與目前選取的項目,再執行 Connectivity Test 和實際連線測試。若清單缺少預期項目,請先確認訂閱網址是否完整、有效,以及目前網路能否連上該網址;不要反覆修改 Global Routing 來取代來源檢查。

注意事項:別把訂閱與 Config 混為一談

Subscribe 主要用於管理伺服器資料;Config 還可能包含路由、DNS 與其他行為設定,不能只看連結外觀就互相替代。訂閱更新可能覆寫由訂閱管理的項目,手動修改前請先保留記錄。刪除訂閱或伺服器前,也要確認目前設定中的策略是否仍引用這些項目,避免名稱還在、實際連線目標卻已失效。

訂閱網址與分享連結可能包含存取憑證,排查時不要公開完整內容。用戶端一次買斷 ≠ 線路方案;Shadowrocket 的購買紀錄與使用者已有的連線資料分別管理。本網站不提供、不販售也不推薦節點或訂閱;取得應用程式的唯一管道是 App Store,購買前可先查看正版核驗說明。

04 · 連線觸發

On Demand:依條件連線,不取代規則分流

On Demand 會在符合條件時觸發系統 VPN 連線;Global Routing 則決定連線後的請求路徑。前往 Settings → On Demand,檢查總開關與已設定的條件。不同裝置可選的項目可能不同,請以目前應用程式介面為準。先在 Home 手動連線並確認設定可用,再啟用按需連線,可避免把伺服器故障誤判為自動連線條件有問題。

如何設定:從單一情境開始

先決定希望在哪種網路情境下自動連線,再設定相應條件,不要一次加入多個彼此重疊的條件。儲存後切換一次相關網路,回到 Home 檢查連線狀態,並連線至固定目標。記下測試時使用的 Wi-Fi 或行動網路、Global Routing 模式與伺服器,才能分別判斷自動觸發和請求分流是否符合預期。

若手動關閉後又再次連線,請先檢查 On Demand 是否再次符合觸發條件,這不一定表示關閉操作失敗。若要暫時停止自動連線,請先調整 On Demand,再關閉 Home 的連線。網路切換時能否恢復連線,會受到系統排程、網路品質與伺服器狀態影響;啟用此功能不代表連線必定持續,也不保證所有背景請求都能立即完成。

05 · 使用記錄

Data:先看統計範圍,再解讀流量變化

Data 用於查看用戶端記錄的流量與相關統計,不是服務提供者帳戶的計費憑證。進入 Data 後,先確認畫面顯示的統計範圍、時間區間與分類,再比較上傳和下載流量。若頁面提供重置功能,請先記錄目前數值,避免把重置後的數字誤認為歷史累計。

如何使用:比較相同時間範圍

排查流量增加時,先停止大型檔案傳輸與背景同步,記錄基準值,再執行一項明確操作並觀察變化。若要判斷某類請求是否直連,應搭配 Global Routing、規則比對結果與連線記錄,不要只憑總流量增加就下結論。統計是否包含特定分類,以及各項數值的意義,請以 Data 目前顯示的標籤為準。

用戶端計數、系統網路統計與服務提供者統計的取樣時間、協定額外負荷與計算方式可能不同,因此數字有差異不代表一定異常。Data 也無法確認訂閱是否到期或剩餘可用流量;這些資訊應查看使用者既有服務的帳戶記錄。若發現流量異常增加,請先查看測試前後的活動與請求,再逐項排除背景下載與同步工作。

06 · 日常選項

Settings:DNS、測試方式、小工具與同步

這些設定各自處理不同問題。修改前先記下原值,每次只調整一項;實際入口與可用選項請以目前應用程式介面為準。

DNS

檢查解析設定時,也要確認請求路徑

DNS 會將網域名稱轉換為位址;網頁無法開啟時,應分別檢查網域解析失敗與伺服器連線失敗。先查看目前 Config 中生效的 DNS 相關設定,再確認 Settings 中的相關選項。設定檔與應用程式設定可能共同影響解析方式,不要只修改一處就假設所有請求都使用相同的解析路徑。

調整前先保存原值,再連線至固定網域,並在 Diagnostics 或連線記錄中確認結果。每次只修改一項解析參數後再測試,避免同時更改模式、伺服器與 DNS。解析成功不代表後續連線一定成功;還要確認目標位址可連線、規則策略正確,以及伺服器名稱與 TLS 參數相符。

Test Method

測試方式不同,結果不可直接比較

Test Method 會決定 Connectivity Test 採用的檢測方式。前往 Settings → Test Method,選擇目前介面提供的方式,再回到 Home 執行 Connectivity Test。若可設定測試目標,請先確認該目標本身連線穩定,並記錄所選方式與網路環境。

測試成功表示相應的檢測條件有收到回應,不代表每個網站或每類應用程式請求都正常。比較伺服器時,請固定使用相同的測試方式、目標與網路,之後再進行實際連線測試。若某種方式測試失敗,但實際連線正常,請優先確認測試目標與檢測機制,不要只憑單次結果刪除伺服器資料。

Today Widget

小工具入口不等於即時狀態頁

Today Widget 用於設定系統小工具提供的捷徑資訊或操作。請在 Settings 查看 Today Widget 相關選項,再前往系統的小工具編輯入口,加入目前裝置支援的項目。可顯示的內容與所在位置,請以應用程式和系統目前提供的介面為準。

先在 Home 選好伺服器並確認連線正常,再使用小工具作為快速入口。系統可能限制小工具的更新頻率;若顯示舊狀態,請開啟應用程式確認,不要連續點按切換來強制更新。小工具不能取代 Config,也無法單獨證明目前請求符合哪條規則。

iCloud

同步前確認範圍,變更前保留副本

iCloud 相關功能可在支援的裝置與帳戶環境中儲存或同步應用程式提供的資料。請先檢查系統 iCloud 的可用空間與應用程式存取權限,再查看 Settings 中的 iCloud 相關選項;哪些資料會參與同步,請依目前介面的說明逐項確認。

不要把同步視為所有設定都能自動還原的保證。進行重要變更前,請另存可還原的副本;在新裝置上使用前,逐項確認 Config、伺服器清單與連線結果。同步資料可能包含連線憑證,請妥善保護帳戶存取權與裝置解鎖方式。應用程式購買紀錄由 App Store 管理,與 iCloud 中的設定資料並非同一項目。

07 · 故障排除

Diagnostics:先記錄現象,再修改設定

Diagnostics 是檢查執行資訊與診斷線索的入口,不是自動修復按鈕。請在 Settings 中開啟 Diagnostics,查看目前提供的診斷項目,並搭配 Home 的連線狀態、Connectivity Test 與相關記錄,區分伺服器連線、網域解析、規則比對及目標存取問題。不同診斷項目回答的問題各不相同,單一項目通過不能取代完整驗證。

如何檢查:建立可重複的最小測試

  1. 記錄目前的網路、選取的伺服器、Global Routing 模式與正在使用的 Config。
  2. 選擇一個明確的連線目標,執行一次測試,並保留錯誤現象與相關記錄。
  3. 每次只改變一個變數,例如暫時從 Config 切換至 Proxy,再連線至相同目標。
  4. 比對診斷記錄以判斷變化;完成後恢復原模式,必要時還原剛才的修改。

若同一台伺服器連線至多個目標都失敗,請先檢查位址、連接埠、驗證資訊與服務是否有效;若只有 Config 模式失敗,優先檢查規則與策略;若網域解析失敗,則單獨檢查 DNS。若目前網路連基本網站都不穩定,請先處理網路本身,再繼續排查用戶端。

設定不是越多越好。透過固定網路、固定目標與單項變更重現的問題,通常更容易找出原因。若仍無法連線,請參閱已開啟連線卻無法上網的逐項排查指南,依序檢查伺服器、模式、DNS 與規則。

設定常見問題

選擇 Direct 後,為什麼系統仍顯示 VPN 狀態?

Direct 是 Global Routing 的請求路徑選擇,不等於關閉連線。若要停止目前的連線,請在 Home 關閉開關,並檢查 On Demand 是否會再次觸發。判斷請求是否經過代理,應確認模式、規則與連線記錄,不能只看狀態列。

修改規則後沒有作用,該先檢查哪裡?

先確認 Global Routing 設為 Config,再確認修改的是目前啟用的設定。接著檢查規則順序、前方是否有範圍更廣的條件、策略目標是否有效,以及 FINAL 的設定。必要時重新建立測試連線,避免繼續觀察修改前已建立的連線。

訂閱更新成功,為什麼 Connectivity Test 仍然失敗?

取得訂閱與連上伺服器是兩個不同環節。先確認目前選取伺服器的參數及有效狀態,再檢查 Test Method、測試目標與目前網路。最後進行實際連線測試,判斷是檢測條件受限,還是連線本身有問題。

更換裝置後,購買紀錄和設定會一起還原嗎?

購買紀錄與設定資料分別管理。請先在 App Store 確認原有購買紀錄,再依實際啟用的同步或備份方式還原資料;通用購買適用性與系統需求請以 App Store 頁面標示為準。還原後也要檢查伺服器、Config 與 On Demand 條件。

前往 App Store