[Features]官方手冊 · 功能介紹

功能與常用設定

先區分流量路徑、伺服器參數與系統觸發條件,再調整 DNS 和診斷選項。各項設定的作用不同;連線失敗時,一次只調整一個變數。

Global Routing 規則與伺服器 Settings 與 Diagnostics

以下以 iPhone / iPad 的介面用語說明;其他平台的選單配置可能不同,請以目前用戶端的實際畫面為準。

[Routing]

Global Routing 三種模式

功能說明:Global Routing 決定依照設定規則處理請求,或統一採用代理或直連路徑。設定檔、代理、直連分別對應介面中的 Config、Proxy、Direct。這項設定與選擇伺服器是兩回事:選好伺服器,不代表每個請求都會經過該伺服器。

設定位置與方式:在 Home 開啟 Global Routing,依目前用途選擇模式。日常依規則使用時選擇 Config,並到 Config 頁面確認已啟用正確的設定檔。需要檢查現有伺服器是否可用時,可暫時切換至 Proxy;測試後請恢復原本模式。

模式 主要作用 適用情境 檢查重點
設定檔 Config 依目前設定檔中的規則決定處理策略。 需要依網域、IP 位址或地區條件分流。 確認目前使用的設定檔、規則順序及最後一條策略。
代理 Proxy 由用戶端接管的請求通常會使用目前的代理。 暫時判斷問題是否與分流規則有關。 確認所選伺服器、協定參數及網路連線狀況。
直連 Direct 由用戶端接管的請求通常會採用直連路徑。 對照檢查本地網路本身的連線狀況。 直連不等於關閉系統中的 VPN 連線。

注意事項:系統流量排除、區域網路略過設定及各平台限制,都可能影響實際路徑。不要將 Proxy 理解為「裝置上的每個封包都會經過遠端」。如果同一目標在 Proxy 下正常、在 Config 下異常,應優先檢查規則是否命中,而非立即重新建立伺服器。

[Rule]

規則類型與處理策略

功能說明:規則由比對條件與處理策略組成。網域後綴、網域關鍵字、IP 網段及地區資料庫各有用途;規則通常依設定檔中的排列順序逐一檢查,由最先符合的項目決定處理方式。PROXY、DIRECT、REJECT 是策略關鍵字,不是伺服器協定。

設定位置與方式:進入 Config,先確認目前使用的設定檔,再檢視或編輯其中的 [Rule] 區段。將明確且適用範圍較小的例外規則放在涵蓋範圍較廣的規則之前,並確認設定檔末尾的 FINAL。以下僅示範規則語法;範例網域不代表實際服務,也不提供可連線的伺服器。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY
關鍵字比對對象使用注意事項
DOMAIN指定的完整網域。不會自動涵蓋其他子網域。
DOMAIN-SUFFIX指定網域及其子網域。適合依相同網域架構進行分流。
DOMAIN-KEYWORD網域中包含的關鍵字。比對範圍較廣,可能符合名稱相近的目標。
IP-CIDR / IP-CIDR6IPv4 / IPv6 網段。確認網段範圍及請求實際連線的目標位址。
GEOIPIP 位址所屬地區。判斷結果會受資料庫及目標位址影響。
FINAL未符合前面規則的請求。通常放在規則末尾,以免提前覆蓋後續規則。

注意事項:DIRECT 表示直連,PROXY 使用相應的代理策略,REJECT 則拒絕符合條件的請求。規則無法補齊伺服器缺少的驗證資訊。新增規則後,請重新發出目標請求並查看紀錄;既有的長連線可能仍沿用先前的路徑。完整設定說明請參閱設定參考。

[Server]

訂閱與伺服器管理

功能說明:伺服器項目會儲存位址、連接埠、協定及驗證參數;訂閱則透過使用者已有的連結批次取得或更新這些項目。伺服器訂閱與規則設定檔是不同類型的內容:更新伺服器清單,不一定會更動 Config 中的分流規則。

設定位置與方式:在 Home 使用 Add Server 新增已有的伺服器。取得訂閱連結後,選擇適用的 Subscribe 類型入口,貼上服務供應商提供的完整網址;已有 QR Code 時,可使用 Scan QR Code。匯入後先確認項目已出現,再選取一台伺服器執行 Connectivity Test,最後開啟連線開關並實際測試連線。

