Provider

Proxy provider 在 Core 加载配置时从一个 URL 下载一组 [[proxy]]，并追加到配置本身定义的代理中。 适合团队统一发布一份内部代理列表。

[[proxy-provider]]
name = "team"
url = "https://config.example.com/specola/team-proxies.toml"

字段

字段	必填	说明
name	是	provider 名称，唯一
url	是	provider 文件的 HTTPS 地址
path	否	下载后保存的位置；默认在 Specola 缓存目录
proxy	否	通过这个代理下载；必须是配置本身定义的 [[proxy]]

出现其他字段会报错。

Provider 文件

文件是只包含 [[proxy]] 的 Specola TOML，格式与代理相同：

[[proxy]]
name = "team-tokyo"
type = "http"
server = "tokyo.proxy.example.com"
port = 8080

[[proxy]]
name = "team-frankfurt"
type = "http"
server = "fra.proxy.example.com"
port = 8080

不接受 Clash YAML、sing-box JSON 或分享链接。

使用 provider 中的代理

Provider 中的代理与配置里直接写的代理完全一样，可以在代理组、规则或 global-proxy 中按名称引用：

[[proxy-group]]
name = "team"
type = "url-test"
proxies = ["team-tokyo", "team-frankfurt"]
url = "https://www.gstatic.com/generate_204"
interval = 300

代理名称在整份配置和所有 provider 之间必须唯一。按过滤条件选择 provider 成员的代理组字段 use 在当前版本不可用，请在 proxies 中直接列出成员。

更新与失败

每次 Core 加载配置（包括 specola-core -t）都会下载 provider。下载失败但已有旧副本时，Core 使用 缓存副本并记录警告；没有副本时加载失败。

Provider 文件会直接影响路由，只使用你信任的、HTTPS 提供的 provider。

规则集

需要复用或下载的规则列表配置在 [rule.cache] 下，见分流规则 → 规则集。