官方手冊 · 功能與設定

Shadowrocket 功能介紹

從 Global Routing 的運作方式開始,再檢查規則、伺服器與連線條件。各項設定依「功能、位置、操作、限制」說明,適合已有自己的訂閱或伺服器資料的使用者。

  • Config / Proxy / Direct
  • 規則比對與策略動作
  • 連線驗證與設定疑難排解
01 · 請求如何處理

Global Routing 三種模式

Global Routing 會在連線啟用後,決定所有請求採用哪種處理方式。入口位於 Home;點選目前模式,確認選擇的是 Config、Proxy 或 Direct。這裡的 Config 是分流模式名稱;底部的 Config 頁面則用來管理設定檔。兩者彼此相關,但不是同一個入口。

模式 處理方式 適用情境 檢查重點
規則 Config 依據目前啟用的設定檔規則,決定請求的處理動作。 需要依網域、位址等條件進行日常分流。 確認設定檔已啟用,並檢查規則順序與最終動作是否正確。
代理 Proxy 通常會將請求交由目前選取的代理處理,而不是依設定規則逐條分流。 暫時測試所選伺服器能否完成目標請求。 目前的伺服器,以及相關網路與解析條件。
直連 Direct 通常直接連線至目標,不經代理伺服器轉送。 檢查裝置目前網路的直接連線狀況。 本地網路是否允許存取,以及目標是否可連線。

先選擇模式,再進行比較

日常依規則使用時,選擇 Config,並確認現有設定檔包含所需規則。排查特定請求時,可暫時切換至 Proxy 或 Direct 進行比較;請使用相同目標、盡量維持網路條件不變,並記下原本的選擇。測試後請恢復日常模式,避免將暫時設定當成長期方案。

模式名稱不代表連線成功。即使系統顯示 VPN 已連線,伺服器驗證、DNS 或目標連線仍可能失敗;Proxy 也不代表裝置的所有系統流量都一定經過同一條路徑。判斷結果時應參考實際請求與診斷記錄,而非只看狀態圖示。

02 · 比對條件與執行動作

規則分流與策略

規則會同時寫明「比對條件」與「符合後的處理方式」。在 Config 頁面選取現有設定檔,進入編輯功能檢查規則,再於 Home 將 Global Routing 設為 Config。修改前先保留備份,確認目前啟用的是剛編輯的檔案,再進行測試。

DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對網域後綴及其子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對。IP-CIDR 與 IP-CIDR6 分別表示 IPv4 與 IPv6 網段;GEOIP 依 IP 地理資料庫比對,資料庫分類不等於網站營運主體所在地。USER-AGENT 的效果取決於是否能讀取請求中的相關資訊,不能假設它能辨識所有 App 流量。

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

以上是規則語法範例,並非完整設定,也不代表適用於實際網站的建議。PROXY 表示交由代理策略處理,DIRECT 表示直接連線,REJECT 表示拒絕請求;設定也可能引用已定義的策略群組名稱。策略群組不是伺服器位址,引用前請確認該群組存在,且群組內已選取有效項目。

規則順序決定比對結果

請求通常會由上而下比對,符合規則後便執行對應動作,因此具體規則應放在可能涵蓋它的廣泛規則之前。FINAL 用來處理前面都未符合的請求,應放在規則末尾。排查時先確認請求的網域或目標位址,再檢查符合的規則與動作;不要只因一次連線失敗,就同時重寫整份規則與 DNS。

03 · 連線參數的來源與管理

訂閱與伺服器管理

Home 中的伺服器列表保存了連線所需的資料。已有訂閱可透過新增入口中的 Subscribe 匯入;單一伺服器可在 Add Server 中填寫。也可依現有資料選擇 Scan QR Code 或從剪貼簿匯入。匯入前請確認資料屬於自己的服務,且格式符合所選入口。

