官方手冊 · 功能與設定

Shadowrocket
功能與常用設定

先確認 Global Routing,再檢查伺服器與規則。依功能查找介面位置、設定步驟和注意事項,避免一次變更多個項目。

路由設定入口

Global Routing 三種模式

設定、代理、直連分別對應 Config、Proxy、Direct。先確認這個選項,再判斷規則是否生效。

功能說明:Global Routing 決定交由用戶端路由處理的流量採用哪種方式。它和 Home 頂端的連線開關是不同設定:開關控制是否啟用連線,Global Routing 則控制啟用後的路由模式。開關已開啟,不代表所有要求都會經過目前的伺服器。

介面位置:在 Home 找到 Global Routing,開啟後選擇 Config、Proxy 或 Direct。日常依網域、IP 和地區分流通常使用 Config;想暫時確認伺服器出口是否正常,可用 Proxy 比較;檢查本地網路是否正常時,可短暫切換至 Direct 比較。

Global Routing 使用情境與檢查重點
模式 / 介面名稱處理方式適用情境注意事項
設定 / Config依目前啟用的設定檔規則選擇策略。日常分流,依網域或 IP 區分連線。務必確認實際啟用的設定檔及規則順序。
代理 / Proxy以代理模式處理交由用戶端接管的流量。暫時確認目前伺服器,排除部分規則的影響。無法修復伺服器逾時,也不代表系統中的每個連線都會由用戶端接管。
直連 / Direct以直連模式連線至目標。比較本地網路與代理路徑的差異。直連正常不能證明伺服器正常。

設定方式:先記下目前選項,選擇一種模式,再使用相同目標和同一個網路重複測試。若 Proxy 正常、Config 異常,優先檢查設定檔中的規則與策略;若兩者都異常,再檢查伺服器連線與 DNS。不要同時切換伺服器、網路和模式,否則無法判斷問題出在哪項設定。

注意事項:測試後請恢復預期模式。若將 Proxy 當成長期排查設定而忘了切回 Config,原本預期直連的要求也會改變路徑;若日常使用時一直維持 Direct,可能會誤以為原有規則失效。

規則類型與策略選擇

功能說明:規則由比對條件和處理策略組成。DOMAIN、DOMAIN-SUFFIX 等關鍵字決定「比對什麼」,PROXY、DIRECT、REJECT 則決定「比對後如何處理」,兩者不可混為一談。規則分流也需要 Global Routing 設為 Config,並確認 Config 啟用的是預期的檔案。

介面位置:進入 Config,查看目前啟用的設定檔及其中的 [Rule] 區段。規則通常依排列順序比對,前面的規則先符合時,後面的備用規則就不會再生效。因此,特定網域規則應放在可能涵蓋它的廣泛規則之前,FINAL 通常置於最後。

關鍵字比對對象設定時檢查
DOMAIN完整網域。是否只需符合這個網域。
DOMAIN-SUFFIX網域本身及其子網域。涵蓋範圍是否超出預期。
DOMAIN-KEYWORD網域中的關鍵字。關鍵字是否太短,造成額外比對。
GEOIPIP 的地區歸屬。歸屬資料庫的結果可能與實際出口不同。
IP-CIDR / IP-CIDR6IPv4 / IPv6 位址範圍。位址類型與網段範圍是否正確。
FINAL前面的規則都未符合的要求。備用策略是否符合預期。

設定方式:先儲存原有設定,再針對一個明確目標新增規則。以下僅為語法範例,example.com 是說明用網域,並非伺服器或訂閱網址。範例將該網域及其子網域交由 PROXY 處理,將符合 GEOIP CN 的要求設為 DIRECT,其餘要求則使用 FINAL 指定的策略。

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

注意事項:PROXY 需要可用的伺服器或相應策略;DIRECT 不會經過該代理路徑;REJECT 則會拒絕符合條件的要求。不要將 REJECT 當成連線失敗時的自動備援。編輯後請確認實際符合的規則,不要只確認檔案中是否有該行;DNS 解析出的位址、IPv6 連線和前置規則,都可能影響比對結果。

USER-AGENT 等依賴要求內容的條件,也會受到流量可見範圍影響,不能把它當成辨識所有加密連線中應用程式的方式。若目標會使用多個網域,也不能只憑一條網域規則就判斷該應用程式的所有流量路徑。

訂閱與伺服器管理

伺服器資訊、訂閱清單和規則設定各有不同用途;匯入成功不代表已完成連線測試。

功能說明:單一伺服器記錄連線位址、連接埠、協定及驗證等參數;Subscribe 用來更新既有訂閱中的伺服器清單;Config 則儲存規則與全域參數。更新伺服器清單不一定會更新目前的規則檔案,切換設定檔也不代表預設伺服器已切換。

