Skip to content
English下载

代理组 ​

[[proxy-group]] 给多个代理起一个共同的名字,并决定每条连接用哪一个。规则、global-proxy 和 dialer-proxy 都可以像引用代理一样引用代理组。

toml
[[proxy]]
name = "office"
type = "http"
server = "office.example.org"
port = 8080

[[proxy]]
name = "office-backup"
type = "http"
server = "backup.example.org"
port = 8080

[[proxy-group]]
name = "work"
type = "fallback"
proxies = ["office", "office-backup", "DIRECT"]
url = "https://www.gstatic.com/generate_204"
interval = 300

下文中以 [[proxy-group]] 开头的示例都是片段:它们引用的 office、office-backup、home 需要像上面这样先声明。

类型 ​

type选择
select你在应用里选中的成员;还没选时用第一个
url-test健康且测得延迟最低的成员
fallback按列表顺序,第一个上次检查没有失败的成员
load-balance在没有失败的成员中,按 strategy 为每条连接选一个

代理组为每条新连接做选择。已经建立的连接继续使用它开始时的成员。

字段 ​

字段必填默认取值
name是—在代理和代理组之间唯一;不能是 DIRECT 或 REJECT;不能含逗号或 ::
type是—select、url-test、fallback 或 load-balance
proxies是—非空的成员名称数组,见成员
url否http://www.gstatic.com/generate_204健康检查地址,只有 url-test 和 fallback 使用
interval否无检查间隔(秒),正整数。不写就不做周期检查
tolerance否0毫秒,不能为负;只用于 url-test
strategy否consistent-hashingconsistent-hashing 或 round-robin;只用于 load-balance
dialer-proxy否无所有成员都经由这个代理连接,见代理链
icon否无应用里显示的代理组图标

[[proxy-group]] 是严格的:写其他字段会报错 unknown field '<key>',值的类型不对 (interval = "300")同样会报错。url、tolerance、strategy 写在用不到它们的类型上会被接受并忽略。 url-test 或 fallback 不写 url 时,加载会告警,并使用默认地址。

段名请写 [[proxy-group]]。复数形式 proxy-groups 会被告警后丢弃,里面的代理组全部丢失。

成员 ​

  • 成员是某个 [[proxy]] 的名称,或 DIRECT、REJECT。
  • 代理组不能嵌套。 在 proxies 里写代理组名会报错 Proxy group '<group>' references unknown proxy: <name>,和名称拼错是同一个错误。 想合并两个组,就直接列出它们的代理。
  • 带 dialer-proxy 的代理组只能包含代理,不能有 DIRECT 或 REJECT。
  • 成员顺序对 select(默认成员)和 fallback(优先顺序)有意义。

各类型如何选择 ​

select ​

使用你在应用里选中的成员,还没选时用第一个。健康检查不会改变 select 组的选择,只用来显示延迟。

url-test ​

  • 在上次检查成功的成员里,延迟最低的胜出。
  • 从未检查过的成员,以及上次检查失败的成员,都不参与比较。
  • 没有任何成员检查成功时,使用第一个成员,即使它检查失败了。
  • tolerance 用来避免来回切换:当前成员的延迟比最快成员高出不超过 tolerance 毫秒时,保持不变。 tolerance = 0 时,只要有更快的成员就切换。

fallback ​

按列表顺序,使用第一个上次检查没有失败的成员。从未检查过的成员算作正常,所以没有健康检查时, 这个组总是使用第一个成员。所有成员上次检查都失败时,使用第一个成员。

希望所有代理都挂掉时流量还能继续,就把 DIRECT 放在最后一个。如果这部分流量绝不能直连,就不要加。

load-balance ​

在上次检查没有失败的成员中选择;都失败时在全部成员中选择。

strategy选择
consistent-hashing(默认)按目标的散列值选成员,同一个网站固定用同一个成员
round-robin每条连接依次换下一个成员

consistent-hashing 的散列键是目标域名的最后两级:a.example.com 和 b.example.com 都是 example.com。这不是按公共后缀表计算的,所以 a.example.co.uk 和 b.other.co.uk 都是 co.uk, 总会落到同一个成员。没有目标域名的连接,如果是被某条规则命中且程序已知,就以程序路径作为键; 否则随机选一个成员。