手動新增時,請先選擇正確的協定,再逐項填入位址、連接埠、驗證資訊及傳輸參數。Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard 與 Hysteria2 所需欄位各不相同;名稱相同的密碼、公鑰或位址也不能任意互換。參數應以現有服務資料為準,不要以反覆猜測加密方式或連接埠取代核對。

Subscribe 更新與手動修改

更新訂閱時會重新讀取遠端列表,名稱、數量與連線參數都可能改變。請先確認訂閱網址仍有效,再使用該訂閱的更新功能;若更新失敗,保留原列表以便比較,不要立刻刪除後重建。自動更新的觸發條件與選項請以目前 App 介面為準;更新列表本身不會延長服務效期。

多份訂閱應使用容易辨別用途的名稱,避免只憑相同的顯示名稱選取伺服器。若手動修改訂閱產生的項目,後續更新可能覆蓋變更;需要保留的個人設定應先備份。刪除訂閱前,請確認其中包含哪些項目,並檢查目前選取的伺服器是否也會一併移除。

伺服器列表與規則設定負責不同工作:前者決定「連線到哪裡」,後者決定「哪些請求走哪條路徑」。看得到伺服器不代表設定已啟用,匯入設定也不代表已填入有效伺服器。完整的更新、排序、匯出與刪除流程,請參閱訂閱與伺服器管理手冊。

04 · 自動觸發條件

On Demand 按需連線

On Demand 可依設定條件觸發或管理 VPN 連線。前往 Settings 中的 On Demand,先閱讀目前介面提供的網路條件與動作,再依實際需求啟用。不同裝置與系統環境可能顯示不同選項,請以 App 內的說明為準。

建議先手動連線,確認現有伺服器、規則與 DNS 運作正常,再設定按需條件。每次只新增一項條件,並在相應網路環境中分別測試連線與中斷狀況;若條件涉及 Wi-Fi 名稱,請確認名稱完全一致,並留意裝置切換網路時的實際行為。

按需連線只負責觸發,不會修正錯誤密碼、失效伺服器或不完整設定。手動中斷後,連線也可能再次觸發;遇到這種情況,請先回到 On Demand 檢查觸發條件,而不是反覆刪除系統 VPN 設定。暫停排查時,先關閉相關按需設定,再手動中斷連線;排查完成後,恢復先前記錄的選項。

05 · 查看使用狀況

Data 流量統計

Data 用來查看用戶端記錄的流量使用狀況。進入 Data 頁面後,先確認目前的統計範圍、時間區間,以及介面標示的上傳與下載方向,再進行一次明確的網路操作。若 App 提供重設統計的功能,請先記下現有數據,以免清除後失去比較依據。

統計資料適合用來確認「某段時間內流量是否有變化」,但不能單獨證明目標網頁已完整載入。例如,請求重試、建立連線或傳輸部分資源時,都可能產生流量;背景活動也會影響數值。測試時請關閉不必要的並行活動,使用相同目標重複觀察,並參考連線記錄判斷。

用戶端統計與現有服務的計量方式可能不同;協定額外負載、統計範圍、重設時間,以及多部裝置同時使用,都可能造成差異。Data 不能取代服務端的剩餘用量資訊,也不應用來推算訂閱效期。若懷疑流量異常,請先確認統計週期,再檢查背景 App 與重複請求。

06 · 網域解析路徑

Settings 與 DNS

DNS 會將網域名稱解析為目標位址,是建立連線前的重要環節。可在 Settings 中檢查相關選項;目前的設定檔也可能包含 DNS 設定,因此檢查時須同時確認啟用中的設定檔內容。修改全域選項前,請先記下原始值,並分清「裝置網路提供的解析方式」與「設定檔指定的解析方式」。

伺服器延遲測試正常,但網頁無法開啟時,請先確認失敗的是網域解析還是後續連線。檢查 DNS 位址格式與可連線性,確認使用的解析方式與目前設定相容,再查看同一網域的請求記錄。支援加密解析不代表任意填入一個位址就能運作;位址、協定與連線路徑必須相互符合。

一次只變更一項解析條件