依協定核對欄位

手動新增時,先選擇正確的協定,再填寫位址與連接埠。Shadowsocks 需確認加密方式與密碼;VMess、VLESS 需確認識別參數及傳輸設定;Trojan 需確認密碼、TLS 與 SNI。HTTP、SOCKS5、WireGuard、Hysteria2 也應以現有伺服器提供的完整參數為準,勿因欄位相似就跨協定套用。

注意事項:更新訂閱時,可能會重新建立或刪除遠端已移除的項目,暫時手動修改的內容不一定會保留。重要參數請另行妥善保存;分享問題紀錄時,請隱藏訂閱網址、驗證資訊及 QR Code。測試結果顯示可連線,不代表所有目標都能正常存取;還需檢查 TLS、DNS 與目前的規則。首次匯入可參照快速入門逐步操作。

[On Demand]

依條件觸發連線

功能說明:On Demand 透過系統的隨選機制,在符合設定條件時觸發連線。它控制的是「何時建立連線」;Global Routing 與規則控制的則是「連線後如何處理請求」,兩者應分別理解。

設定位置與方式:在 Settings 找到 On Demand 相關選項,查看目前可用的網路條件及觸發設定。先確認手動連線正常,再啟用此功能,並依需求設定 Wi-Fi 或行動網路條件。若設定涉及 Wi-Fi 名稱,請核對實際名稱,避免將訪客網路或同名網路誤認為預期環境。

注意事項:修改後,分別測試連上網路、離開網路,以及中斷連線後再次存取這三種情境。若手動中斷後又自動連線,先檢查是否仍符合 On Demand 條件,不要反覆刪除系統設定。隨選連線無法修正錯誤的伺服器參數,也不能保證切換網路期間既有連線不中斷。暫時排查時,可關閉隨選條件並改為手動連線,測試後再恢復設定。

[Data]

流量統計與觀察範圍

功能說明:Data 用於查看用戶端記錄的流量資訊,方便觀察上傳、下載及介面提供的分類統計。這些數據反映用戶端能記錄的流量,不是電信業者帳單,也不能直接視為訂閱服務的剩餘流量。

查看方式:開啟 Data,先確認統計範圍、時間區間及頁面實際提供的分類,再觀察一次可重複的存取流程。比較修改前後的行為時,應維持相同網路、相同目標及相近的使用條件。若要重新開始記錄,先確認介面上的重設操作會影響哪些資料,並保存必要資訊後再執行。

注意事項:背景工作、系統流量、連線重複使用,以及統計的起訖時間,都可能造成數字差異。下載計數增加,只表示觀察範圍內有資料傳輸,不能據此確認某個請求符合預期規則。若要判斷特定流量的路徑,應一併檢視請求紀錄、目標網域、所選模式及策略,而非只看總量。

[Settings]

常用設定逐項說明

Settings 中的選項可調整解析、測試、快速入口及資料同步等行為。不同平台與用戶端的介面分類可能不同;尚未確認用途前,請保留目前設定,不要照著其他裝置的截圖逐項套用。以下不指定固定預設值,請以目前介面、使用中的設定檔及實際網路條件為準。

DNS:先確認由哪一方處理解析

用途與位置:DNS 會將網域名稱解析為 IP 位址,相關行為可能受 Settings 中的 DNS 選項影響,也可能由 Config 內的 [General] 項目控制。檢查時,應先開啟目前使用的設定檔,再對照用戶端目前的 DNS 設定,不能只檢查其中一處。

設定與注意事項:先以目前的解析方式建立可用基準;只有遇到明確的解析失敗、異常位址或特定網路相容性問題時,再依現有網路需求調整。設定檔中的 dns-server = system 表示使用系統 DNS。修改後重新發出測試請求,並留意快取及既有連線。DNS 正常不代表伺服器驗證正常;使用加密解析,也不代表應用程式的請求一定會經過代理。

Test Method:確認測試實際檢查的項目

