官方手冊 · 功能參考

Shadowrocket
功能與設定

先確認 Global Routing,再檢查規則、伺服器與 DNS。每次只調整一個項目,並以相同請求驗證結果。

涵蓋 iPhone、iPad、Mac、Windows、Android 與 Linux;以下以 iPhone / iPad 的英文介面項目示範操作,其他平台的選單位置及可用設定請依實際介面為準。

  • Global Routing → 規則 → 策略
  • 每次只修改一項設定
  • 透過記錄與實際請求驗證

Global Routing 三種模式

模式決定請求是否交由設定檔規則判斷,不代表選擇了哪一台伺服器。

功能說明:Global Routing 是整體路由方式。在 Home 開啟 Global Routing,可選擇設定檔、代理或直連,對應英文介面項目 Config、Proxy、Direct。一般依網域和位址分流時,通常選擇 Config;需要排除規則影響時,才暫時使用 Proxy 或 Direct 作為對照。請勿將「切換模式」和「啟動連線」視為同一個步驟;選好模式後,仍須確認 Home 的連線狀態。

介面選項請求處理方式適用情境檢查重點
Config · 設定檔依目前設定檔中的規則決定策略。日常分流、區域網路直連,以及為特定網域指定策略。目前使用的設定檔、規則順序與 FINAL。
Proxy · 代理以代理方式處理接管的請求,不依一般分流規則逐條判斷。暫時排查路徑差異是否由規則造成。目前選取的伺服器及其實際連線狀況。
Direct · 直連以直連方式處理接管的請求。確認本地網路本身是否能連線至目標。目前的網路、目標服務與 DNS。

設定方式:先在 Config 確認要使用的設定檔,再返回 Home,將 Global Routing 設為 Config,選擇現有伺服器後啟動連線。以同一個目標發出新的請求,檢查記錄中的命中規則與策略。測試期間維持相同的網路條件,避免同時切換 Wi-Fi 與路由模式,否則難以判斷是哪項變更造成影響。

注意事項:Proxy 不是能解決所有連線問題的開關,Direct 也不代表關閉系統中的 VPN 連線。模式只說明路由處理方式;系統接管範圍、設定檔中的例外及平台網路機制仍會影響結果。排查完成後請恢復原先使用的模式,避免一直保留暫時設定。

規則類型與策略

規則判斷「比對什麼」,策略決定「比對後如何處理」。

在 Config 編輯目前使用的設定檔

功能說明:規則分流會依請求的網域、位址等條件選擇處理方式。在 Config 找到目前使用的設定檔,透過編輯入口檢查 [Rule] 區段。規則由上而下依序判斷,命中後採用該行策略,因此較具體的例外通常應排在範圍較廣的規則之前。

設定方式:DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對網域及其子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對。IP-CIDR 與 IP-CIDR6 分別比對 IPv4、IPv6 網段;GEOIP 依 IP 位址所屬地區資料比對。USER-AGENT 需有可取得的請求資訊,不應假設所有連線都符合此條件。

注意事項:PROXY 使用代理策略,DIRECT 直連,REJECT 拒絕請求。介面選項 Proxy 與規則策略 PROXY 的大小寫不同,編輯設定檔時請保留關鍵字原樣。FINAL 是前面的規則都未命中時採用的預設策略,應放在末尾;若放得太前面,後續規則便不會生效。

以上僅示範語法,並非適用於所有網路的完整設定。修改前請先備份原設定檔,修改後重新發出請求並查看命中記錄。既有連線可能繼續沿用原路徑,因此不能只重新整理一條既有長連線,就認定新規則沒有生效。若需了解完整區段結構與比對方式,請接著閱讀設定檔完整指南。

訂閱與伺服器管理

伺服器參數、訂閱來源與設定檔是不同項目,請分別管理。

Home、Add Server 與 Subscribe

功能說明:伺服器項目會儲存位址、連接埠、通訊協定與驗證資訊;Subscribe 用於從使用者已有的訂閱網址取得伺服器清單;Config 則儲存路由規則等設定。匯入訂閱不代表會自動取得符合目前需求的分流規則,切換設定檔也不等於更換伺服器清單。