先儲存目前設定,再逐項修改並重新測試。不要同時更換伺服器、Global Routing 與 DNS,否則無法判斷結果的原因。IP 類規則可能會依賴解析後的位址,DNS 變更也可能影響規則比對結果;因此解析恢復後,還要檢查實際符合的分流動作。

若變更後狀況變差,請還原已記錄的設定再繼續排查。清除快取有助於重新觀察解析流程,但無法解決解析服務無法連線或規則錯誤的問題。分享記錄時請隱藏私人網域、訂閱網址與驗證資料,只保留重現問題所需的欄位。

07 · 測試結果的解讀

Test Method 與 Diagnostics

Test Method 用來選擇連線測試方式,可在 Settings 中檢查;Home 中的 Connectivity Test 則用來測試列表中的項目。請先依排查目的選擇合適的測試方式,再測試伺服器。若目前方式需要目標位址,請確認該位址有效且可依預期連線。

不同測試方式檢查的連線路徑不同:基礎連線成功,不代表驗證與目標請求都正常;以請求為基礎的測試也會受到測試目標、DNS 與目前網路影響。比較結果時,請維持測試方式與目標一致,不要直接混合不同方法的數值。單次測得較低延遲只反映當下條件,不能取代實際使用測試。

Diagnostics 檢查順序

Diagnostics 可用來進一步收集或查看疑難排解資訊,可從 Settings 中的相關入口檢查。先確認裝置基本網路正常,再核對伺服器參數,接著檢查網域解析、符合的規則與目標連線。每次重現問題時只送出一個明確請求,並記錄發生問題的網路環境與操作順序,避免大量同時進行的請求掩蓋線索。

記錄或診斷結果可能包含伺服器位址、存取網域等私人資訊。提供給他人前請先檢查內容,移除訂閱憑據、密碼與私鑰;不要直接分享完整設定。若錯誤集中在驗證階段,請重新核對參數;若只發生於特定網域,則優先檢查解析與規則,而非反覆重新安裝 App。

首次連線的完整驗證順序,請參閱使用教學。診斷的目的是找出失敗環節,而不是不斷切換選項,碰巧取得一次成功。

08 · 日常操作與復原

Today Widget 與 iCloud 同步

Today Widget 快速操作

Today Widget 的相關選項位於 Settings,可設定系統支援的小工具顯示內容或快速操作。先在 App 中確認可用項目,再前往系統的小工具管理介面新增。是否能顯示、可執行哪些操作及顯示位置,取決於裝置系統與目前 App 的支援情況;不要將某一種版面視為所有裝置都相同。

小工具適合執行已驗證過的日常操作,無法取代完整的伺服器與規則檢查。透過小工具切換後,若結果不如預期,請回到 Home 檢查目前伺服器、連線狀態與 Global Routing。若顯示內容尚未更新,請先開啟 App 確認實際狀態,不要只依小工具文字判斷連線是否成功。

iCloud 同步與獨立備份

在 Settings 中檢查 iCloud 同步相關選項,並確認系統已允許 App 使用 iCloud。同步前先確認目前裝置上的設定與訂閱完整;在新裝置上則先等待同步完成,再檢查檔案、伺服器列表與目前選取項目。具體同步內容請以 App 內說明及裝置實際顯示為準,不要預設所有設定與狀態都會還原。

iCloud 同步不等於獨立備份:刪除或修改內容可能會同步到其他裝置,離線期間的資料也可能尚未上傳。大量刪除、替換設定或更換裝置前,請另外匯出需要保留的內容並妥善保存。設定與訂閱可能包含敏感參數,備份請存放在自己掌控的位置,避免當作一般附件公開分享。

App Store 的已購項目復原與設定復原是兩個步驟。前者可恢復取得 App 的資格,後者則用來還原自己的服務與設定;重新安裝後仍須確認資料是否齊全,再完成一次連線測試。購買適用性與系統需求請以 App Store 頁面標示為準。

依需求繼續閱讀