官方手冊 · 功能與設定

Shadowrocket
功能與設定

先確認 Global Routing,再檢查規則與伺服器。
依照介面位置、操作方式和影響範圍逐項設定。

  • 路徑Home → Global Routing
  • 設定檔Config → Rule
  • 檢查Data / Settings

本頁主要說明 iPhone、iPad 上的操作方式。不同裝置與應用程式版本的選單位置可能不同,設定名稱和選項請以應用程式內實際顯示為準;系統需求請以 App Store 頁面標示為準。初次使用時,先匯入既有伺服器資訊並完成連線授權,再調整下列選項。

一次買斷用戶端 ≠ 線路方案。Shadowrocket 是付費閉源商業應用程式,唯一取得管道是 App Store。本文以使用者已有自己的訂閱或伺服器資訊為前提;訂閱連結請向你的服務商索取。本網站不提供、不販售也不推薦節點或訂閱。

01 / ROUTING

Global Routing:設定、代理與直連

Global Routing 決定請求採用哪種整體處理方式。在 Home 中開啟 Global Routing,可選擇設定(Config)、代理(Proxy)或直連(Direct)。這項選擇不是伺服器協定,也不能取代連線開關:伺服器參數決定連線方式,Global Routing 則決定流量如何處理。

模式處理方式適用情境檢查重點
設定(Config)依照目前生效設定中的規則與策略處理請求。日常依網域、位址等條件分流。目前設定、規則順序、比對策略與 FINAL。
代理(Proxy)以代理方式處理由用戶端接管的請求,實際結果仍受相關排除設定影響。短時間確認所選伺服器能否處理目標請求。所選伺服器、協定參數與代理相關設定。
直連(Direct)以直連方式處理由用戶端接管的請求。與目前網路的直連結果比較,縮小故障範圍。本地網路、解析結果與目標服務狀態。

日常使用先確認 Config

如果已有可信任的設定檔,先前往 Config 確認目前使用的是哪個檔案,再回到 Home 選擇 Global Routing → Config。將檔案匯入清單,不代表該檔案已經生效。規則中的 PROXY 也不一定永遠指向同一台伺服器:若設定使用策略群組,還需要確認群組內的選擇。

以 Proxy 和 Direct 交叉比對

遇到「某個網站無法開啟」時,可以在其他條件不變的情況下,分別觀察 Proxy 與 Direct 的結果。如果 Proxy 可以連線、Config 卻不行,優先檢查規則是否將該請求交給錯誤的策略;若兩種方式都失敗,再檢查 DNS、目前網路與目標服務。測試後請恢復原本的使用模式,避免將臨時排查設定留作長期設定。任何模式都不代表所有系統流量必定走相同路徑,也不能取代實際連線紀錄的確認。

02 / RULE

規則分流:比對條件與執行策略

規則是在 Config 中描述請求處理方式的條件清單。使用 Global Routing → Config 時,規則通常依照由上而下的順序比對,符合後便採用相應策略。因此,規則「寫了什麼」和「放在哪裡」同樣重要。可在 Config 查看目前設定中的規則,也可在設定文字的 [Rule] 區段確認各項內容;編輯前請先保留原始檔案的副本。

關鍵字比對對象使用注意事項
DOMAIN完整網域名稱。用於指定單一主機名稱。
DOMAIN-SUFFIX網域本身及其子網域。比起逐一列出子網域,更適合處理同一網域範圍。
DOMAIN-KEYWORD網域中的關鍵字。比對範圍可能較廣,請避免使用過短或含義模糊的詞。
IP-CIDR / IP-CIDR6IPv4 / IPv6 位址範圍。網域解析結果與解析時機會影響位址規則的判斷。
GEOIP位址資料庫中的地區歸屬。資料庫中的地區歸屬不等於服務內容所在地,邊緣位址也可能變動。
USER-AGENT可取得的 User-Agent 資訊。取決於流量類型與可見資訊,不能作為通用的應用程式識別方式。
FINAL未符合前面規則的請求。通常放在規則清單末尾,作為後備處理。

PROXY、DIRECT、REJECT 分別代表什麼

PROXY 指向代理策略,DIRECT 表示直連,REJECT 表示拒絕請求。這些是處理動作,不是網域或伺服器協定。以下範例僅用來說明順序與寫法,範例網域並非實際服務入口;複製前請先了解每一行的目標與範圍。

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

精確的例外規則宜放在範圍較廣的規則之前。如果某個網域已符合前面的 DOMAIN-SUFFIX,後面的 DOMAIN 項目可能就不會生效。修改後請檢查實際請求紀錄,確認符合的是哪條規則;不要只憑網頁能否開啟,就判定整份設定都正確。遠端設定更新也可能覆蓋本機修改,長期維護時應區分自訂規則與遠端檔案的範圍。

