文档配置代理集合

代理集合

proxy-providers 让你通过订阅链接动态拉取一批节点，而不用把每个节点手写进 proxies。策略组用 use 字段引入代理集合。

配置示例

config.yaml YAML

proxy-providers:
  provider1:
    type: http
    url: "http://test.com"
    path: ./proxy_providers/provider1.yaml
    interval: 3600
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300
      lazy: true
    filter: "(?i)港|hk|hongkong|hong kong"
    override:
      additional-prefix: "[provider1] "
      udp: true

基础字段

键名（如 provider1）必须

集合名称，不能重复，建议和策略组名称区分开。

type必须

可选 http/file/inline。

urltype 为 http 时必须

订阅地址。

path可选

下载后保存的文件路径，不填则用 URL 的 MD5 作为文件名。出于安全考虑，路径只允许在 HomeDir 内，其他位置需要设置 SAFE_PATHS 环境变量。

interval可选

更新集合的时间间隔，单位秒。

proxy可选

经过指定代理进行下载/更新。

size-limit默认 0

限制下载文件的最大大小，单位字节，0 表示不限制。

header可选

自定义 HTTP 请求头，比如给需要鉴权的订阅地址加 Authorization。

payloadtype 为 inline 时必须

直接内联写节点内容，格式和 proxies 一致；当 http/file 解析失败时也会用作兜底节点。

health-check 健康检查

字段	说明
`enable`	是否启用
`url`	健康检查地址，推荐 `https://www.gstatic.com/generate_204` 或 `https://cp.cloudflare.com`
`interval`	检查间隔，单位秒
`timeout`	超时时间，单位毫秒
`lazy`	默认 true，集合内节点没被使用时不进行测试
`expected-status`	期望的 HTTP 响应状态码，写法见代理组通用字段

override 覆写

批量覆写这个集合里所有节点的字段，常见用法：

字段	说明
`additional-prefix` / `additional-suffix`	给节点名称统一加前缀/后缀
`proxy-name`	用正则替换节点名称内容，`pattern` 匹配、`target` 替换（支持 `$1` 分组引用）
`udp` / `tfo` / `mptcp` / `skip-cert-verify` / `dialer-proxy` / `interface-name` / `routing-mark` / `ip-version`	批量覆写通用字段，含义同各自的通用字段说明
`up` / `down`	批量设置带宽（Hysteria/Hysteria2 专属）
`udp-over-tcp`	批量设置 UDP over TCP（Shadowsocks 专属）

筛选与解密

filter / exclude-filter可选

用关键词或正则筛选/排除节点，多个正则之间用 ` 分隔。

exclude-type可选

不支持正则，用 | 分割，按节点类型排除，如 "ss|http"。

age-secret-key可选

如果订阅文件是用 age 加密的，填这个密钥即可自动解密；可用 mihomo age keygen 生成对应密钥。

集合文件本身的写法（YAML / URI / Base64 三种格式），请看代理集合内容。