官方手冊 / 功能與設定

Shadowrocket
功能與設定詳解

先確認 Global Routing,再檢查 Config 與伺服器。每次只修改一類設定,並以同一個目標重新測試,避免混淆規則、DNS 與連線問題。

查看首次連線教學

適用裝置:iPhone / iPad / Mac / Windows / Android / Linux。以下以 iPhone / iPad 介面說明;其他平台請依同名項目查找,實際入口與可用功能以目前平台介面為準。

01 / 整體處理方式

Global Routing 三種模式

入口:Home → Global Routing

Global Routing 決定用戶端如何處理納入接管範圍的請求。設定模式對應 Config,代理模式對應 Proxy,直連模式對應 Direct。日常依規則分流通常選擇 Config;排查特定請求是否受規則影響時,可暫時切換至 Proxy 或 Direct 作為對照。切換模式不等於更換伺服器,也不會自動修正帳號、連接埠或協定參數。

三種模式的用途與檢查項目
介面選項處理方式適用情境優先檢查項目
Config / 設定依目前啟用的設定規則選擇策略。日常規則分流,分別處理需要代理與直接連線的請求。確認 Config 已啟用,且規則順序與策略指向正確。
Proxy / 代理納入接管範圍的請求主要透過代理處理,仍須留意系統與設定中的略過項目。暫時排除規則比對錯誤,確認所選伺服器能否連線至目標。Home 中目前選取的伺服器、協定參數及伺服器端是否可用。
Direct / 直連納入接管範圍的請求皆以直接連線方式處理。確認目前網路本身能否連線至目標,或暫時停止使用代理策略。本地網路、DNS 與目標服務是否正常。

在 Home 開啟 Global Routing,選擇所需模式後返回,再以同一個網站或 App 發出新請求。既有的長連線可能仍沿用原本的連線路徑,必要時請關閉目標 App 後重新開啟。若 Proxy 可連線、Config 卻失敗,優先檢查規則與策略;若兩種模式都失敗,請先確認伺服器、網路與目標服務,不要立即擴大規則適用範圍。

02 / 比對與策略

Rule 規則分流

入口:Config → 目前設定中的 Rule

規則分流會將「請求符合哪些條件」與「符合後如何處理」分開。DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD 是網域相關條件;IP-CIDR、IP-CIDR6 用於比對位址範圍,GEOIP 用於判斷位址所屬區域。USER-AGENT 涉及比對請求標頭,只有用戶端能取得相應資訊時才有作用,不能視為適用於所有加密流量的 App 識別方式。

常見策略包括 DIRECT、PROXY、REJECT。DIRECT 表示直接連線,PROXY 交由代理策略處理,REJECT 則拒絕符合條件的請求。設定也可能使用自訂策略名稱;修改前請確認該名稱已在目前設定中定義,且指向預期的伺服器或策略群組。名稱相似不代表作用相同。

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

以上僅為語法範例,並非可直接取代現有設定的完整方案。DOMAIN 精確比對指定網域;DOMAIN-SUFFIX 也會比對其子網域;DOMAIN-KEYWORD 的範圍較廣,容易涵蓋原本不打算處理的網域。規則通常依序檢查,優先採用第一個符合的條件,因此具體規則通常應放在較廣泛的條件之前,並將 FINAL 放在最後,以處理其餘請求。

設定前先備份目前的 Config,新增一條範圍明確的規則,確認 Global Routing 設為 Config,再發出新請求並檢查記錄中的比對結果。若規則未命中,請核對實際連線的網域與重新導向後的網域是否一致;若已命中卻走錯路徑,請檢查策略指向,不要反覆新增相同條件。涉及 IP 判斷的規則,也要考量網域解析結果與設定中的解析選項。

03 / 匯入與管理

Subscribe 與伺服器管理

入口:Config / Subscribe、Home / Add Server

訂閱可用來批次取得並更新伺服器項目;伺服器項目則保存連線所需的位址、連接埠、協定與驗證參數。本文假設你已有自己的訂閱或伺服器資訊;訂閱連結請向你的服務商索取。購買或安裝用戶端後,不會自動取得可用的連線線路。