介面位置:在 Home 查看伺服器清單,透過 Add Server 手動新增自己已有的伺服器,或使用 Scan QR Code 匯入自己已有的資訊。新增訂閱時,依目前介面選擇 Subscribe,並輸入自己的訂閱網址。各平台的選單位置可能不同;操作後請回到 Home 檢查清單內容。

設定方式:手動輸入時,先依伺服器資料選擇協定,再逐項確認位址、連接埠及驗證欄位。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 的欄位不能混用;涉及 TLS、傳輸方式或伺服器名稱時,也必須符合既有資料,不能只靠連接埠猜測協定。

  1. 先確認訂閱網址完整,避免複製時帶入空格、換行或漏掉查詢參數。
  2. 匯入後執行更新,確認清單中是否出現預期的伺服器;更新失敗時先記錄錯誤,不要急著刪除舊清單。
  3. 在 Home 選擇預設伺服器,確認選取標記,再執行 Connectivity Test。
  4. 保留一個已確認可用的基準,逐一比較其他伺服器,避免批次修改後無法還原。

注意事項:訂閱網址可能包含可識別帳戶的資訊,分享截圖或記錄前請先遮蔽;不要將完整網址貼到公開留言中。更新訂閱可能覆蓋該群組中的記錄,手動修改前請先確認下次更新是否會取代內容。Connectivity Test 的結果只代表該測試方法下的連線可達性,仍須實際開啟目標確認。

On Demand 隨選連線

功能說明:On Demand 可依系統支援的網路條件觸發連線。它處理的是「何時建立連線」,不會取代 Global Routing 決定「連線後如何分流」,也不會自動修復失效的伺服器或過期訂閱。

介面位置:在 Settings 找到 On Demand 及相關條件設定。不同系統支援的條件可能不同,請先閱讀目前選項再決定是否啟用;不要把某平台的條件清單直接套用到其他平台。

設定方式:先確認手動連線時伺服器和規則都正常,再設定要觸發連線的網路條件。一次只新增一種條件,接著在 Wi-Fi 與行動網路之間切換,觀察是否依預期建立或結束連線。若介面允許為特定網路設定例外,請一併檢查例外與一般條件,避免設定互相覆蓋。

注意事項:手動關閉連線後又自動連上,可能是隨選條件仍然成立,不一定是開關異常。若要暫時停止自動連線,應一併檢查 On Demand,而不是反覆操作 Home 開關。網路頻繁切換時,也請留意重新連線的次數,分辨是隨選觸發、系統休眠還是伺服器中斷;不能只憑狀態列圖示判斷原因。

Data 流量統計

用來觀察連線變化與流量趨勢,不能取代網路業者或伺服器端的流量統計。

功能說明:Data 顯示用戶端可記錄範圍內的流量與連線資訊,可用來觀察哪個時段發生傳輸,以及連線後是否有上傳或下載。這是排查線索,不是所有裝置流量的統一帳單;系統未經用戶端處理的流量及不同統計方式都可能影響結果。

介面位置:開啟 Data,先確認目前顯示的統計範圍和時間,再查看可用的明細。不同版本或平台顯示的項目可能不同;比較資料時請使用相同範圍,不要直接比較單次連線數據與累計數據。

設定方式:排查特定目標時,先記下目前數據,再單獨存取一次該目標並觀察增量。若介面提供重設統計功能,請先保存需要的記錄,再執行重設;重新連線不一定會清除所有累計數據。搭配要求記錄查看符合的策略,才能判斷傳輸是否經過預期路徑。

注意事項:上傳與下載數字變化只能表示有資料傳輸,不能證明網頁已完整載入;測試、背景同步和重試也會產生流量。若持續重試但頁面沒有顯示,應一併檢查 DNS、連線錯誤和規則。發現耗電或流量異常時,先比較關閉背景工作的結果,再找出具體連線,不宜直接歸因於單一開關。

Settings 常用項目

先記下原始值,再一次調整一個項目;也要一併確認目前設定檔中的相關參數。

DNS:先確認是否為解析失敗

功能與位置:DNS 會將網域解析為連線所需的位址。在 Settings 找到 DNS 相關項目,同時檢查 Config 的 [General] 是否包含 dns-server 等參數。若設定頁和設定檔中都有相關項目,請確認實際生效的設定,不要假定修改其中一處就能涵蓋所有情況。

設定方式:先記下目前值,測試數個明確網域,再判斷是否需要更換解析方式。若所有伺服器都只有在使用網域存取時失敗,DNS 是優先檢查項目;若只有單一目標異常,也應檢查該目標的規則與服務狀態。修改後以相同目標重新測試,並留意快取對結果的影響。

