OFFICIAL MANUAL / FEATURES

Shadowrocket 功能與設定

先選擇 Global Routing,再檢查規則與伺服器;連線建立後,使用 Data 與 Diagnostics 確認實際處理結果。

  • 路由模式與規則策略
  • 既有服務資訊管理
  • 設定與診斷入口

本篇是 Shadowrocket 官方手冊的功能參考,主要說明 iPhone / iPad 上的操作方式。功能名稱保留英文原文;入口位置、可選項目與系統需求請以 App Store 頁面標示及裝置上的實際介面為準。首次設定可先閱讀入門指南,需要取得 App 時請參閱App Store 取得說明。

路由入口01 / ROUTING

Global Routing 三種模式

Global Routing 決定請求採用哪一種路由方式,通常可從 Home 進入。這項設定與目前選取的伺服器不同:選好伺服器,不代表所有請求都會經由該伺服器;是否走代理路徑,還要看目前模式與規則比對結果。日常依規則分流時使用 Config;要確認所選伺服器的基本連線能力,可暫時使用 Proxy;檢查目前網路的直接連線情況,則可使用 Direct。

設定前先記下原本的模式,再選擇本次需要的模式,回到 Home 確認伺服器與連線開關。測試結束後,請恢復預期設定。切換模式會影響之後的請求,既有連線可能仍維持原狀;驗證時請重新發出請求,必要時重新建立連線,不要只查看持續開啟的頁面。

模式 處理方式 適用情境 檢查重點
設定 · Config 依目前啟用的設定檔與規則選擇策略。 需要讓不同網域或位址走不同路徑時。 確認設定檔已啟用、規則順序、策略目標及 FINAL。
代理 · Proxy 透過代理路徑處理流量,用來檢查所選伺服器的連線情況。 需要排除規則因素,確認伺服器基本可用性時。 伺服器參數、連線能力及目標網站是否可存取。
直連 · Direct 採用直接連線,不經由代理伺服器轉送。 確認目前網路的直接連線結果時。 本地網路、DNS 與目標網站本身的狀態。
規則設定02 / RULES

規則類型與策略目標

規則說明「比對哪些內容」,策略則說明「比對成功後如何處理」。在 Config 中選取要使用的設定檔,再檢視或編輯其中的規則。通常會由上而下依序比對,符合第一條適用規則後便採用其策略;FINAL 則指定先前未符合任何規則的請求應如何處理。因此,精確規則通常應排在較廣泛的規則之前,不能只確認檔案中是否出現某個網域。

常見規則類型

DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對指定網域及其子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對。IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址網段;GEOIP 依據 IP 位址的地理歸屬資訊比對。USER-AGENT 取決於請求中是否包含相應資訊,不能視為適用於所有加密流量的通用條件。

PROXY、DIRECT 與 REJECT

PROXY 指定由代理處理,DIRECT 指定直接連線,REJECT 則拒絕符合條件的請求。設定檔也可能引用具名策略或策略群組,此時還須確認目標存在、名稱相符,且目前選取的項目符合預期。介面中的 Proxy 是模式名稱,規則中的 PROXY 是策略關鍵字,編輯時請保留各自原本的寫法。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

以上僅為規則順序範例,並非可直接取代日常設定的完整檔案。此處的 DOMAIN-KEYWORD,ads 只用來示範關鍵字比對,可能涵蓋非預期的網域;修改前應先確認比對範圍。請保留原設定檔副本,每次只修改一類規則,再以新的請求驗證,避免同時變更規則、DNS 與伺服器而無法判斷原因。

服務資訊03 / SERVERS

訂閱與伺服器管理

伺服器記錄會保存連線位址、連接埠、協定及驗證等參數;訂閱則用於集中管理一組記錄。以下操作皆以使用者已有自己的訂閱或伺服器資訊為前提。Home 可用來查看、選取及管理伺服器;Add Server 用於新增記錄;Scan QR Code 可辨識支援的 QR Code 內容。匯入前先確認內容是訂閱連結、單一伺服器 URI,還是含有規則的設定檔,三者不能只因連結外觀相似就互相替代。

