文件 設定 代理組通用欄位

代理組通用欄位

策略組(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 回傳自訂圖示字串,配合支援的面板顯示