官方手冊 / 功能與常用設定

Shadowrocket 功能 與常用設定說明

先在 Home 確認伺服器與 Global Routing,再到 Config 檢查規則。本頁依「功能是什麼、在哪裡、如何設定、需要注意什麼」整理各項內容,適合已有訂閱或伺服器資訊的使用者。

  • Home / 連線與伺服器
  • Config / 設定檔
  • Data / 流量記錄
  • Settings / 常用設定
01 / Home

Global Routing 三種模式

設定、代理、直連分別對應 Config、Proxy、Direct。這些模式決定如何處理連線,與伺服器協定不同。

Global Routing 是選擇全域路由模式的入口,通常在 Home 中調整。Config 會依目前生效的設定檔規則處理連線;Proxy 會將由用戶端接管的連線交由所選伺服器處理;Direct 則讓這些連線直接連至目標。系統保留流量、排除項目及既有連線可能另有處理方式,因此不能只看模式名稱,就判定裝置上的每一條連線。

日常需要依不同目標採取不同處理方式時,請選擇 Config;排查某個目標是否因規則套用錯誤策略時,可暫時切換至 Proxy 作為對照;要確認本地網路能否直接連線至目標,可用 Direct 比較。切換後請重新開啟目標或重新送出請求,避免將舊連線的結果誤認為新模式的表現。

介面模式 主要處理方式 適用情境 設定前確認
Config / 設定 依目前設定檔中的規則選擇策略 日常規則分流,分別處理網域與 IP 位址範圍 目前生效的檔案、規則順序及 FINAL
Proxy / 代理 由用戶端接管的連線使用所選伺服器 與 Config 比較,找出規則相關問題 伺服器參數、服務狀態及實際連線結果
Direct / 直連 由用戶端接管的連線直接連至目標 確認本地網路與目標是否可連線 目前網路、目標位址及本地 DNS 環境
02 / Config

規則分流與比對順序

先看比對對象,再看策略;由上往下比對,命中即停止。

規則分流用來決定某條連線要經由伺服器、直接連線或拒絕。進入 Config 後,先確認目前啟用的是哪一份設定檔,再檢視或編輯其中的規則。匯入或儲存檔案不代表已啟用;若編輯的是另一份未生效的檔案,Home 中的連線行為也不會因此改變。

常見規則由類型、比對內容與策略組成。DOMAIN 比對完整網域,DOMAIN-SUFFIX 比對指定網域及其子網域,DOMAIN-KEYWORD 比對網域中的關鍵字。需要精確控制時,優先使用範圍明確的網域規則,避免範圍過廣的關鍵字連不相關的目標也一併比對。

IP-CIDR 與 IP-CIDR6 分別比對相應的 IP 位址範圍;GEOIP 依據 IP 位址歸屬資料庫判斷,不等於辨識網站內容或使用者所在位置。網域是否先經過解析、採用哪個解析結果,也可能影響 IP 位址規則的比對結果。排查時請一併確認規則與 DNS 設定。

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

以上內容僅用於說明語法,並非適用於所有網路的完整設定。示範網域不代表任何連線服務。

PROXY

將命中的連線交由代理策略處理。還需確認引用的伺服器或策略有效;規則本身不會建立可用的伺服器。

DIRECT

讓命中的連線直接連至目標。適合明確應由本地網路連線的位址,但結果仍取決於目前網路與目標服務。

REJECT

拒絕命中的連線。使用前請確認比對範圍;如果網頁資源或登入介面被誤判,可能造成頁面內容缺漏或操作失敗。

調整時,請將範圍較明確的例外規則放在範圍較廣的規則之前,並將 FINAL 留在最後作為預設處理。若前面的規則已命中,後續更精確的規則也不會再執行。每次只修改一組規則,並記錄目標、預期策略與實際結果;不要同時更換伺服器、DNS 與規則,否則難以判斷是哪項變更造成影響。

使用 USER-AGENT 等依賴請求資訊的規則時,也要確認目前連線是否具備可供比對的條件,不能假設所有流量都能讀取相關欄位。更多規則排列與預設處理方式,請參閱自訂規則優先順序與 FINAL。

03 / Home · Add Server

訂閱與伺服器管理

伺服器項目儲存連線參數,訂閱用於維護一組項目,設定檔則負責規則等設定。三者不能互相取代。

新增已有的伺服器資訊

在 Home 點選 Add Server 新增項目。先依服務提供者提供的資訊選擇 Type,再逐項填寫位址、連接埠、驗證及傳輸相關欄位。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 等協定所需欄位各不相同;不要只因位址與連接埠相同,就將同一組參數套用到其他 Type。