手動新增時,先確認 Type,再依序填入位址、連接埠及協定所需參數。例如 Shadowsocks、VMess、VLESS、Trojan 對驗證與傳輸設定的要求各不相同;HTTP、SOCKS5 等類型也須符合服務資訊。不要根據名稱猜測參數,也不要為了讓設定成功儲存而任意刪除 TLS、傳輸或憑證相關欄位。

Subscribe 與設定檔的差異

Config 頁面中的 Subscribe 用於相應的設定訂閱操作;管理伺服器訂閱時,請使用伺服器訂閱的匯入入口或支援的匯入方式。匯入後可依內容確認結果:伺服器記錄應出現在 Home,規則設定則應出現在 Config,並視需要啟用。若解析失敗,先確認輸入類型與連結是否完整,不要反覆將同一內容匯入不同位置。

重新整理訂閱主要是更新來源提供的記錄,不代表目前的規則設定也會同步調整。更新後請確認目前選取的伺服器仍存在、是否出現重複記錄,以及自訂備註是否仍能辨識。刪除舊訂閱前先確認其所屬來源,避免誤刪仍在使用的手動記錄。含有驗證資訊的訂閱連結、QR Code 與伺服器詳細資料都應妥善保管,不要貼到公開討論區。

依照步驟完成首次匯入 →
連線條件04 / ON DEMAND

On Demand 按需連線

On Demand 可依設定條件觸發連線,不負責選擇具體規則策略,也不能取代伺服器可用性檢查。請在 Settings 中尋找 On Demand 相關選項,並依實際介面查看可用的網路條件。設定前先手動連線,確認伺服器與規則運作正常,再新增自動觸發條件;遇到問題時,才能分辨是服務本身無法使用,還是未符合連線條件。

設定時請明確指定要在哪些 Wi-Fi 或行動網路環境下連線,逐項確認條件、適用範圍及儲存結果。完成後分別在指定網路與另一種網路環境中重新測試,確認系統連線狀態符合預期。iPhone 與 iPad 支援的網路功能可能不同,請依裝置實際提供的選項設定,不要直接照搬另一部裝置的條件。

啟用 On Demand 後,手動中斷連線不一定代表之後會持續保持中斷;系統再次符合條件時,可能會重新觸發連線。若要暫時停止自動連線,請先檢查 On Demand,而非反覆操作 Home 的開關。耗電也不應只歸因於此選項,還須一併考量實際流量、伺服器重新連線、訊號狀況與背景活動。修改規則或排查連線問題期間,可先停用自動觸發,完成驗證後再重新啟用。

使用記錄05 / DATA

Data 流量統計

Data 用於查看客戶端記錄的流量資訊。進入 Data 後,先確認頁面顯示的統計範圍與計算方式,再查看傳送、接收等記錄。統計數值可協助確認連線後是否有資料傳輸,但無法單獨證明特定請求已採用預期策略;若要判斷實際連線路徑,應搭配規則比對資訊或可用的連線記錄。

驗證時可先記下目前數值,發出一筆明確的存取請求,再返回查看變化。背景 App、系統服務及既有連線都可能產生流量,因此不要把短時間內的所有增量都視為剛開啟單一網頁所產生。若準備清除計數,請先保存必要記錄,並確認重設影響的範圍;不同統計週期的數值不適合直接相減比較。

Data 不是伺服器端的帳戶餘額,也不等同電信業者的計費帳單。伺服器端統計可能採用不同計費方式、時間範圍或額外開銷,數值不一致時,請先確認統計口徑是否相同。若遇到「連線狀態正常,但沒有預期流量」,請依序檢查目前伺服器、Global Routing、是否重新發出目標請求,以及是否因符合 DIRECT 而未使用代理路徑。

常用選項06 / SETTINGS

Settings 常用設定

Settings 集中提供 App 行為與工具相關選項。調整前先確認目前的設定檔是否也定義了相關參數,避免只修改全域設定,卻忽略正在使用的設定內容。以下依用途說明各項目;實際分類位置與可選值請以裝置上的介面為準。每次修改後都要儲存並驗證,且保留原值以便還原。

DNS:網域名稱解析

DNS 負責將網域名稱解析為可連線的位址。可從 Settings 的 DNS 相關入口確認解析設定,同時檢查 Config 中目前設定的 DNS 內容。排查時先區分「網域解析失敗」與「取得位址後連線失敗」:若伺服器使用網域名稱,其解析結果也可能影響連線建立。設定自訂 DNS 位址前,請確認格式、可連線性與使用情境;不要把更換 DNS 當成所有問題的通用解法。