位置與設定方式:在 Home 點選 Add Server 新增項目,依資訊提供者提供的資料填寫參數。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 所需欄位各有不同,請勿只因名稱相似,就套用其他通訊協定的參數。已有 QR Code 時使用 Scan QR Code;已有訂閱網址時選擇 Subscribe,確認網址後儲存並更新,再從清單中選取項目。

  1. 匯入前請確認內容是單一伺服器、訂閱網址還是設定檔,並選擇相應的入口。
  2. 儲存後確認項目數量與名稱符合預期,再執行 Connectivity Test。
  3. 選取一個項目實際連線,發出一般使用請求;確認可用後再整理舊項目。

注意事項:更新訂閱可能會覆寫該來源建立的項目,手動修改前請先考慮下次更新的影響。訂閱網址可能包含存取憑證,請勿放入公開截圖、聊天記錄或問題描述中。Connectivity Test 的結果僅反映所選測試方式下的狀況,不能取代實際連線驗證;更新失敗也不代表所有已儲存的伺服器同時失效。

若要移轉設定,請先區分設定檔匯出與伺服器資訊匯出,避免將含有憑證的內容當作一般規則公開分享。對不熟悉的設定檔,請先檢查規則、DNS 與重寫項目,再決定是否啟用;不要只憑檔名判斷用途。

On Demand 隨選連線

先確認手動連線正常,再新增自動觸發條件。

功能說明:On Demand 會依照設定的網路條件,要求系統建立連線,減少重複手動操作。它控制的是何時發起連線,不會判斷某個網域應使用 PROXY 或 DIRECT;連線建立後,請求仍依 Global Routing 與目前設定檔處理。

位置與設定方式:在 Settings 找到 On Demand,確認介面提供的 Wi-Fi、行動網路或網路例外條件。先確認手動連線成功,再只啟用一項必要條件;儲存後切換至相應網路,觀察系統連線狀態,並以同一個請求驗證。若要為特定 Wi-Fi 設定例外,請確認網路名稱正確,且各條件之間不會互相抵銷。

注意事項:啟用 On Demand 後,手動中斷連線可能會因符合條件而由系統再次連線,這不一定表示連線開關故障。若要暫停自動連線,應先停用相關條件,再中斷連線。遇到需要網頁認證的 Wi-Fi,請先完成網路登入再測試;系統權限、休眠與網路切換時機也可能影響觸發,無法保證任何情況下都會立即重新連線。

Data 流量統計

先確認統計範圍,再比較數值;用戶端記錄不等於服務商帳單。

功能說明:Data 顯示用戶端可記錄的流量使用情況,可用來觀察連線期間上傳與下載的變化,並協助找出持續發出請求的情形。統計範圍取決於介面標示的對象與時間範圍,不應將單一頁面的總計直接視為裝置全部的網路用量。

位置與使用方式:開啟 Data,先確認目前顯示的統計範圍與可用篩選條件。排查用量異常時,記下測試前的數值,暫停無關應用程式的背景活動,只執行一次目標操作,再返回 Data 比較變化。若介面提供重設選項,請先保留必要記錄,確認後再重設,以免失去前後比較的依據。

注意事項:通訊協定封裝、重試機制、統計週期與計量方式,都可能造成用戶端數值與系統或服務商記錄不同。訂閱中顯示的用量通常來自訂閱回應所附資訊,並非 Data 的本機累計;未顯示訂閱用量,也不能據此判斷訂閱失效。流量增加只表示有資料傳輸,仍須配合請求結果與記錄確認實際服務是否成功。

Settings 常用項目

請以目前平台的介面為準;也要一併檢查設定檔中已有的設定。

DNS:網域解析與設定來源

功能說明與位置:DNS 會將網域解析為 IP 位址,既影響連線目標,也可能影響依賴位址的規則判斷。在 Settings 查找 DNS 相關選項,同時檢查目前 Config 是否指定了解析設定,避免只修改一處,卻忽略實際生效的設定。

設定方式與注意事項:先保留目前可用的設定,確認問題發生在網域解析階段還是後續連線階段,再決定是否調整解析方式。修改後以相同網域重新測試並查看記錄,必要時依介面提供的操作清除相關快取。不要同時修改 DNS、伺服器與規則;加密解析也需要可連線的網路路徑,填入解析伺服器位址不代表一定能連線。

Test Method:Connectivity Test 的測試方式