03 / SERVER

Subscribe 與 Add Server:訂閱和伺服器管理

伺服器項目會儲存連線所需的參數,訂閱則用於批次取得及更新這些項目。兩者都不等同於 Config 規則檔案。Home 中的伺服器清單用來選擇連線對象;透過 Add Server 可新增單一伺服器,也可使用應用程式提供的 Subscribe 入口匯入既有訂閱。不同介面配置下,入口位置可能有所變動,請以畫面上的實際名稱為準。

先分清訂閱連結與單一連線資訊

向你的服務商取得訂閱連結後,在對應的 Subscribe 或 URL 輸入欄位貼上完整網址,儲存並執行更新,再確認是否產生預期的項目。如果取得的是單一伺服器參數,請在 Add Server 選擇相應的 Type,逐項填入位址、連接埠與驗證資訊。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 所需欄位各不相同,不能只更改協定名稱,卻沿用上一種協定的所有參數。

TLS、SNI、傳輸方式等欄位必須符合伺服器端的要求;WireGuard 的 Address、Endpoint 與金鑰欄位也各有用途。若沒有欄位設定依據,請先保留現有值,不要自行猜測填入。完整匯入步驟請參閱首次連線教學;WireGuard 欄位說明請參閱WireGuard 參數說明。

更新不代表所有設定都會被取代

訂閱更新通常用來刷新其管理的伺服器清單,不應理解為一定會更新目前的 Config、切換 Global Routing 或選取最佳伺服器。更新後請確認項目名稱、目前選擇與測試結果;訂閱管理的項目可能在下次更新時重新產生,手動修改前請先備份。刪除訂閱前,也請確認是否仍需要其中的伺服器紀錄。

04 / ON DEMAND

On Demand:依網路條件觸發連線

On Demand 可依照設定的網路條件觸發 VPN 連線。它處理的是「何時嘗試連線」,而非「請求採用哪種策略」。請在應用程式提供的 On Demand 頁面查看條件與動作;路由分流仍由 Global Routing 和目前設定控制。

設定前先確認手動連線運作正常,再逐一新增按需條件。例如,若要依 Wi-Fi 環境區分處理方式,請確認條件中的網路名稱、比對範圍及對應動作,並分別在符合與不符合條件的網路中測試。條件名稱看起來正確,不代表目前網路一定符合條件;一開始不要同時加入多個含義相近的條件。

啟用後,系統可能在符合條件時再次發起連線,因此手動中斷後又重新連線,不一定是異常。若要完整測試停用效果,請先確認 On Demand 是否仍啟用,再查看系統 VPN 狀態。網路切換、系統排程與裝置權限都可能影響觸發時機,按需連線不保證每次切換都會立即完成。若裝置上已有其他 VPN 設定,也請確認目前實際使用的是哪一項。

05 / DATA

Data:流量統計與請求線索

Data 可用來查看應用程式記錄的流量統計,並提供排查線索。進入 Data 後,先確認目前頁面的統計對象、時間範圍與單位,再比較上傳和下載的變化。不同頁面可能顯示連線期間或其他範圍的資料,不能直接將某個數字視為帳單用量或單一應用程式的全部流量。

驗證目標請求時,可先記下 Data 中的計數,單獨執行一次目標操作,再返回查看變化。如果計數沒有改變,請進一步確認連線開關、Global Routing,以及該請求是否在用戶端的處理範圍內;如果計數增加但載入失敗,也不能據此認定伺服器端正常,還需檢查解析、連線與回應階段。

用戶端的計數方式可能包含連線耗用量,也可能與服務商依帳戶、週期或計費方向統計的方式不同,因此 Data 不能取代服務商的用量紀錄。若要清除或重設資料,請先閱讀確認提示,並保留排查所需的資料。流量大小與請求成功率是不同指標,數字增加不代表頁面內容已完整載入。

06 / SETTINGS

Settings 常用項目:解析、測試與同步

Settings 中各選項的影響範圍不盡相同,有些會與目前的 Config 一起決定最終行為。以下依用途說明,不將特定數值列為適用所有網路的固定建議。預設值、可選項目與入口請以應用程式內顯示為準;調整前先記錄原始值,每次只變更一個影響因素。

DNS:先確認解析路徑

DNS 會將網域名稱轉換為位址,解析失敗可能造成連線逾時,也可能使位址規則無法依預期判斷。請檢查 Settings 中可見的 DNS 相關項目,同時確認目前 Config 是否包含 DNS 設定。不要假設只要修改 Settings 中某個項目,就一定會覆蓋設定檔內的所有行為。

