官方手冊 · 功能介紹

Shadowrocket 功能與常用設定

先確認 Global Routing,再檢查規則與伺服器。依功能所在介面、設定方式及影響範圍,逐項建立可供檢查的設定。

  • Config / Proxy / Direct
  • Rule 與策略
  • Settings 檢查清單
01 · Global Routing

Config、Proxy、Direct 三種模式

Global Routing 決定連線的整體處理方式;選取伺服器不代表所有連線都會經過該伺服器。

在 Home 開啟 Global Routing,可選擇 Config、Proxy 或 Direct。這裡的「設定、代理、直連」是三種模式的中文說明,介面用詞仍為 Config / Proxy / Direct。日常使用通常從 Config 開始,讓目前設定中的規則決定各連線採用的策略;只有需要縮小排查範圍時,才暫時切換至另外兩種模式。

模式與介面用詞處理方式適用情況注意事項
設定 · Config依照目前設定中的規則與策略處理連線。日常使用時,需要依不同網域、地址或網路用途分別處理。先確認目前啟用的 Config,以及規則所引用的策略。
代理 · Proxy以代理路徑處理流量,仍受系統與客戶端處理範圍限制。暫時判斷問題是否與規則分流有關。這不是提升速度的開關;伺服器故障時,切換至此模式無法修復伺服器。
直連 · Direct透過裝置目前網路的直接連線路徑處理流量。與原始網路狀態比較,確認問題是否與代理路徑有關。這不等於關閉客戶端連線開關,也不保證其他設定不再造成影響。

設定與驗證方式

先在 Home 記下目前的 Global Routing 模式與所選伺服器,再切換一種模式,透過相同網路存取同一目標。盡量重新建立連線,避免沿用舊連線而影響判斷。若 Proxy 可用但 Config 不可用,請著重檢查符合條件的規則及其策略引用;若 Direct 也失敗,應先確認本機網路、目標服務狀態與系統時間。比較完成後,請恢復原本的模式,不要長期保留暫時性的排查設定。

02 · Rule / Config

規則負責比對,策略負責處理

先確認符合哪條規則,再查看該規則指向的策略。

功能說明與所在介面

規則分流會依據網域、IP 位址等條件選擇處理路徑。在 Config 中選取目前使用的設定,再查看其中的 Rule 內容。規則通常依序比對,較具體的條件應排在較廣泛的條件之前;末尾的 FINAL 會為未符合前述規則的連線指定處理策略。

DOMAIN 用於比對完整網域,DOMAIN-SUFFIX 用於比對網域及其子網域,DOMAIN-KEYWORD 依網域中的關鍵字比對。IP-CIDR 與 IP-CIDR6 分別表示 IPv4、IPv6 位址範圍;GEOIP 依位址所屬地區資料比對。USER-AGENT 適用於能取得相應請求資訊的情境,不適合用作所有連線都能使用的應用程式識別條件。

設定方式與注意事項

DIRECT 表示直接連線,REJECT 表示拒絕連線。PROXY 應依目前設定中的實際定義解讀為代理策略;自訂策略名稱也必須有效存在於設定中。即使規則文字正確,若所引用的策略失效,連線仍可能無法依預期處理。

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

以上為語法範例,不能直接取代現有的完整設定檔。修改前請保留副本,每次只調整一組條件,再透過連線記錄確認比對結果。REJECT 只會拒絕符合條件的連線;同一網域若承載多種內容,依網域拒絕也可能影響正常功能。

03 · Subscribe / Add Server

管理既有訂閱與伺服器

訂閱是更新伺服器資料的入口,設定檔則是規則與設定的集合,兩者用途不同。

Subscribe:集中更新既有伺服器資料

在 Home 的新增入口中,依實際介面選擇 Subscribe,輸入自行持有的訂閱 URL,並設定容易辨識的名稱。儲存後執行更新,再確認伺服器列表是否出現預期項目。更新訂閱會同步該入口回傳的資料,不代表目前 Config 中的規則也一定會一併變更。