散列是在当前正常的成员之间计算的,所以某个成员失败或恢复时,很多网站会换到别的成员。 load-balance 分散的是整条连接,不会让单个下载变快。

健康检查 ​

健康检查经由成员向检查地址发送一个 HTTP 请求。3 秒内收到 200–299 的状态码即为成功。 延迟是整个请求的耗时,包括连接代理和握手的时间。

  • interval 打开周期检查。第一轮立即检查所有成员;之后每次检查一个成员,均匀分布在间隔内: 10 个成员、interval = 300 时,每 30 秒检查一个。两次检查之间至少隔 5 秒,所以成员很多时, 一轮会比 interval 更长。
  • url 只有 url-test 和 fallback 使用。select 和 load-balance 组总是检查默认地址。 支持 HTTPS 地址。请选一个和你关心的流量走同样路径的地址:检查只能证明这个地址经由该成员可达。
  • REJECT 的检查总是失败。DIRECT 和代理一样会被检查。
  • 健康状态属于代理,不属于代理组。 一个代理在两个组里只有一份结果,以最近一次检查为准, 不管是哪个组发起的。
  • 在应用里测延迟也会更新同一份结果。 手动测试失败,会让这个代理在所有 url-test、fallback、 load-balance 组里都被视为失败,即使那个组没有写 interval。
  • 不写 interval 时不做周期检查:fallback 一直用第一个成员;url-test 也一直用第一个成员, 直到手动测延迟给了它数据。
  • 带 dialer-proxy 的代理组,成员检查时不经过组的入口代理。见 代理链。

在应用里选择成员 ​

在「代理组」页面或托盘菜单里为 select 组选择成员,选择立即作用于新连接。

  • 选择保存在 Core 的内存里。重新激活 Profile 时会保留(见下文),但 Core 重启后不保留: 重启后代理组又从第一个成员开始。
  • 应用只允许在 select 组里选择。url-test、fallback、load-balance 组自己选择成员。

重新加载时会怎样 ​

重新激活 Profile 时,改动就地生效,不需要重启 Core:

  • 名称不变、仍然存在的代理组,如果选中的成员还在列表里,保留选择;否则回到默认。
  • 未改动的代理保留健康结果。 设置有改动的代理没有结果,相当于从未检查过。
  • 仍然存在的代理组,round-robin 保留当前位置。
  • 给代理组改名,等于删掉旧组、新建一个组。

Linux eBPF 下进程规则会固定成员 ​

在 Linux eBPF 增强模式下,指向代理组的进程规则第一次命中时选定一个成员,并一直使用它, 直到重新加载节点、代理组或规则。对这些连接,url-test 不会切换,fallback 不会故障转移, load-balance 不会分散,在 select 组里换选择也不起作用。其他类型的规则以及 Windows、macOS 不受影响。见进程规则。

示例 ​

手动选择(片段):

toml
[[proxy-group]]
name = "exit"
type = "select"
proxies = ["office", "home", "DIRECT"]

自动选最快,明显更快才切换(片段):

toml
[[proxy-group]]
name = "auto"
type = "url-test"
proxies = ["office", "home"]
url = "https://www.gstatic.com/generate_204"
interval = 300
tolerance = 50

分散连接,跳过失败的成员(片段):

toml
[[proxy-group]]
name = "spread"
type = "load-balance"
proxies = ["office", "home"]
strategy = "round-robin"
interval = 300

在规则里使用代理组(片段):

toml
[route]
rules = [
  "DOMAIN-SUFFIX,corp.example.com,work",
  "FINAL,auto",
]

排错 ​

  1. url-test 或 fallback 从不切换:加上 interval,不写就不会检查。
  2. 能用的代理被避开了:它上次检查失败了。可能是检查地址在这个代理上被屏蔽,可能是手动测延迟失败, 也可能是代理组带了 dialer-proxy(成员检查时不经过它)。
  3. references unknown proxy:成员名拼错了,或者写的是代理组。代理组不能嵌套。
  4. 重启应用后选择丢了:Core 重启后不保留选择。
  5. 在 Linux 上某个程序始终不换成员:这是 eBPF 下的成员固定。

另见代理、代理链和规则。