代理組通用欄位
策略組(proxy-groups)是把一批節點包裝成一個整體,規則裡可以像引用單個節點一樣引用它。6 種類型(select/url-test/fallback/load-balance/relay 等)都共享這一批欄位。
設定範例
config.yaml YAML
proxy-groups: - name: "proxy" type: select proxies: - DIRECT - ss use: - provider1 url: 'https://www.gstatic.com/generate_204' interval: 300 lazy: true filter: "(?i)港|hk|hongkong|hong kong" exclude-filter: "美|日" exclude-type: "Shadowsocks|Http"
基礎欄位
name必須策略組名稱,含特殊符號時要用引號包裹。
type必須策略組類型:select/url-test/fallback/load-balance/relay。
proxies可選引入出站代理或其他策略組,按陣列順序排列。
use可選引入一個或多個代理集合(proxy-providers)。
健康檢查
url可選健康檢查測試位址。注意:只會檢查 proxies 欄位裡的代理,不會檢查透過 use 引入的代理集合節點(那些由集合自己的 health-check 負責)。
interval可選健康檢查間隔,不為 0 則啟用定時測試,單位秒。
lazy預設 true懶惰狀態,目前未被選中/使用時不進行測試,省資源。
timeout可選健康檢查逾時時間,單位毫秒。
max-failed-times預設 5最大失敗次數,超過後觸發一次強制健康檢查。
expected-status預設 *期望的 HTTP 回應狀態碼,設定後只有回應碼匹配才認為節點可用。寫法支援 / 匹配多個狀態碼、- 匹配範圍,可混合書寫,如 200/302/400-503。
批量引入與篩選
include-all / include-all-proxies / include-all-providers可選批量引入全部出站代理和/或全部代理集合(按名稱排序),不含策略組本身;include-all-providers 會使 use 欄位失效。
filter / exclude-filter可選關鍵詞/正規表示式篩選或排除節點,僅作用於引入的代理集合和批量引入的全部代理,多個正規表示式用 ` 分隔。
exclude-type可選不支援正規表示式,用 | 分割按類型排除,僅作用於引入的出站代理。
其他欄位
| 欄位 | 說明 |
|---|---|
default-selected | 預設選擇的節點,為空或節點不存在時預設選第一個 |
empty-fallback | 組內節點為空時的回退出站,預設 COMPATIBLE,只能填代理名不能填策略組 |
disable-udp | 停用該策略組的 UDP |
hidden | 讓 API 回傳 hidden 狀態,前端適配後可以隱藏該策略組展示 |
icon | 讓 API 回傳自訂圖示字串,配合支援的面板顯示 |