已有訂閱連結時,請從 Config 的 Subscribe 入口新增,儲存後執行更新,再回到 Home 確認項目。若只有單一伺服器資料,請使用 Add Server 選擇對應類型,再逐項填寫。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定所需欄位各不相同,請依服務商提供的資訊填寫,不能只複製位址和連接埠就當作設定完成。

Scan QR Code 和剪貼簿匯入適用於已有分享資訊的情況。匯入前請確認內容是伺服器分享資訊還是完整設定,避免將設定網址填入伺服器位址欄。訂閱 URL 通常包含存取憑證,不應放進公開截圖、聊天記錄或診斷附件;若連結外洩,請聯絡服務商處理並更換。

更新前記下目前選取的伺服器與重要備註。更新訂閱可能會取代項目,手動修改訂閱項目的欄位也可能遭到覆寫,因此長期使用的手動輸入伺服器資料應另外整理。多個訂閱可依用途命名;刪除前先確認來源與所屬群組,不要只因顯示名稱重複就認定是同一個項目。

查看訂閱更新、排序與備份手冊 →

04 / 自動觸發連線

On Demand 按需連線

入口:Settings → On Demand

On Demand 會依據設定的網路條件自動觸發連線,作用與 Global Routing 不同:前者決定「何時連線」,後者決定「連線後請求如何處理」。此功能依賴平台提供的網路延伸機制與目前權限,不能假設在每個 App、每種網路狀態下都以相同方式運作。

先在 Home 手動連線並確認伺服器可用,再進入 Settings 的 On Demand,依目前介面提供的網路類型、Wi-Fi 等條件進行設定。首次只啟用一組容易驗證的條件;切換網路後觀察連線狀態,再決定是否增加例外。若目前平台沒有相應入口,請依該平台實際提供的功能操作,不要直接套用其他裝置的設定。

若要暫時停止自動連線,請一併檢查 On Demand,而不只是關閉 Home 開關。若連線反覆恢復,先停用按需觸發條件並觀察;不要藉由刪除所有伺服器來解決。切換 Wi-Fi 與行動網路後若短暫中斷,也要分辨是網路重新建立連線,還是自動觸發規則符合條件。

05 / 用量檢視

Data 流量統計

入口:Data

Data 可用來查看用戶端記錄的上傳、下載及相關連線用量。查看數值前,先確認統計範圍:目前連線、累計記錄以及依伺服器顯示的項目,起訖時間可能各不相同。這裡的統計範圍不等同於系統的行動網路用量統計,也不等同於服務商帳戶中的計費資料。

若要確認某項操作是否產生流量,可先記下目前計數,暫停其他背景傳輸,再執行一次明確的連線操作並比較前後變化。若目前介面支援清除統計,請先保存需要的記錄再清除,避免誤以為統計歸零就代表服務商帳戶的流量額度也已恢復。

統計增加只能表示資料經過相應的記錄範圍,不能單憑數字證明目標內容已完整載入。連線重試、協定額外負載及背景同步也會產生流量。若流量異常增加,請搭配連線記錄、伺服器選擇與目標 App 逐項縮小範圍;若流量很少但頁面無法開啟,請繼續檢查 DNS、連線建立與目標回應。

06 / 常用設定

Settings 項目說明

入口:Settings;設定內的選項也需檢查 Config

Settings 中的全域設定與 Config 內的設定項目可能共同影響連線。遇到名稱相同或相近的選項時,請先確認目前啟用的設定及該項說明,不要假設所有平台的設定優先順序都相同。以下依使用目的說明,實際選項以目前介面為準。

DNS:先確認解析,再檢查分流

DNS 會將網域轉換為位址,是連線流程中的獨立環節。請檢查 Settings 中與 DNS 相關的項目,也確認目前啟用的 Config 是否包含 DNS 設定。使用已知可用且適合目前網路的解析設定,一次只修改一個項目;儲存後重新連線,並以相同網域重新測試,避免快取結果掩蓋變化。