匯入前請確認 URL 完整無誤,特別留意複製時多出的空格、換行,以及遺漏的查詢參數。訂閱連結可能包含身分驗證資訊,應如同密碼妥善保管,勿貼入公開記錄或截圖。更新失敗時,先依錯誤類型分別處理:網址無法連線、身分驗證失敗及回傳格式不相容的處理方式各不相同,不宜反覆刪除所有設定。

Add Server:逐項新增單一伺服器

手動新增時,請先在 Add Server 選擇正確的協定類型,再依照既有伺服器資料填寫位址、連接埠與驗證參數。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2 的欄位不可互相套用;名稱同為「密碼」或「金鑰」的欄位,格式也不一定相同。

使用 Scan QR Code 時,請確認 QR Code 確實對應要匯入的伺服器資料;匯入後仍須檢查協定與欄位。儲存時請使用能區分用途的備註,避免只依列表順序選取伺服器。刪除項目前先確認其來源:由訂閱產生的項目可能在下次更新後再次出現,手動建立的項目則應另外備份。

切換與測試的限制

選取伺服器後,可使用 Connectivity Test 檢查目前條件下的連線狀況。測試結果反映特定方法、目標與時間點的狀況,不代表所有網站都能正常存取,也不是頻寬測試。切換後若舊頁面沒有變化,請重新發出請求,並同時確認 Global Routing 是否依預期將目標交由所選策略處理。

04 · On Demand

依網路條件觸發連線

On Demand 管理何時建立連線,不會取代 Rule 對個別連線處理策略的判斷。

功能說明與所在介面

On Demand 利用系統提供的隨選連線機制,依已設定的網路條件觸發連線行為。請在 Settings 中尋找 On Demand 相關入口,具體條件與可選動作以目前客戶端顯示為準。首次設定前,請先確認手動開啟連線可正常使用,避免混淆伺服器問題與自動觸發問題。

例如,使用者可依實際可用的選項,為特定 Wi-Fi 環境設定不同的連線行為。網路名稱是條件,是否建立連線則是結果;連線建立後,流量仍由 Global Routing 和目前設定決定路徑。

設定方式與注意事項

先新增一條容易驗證的條件,儲存後在符合條件的網路與其他網路之間切換,觀察連線是否依預期建立。若同時設定多條條件,請檢查其順序與涵蓋範圍。測試時應區分手動關閉連線與 On Demand 規則重新觸發連線,避免將自動重新連線誤判為開關失效。

On Demand 不保證應用程式在任何系統狀態下持續運作,也無法確保網路切換期間所有既有連線不中斷。若要徹底停止隨選觸發,應一併檢查 On Demand 設定,而非只反覆操作 Home 的連線開關。

05 · Data

查看流量統計與連線線索

Data 用於查看客戶端記錄的流量資訊。開啟 Data 後,先確認目前頁面顯示的時間範圍、統計類別,以及是否有重設操作,再解讀上傳與下載數值。不同平台與介面提供的統計項目可能不同,只有統計範圍一致時,前後數據才具可比性。

若要排查某項操作是否產生流量,可先記下目前數值,完成一次明確的存取後,再返回查看變化。若要清除統計資料,請先保存供比較的結果;重設會改變後續比較的基準。統計數值增加只表示客戶端記錄到相應資料,不能單憑此確認頁面已完整載入、規則已正確比對,或遠端應用程式已成功處理。

Data 並非服務提供者的計費帳單。客戶端統計範圍、協定封裝、重傳及遠端計量方式可能各不相同,不應據此直接推算剩餘用量。若流量異常增加,應搭配系統背景活動與連線記錄追查來源,不要只根據流量數值就同時變更 DNS、協定及規則等多項設定。

06 · Settings

DNS、測試方法與輔助功能

依用途分別調整常用設定;修改前記下原始值,驗證後再決定是否保留。

DNS:網域名稱解析設定

