远程代理集

在配置文件直接声明的代理，无法在后台自动更新。我们更推荐使用远程代理集（proxy-provider），能在后台自动从 URL 更新策略组。

基本用法

要使用远程代理集，需要在 proxy-providers 下定义，并在 proxy-groups 中引用。

proxy-providers:
  provider-a:
    url: https://raw.githubusercontent.com/STASH-NETWORKS-LIMITED/stash-example/main/config.yaml
    interval: 3600
    filter: 'example'

  provider-b:
    url: https://raw.githubusercontent.com/STASH-NETWORKS-LIMITED/stash-example/main/config.yaml
    interval: 3600

proxy-groups:
  - name: auto
    type: url-test
    interval: 300
    use:
      - provider-a  # reference to provider-a
      - provider-b  # reference to provider-b

远程代理集格式

一个合法的远程代理集必须包含 proxies 字段：

proxies:
  - name: 'ss1'
    type: ss
    server: server
    port: 443
    cipher: AEAD_CHACHA20_POLY1305
    password: 'password'
  - name: 'ss2'
    type: ss
    server: server
    port: 443
    cipher: AEAD_CHACHA20_POLY1305
    password: 'password'

远程代理集支持通过 filter 字段，使用正则表达式过滤代理名。远程代理集为空时候，会以 DIRECT 替代。

快捷引用远程代理集

Stash 也支持通过 use-url 在策略组中快捷引用远程代理集，此时不可指定更新时间和名称。

proxy-groups:
  - name: auto
    type: url-test
    interval: 300
    use-url:
      - https://raw.githubusercontent.com/STASH-NETWORKS-LIMITED/stash-example/main/config.yaml

配置参数说明

url

远程代理集配置文件的 URL 地址，支持 HTTP/HTTPS 协议。

interval

更新间隔时间，单位为秒。建议设置为 3600（1小时）或更长，以避免频繁请求。

filter

可选参数，使用正则表达式过滤代理名称。只有名称匹配的代理才会被包含在代理集中。

使用优势

• 自动更新：无需手动更新配置文件，Stash 会自动从远程 URL 获取最新代理列表
• 灵活管理：可以同时引用多个远程代理集，实现代理的动态组合
• 过滤功能：支持通过正则表达式筛选需要的代理节点
• 容错处理：当远程代理集为空或无法访问时，会自动回退到 DIRECT 策略