使用 Scan QR Code 匯入時,請確認來源及掃描後辨識出的欄位。QR Code 只是參數載體,不代表其中內容已經過驗證。儲存後,在 Home 選取預期項目並執行 Connectivity Test,再實際連線確認。若測試失敗,請先檢查資料是否完整、驗證資訊是否正確,以及服務是否有效,不要直接歸因於規則。

匯入與更新現有訂閱

已有訂閱連結時,請從新增入口選擇 Subscribe,貼上完整網址並儲存。訂閱通常含有敏感憑證,請避免將內容放在截圖、公開文件或聊天記錄中。若複製的內容含有前後空格、換行或遺漏查詢參數,可能導致解析失敗或清單空白。訂閱網址也不能只因外觀相似,就與一般網頁網址互換。

服務提供者更新清單後,請使用相應訂閱的更新功能取得新項目。清單更新不代表目前的 Config 已被取代,也不保證更新前選取的項目仍然存在。更新後請重新確認群組、所選伺服器與實際連線;手動修改訂閱產生的項目,可能在下次更新時被覆蓋,重要參數請以自己的安全方式保存。

刪除前先確認項目來源

整理清單時,先分辨手動新增項目與訂閱項目。刪除某個訂閱群組可能影響群組中的多筆伺服器記錄,而只修改顯示名稱不一定會改變連線參數。若準備更換訂閱,請先確認新清單可用,再清理舊記錄;尚未確認如何復原前,不要一次刪除所有項目。解析問題可參閱訂閱解析失敗自我檢查清單。

04 / Settings · On Demand

On Demand 隨選連線

依條件觸發連線行為,不負責判斷所選伺服器是否適合目前用途。

On Demand 可讓系統依據已設定的網路條件觸發 VPN 連線。請在 Settings 中尋找 On Demand 相關設定,依實際顯示的選項設定條件。這與 Home 的手動連線開關用途不同:手動開關控制目前的連線,On Demand 則可能在條件再次符合時重新發起連線。

設定前請先完成一次穩定的手動連線,確認所選伺服器與 Global Routing 符合預期。接著從單一條件開始,分別驗證進入條件、離開條件、鎖定畫面後恢復,以及網路切換時的行為。不要一次堆疊多組條件,否則某個條件覆蓋另一個條件時,容易誤以為「已關閉卻又自動連線」。

若裝置重新連線,請先檢查 On Demand 是否仍處於啟用狀態,再查看系統 VPN 設定及其他相關自動化條件。暫時需要停止自動連線時,應處理觸發條件,而不只是反覆切換 Home 開關。不同系統環境的觸發時機可能有所不同,儲存後務必透過實際切換網路驗證。

05 / Data

Data 流量統計與記錄

用於查看用戶端記錄的傳輸活動,不應直接視為服務提供者的帳單數據。

Data 可查看應用程式提供的流量統計與相關記錄。請先確認目前頁面顯示的統計範圍與時間區間,再解讀上傳、下載或累計數值。不同記錄可能涵蓋目前連線、特定項目或一段統計期間;不要直接相加不同統計口徑的資料,也不要將單一頁面的數值視為整部裝置的網路用量。

要確認某項操作是否產生流量,先記下觀察起點,再單獨開啟目標並等待傳輸完成,接著返回 Data 比較變化。背景同步、媒體預先載入及應用程式本身的請求都可能同時產生流量,因此短時間內的增加只能協助縮小範圍,無法單獨證明某個網域套用了指定策略。

服務提供者的計費方式可能採用不同的時間區間、協定額外負載或統計規則。若 Data 顯示的用量與服務提供者不同,請分別確認雙方的統計口徑。清除統計前,先保存確實需要的記錄,並確認清除操作的適用範圍;清除本地記錄不會改變遠端用量。若要確認分流是否正確,請一併查看目標請求的連線資訊與目前規則,而非只看總流量。

06 / Settings

Settings 常用項目

以下名稱以英文介面為準。實際選單位置與可用選項請以目前應用程式顯示為準,相關設定也可能由目前的設定檔提供。

DNS:確認網域解析路徑

DNS 會將網域解析為連線使用的位址。檢查 Settings 中的 DNS 相關設定時,也要查看目前 Config 是否包含 DNS 參數;不要只修改單一頁面,就認定實際解析路徑已經改變。先記錄原有設定再進行調整,確認填入的位址與格式符合該選項要求,並檢查解析請求透過哪條路徑傳送。

遇到網域無法連線、IP 位址規則結果與預期不符,或部分資源偶爾載入失敗時,可先查看解析結果,再與實際連線位址比對。同一網域可能回傳多個位址,快取也可能保留舊結果;修改後請重新送出請求,必要時使用應用程式提供的相關清除功能。不要只因更換解析位址後某次連線成功,就認定所有連線問題都已解決。