DNS 會將網域名稱轉換為連線所需的位址。在 Settings 的 DNS 相關入口與目前 Config 中,可能都有影響解析的選項;請先確認正在編輯哪一層設定,再檢查實際生效方式。不要假設修改某個頁面就會覆蓋所有設定。

請使用自己清楚了解且可連線的解析位址,並確認位址格式符合所選的解析方式。若只有透過網域存取失敗、已知位址卻可連線,DNS 是可排查的方向之一;若伺服器本身無法連線,單純更換 DNS 通常無法解決。也應將 IPv6、快取及不同網路回傳的位址差異納入比較。

Test Method:測試方式

在 Settings 中查看 Test Method,確認 Connectivity Test 使用的方法;可選項目以目前介面為準。不同方法檢查的環節不同,不能直接把某種測試的數值當作另一種測試的結論。

比較伺服器時,請保持測試方法、目標與裝置網路一致,再進行少量重複測試以觀察穩定性。單次測試成功不代表驗證、網域解析與實際應用程式請求都正常;測試失敗也可能是測試目標或方法受到限制。請繼續以實際使用情境驗證,不要只依列表中的單次結果排序。

Today Widget:快速查看與操作

Today Widget 是系統支援時可使用的快速入口,可用來查看狀態或執行客戶端提供的操作。請在 Settings 中尋找相關選項,並在系統的小工具管理介面確認是否可新增;入口是否顯示及可執行哪些動作,取決於系統與客戶端目前提供的支援。

設定後,先透過小工具執行一次操作,再返回 Home 確認實際連線狀態。小工具更新可能有延遲,不要只憑暫時顯示的文字或圖示判斷。若系統中找不到相應小工具,使用應用程式內的入口即可,不必為了尋找小工具而修改網路設定。

iCloud:同步與復原

在支援 iCloud 的 Apple 裝置上,先檢查系統帳號、iCloud 權限及 Settings 中的相關選項,再確認目前功能實際同步哪些資料。同步、匯出與備份並非同一回事,不應假設所有伺服器憑證、規則與執行狀態都會自動保持一致。

首次跨裝置同步前,請分別保留重要設定的可用副本;先在其中一台裝置進行小幅變更,等待同步後再檢查另一台裝置的結果。不要同時在兩端大量編輯,以免難以判斷覆寫順序。共用裝置也應留意帳號存取權限,避免將含有憑證的設定暴露給其他使用者。

07 · Diagnostics

沿連線流程找出問題

先記錄現象與相關情境,再運用診斷結果縮小排查範圍。

Diagnostics 用於取得排查線索,請在 Settings 中尋找相應入口;可用工具與記錄內容以實際介面為準。開始前記錄裝置網路、Global Routing、目前 Config、所選伺服器及目標位址,並說明故障發生在連線前、網域解析階段,還是請求送出後。相同現象可能源自不同環節,描述越具體,就越容易判斷下一步。

  1. 先確認基本網路。檢查裝置能否正常連線、系統時間是否正確,以及目標服務本身是否可用。若只有單一目標連線失敗,不要立刻重建所有伺服器列表。
  2. 接著確認伺服器資料。核對協定類型、位址、連接埠、驗證欄位及相關傳輸參數。若問題發生在訂閱剛更新後,請比較更新前後的項目差異,不要任意修改協定參數。
  3. 再檢查比對路徑。透過可用的連線記錄確認網域、符合的規則與最終策略。Config 和 Proxy 的結果不一致時,優先檢查規則順序、策略名稱及 DNS 結果。
  4. 最後逐項比較。每次只更換網路、伺服器、模式或一項設定;重新發出請求後記錄結果。如此才能判斷變化來自哪個步驟,避免多項修改互相影響、難以辨別。

分享診斷記錄前,請移除訂閱 URL 中的憑證、密碼、金鑰及不必要的裝置資訊,同時保留錯誤類型與必要的時間資訊。不要公開包含敏感欄位的完整設定檔。診斷資訊可作為判斷依據,但不保證能自動修復問題;排查完成後,請恢復暫時使用的模式與測試設定,並保留能清楚說明的最終設定。