代理组
[[proxy-group]] 给多个代理起一个共同的名字,并决定每条连接用哪一个。规则、global-proxy 和 dialer-proxy 都可以像引用代理一样引用代理组。
[[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-hashing | consistent-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 不受影响。见进程规则。
示例
手动选择(片段):
[[proxy-group]]
name = "exit"
type = "select"
proxies = ["office", "home", "DIRECT"]自动选最快,明显更快才切换(片段):
[[proxy-group]]
name = "auto"
type = "url-test"
proxies = ["office", "home"]
url = "https://www.gstatic.com/generate_204"
interval = 300
tolerance = 50分散连接,跳过失败的成员(片段):
[[proxy-group]]
name = "spread"
type = "load-balance"
proxies = ["office", "home"]
strategy = "round-robin"
interval = 300在规则里使用代理组(片段):
[route]
rules = [
"DOMAIN-SUFFIX,corp.example.com,work",
"FINAL,auto",
]排错
url-test或fallback从不切换:加上interval,不写就不会检查。- 能用的代理被避开了:它上次检查失败了。可能是检查地址在这个代理上被屏蔽,可能是手动测延迟失败, 也可能是代理组带了
dialer-proxy(成员检查时不经过它)。 references unknown proxy:成员名拼错了,或者写的是代理组。代理组不能嵌套。- 重启应用后选择丢了:Core 重启后不保留选择。
- 在 Linux 上某个程序始终不换成员:这是 eBPF 下的成员固定。