排查時不要一次更換所有 DNS 項目。網域解析成功不代表代理連線也成功;DNS 請求採用的路徑與目標連線使用的策略,仍須分別確認。若只有部分網域失敗,請先檢查拼字、解析記錄與規則比對;若多個目標同時失敗,再比較本地網路與所選的解析方式。

Test Method:測試方式不等於實際體驗

Test Method 會影響伺服器測試採用的方式。先在 Settings 查看目前的方法,再從 Home 執行 Connectivity Test。測試結果反映特定探測條件下的可連線性或耗時,不代表所有網站的回應速度,也無法證明驗證、傳輸和目標存取的每個環節都正常。

比較伺服器時,請保持測試方式、網路與測試目標一致。探測失敗時,先確認伺服器端是否會回應這類探測,再以實際連線結果交叉判斷;不要只因某個測試數值較低,就頻繁切換目前穩定使用的伺服器。

Today Widget:快速入口與主畫面確認

Today Widget 可在支援此元件的平台上快速存取或查看狀態。先在 Settings 檢查相關選項,再依系統提供的方式新增元件。元件是否可用及顯示位置取決於系統版本;若裝置沒有對應入口,請直接使用 Home 連線或切換。

透過元件操作後,仍應返回 Home 確認伺服器與連線狀態。元件資訊可能有更新延遲,不要只依據舊狀態判斷連線已停止;元件也不適合作為完整的規則或訂閱管理介面。

iCloud 同步:同步前先備份

iCloud 同步適用於目前平台與介面支援同步的內容,不代表所有裝置之間都會完整即時同步。先確認系統的 iCloud 權限,再檢查 Settings 中的同步選項與具體項目。首次啟用前請儲存本機備份,確認以哪一台裝置的資料為準,再到另一台裝置檢查同步結果。

同步設定不代表 App 購買記錄或服務商帳戶也會一併同步,也不表示目前連線狀態會自動一致。多台裝置同時編輯可能造成內容遭覆寫;大幅修改時,請先在一台裝置完成並確認同步,再處理其他裝置。同步檔案也可能包含敏感連線資訊,請妥善管理裝置與雲端帳戶的存取權限。

07 / 故障排查

Diagnostics 與連線記錄

入口:Settings → Diagnostics 相關項目

Diagnostics 可協助判斷問題來自解析失敗、伺服器連線失敗、驗證失敗或請求處理異常。開啟目前介面提供的診斷與記錄功能,先記下錯誤時間、使用的網路、Global Routing 模式及目前伺服器,再重現一次問題。如此一來,記錄便能對應到具體操作,不必從長時間累積的記錄中猜測。

先確認問題發生在哪個環節:未取得網域解析結果,優先檢查 DNS;連不上伺服器,檢查位址、連接埠與網路;已建立連線但無法正常存取目標,則繼續檢查策略、協定附加欄位與目標回應。不同錯誤可能呈現相似症狀,不能將所有逾時都歸因於規則問題。

若需向服務商說明狀況,可整理錯誤訊息、重現步驟與網路類型。分享前請移除訂閱 URL、密碼、驗證識別資訊及不必要的存取記錄;截圖也應逐項檢查。排查完成後,請恢復日常記錄設定,並清除不再需要的診斷檔案,避免長期保留敏感的存取細節。

08 / 設定複查

沿著同一條連線流程檢查

發生問題時先記錄目前狀況,再逐項對照。恢復正常後,還原暫時變更,只保留確認有效的修改。

  1. Home:確認連線開關、目前伺服器與 Global Routing,排除選錯項目的可能。
  2. Config:確認啟用的設定、規則順序與策略名稱,不要只確認下載是否成功。
  3. Connectivity Test:使用相同網路與 Test Method,並搭配實際連線結果判斷。
  4. DNS / Diagnostics:依問題發生的環節逐步排查,儲存必要記錄後恢復日常設定。