官方手冊 · 功能與設定

Shadowrocket
代理模式與常用設定

先確認連線的處理方式,再調整規則與網路參數。從 Home 的連線入口,到 Config 的規則,再到 Settings 的輔助設定,依用途查閱。

本頁主要說明 iPhone / iPad 上的操作。介面分區與可用項目以 App 內實際顯示為準;系統要求以 App Store 頁面標示為準。凡涉及匯入,皆以使用者已有自己的訂閱或伺服器資訊為前提。

GLOBAL ROUTING

Config、Proxy、Direct
分別何時使用

Global Routing 決定整體處理方式;選取的伺服器則決定代理連線使用的目標。兩者是不同的設定。

是什麼:Global Routing 是連線處理模式的入口。設定模式對應 Config,代理模式對應 Proxy,直連模式對應 Direct。它不是協定選擇器,也不負責將既有訂閱匯入 App。即使已選取伺服器,切換模式後,實際連線仍可能採用不同的處理路徑。

在哪個介面:在 Home 找到 Global Routing,開啟模式選擇。這裡的 Config 是一種模式選項,與底部用來管理設定檔的 Config 分頁用途不同:前者決定以規則處理連線,後者決定目前使用哪份設定檔。

介面選項處理方式常見用途檢查重點
Config依目前設定的規則與策略處理連線。依網域或位址進行日常分流。是否已選取設定檔、規則順序是否正確、策略目標是否有效。
Proxy通常將連線交由目前的代理目標處理,仍須留意 App 與系統的適用範圍。暫時排查規則是否造成連線差異。目前伺服器是否可用,以及驗證資訊與協定參數是否正確。
Direct以直連方式處理,不經由選取的代理伺服器。確認目前網路本身的連線狀況。本機網路與 DNS 解析是否正常;Direct 不代表關閉連線開關。

如何設定:已有可用設定檔且需要分流時,選擇 Config;懷疑規則造成特定請求走向不符時,可暫時選擇 Proxy,再重新送出相同請求;需要對照本機網路時,改用 Direct。記下原本的模式,完成比較後再恢復,避免排查設定變成長期設定。

注意事項:切換模式後,應以新建立的連線進行驗證;既有長連線可能會維持原狀態。Proxy 可以連線而 Config 不行,只能表示需要繼續檢查規則、策略與相關 DNS 設定,不能直接斷定某條規則一定有誤。三種模式都無法修復失效的伺服器驗證資訊。

閱讀 Global Routing 模式說明 →
RULE ENGINE

規則負責比對
策略決定處理目標

是什麼:規則描述「哪些連線應如何處理」。常見比對條件包括網域、網域後綴、網域關鍵字與 IP 位址範圍;策略則指向 PROXY、DIRECT、REJECT 或設定檔中定義的策略名稱。即使規則比對正確,若策略指向失效目標,連線仍可能失敗。

在哪個介面:進入 Config,先確認目前選取的設定檔,再查看或編輯其中的規則。只將設定檔加入列表,不代表已啟用;使用 Global Routing 的 Config 模式時,還需確認實際生效的檔案。

常見比對條件

  • DOMAIN 比對指定的完整網域,適合範圍明確的單一目標。
  • DOMAIN-SUFFIX 比對網域本身及其子網域,適合依整個網域範圍處理。
  • DOMAIN-KEYWORD 依網域中的關鍵字比對,涵蓋範圍可能比預期更廣。
  • IP-CIDR 與 IP-CIDR6 分別表示 IPv4 與 IPv6 位址範圍;GEOIP 則使用 IP 地理位置條件。
  • FINAL 用於處理未符合前面規則的連線,通常放在規則末尾。

如何設定:先備份目前的設定檔,再將精確規則放在範圍較廣的規則之前,最後設定 FINAL。以下僅展示規則語法,example.com 是虛構的教學網域,不代表實際分流設定建議。

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

在這段範例中,完整網域 example.com 會先符合第一條規則;其子網域可繼續符合第二條;未符合前述規則的連線則交由 FINAL 處理。PROXY 實際使用的目標,仍須依目前的伺服器與完整設定檔判斷。

注意事項:規則通常依序檢查,過早放置涵蓋範圍過廣的比對條件,可能會遮蔽後面的精確條件。IP 類規則與網域類規則取得的資訊不同,DNS 解析結果也會影響判斷。發生異常時,先從連線記錄確認目標與比對結果,再修改相關規則,不宜直接加入大量例外。

