官方手冊 · 功能與設定

Shadowrocket 代理模式與常用設定

先確認 Global Routing 如何處理連線,再調整 Config 中的規則與 Settings 裡的個別選項。模式、伺服器和 DNS 各屬不同層次;一次只變更一項,才能判斷變化的原因。

  • Global Routing:選擇處理方式
  • Config:設定規則與策略
  • Diagnostics:找出異常環節

本文以 iPhone / iPad 的介面路徑為例。不同系統與應用程式版本的選單位置可能不同,請以目前裝置顯示的選項為準。初次使用請先閱讀使用說明,需要取得用戶端請前往下載用戶端。

功能與設定章節索引

已能連線但分流結果不如預期,先看前兩節;無法連線則先核對伺服器參數,再檢查 DNS 與 Diagnostics。

Home · Global Routing

Config、Proxy、Direct 三種模式比較

Global Routing 決定連線的整體處理方式,不等同於伺服器清單中的某個節點,也不等同於系統連線開關。

在 Home 找到 Global Routing 後,可依使用目的選擇 Config、Proxy 或 Direct。三種模式分別代表依設定檔處理、代理、直連:Config 依目前設定檔判斷策略,Proxy 將由用戶端接管的連線交由代理處理,Direct 則讓接管的連線直接連至目標。本文討論的是由用戶端接管的流量,模式名稱不代表對所有系統行為的絕對保證。

介面用語與意義 適用時機 設定前檢查 容易混淆之處
Config · 設定檔 日常依網域、位址等條件進行分流。 在 Config 選取正確的設定檔,確認規則與 FINAL。 切換至 Config 不會自動補齊規則,也不會修正錯誤的伺服器資訊。
Proxy · 代理 短暫測試所選伺服器能否連線至目標。 確認所選伺服器、協定參數及基本網路均可使用。 不適合用來證明規則正確,因為它不會依照日常 Config 規則進行相同的分流。
Direct · 直連 檢查不經代理伺服器時,基本網路能否連線至目標。 明確指定測試目標,並記下切換前的模式。 Direct 不等於關閉連線開關;用戶端仍可能處於啟用狀態。

依測試目的切換,完成後恢復日常設定

例如,同一個網站在 Proxy 下正常、在 Config 下異常,可優先查看該連線在 Config 中符合哪條規則,而非立刻更換伺服器。若 Direct 下連基本網站都無法開啟,應先檢查 Wi-Fi、行動網路或網路登入狀態。每次切換後重新發送請求,必要時關閉原頁面再開啟,減少重複使用舊連線對判斷造成的影響。

比較完成後,請恢復原本的 Global Routing。不要同時變更模式、更換伺服器和 DNS,再把結果歸因於其中某一項;即使這樣暫時恢復連線,也無法得到可重複驗證的排查結論。

Config · Rule

規則比對與策略選擇

規則說明「哪些連線」,策略說明「如何處理」。使用前先確認 Global Routing 設為 Config。

通常可在 Config 的目前設定檔中查看或編輯規則。常見規則類型包括精確比對網域的 DOMAIN、比對網域及其子網域的 DOMAIN-SUFFIX、依網域包含文字比對的 DOMAIN-KEYWORD,以及針對位址範圍的 IP-CIDR、IP-CIDR6。GEOIP 依賴相應的位址資料庫,不能僅憑該結果確定企業所屬地區或伺服器實際營運地點。

PROXY 代表交由代理處理,DIRECT 代表直接連線,REJECT 代表拒絕符合條件的連線。規則也可能引用設定檔中定義的策略名稱;此時必須確認該名稱確實存在,且指向預期的對象。名稱拼寫相近不代表是同一個策略,匯入後應檢查設定檔是否能正常載入。

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

以上為教學範例,example.com 與 example.org 用於示範語法,不代表實際需要代理的網站。第一行只適用於指定網域,第二行涵蓋 example.org 及其子網域,第三行則示範私有位址範圍的直連處理;FINAL 放在最後,用來處理前面都未符合的連線。

先看順序,再看規則範圍

規則通常依序比對,先符合的規則會決定處理結果。範圍較廣的規則若放在前面,後續精確的例外規則可能無法生效。新增規則時,應先寫具體例外,再安排範圍較廣的比對,最後檢查 FINAL。DOMAIN-KEYWORD 的涵蓋範圍尤其容易超出預期:它比對的是文字,而非某個網站完整且固定的網域集合。

修改前請保留原設定檔副本,儲存後確認目前啟用的是修改後的設定檔。單一頁面也可能載入獨立的圖片、登入或 API 網域,因此「首頁開得起來」不代表「頁面所有功能都正常」。若只想讓指定網站經由代理連線,可接著閱讀DOMAIN-SUFFIX 與 FINAL 的情境說明。

Home · Add Server · Subscribe

訂閱與伺服器管理

Subscribe 可管理並更新伺服器來源,Add Server 則用來輸入單一伺服器資訊;兩者都需要有效的連線參數。

