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 | 来源 |
|---|---|
inline | Profile 里的 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