若涉及 IPv6、區域網路網域或不同網路環境,也應檢查解析結果是否適用於目前網路。變更 DNS 後請重新發出請求,必要時重新連線,並留意快取的影響。不要以停用憑證驗證取代 DNS 排查;憑證錯誤、網域錯誤與路由錯誤應分別處理。

Test Method:連線測試方式

Test Method 用於選擇連線測試所採用的方法,可在 Settings 中查看。設定後回到 Home 使用 Connectivity Test,並依本次選用的方法解讀測試結果。不同方法驗證的環節不同,耗時數值也不適合跨方法直接比較;測試目標、目前網路與伺服器狀態都會影響測試結果。

單次測試成功,只能表示在該測試條件下,相應連線路徑可用,不代表所有目標網站、DNS 與規則都正確。測試失敗時,先確認所選方法與測試目標是否適用,再檢查伺服器參數及網路狀態。為方便比較,請在相同網路與相同方法下測試;不要連續修改多項設定後,只保留最後一次結果。

Today Widget:快速查看與操作

Today Widget 相關設定可管理系統元件能顯示或操作的內容。先在 Settings 中查看對應選項,再前往系統允許新增元件的位置完成設定;能否新增、顯示樣式與更新行為取決於系統和裝置實際支援的功能。元件適合日常快速操作;完整設定仍應在 App 內進行。

元件顯示可能受系統更新頻率影響,不能只憑元件上的舊狀態判斷目前連線情況。若狀態不一致,請開啟 Home 確認連線與伺服器;鎖定畫面上顯示的內容,也應依個人隱私需求選擇。

iCloud:同步與換機準備

請在 Settings 中查看 iCloud 相關選項,並確認系統的 iCloud 權限是否允許 App 使用相應功能。同步前先核對目前介面明確列出的同步項目;不要預設伺服器、設定檔、所有設定與使用記錄都會一併同步。更換裝置前,先確認重要內容確實已出現在新裝置上,並備份必要資料。

iCloud 同步與透過 App Store 恢復已購項目是兩回事:前者涉及 App 內容,後者用於恢復取得 App 的資格。更換裝置後,仍須檢查服務資訊、已啟用的設定檔及系統連線授權。購買記錄與恢復順序的說明,請參閱已購項目恢復說明。

問題排查07 / DIAGNOSTICS

Diagnostics 與驗證順序

Diagnostics 提供協助定位問題的診斷入口,可在 Settings 中尋找。使用前先記下問題發生時的網路環境、目前伺服器、Global Routing 與設定檔名稱,再執行實際可用的檢查。診斷輸出只能協助縮小問題範圍,不保證會自動修復;應將結果與實際存取情況對照,不要只憑一行提示就認定所有設定正常。

可依照以下順序建立最精簡的驗證流程。每一步只變更一項因素,並保留變更前後的結果。若暫時切換至 Proxy 後可以存取,但在 Config 下失敗,請優先檢查規則、策略目標與設定內容;若兩種模式都無法存取,則進一步確認伺服器資訊、DNS 與目前網路。Direct 的結果只反映直接連線情況,不能據此推斷代理伺服器一定正常。

  1. 確認基本狀態。確認目前網路可正常建立連線、系統授權已完成,且 Home 選取的是預期伺服器。
  2. 測試伺服器。使用相同的 Test Method 執行 Connectivity Test,確認位址、連接埠、驗證資訊與協定參數。
  3. 檢查路由。確認 Global Routing,並檢查 Config 中已啟用的設定檔、規則順序及 FINAL 的指向。
  4. 檢查 DNS。區分解析失敗與連線失敗,記錄目前的解析設定,再視需要單獨調整。
  5. 重新發出存取請求。搭配 Data 與可用的記錄確認結果,排除舊連線與快取造成的誤判。

對外提供診斷資訊前,請確認其中是否包含訂閱連結、驗證欄位、伺服器詳細資料或存取記錄,並先移除敏感內容。描述問題時保留「操作前提、執行步驟、實際結果、預期結果」,比只寫「無法連線」更容易重現與定位。