功能說明與位置:Settings 中的 Test Method 會決定 Connectivity Test 如何測試項目。不同方式驗證的層級不同,有些較接近基本連線能力,有些則還取決於測試目標是否回應,不能將結果視為同一種指標直接比較。

設定方式與注意事項:比較多個項目時,請固定 Test Method、測試目標與本地網路,連續測試後再觀察結果。逾時可能是伺服器、測試目標或目前網路所致;顯示可連線也不代表所有目標服務都能使用。排查時先透過測試縮小問題範圍,再以實際要使用的服務確認,不要只憑單一延遲數值下結論。

Today Widget:快速查看與操作

功能說明與位置:Today Widget 可透過系統支援的小工具入口查看狀態或執行快速操作。先在 Settings 檢查相關設定,再依系統管理小工具的方式加入;可顯示的內容與操作功能以系統及目前應用程式介面為準。

設定方式與注意事項:完成主應用程式的權限與連線設定後,再設定並試用小工具。小工具顯示可能受系統更新時機影響,不能把尚未更新的狀態視為最終連線結果。若顯示狀況與預期不符,請返回 Home 檢查目前狀態;不要反覆點選小工具來取代確認。

iCloud 同步:跨裝置管理設定

功能說明與位置:在提供此選項的 Apple 裝置上,Settings 中的 iCloud 相關設定可管理應用程式支援同步的內容。同步取決於系統 iCloud 狀態、帳戶與應用程式權限,不應假設伺服器、設定檔、歷史記錄等所有項目都會同步。

設定方式與注意事項:先確認兩部裝置使用預期的 iCloud 帳戶,再查看介面列出的同步範圍。首次啟用前,請分別保留本機副本;先在一部裝置完成修改並等待同步,再到另一部裝置確認,避免同時編輯造成覆寫或衝突。同步不等於獨立備份,也不等於 App Store 購買記錄;設定移轉與重新取得應用程式需分開處理。

Diagnostics:蒐集排查資訊

功能說明與位置:Diagnostics 提供連線排查所需的診斷資訊,可在 Settings 中找到此入口。它能協助判斷問題發生在解析、建立連線還是後續請求階段,並不是自動修復功能。

設定方式與注意事項:先記下問題發生時的網路類型、Global Routing 與目前設定檔,再依介面提供的方式執行診斷或查看記錄。為方便分析記錄,請只重現一次目標問題,避免同時進行大量測試。分享前移除伺服器位址、訂閱連結、驗證資訊與不必要的存取記錄;保留錯誤類型與操作順序即可,不應直接公開完整且含敏感資訊的記錄。

設定後的檢查順序

分開驗證「能否連線」、「如何分流」與「是否自動觸發」。

  1. 確認基礎網路。先確認目前的 Wi-Fi 或行動網路可正常使用;若需要網頁認證,先完成認證,並記下測試使用的網路。
  2. 確認伺服器資訊。檢查通訊協定、位址、連接埠與驗證欄位,再執行 Connectivity Test;不要將測試失敗直接歸咎於規則。
  3. 確認 Global Routing。需要規則分流時選擇 Config,並確認啟用的是剛編輯的設定檔,而非名稱相似的副本。
  4. 確認單次請求。發出新的目標請求,查看命中規則與策略;解析失敗時先檢查 DNS,命中結果不符時再檢查規則順序與條件。
  5. 最後確認自動化。手動連線穩定後才啟用 On Demand,再檢查網路切換、Today Widget 狀態與 Data 數值變化。

若修改後發生問題,請還原剛才修改的項目,並在原有測試條件下再次驗證。能穩定重現的修改前後差異,比一次調整多項參數更有參考價值。首次操作可閱讀入門指南;需要逐行檢查規則時,請參閱設定檔完整指南;安裝與取得相關問題則請查看全平台下載說明。

切換至 Proxy 後可用,Config 下卻無法使用,該先檢查哪裡?

先確認目前使用的設定檔,再比較同一目標在 Config 下命中的規則與策略。檢查是否被較前面的 REJECT、DIRECT 或範圍過廣的規則攔截,同時留意網域解析結果;尚未確認命中記錄前,不要直接替換整份設定檔。

中斷連線後又自動連線,如何暫停?

先檢查 On Demand 是否仍設有符合目前網路的觸發條件。暫停相關條件後再中斷連線,並觀察系統狀態。若仍反覆連線,再檢查系統中其他與此連線相關的自動化設定。