規則語法範例
以下僅用於說明順序與策略,並非完整設定,也不對應任何實際線路。
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
01 / GLOBAL ROUTING
Global Routing 決定流量採用哪種處理邏輯;伺服器選擇則決定需要代理時使用哪個出口。兩者是不同的設定。
是什麼:三種模式對應介面中的 Config、Proxy、Direct。Config 依目前設定檔中的規則分流;Proxy 用於統一透過代理路徑檢查;Direct 則用於統一直連對照。日常需要區分不同目標時,先使用 Config,再檢查個別規則。
在哪裡、如何設定:在 Home 找到 Global Routing,開啟後選擇模式,再返回 Home 確認伺服器選擇與連線開關。選擇 Config 前,先到 Config 頁面確認所需檔案已啟用;只匯入檔案但未啟用,不能據此判斷規則已生效。
| 中文說明 / 介面用語 | 處理方式 | 適用情境 | 檢查重點 |
|---|---|---|---|
| 設定檔 / Config | 依目前設定檔規則決定策略。 | 日常分流,需分別處理不同網域或位址。 | 已啟用的設定檔、規則順序、策略指向。 |
| 代理 / Proxy | 將接管的請求統一交由代理路徑處理。 | 短時間確認所選伺服器能否處理目標請求。 | 伺服器參數、連線可達性、DNS 與目標服務。 |
| 直連 / Direct | 將接管的請求直接交由目前網路處理。 | 確認本地網路是否可連線,縮小排查範圍。 | 目前 Wi-Fi 或行動網路本身的連線狀況。 |
注意事項:此處的「統一」是指用戶端實際接管的流量,不代表保證處理裝置上的所有系統活動。Direct 也不等於關閉連線開關;用戶端仍可能參與請求處理與記錄。測試結束後應恢復原本模式,避免臨時切換影響後續判斷。若 Proxy 可以存取而 Config 無法存取,應優先檢查比對規則與策略,不要立刻重新建立所有伺服器資料。
02 / RULES & POLICIES
是什麼:規則由比對類型、比對內容與策略組成。DOMAIN 比對完整網域名稱,DOMAIN-SUFFIX 比對網域後綴及其子網域,DOMAIN-KEYWORD 依網域中的關鍵字比對。後綴規則通常比範圍寬泛的關鍵字更容易檢查;填寫時只輸入網域部分,不要加入通訊協定前綴或網頁路徑。
IP-CIDR 與 IP-CIDR6 分別用於 IPv4、IPv6 網段;GEOIP 依 IP 位址的地區資料庫比對,結果會受資料庫與解析結果影響。USER-AGENT 需依賴請求中可讀取的相應欄位,並非所有連線都具備此條件,因此不能視為通用的應用程式識別方式。
在哪裡、如何設定:前往 Config 開啟目前使用的設定檔,檢查規則內容與排列順序。比對通常由上而下進行,最先符合的規則會決定策略。因此,較具體的例外應排在範圍較廣的規則之前,最後再放置兜底規則。修改前先保留原始檔案;每次只調整一類條件,儲存後確認目前啟用的仍是這份設定檔。
以下僅用於說明順序與策略,並非完整設定,也不對應任何實際線路。
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,DIRECT
DOMAIN-KEYWORD,ads,REJECT
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
注意事項:PROXY 表示交由代理策略處理,DIRECT 表示直連,REJECT 表示拒絕請求;設定檔也可能引用自訂策略群組名稱,請確認該名稱確實存在。FINAL 是前面的規則都未符合時使用的兜底規則,不是「再次測試所有規則」。關鍵字比對範圍過大時,可能影響不相關的目標;遇到異常時,應查看請求實際符合的規則,而非只確認規則文字中是否出現目標名稱。
03 / SUBSCRIBE & SERVER
是什麼:伺服器項目包含建立連線所需的通訊協定、位址、連接埠與驗證資訊;Subscribe 用於透過使用者已有的訂閱網址更新一組伺服器。Config 則管理規則等設定內容。訂閱匯入成功,不代表已選好設定檔;設定檔已啟用,也不代表其中引用的伺服器一定存在。
在哪裡、如何設定:在 Home 使用新增入口,前往 Add Server。匯入已有訂閱時選擇 Subscribe,完整貼上服務商提供的網址,填入方便辨識的名稱後儲存;更新完成後返回 Home,確認群組已顯示,再選擇要使用的伺服器。若已有單一伺服器的參數,選擇對應的 Type,依原始資料逐項填寫。使用 Scan QR Code 時,也應在儲存前核對解析出的類型與位址。
Shadowsocks、VMess、VLESS、Trojan、HTTP、SOCKS5、WireGuard、Hysteria2 等通訊協定的欄位並不通用。請以目前平台顯示的 Type 與已有參數為準,不能只因伺服器位址相同就更換通訊協定。若涉及 TLS、SNI、傳輸路徑或其他附加欄位,請保留原始資料中的值,不要憑名稱猜測。
注意事項:訂閱是更新入口,不是連線成功的證明。若更新失敗,先判斷是網址無法存取、驗證失效,還是回傳內容無法解析;若更新成功但連線失敗,再檢查所選項目與參數。更新訂閱可能覆蓋群組項目的手動修改,若要長期保留變更,建議先記錄或另存。訂閱網址、QR Code 與匯出檔案可能含有驗證資訊,交流問題時請遮蔽敏感內容。
04 / ON DEMAND
是什麼:On Demand 可依網路條件觸發連線。它處理的是「何時連線」,Global Routing 處理的是「連線後如何分流」。啟用 On Demand 不會自動補齊伺服器或設定檔,也不能取代對現有連線的驗證。
在哪裡、如何設定:在 Settings 找到 On Demand,先閱讀目前介面中的條件項目,再依需求設定 Wi-Fi、行動網路或特定網路相關條件。初次設定建議只新增一種條件,並記下預期行為。例如,先確認某個 Wi-Fi 條件是否依預期觸發,再新增其他網路條件,避免多個條件疊加後難以判斷原因。
儲存後,實際切換一次網路,確認系統連線狀態與 Shadowrocket 中顯示的狀態是否一致。測試前先確認手動連線運作正常;若手動連線本身就失敗,繼續增加自動觸發條件只會讓問題更難釐清。各平台的背景執行方式與可用條件可能不同,請依裝置顯示的選項設定。
注意事項:手動中斷連線後,若仍符合觸發條件,系統可能再次建立連線,這不代表開關故障。需要暫停時,先暫時關閉 On Demand,再關閉連線。使用公共 Wi-Fi 且需要登入驗證時,應先完成網路登入,再測試自動連線;不要同時修改路由模式、DNS 與觸發條件。
05 / DATA
是什麼:Data 顯示用戶端記錄的流量數據,可用來觀察上行、下行與累計變化。若目前平台提供依伺服器或應用程式分類的檢視方式,可分別檢查出口使用情況與流量來源。應用程式分類範圍受系統功能限制,不能據此推斷裝置上的所有活動都已完整識別。
在哪裡、如何設定:開啟 Data,先確認目前檢視畫面、統計範圍與單位,再查看數值。上行是裝置送出的資料,下行是裝置接收的資料;即時速率與累計流量是不同指標,不能直接比較。測試規則時,先記下目前數值,只發出一次目標連線,再查看相關項目是否增加,並搭配請求紀錄核對策略。
若要開始新的觀察區間,使用介面提供的重設功能前,先保存必要數值並確認重設對象與範圍。不要假設所有統計都從安裝當天開始,也不要假設每次連線都會清零;實際起算時間請以目前介面與重設行為為準。訂閱中顯示的流量額度與有效期限來自訂閱回傳資訊,並不等同於 Data 的本機統計。
注意事項:通訊協定封裝、重試、統計方式與觀察時間不同,都可能造成 Data、系統設定與服務商數據不一致。流量增加只能表示有資料傳輸,不能單獨證明某條網域規則已符合;若由快取提供內容,頁面正常開啟時也可能幾乎沒有新增流量。詳細讀取方式請參閱Data 流量統計說明。
06 / SETTINGS
初次使用時先保留目前設定。只有在有明確需求時才調整單一項目,並記下原始值;沒有一組適用於所有網路的固定設定。
是什麼、在哪裡:DNS 會將網域名稱轉換為 IP 位址。Settings 中的 DNS 相關設定與 Config 內的 DNS 內容需要一併檢查,不能只根據其中一處判斷最終解析路徑。網域規則、IP 規則與不同解析結果也可能彼此影響。
如何設定:若目前連線正常,先保留現有解析方式作為基準。若發生解析失敗或位址異常,記下目標網域、目前網路與錯誤狀況,再確認 DNS 位址是否可連線。使用 DNS over HTTPS 時,必須填寫完整且有效的解析端點;端點本身也需透過網路與設定才能存取,填入後不保證一定有所改善。
注意事項:網域解析成功不代表目標服務可用。切換 DNS 後,既有連線與快取可能使變更不會立即反映,請透過新的測試請求確認。不同解析方式的說明請見DNS 設定說明。
是什麼、在哪裡:Test Method 位於 Settings 的測試相關設定中,用來選擇 Connectivity Test 採用的方法。不同測試方法可能只驗證不同層次的連線能力,因此清單中的結果不能一概視為實際網頁速度。
如何設定:依目前介面提供的選項選擇測試方式,並在方法、目標與網路環境相同的情況下比較結果。測試目標應是已知可存取且回應相對穩定的位址。先測試一個已知可用的項目,再與其他項目比較,避免目標本身故障而造成誤判。
注意事項:某種方法沒有回應,不一定代表一般請求無法連線;測試有回應,也不代表所有通訊協定與目標都正常。最後仍須透過實際存取與請求紀錄確認,不應只依一次測試結果就頻繁切換伺服器。
是什麼、在哪裡:Today Widget 是系統支援的元件入口與狀態顯示功能;相關選項可在 Settings 中查看。元件的新增位置、顯示方式與更新時間會因系統版本而異,請以裝置實際提供的元件功能為準。
如何設定、注意事項:先在應用程式內確認連線正常,再前往系統元件編輯入口新增相應元件。需要操作連線時,留意系統是否要求解鎖或返回應用程式。元件資訊可能延遲更新;若顯示內容與應用程式不一致,請回到 Home 並核對系統連線狀態,不要將舊數據視為目前狀態。
是什麼、在哪裡:在支援 iCloud 同步的 Apple 裝置上,可透過 Settings 檢查相關選項。同步不等於裝置備份,也不代表每項執行狀態、記錄與統計都會跨裝置複製。
如何設定:先確認裝置使用預期的 iCloud 帳號,且系統允許應用程式使用相關服務,再檢查用戶端列出的同步範圍。多部裝置首次同步前,請分別保留重要設定檔的可還原副本;先在一部裝置上進行小幅修改,等待另一部裝置確認同步後,再繼續編輯。
注意事項:不要在多部裝置上同時修改同一份內容,也不要在同步尚未完成時反覆開關功能。匯出檔案可能包含伺服器驗證資訊,請以敏感檔案方式保存。其他平台即使有同名設定,也不能假設其 iCloud 行為相同。更多選項請見Settings 設定參考。
07 / DIAGNOSTICS
是什麼、在哪裡:Diagnostics 是診斷相關入口,Log 可用來查看可用的執行與請求資訊。可在 Settings 中尋找目前平台提供的相關工具。診斷的目標是確認問題發生在哪一層,而不是看到錯誤就一次修改所有選項。
如何設定:記錄網路類型、Global Routing 模式、所選伺服器與目標網域;若介面提供記錄層級,只在重現問題期間啟用所需的詳細程度。接著發出一次新的目標請求,依「是否接管、符合哪條規則、採用什麼策略、是否完成解析與連線」的順序查看紀錄。
若所有目標都失敗,先檢查目前網路與伺服器連線狀況;若只有單一目標失敗,重點檢查比對規則、目標位址與 DNS;若切換至 Proxy 後恢復,請對照 Config 中的策略指向;若關閉連線後仍失敗,應先排查本地網路或目標服務。每次調整後都使用相同目標重試,才能判斷是哪項變更造成影響。
注意事項:記錄中缺少某筆請求,不一定代表規則遺漏,也可能是連線未被接管、快取未產生新請求,或目前記錄範圍不包含該事件。分享診斷資料前,請遮蔽訂閱網址、密碼、驗證欄位與個人存取內容。排查完成後恢復日常記錄設定,並保留「原始設定、變更項目、重現結果」三項紀錄,方便日後比對。