注意事項:解析器本身也必須可連線。不要把隨意找到的位址寫進設定,也別把 DNS 當成修復驗證錯誤或連接埠逾時的通用方法。若涉及 IPv6,請一併檢查取得的位址類型及目前網路是否可連線至 IPv6。

Test Method:統一測試方式

功能與位置:Settings 中的 Test Method 決定相關連線測試採用的方法。不同方法檢查的連線環節不同,因此不能脫離測試方法直接比較兩個數值;某一種方法失敗,也不能單獨證明所有實際要求都會失敗。

設定方式:先選擇符合目前排查目的且介面支援的方法,再到 Home 執行 Connectivity Test。比較多台伺服器時,請保持方法、網路和測試目標一致;必要時重複測試,並以實際存取結果再次確認。

注意事項:測試耗時不等於下載速度,單次耗時也不能證明長期穩定性。不要為了取得更小的數值而反覆更換方法,卻忽略實際連線是否成功。

Today Widget:快速入口與狀態確認

功能與位置:Today Widget 是系統允許時提供的快速控制入口。先在 Settings 查看相關選項,再到系統的小工具介面確認是否可以加入;不同系統版本對小工具形式及背景操作的限制各不相同。

設定方式與注意事項:只有在目前系統提供相應入口時才新增,操作後回到 Home 確認實際狀態。小工具顯示可能有更新延遲,不要將舊狀態當成目前的連線結果。若找不到相同入口,請以目前系統支援的功能為準,不必為此反覆重設設定。

iCloud:同步前先保護本機設定

功能與位置:在支援 iCloud 的 Apple 裝置上,Settings 中的相關選項可管理應用程式支援範圍內的雲端同步。這不等於會將所有設定、連線狀態和記錄完整複製到另一台裝置。

設定方式:先保存重要設定,再確認系統已登入預期帳戶、iCloud 可正常使用,且應用程式權限已開啟。首次在另一台裝置使用時,請等候同步完成,再檢查檔案內容、目前啟用的項目及預設伺服器,不要直接覆蓋既有的本機檔案。

注意事項:同步不能取代獨立備份,刪除或覆蓋的變更也可能同步到其他裝置。若兩端內容不一致,先保留兩份副本再比較,不要連續在兩端編輯同一個檔案;不同平台之間的設定移轉也不能一概視為可由 iCloud 自動完成。

Diagnostics:收集可重現的錯誤資訊

功能與位置:在 Settings 找到 Diagnostics 及可用的診斷入口,收集連線問題相關資訊。請針對一次明確重現的問題檢視記錄;長時間累積且混雜的記錄,往往難以判斷哪一筆錯誤與目前問題有關。

設定方式:記下網路類型、Global Routing、目前伺服器及目標,接著重現一次問題,再查看相近時間的解析、連線或規則記錄。先分辨 DNS 失敗、連線逾時、驗證錯誤和規則比對異常,再進行相應排查。

注意事項:提交診斷資訊前,請遮蔽訂閱網址、驗證欄位及其他個人資料。診斷完成後,恢復日常所需的記錄層級,避免長期保留不必要的記錄。更多症狀分類說明請見疑難排解手冊。

設定後的檢查順序

各項功能彼此相關:伺服器無法連線時,調整規則通常無法解決問題;Global Routing 未設為 Config 時,單獨修改 [Rule] 也可能看不到預期效果。請依下列順序驗證,讓每一步的結果都能對應到明確設定。

  1. 確認基本網路。記下目前使用 Wi-Fi 或行動網路,先確認網路本身可正常使用;比較時不要同時切換網路。
  2. 確認伺服器。在 Home 檢查預設選擇與參數,使用 Connectivity Test 記錄基準,再實際存取目標。
  3. 確認路由模式。檢查 Global Routing;使用 Config 時,進一步確認啟用的設定檔,而不只是檔案名稱是否存在。
  4. 確認解析與規則比對。查看 DNS 結果、規則順序和最終策略。一次只修改一條相關規則,儲存後重新測試。
  5. 確認自動行為。手動連線正常後,再測試 On Demand、同步和快速入口,避免多個自動操作影響判斷。
  6. 保留有效結果。記下讓問題恢復正常的具體變更;若沒有改善,先還原再嘗試下一項,不要疊加不確定的設定。

第一次操作可依使用教學完成匯入與首次連線;若錯誤能穩定重現,請進入疑難排解手冊依症狀檢查。常見設定問題集中於FAQ,不必為了排查單一目標而重新設定所有功能。

免費下載 Shadowrocket