用途與位置:在 Settings 查看 Test Method,此選項會影響可用性測試採用的方式。不同方式可能只檢查網路層的連通性,也可能進一步連線至測試目標;解讀結果時須考量所選的方法。

設定與注意事項:比較多台伺服器時,請使用相同的測試方法,並確認介面允許設定的測試目標。若測試失敗但實際存取正常,應先排除測試目標無法連線或沒有回應的情況。Connectivity Test 的結果僅供參考:測試通過後仍須驗證實際應用程式的請求,不能只憑單次測試數值判斷長期連線品質。

Today Widget:提供快速檢視入口

用途與位置:Today Widget 相關設定用於配置系統支援的快速檢視或操作入口。在 Settings 查看用戶端提供的選項,再前往系統允許新增小工具的位置完成設定。實際可用形式取決於系統與目前的用戶端。

設定與注意事項:新增後先確認顯示內容,再測試快速操作是否與 App 內的狀態一致。小工具可能受系統更新頻率影響,畫面不一定會立即更新。若對連線狀態有疑問,請返回 Home 確認,不要只根據小工具顯示的舊狀態反覆切換。

iCloud:實際確認同步範圍

用途與位置:在 Settings 尋找 iCloud 同步相關選項,並確認系統中的 iCloud 權限允許 Shadowrocket 使用。同步可讓支援的資料在同一帳號的裝置間保持一致,不應視為完整複製所有執行狀態。

設定與注意事項:移轉前,先在原裝置確認同步已完成,並另行保存重要設定檔。新裝置登入相同 iCloud 帳號後,逐項確認伺服器、訂閱及目前使用的設定檔;系統連線權限仍須在新裝置上確認。同步可能延遲,也可能同步刪除操作,不應將同步視為獨立的歷史備份。若涉及敏感設定,還應檢查裝置及帳號的存取權限。

[Diagnostics]

診斷與紀錄的使用方式

功能說明:Diagnostics 和相關日誌選項可收集連線過程中的線索,協助判斷問題出在解析、伺服器連線、驗證或規則比對。紀錄本身無法修復連線;若沒有明確的問題目標,也不適合持續擴大紀錄範圍。

設定位置與方式:在 Settings 尋找 Diagnostics 或目前介面提供的日誌入口。先記下網路類型、所選伺服器及 Global Routing 模式,再啟用所需紀錄,重新發出一次失敗的請求。觀察目標位址是否正確,以及是否出現解析錯誤、連線失敗或驗證相關資訊,並將問題對應至具體環節。

注意事項:每次只重現一個問題,避免大量背景請求掩蓋線索。分享紀錄前,請移除訂閱連結、密碼、識別參數、個人網域及不必要的存取紀錄;診斷完成後,恢復適當的日誌層級。若只在某個 Wi-Fi 網路下失敗,先使用相同設定切換網路重測;若只在 Config 下失敗,應先檢查規則,不要直接放寬 TLS 檢查。

[Verify]

依照相依順序檢查設定

各項功能彼此相依:有效的伺服器參數是連線基礎,正確的設定檔決定分流,DNS 決定網域解析結果,而 On Demand 只負責觸發連線。若混在一起調整,問題會更難重現,也不利於還原原本設定。

  1. 先確認輸入資料。確認現有訂閱可正常更新,或手動新增的伺服器協定、位址、連接埠及驗證欄位均完整;不要試圖修改規則來補足缺少的參數。
  2. 再確認基本連線。選取一台伺服器,在目前網路下執行測試並實際存取。必要時可暫時使用 Proxy 縮小排查範圍,完成後恢復原設定。
  3. 接著檢查分流。切換至 Config,確認目前使用的設定檔、規則順序及 FINAL,再對同一目標重新發出請求並檢查比對結果。
  4. 最後加入自動化設定。手動連線穩定後,再啟用 On Demand、小工具入口及同步功能;每次新增一項都要獨立驗證,並保留還原設定的依據。

若仍無法找出問題,請前往常見問題依照症狀排查;若要瞭解各項設定之間的影響,請參閱Settings 設定參考。記下「在哪個網路、哪種模式、存取哪個目標時發生問題」,通常比同時更改多組選項更容易找出原因。