查閱規則關鍵字與策略概念 →
SUBSCRIBE / SERVER

匯入既有訂閱
與管理單一伺服器

是什麼:訂閱用於批次管理伺服器資訊;單一伺服器項目則儲存特定連線目標的協定、位址、連接埠與驗證參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定所需欄位各不相同,不能只更換協定名稱,卻沿用其他協定的參數。

在哪個介面:在 Home 使用 Add Server 新增項目;既有訂閱可在相應類型中選擇 Subscribe。已有的分享資訊也可透過 Scan QR Code 或剪貼簿匯入入口處理,實際入口以目前介面顯示為準。所有操作均以使用者已持有自己的訂閱或伺服器資訊為前提。

如何設定:匯入前先確認內容是訂閱連結、單一伺服器分享資訊,還是設定檔。將訂閱連結填入 Subscribe 對應欄位,儲存並更新後,確認群組中是否出現伺服器;手動輸入時先選擇協定,再逐項確認位址、連接埠、驗證資訊,以及協定所需的傳輸與 TLS 參數。最後在 Home 明確選取要使用的伺服器。

多個訂閱應使用容易辨認的名稱分開整理。更新前記下目前選取的項目,更新後確認項目是否仍存在且仍為選取狀態。遠端回傳內容變動可能造成項目增減,不要將訂閱列表視為永遠不變的本機清單。

注意事項:更新訂閱只代表重新取得列表,不代表每台伺服器都能連線。Connectivity Test 的結果也不等於下載速度;測試條件、協定交握與目前網路狀況都會影響數值。刪除群組前,先確認有可用的還原資料;分享截圖時,請遮住完整訂閱網址與驗證欄位。

查看訂閱與伺服器管理手冊 →
ON DEMAND

依網路條件觸發連線
不取代分流規則

是什麼:On Demand 用於依據設定條件觸發或維持系統 VPN 連線。它回答的是「何時建立連線」,而 Config 中的規則回答的是「建立連線後如何處理請求」。這兩層設定須分開檢查;啟用 On Demand 不會自動建立伺服器資訊或規則設定。

在哪個介面:進入 Settings 尋找 On Demand 相關設定,確認目前可用的網路條件與動作。首次建立連線所需的 VPN 設定授權由系統確認;請先閱讀系統提示,再依實際需要允許。

如何設定:先關閉自動觸發相關設定,以手動方式完成一次連線驗證。確認伺服器、Global Routing 與設定檔運作正常後,再啟用 On Demand,並依介面提供的選項設定網路條件。若新增 Wi-Fi 名稱條件,請確認名稱正確,並了解該規則對應的動作。

注意事項:啟用後,連線可能在符合條件時重新建立,因此手動中斷連線不一定會持續斷線。測試自動行為時,先檢查 On Demand 條件,再切換一次目標網路並觀察結果。不要反覆刪除系統設定來取代條件排查;系統 VPN 標示存在,也不代表所有請求都會經過代理伺服器。

DATA / OBSERVATION

流量統計與連線記錄
用於確認實際狀況

是什麼:Data 提供 App 端的流量查看入口,協助了解連線期間的資料變化。統計僅反映 App 能記錄的範圍,不應直接等同於服務供應商的用量帳單,也不是網路速度測試報告。統計週期、重設方式及遠端計費標準可能不同。

在哪個介面:開啟底部的 Data,查看目前介面提供的統計與記錄項目。若要分析單次請求,可搭配 App 提供的連線記錄入口,檢查目標、時間及可顯示的策略資訊;可用欄位以實際介面為準。

如何設定:開始驗證前,先記下目前計數與時間,再連線至明確的目標,返回 Data 觀察變化。若要重新開始比較,先確認重設選項的適用範圍,並儲存仍需保留的資訊後再操作。比較兩次測試時,應使用相同網路、目標與操作,減少背景活動造成的干擾。

注意事項:計數增加只表示有資料傳輸,不能單獨證明目標服務已正常運作。連線失敗時,仍可能產生 DNS 查詢、交握或重試流量。查看記錄時,依時間定位剛發出的請求;分享前遮蔽網域、位址及可能涉及個人活動的資訊,切勿提交完整的敏感記錄。

SETTINGS / DIAGNOSTICS

常用輔助設定
依問題逐項調整

以下項目可從 Settings 或目前設定檔的相關入口檢查。設定名稱保留英文原文;入口分組與可用功能以 App 目前顯示為準。

DNS:先確認解析由哪一層設定

