Skip to content
English下载

Provider ​

有些代理工具会从单独的文件或 URL 加载节点或规则,这种来源叫 Provider。Specola Core 没有 Provider。 本页列出 Core 遇到 Provider 相关设置时的处理方式,以及应该改用什么。

Core 如何处理 Provider 设置 ​

设置结果
[[proxy-provider]]报错:Unsupported top-level field 'proxy-provider'; supported: general, proxy, proxy-group, route, dns, sniffer, enhanced-mode. ...
[[proxy-group]] 里的 use = [...]报错:proxy-group[<n>]: unknown field 'use'
rule-providers忽略,并告警 Ignoring configuration field 'rule-providers' in the minimal build
指向某个规则 Provider 的 RULE-SET,<名字>,...报错,因为没有同名的 [route] rule-set

在多个 Profile 之间共享节点 ​

在 Profile 里用 [[proxy]] 列出节点,代理组按名字引用:

toml
[[proxy]]
name = "team-tokyo"
type = "trojan"
server = "tokyo.example.org"
port = 443
password = "replace-with-password"
tls = { server-name = "tokyo.example.org" }

[[proxy]]
name = "team-frankfurt"
type = "trojan"
server = "frankfurt.example.org"
port = 443
password = "replace-with-password"
tls = { server-name = "frankfurt.example.org" }

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

想在多个 Profile 里使用同一批节点,就把它们放进一个模块,再把模块应用到各个 Profile。模块里的代理组 既可以引用模块里的节点,也可以引用 Profile 里的节点。节点有变化时,只改模块这一处,再重新激活 Profile 即可。

代理组成员只能是节点、DIRECT 或 REJECT,代理组不能嵌套代理组。见代理组。

复用和下载规则 ​

规则列表写在 [route] rule-set 里,用 RULE-SET 规则引用:

toml
[route]
rules = [
  "RULE-SET,ads,REJECT",
  "RULE-SET,dev-sites,work",
  "FINAL,DIRECT",
]
rule-set = [
  { name = "dev-sites", type = "inline", behavior = "classical", rules = ["DOMAIN-SUFFIX,github.com", "DOMAIN-SUFFIX,npmjs.org"] },
  { name = "ads", type = "remote", behavior = "domain", url = "https://rules.example.org/ads.txt" },
]

这是一个片段:work 必须是 Profile 里的节点或代理组。

type来源
inlineProfile 里的 rules 数组
local一个文件,默认 rule-sets/<name>.txt,必须存在
remote一个 URL,每次加载 Profile 都会下载;下载失败时用缓存,还没有缓存则加载失败。proxy 指定下载时经由的节点。

远程规则集在 Profile 运行期间不会刷新:要重新下载,请再次激活 Profile。update_interval 能写但不生效。 GeoIP 和 GeoSite 数据也可以下载,周期由 geo-update 决定。规则集、behavior、GeoIP 和 GeoSite 详见分流规则。

规则集也可以放在模块里,按名字合并:模块里的规则集会替换 Profile 里的同名规则集。

从其他工具转换 Profile ​

把每个 Provider 的节点改写成 [[proxy]] 条目,把代理组的 use 换成 proxies 里的节点名,把每个规则 Provider 改写成一个 rule-set 条目。然后校验:

bash
specola-core --test-config --config converted.toml