Test Method:了解 Connectivity Test 的用途

Test Method 決定連線測試採用的方式,可在 Settings 的測試相關選項中查找。不同方式檢測的層面各異:某項測試成功,不代表驗證、目標網頁及完整傳輸流程都正常。先確認測試方法與測試目標,再從 Home 對所選伺服器執行 Connectivity Test。

比較不同項目時,應維持測試方法、目標與本地網路一致,並盡量在接近的時間內完成。某個項目沒有測試結果,也可能與測試目標或檢測方式有關;請再以實際需要存取的目標驗證。不要以單次測試數值判斷長期穩定性,也不要為了追求更低數值,反覆更改與測試無關的設定。

Today Widget:快速查看與操作入口

Today Widget 相關設定可調整相應小工具入口的顯示或操作內容。請在 Settings 確認應用程式提供的選項,再前往系統支援的小工具介面完成新增。能否顯示、如何新增及可執行哪些操作,取決於目前系統與應用程式的支援情況,不應將某種版面視為所有裝置都固定採用的介面。

小工具適合快速查看狀態,但畫面可能有更新間隔。操作後請返回 Home 確認實際連線狀態與所選伺服器,不要只依小工具文字判定目前連線一定成功。若小工具顯示與應用程式內的狀態不同,請先在應用程式中確認,再檢查系統小工具的更新與可用性。

iCloud:同步後確認實際生效內容

iCloud 相關功能可在符合條件的裝置間儲存或同步應用程式支援的資料。請在 Settings 查看相關選項,並確認系統已登入的 Apple 帳號及 iCloud 權限。啟用前請先閱讀應用程式對同步範圍的說明,不要假設所有伺服器、設定檔、統計資料與系統 VPN 狀態都會一併同步。

在多部裝置間使用時,請先保留重要資料,等待同步完成後再逐項確認清單。同步取得的設定檔仍需確認是否已設為目前使用的檔案,以及相應伺服器是否有效。不要把同步當成獨立備份:刪除或修改內容也可能同步至其他裝置,連線憑證同樣需要妥善保管。

Diagnostics:針對單一故障現象蒐集線索

Diagnostics 可查看應用程式提供的診斷資訊或執行相關檢查。請在 Settings 尋找此功能,記錄問題發生時的網路、Global Routing、所選伺服器與操作順序,再重現一次問題。不同診斷項目回答的問題各異,請先釐清要檢查的是解析、建立連線,還是後續資料傳輸。

檢視結果時,請將目標位址、失敗階段與設定一併考量,不要只根據單一錯誤訊息就連續更改多項設定。若要儲存或轉述診斷內容,請先移除訂閱網址、驗證資訊、個人瀏覽記錄等敏感資料。診斷功能可協助定位問題,但不會自動修正服務提供者端的狀態,也不能取代對現有服務資訊的確認。

07 / 驗證順序

設定完成後如何確認結果

一次只變更一項條件,並保留可還原的原始設定。

先確認連線基礎

  1. 在 Home 確認所選伺服器,避免選到舊項目。
  2. 確認 Type、驗證與傳輸參數,再執行 Connectivity Test。
  3. 檢查連線開關與系統 VPN 狀態,再實際連線確認。
  4. 若有自動重新連線,請確認 On Demand 的啟用狀態與條件。

再確認分流結果

  1. 確認 Global Routing 設為 Config,且目標設定檔已生效。
  2. 由上往下找出第一條可能命中的規則,並檢查策略引用。
  3. 確認 DNS 解析結果與 IP 位址規則的比對條件。
  4. 重新送出目標請求並比對連線資訊;完成後恢復日常模式。
修改 Config 後,為什麼連線行為沒有改變?

先確認修改的是目前生效的檔案,再確認 Global Routing 已選擇 Config。接著檢查目標是否命中較前面的規則,並重新建立目標連線。既有連線、DNS 快取,或編輯了未啟用的檔案,都可能讓人誤以為「修改沒有生效」。

訂閱更新成功,是否代表所有伺服器都可用?

更新成功表示本次已完成取得與解析清單,不代表每台伺服器都已通過驗證及實際連線測試。更新後請重新確認所選項目,再執行測試並連線至目標。若只有部分項目失敗,請分別檢查參數與服務狀態,不要立即重設所有設定。

Data 有流量記錄,為什麼頁面仍無法正常開啟?

有傳輸記錄不代表整個請求已成功。解析、連線嘗試、部分資源或背景工作都可能產生流量。請檢查實際失敗的目標與階段,確認是否有 REJECT 誤判、驗證失敗或目標服務異常,再透過 Diagnostics 蒐集相關線索。

首次設定請依照使用說明逐步完成;若需要從取得、授權到日常維護的完整流程,請閱讀新手到進階完整手冊。