是什麼、在哪裡:DNS 會將網域解析為位址,相關選項可能位於 Settings 的 DNS 設定,以及目前 Config 的 DNS 欄位。兩處都應確認,不能只憑單一開關判斷實際解析路徑。

如何設定:先記下目前值,確認使用的是系統 DNS、自訂 DNS 還是 DNS over HTTPS,再只調整與目標問題相關的一項。重新測試同一網域時,留意快取的影響,並搭配連線記錄確認 DNS 解析與連線是否各自成功。

注意事項:加密 DNS 不等於代理連線,DNS 解析成功也不代表目標連接埠可連線。伺服器位址本身可能需要先經過 DNS 解析,不當設定可能造成連線相依問題。沒有明確故障證據時,先保留可正常運作的設定。

Test Method:決定測試條件,不代表實際速度

是什麼、在哪裡:Settings 中的 Test Method 用來選擇伺服器測試方式,會影響 Connectivity Test 的測量方式,以及結果較接近哪個連線階段。

如何設定:先閱讀目前方式的說明,選定後比較同一組既有伺服器;若介面允許設定測試目標,應保持目標一致。切換方式後重新測試,不要將新舊方式測得的數值混在一起排序。

注意事項:測試數值較低,不代表持續傳輸一定更快;測試失敗時,也須分辨是目標無法連線、交握失敗或本機網路問題。最後應以實際服務的持續連線狀況再次確認。

Today Widget:提供系統端的快速查看入口

是什麼、在哪裡:Today Widget 相關設定可用於系統支援的快速查看或操作入口。可先在 Settings 尋找對應項目,再前往系統允許新增小工具的位置確認是否可用。

如何設定:依介面提供的選項設定顯示內容或動作,新增後確認顯示狀態是否與 App 內一致。系統支援的形式以目前裝置與 App 實際提供的功能為準。

注意事項:快速入口不能取代完整的設定檢查。顯示狀態可能需要重新整理;發生連線問題時,仍應開啟 Home 確認伺服器與 Global Routing,不要只根據小工具中的標示下結論。

iCloud:區分同步、還原與備份

是什麼、在哪裡:iCloud 相關功能可在支援範圍內儲存或同步資料。請從 Settings 檢查 App 提供的 iCloud 項目,同時確認系統是否允許 App 使用 iCloud。

如何設定:啟用前先儲存一份可還原的資料,閱讀實際同步項目與覆寫提示;更換裝置後,確認資料已完成同步,再決定是否啟用連線。不要假設伺服器選取狀態、統計記錄與所有設定都會一併移轉。

注意事項:透過 App Store 還原已購項目,是重新取得 App 購買項目,不等於還原 App 內設定。同步會傳播資料變更,無法完全取代獨立備份;訂閱網址與驗證參數屬於敏感資料,應依個人帳戶的安全需求妥善管理。

Diagnostics:先判斷故障層級,再保留必要資訊

是什麼、在哪裡:Diagnostics 是輔助排查入口,可在 Settings 的相關工具區域尋找。它用於收集與檢查 App 可提供的診斷資訊,不會自動修正伺服器參數或分流規則。

如何設定:先記下異常發生時間、目前網路、Global Routing 與選取的伺服器,再執行與問題相關的診斷。重現一次問題後,儲存必要結果並與正常情況比較;不要持續變更設定後,才一次收集大量記錄。

注意事項:診斷內容可能包含網域、位址、設定片段或驗證資訊。對外分享前,應逐項檢查並遮蔽敏感內容;不能因為產生診斷結果,就認定問題一定出在本機或遠端。

CHECK IN ORDER

設定完成後的檢查順序

  1. 確認資料。在 Home 檢查選取的伺服器與協定欄位;成功匯入訂閱後,仍須確認已實際選取項目。
  2. 確認模式。確認 Global Routing。使用 Config 時,接著確認目前設定檔與相關策略目標。
  3. 手動驗證。先測試一次明確的連線操作,再到 Data 或連線記錄查看對應時間的變化。
  4. 單項比較。需要排查時,每次只變更模式、伺服器或 DNS 其中一項,並在每次變更後建立新連線。
  5. 恢復日常狀態。排查完成後,恢復預期模式,再檢查 On Demand、同步與快速入口,避免留下臨時設定。

首次使用可依使用說明完成完整流程;需要管理多個既有訂閱時,請前往訂閱手冊逐章確認。App 購買、裝置相容性與系統要求一律以 App Store 頁面標示為準;取得前可先閱讀正版驗證說明。

Shadowrocket 正版下載