在 Home 點選新增入口進入 Add Server,選擇與現有資料相符的 Type,再填入位址、連接埠與驗證資訊。若資料是訂閱連結,請從 Subscribe 對應入口匯入;若是 QR Code,則可使用 Scan QR Code。訂閱連結請向你的服務商取得,複製時確認首尾沒有空格、換行,也沒有誤複製說明文字。

Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 等名稱代表不同協定或連線類型,不能只因名稱相似就套用相同參數。Type 選錯時,即使位址與連接埠看似正確,也可能無法連線。TLS、SNI、傳輸方式等項目應逐一對照原始資料,不要為了消除提示而任意放寬憑證驗證。

更新訂閱與編輯單筆記錄的差異

更新訂閱會重新取得來源中的伺服器清單。直接修改由訂閱產生的項目,後續更新時可能會被覆寫,因此應先確認該筆記錄是手動管理,還是由訂閱管理。需要長期保留的個人備註和獨立測試記錄,應選擇適合目前版本的管理方式,並在更新後確認內容仍然存在。

管理多個 Subscribe 時,先依來源和用途命名,再整理排序。名稱相同不一定代表伺服器重複,應一併比對位址、連接埠、協定與驗證欄位。刪除前確認是否被目前選取項目或設定策略引用;更新後也要核對所選伺服器,避免清單變動後仍使用錯誤項目。

訂閱網址本身可能包含存取憑證。分享螢幕截圖、匯出檔案或診斷資料前,請遮蔽完整連結、密碼及驗證欄位。若匯入成功卻沒有可選項目,先檢查回傳內容是否為支援的訂閱資料,再確認來源是否可存取,而不是一再建立相同訂閱。

Settings · On Demand

On Demand 按需連線

On Demand 會依已設定的網路條件觸發連線行為,不能取代 Config 中逐條設定的分流規則。

在 Settings 或目前版本提供的 On Demand 入口中,先查看可用條件,再依 Wi-Fi、行動網路或指定網路等實際選項進行設定。建議先從容易觀察的條件開始,例如只測試一次 Wi-Fi 與行動網路之間的切換;確認行為符合預期後,再增加其他條件。

啟用前先手動完成一次正常連線,確認所選伺服器與 Config 均可使用。否則自動觸發只會重複同一個失敗流程。設定後離開相關頁面,實際切換網路並觀察系統連線狀態,再重新發送請求;只看到 On Demand 開關已開啟,不能證明所有觸發條件都已生效。

手動關閉後又重新連線,先檢查觸發條件

網路變更後連線又重新建立,可能是 On Demand 規則仍在生效。若要暫停自動行為,應檢查相應條件,而不是反覆操作 Home 的連線開關。測試結束後記下保留了哪些條件,避免日後將自動重新連線誤認為異常。

飯店、公共場所等需要網頁驗證的網路,可能必須先完成網路登入,再啟動代理連線。若連線反覆變動,先確認網路驗證與訊號穩定,再調整按需條件。On Demand 也無法讓失效的訂閱、錯誤密碼或無法連線的伺服器恢復正常。

Data

流量統計與觀察方式

Data 可查看用戶端記錄的流量變化;統計範圍與重設週期請以頁面實際標示為準。

開啟 Data 後,先區分上傳、下載、目前速率與累計用量,再查看頁面提供的篩選條件或時間範圍。速率表示一段時間內的資料變化,累計用量則是某個統計週期內的資料總量;兩者不能直接互換,也不適合只憑某個瞬間數值評估連線品質。

若要觀察某次操作,先記下目前計數與時間,再單獨執行該操作,接著返回 Data 比較變化。若目前版本提供重設功能,請先確認是否要保留歷史記錄,再進行重設。背景同步、圖片載入和系統工作可能同時產生流量,測試時應盡量減少其他活動。

本機計數不等於伺服器端用量

用戶端與伺服器端的統計時間範圍、協定額外負載和計算方式可能不同,因此出現差異時應先確認統計基準一致。Data 不應作為訂閱剩餘額度的唯一依據,也無法單獨證明某個請求符合 PROXY。判斷分流結果仍須一併檢查 Global Routing、目前設定檔與連線記錄。

若閒置時仍有流量,先檢查照片同步、系統更新、持續播放的音訊或影片,以及應用程式背景工作,再決定是否需要進一步診斷。不要只根據流量曲線就認定 On Demand 或某條規則失效。

Settings · DNS · Config

DNS 設定與網域解析

DNS 會將網域名稱轉換為連線所需的位址。解析正常與代理伺服器可用,是兩個需要分開驗證的條件。

在 Settings 的 DNS 相關選單及目前 Config 中檢查解析設定。不同設定檔可能有各自的 DNS 項目,因此修改前應先確認目前生效的來源,避免只改到未使用的選項。初次排查時應保留可正常運作的預設設定,不要一次填入多組互相矛盾的位址。