設定前先釐清目標:要解決解析逾時、確認位址結果,還是調整解析請求的路徑。如果服務商有相關要求,請依照要求設定;否則先保留目前可正常運作的方案,再逐項測試。加密解析只描述解析請求的傳輸方式,不會自動改變所有應用程式流量的路由。網頁異常時,也要區分「網域尚未解析」與「已取得位址但連線失敗」,避免反覆更換 DNS 而掩蓋真正問題。

Test Method:在相同條件下比較測試結果

Test Method 用來選擇連線測試方式。請先在 Settings 確認設定,再透過 Home 的 Connectivity Test 檢查既有伺服器。不同方法涵蓋的環節不同:有些偏重傳輸層連線能力,有些則也取決於測試目標的回應。可用方法與目標請以目前版本顯示的選項為準。

比較伺服器前,請保持測試方法、測試目標與本地網路一致。較低的延遲數值不代表吞吐量較高,也不保證長時間連線穩定;逾時也可能是測試目標暫時無法連線。先測試少數項目,再用實際需要的服務驗證,避免把單次結果當成永久排序依據。

Today Widget:快速入口不取代主畫面確認

Today Widget 提供系統允許範圍內的快速資訊或操作。請先在 Settings 檢查相關設定,再前往系統中的編輯入口加入可用元件。元件形式與可用操作會受系統版本及應用程式支援情況影響,不宜直接套用其他裝置上的配置。

透過元件操作後,請回到 Home 確認目前伺服器、連線狀態與 Global Routing。元件顯示可能受更新時機影響;若畫面沒有立即變更,請先確認主畫面和系統 VPN 狀態,不要連續切換開關。若要暫停自動連線,也請一併檢查 On Demand。

iCloud 同步:同步前保留本機副本

iCloud 同步可在支援的裝置間傳送應用程式允許同步的內容。請先確認裝置已登入預期使用的 Apple 帳號,並允許應用程式使用 iCloud,再到 Settings 檢查同步相關選項。可同步的項目與同步時機請以應用程式內說明為準,不要預設伺服器、設定、統計資料及所有開關都會完整複製。

首次啟用或更換裝置前,請先備份需要保留的設定。若兩台裝置都曾修改內容,請避免同時反覆儲存;先確認要保留哪一份,再查看另一台裝置的結果。同步完成不代表已建立連線,新裝置仍須確認目前設定、伺服器選擇與系統 VPN 授權。購買紀錄與設定資料是兩回事,復原已購買的應用程式不代表所有本機設定也會一併復原。

Diagnostics:依發生階段蒐集線索

Diagnostics 可協助檢查解析、連線與請求處理等環節。請在 Settings 中尋找 Diagnostics 或相應的診斷入口,先確認要檢查的目標,再執行與問題相關的項目;實際項目名稱請以目前介面為準。診斷工具顯示成功,只能證明其涵蓋的環節正常,不代表所有目標請求都能成功。

記錄問題發生時的網路類型、Global Routing、所選伺服器與錯誤訊息,再搭配可用的 Log 資訊判斷故障階段。若需要更詳細的紀錄,短暫啟用並重現一次即可,完成後請恢復適合日常使用的紀錄層級。Log 可能包含網域、位址及連線參數,提供給他人前請先去除敏感資訊;不要直接傳送完整設定作為排查截圖。

07 / CHECK

變更設定後的檢查順序

在同一次排查中同時修改規則、伺服器、DNS 和測試方法,會讓結果難以比較。請依照下列順序檢查,每完成一步就記錄一次結果;如果新設定沒有改善,先還原原值,再進行下一項。

  1. 確認連線基礎。檢查 Home 的連線狀態與系統 VPN 授權,並確認所選伺服器是既有訂閱中的項目,或是自行設定的有效項目。
  2. 確認 Global Routing。在 Config、Proxy、Direct 之間短暫切換比對,區分規則問題與連線路徑問題,測試後恢復原本模式。
  3. 確認目前的 Config。核對生效檔案、規則順序、策略群組選擇與 FINAL,避免編輯到未使用的檔案。
  4. 確認解析與測試條件。檢查 DNS 結果,並保持 Test Method 和測試目標一致,再觀察 Connectivity Test 與實際請求。
  5. 確認自動化與同步。檢查 On Demand 是否再次觸發連線,以及 iCloud 是否同步了其他裝置的變更,接著使用 Data 和 Diagnostics 再次確認。

若要逐項查看設定的影響範圍,請繼續閱讀Settings 設定項目參考;若是單一伺服器連線失敗,可依照節點逾時檢查順序確認協定參數與系統時間。保留可重複的測試步驟,比頻繁更換整份設定更容易找出原因。