若要變更 DNS,先記下原值,再使用格式正確且目前網路可連線的解析服務位址。若使用加密傳輸的 DNS,也需要考量解析服務本身的連線條件與路由。設定文字能儲存,不代表填入的服務一定能連線。

區分解析失敗與連線失敗

「無法解析伺服器名稱」、「已解析但連線逾時」及「建立連線後憑證不符」發生在不同階段。先使用目前版本提供的 DNS 或診斷工具,檢查目標網域是否解析出合理結果,再測試伺服器連線。不要只憑網頁能否開啟,就判斷所有 DNS 行為。

修改後重新發送請求,必要時重新建立用戶端連線,以減少舊連線和快取造成的干擾。位址規則與網域規則可能在不同資訊條件下符合,排查時應參照實際記錄;也不要把某個網域解析出的位址,永久視為該網站所有服務共用的位址。

Settings

Test Method、Today Widget 與 iCloud

常用設定各有不同用途。測試方式會影響測試結果,快速小工具會影響操作入口,同步則關係到設定的儲存與移轉。

Test Method:先確認測試項目

在 Settings 找到 Test Method,查看目前可選的測試方式及其參數,再回到 Home 執行 Connectivity Test。不同方式可能只驗證連線是否建立,也可能進一步向指定目標發出請求;測試成功只代表該測試條件成立,不代表所有網站與協定都能正常使用。

比較多台伺服器時,請維持 Test Method、測試目標與基本網路條件一致,避免將不同條件下的結果放在一起比較。若 Connectivity Test 有結果,但實際頁面無法開啟,應繼續檢查目標網站、規則符合情況與 DNS;若測試目標本身無法連線,也可能導致多台伺服器同時顯示異常。

Today Widget:使用快速操作後確認狀態

若目前系統和應用程式版本提供 Today Widget,可在系統允許的位置加入,並在 Settings 檢查相關選項。它提供快速入口或狀態資訊,不是另一份獨立的伺服器設定。操作完成後,可返回 Home 核對所選伺服器、Global Routing 與連線狀態。

系統對小工具的顯示方式和更新時機可能有所限制。小工具未顯示或內容未即時更新時,先確認系統版本、小工具是否已加入,以及應用程式內的開關狀態;不要只憑小工具文字判斷連線是否已建立。需要準確判斷時,應一併確認應用程式內狀態和實際請求結果。

iCloud:同步前先保留可還原的副本

使用 iCloud 同步前,確認裝置已登入預期的 Apple 帳號,並已允許相關 iCloud 功能。在 Settings 查看同步選項,了解目前版本會同步哪些內容,再到另一台裝置確認結果。同步不會完整複製單一裝置上的所有系統授權、網路狀態和執行中的連線。

移轉前建議另外匯出要保留的 Config,並記下訂閱來源。兩台裝置同時編輯同一份設定檔,可能造成覆寫或衝突;先在一端完成修改,等待同步並確認結果後,再繼續另一端的操作。包含伺服器資訊的匯出檔應妥善保存,分享前請移除驗證欄位。詳細移轉步驟請參閱設定備份與還原說明。

Settings · Diagnostics

Diagnostics 與排查順序

診斷的目標是找出故障發生在哪一層,而不是將所有設定逐項重設。

在 Settings 中尋找 Diagnostics 或目前版本提供的診斷入口,選擇與症狀相關的工具。先記下目前網路、所選伺服器、Global Routing 與 Config 名稱,再重現一次異常。若有連線記錄,應著重查看目標網域、符合的策略和失敗階段,而非只摘錄最後一則錯誤訊息。

  1. 確認基本網路。檢查 Wi-Fi 或行動網路是否可用,以及是否需要先完成網路登入。
  2. 核對伺服器資料。確認 Type、位址、連接埠與驗證參數,避免在資料錯誤的情況下反覆調整規則。
  3. 短暫比較 Global Routing。先明確訂定測試目的,再比較 Proxy 與 Config;完成後恢復日常模式。
  4. 檢查 DNS 與規則。分別確認網域解析、比對順序、策略引用及 FINAL,找出設定層面的差異。
  5. 保留最精簡的重現條件。一次只變更一項,記錄變更與結果;無效的修改應立即還原。

記錄檔或診斷匯出資料可能包含伺服器位址、存取網域、訂閱連結及驗證欄位。提供給協助排查的人員前,請先檢查並遮蔽敏感內容;不要將完整原始資料直接放進公開截圖。保留錯誤類型、操作順序和已隱去敏感資訊的規則片段,通常更有助於重現問題。

若只在網路切換後出現異常,請配合 On Demand 檢查觸發條件;若只有特定網站異常,優先檢查該網站涉及的網域與策略;若所有連線都失敗,則從基本網路、伺服器與驗證資訊開始檢查。依症狀查看處理流程,請參閱疑難排解;簡短問題可查閱常見問答。