工作原理
本页跟着一条连接走一遍 Core,从它到达开始,到数据开始流动为止。规则的表现和预期不一致时,了解这个顺序很有帮助: 每一步只能用到前面各步已经得到的信息。
program ──► ingress ──► process ──► DNS mapping / sniffing ──► rules ──► group ──► dialer ──► server
(port, TUN, (who (which host name (first (which (DIRECT,
eBPF, opened belongs to this IP) match) member) proxy, chain)
gateway) it)
telemetry: Connections, rule and proxy counters, logs1. 入口:连接从哪里来
| 入口 | 进来的流量 | 目标的形式 | 是否知道进程 |
|---|---|---|---|
本地端口([general] port) | 设置了 HTTP 或 SOCKS5 代理的程序发出的 TCP | 程序发来的主机名,或 IP | 本机程序:知道 |
| TUN(增强模式,Windows 和 macOS) | 被路由进虚拟网卡的 TCP 和 UDP | IP(如果 DNS 由 Core 应答,则是 Fake-IP) | TCP 知道,UDP 尽力而为 |
| eBPF(增强模式,Linux) | 内核选中的 TCP 和 UDP,交给 Core 的本地端口 | IP | 知道,由内核记录 |
路由器网关(Linux,--gateway) | 局域网设备的流量,经 TPROXY 重定向 | IP | 不知道;改用来源地址、MAC 和设备名 |
- 本地端口监听
127.0.0.1;allow-lan = true时监听所有 IPv4 地址。它支持 HTTP(CONNECT和普通的http://请求)和 SOCKS5CONNECT,只承载 TCP。SOCKS5 客户端发来 Fake-IP 时,按它背后的主机名处理。 - TUN 按路由接管:进入虚拟网卡的流量都归它,
exclude-routes或更具体的路由排除在外的除外。见 TUN。 - eBPF 在内核里根据你的规则决定哪些连接能到达 Core。目标在私有网段的连接和 IPv6 永远不会被接管。 见 Linux eBPF。
- Core 自己连接代理服务器时绑定物理网卡,所以这些连接不会绕回增强模式。
2. 识别进程
Core 找出发起连接的程序,供进程规则匹配:
- 本地端口: 向操作系统查询客户端套接字属于哪个进程。只有来自本机的连接才有进程。
- TUN: 在系统套接字表里查每条新流的所有者。TCP 是准确的;很快关闭的 UDP 套接字可能查不到。
- eBPF: 内核在套接字创建时就记下了进程。
- 路由器网关: 局域网设备没有本机进程,请用
SRC-IP-CIDR、SRC-MAC或SRC-DEVICE规则。
进程未知时,所有进程规则都会被跳过。带 include-children 的规则还会查询父进程链。
3. DNS:这个地址对应哪个主机名
增强模式看到的是 IP,而大多数规则针对的是主机名。Core 的办法是自己应答 DNS 查询,并记住每个应答属于哪个名字。 开启增强模式、启用 [dns] listener,或处于路由器网关模式时,DNS 模块才会运行。
对于增强模式接管的查询,Core 先决定这个名字的去向,再给出应答:
| 名字 | 应答 |
|---|---|
写在 [dns] hosts 里 | 配置的地址 |
| 代理服务器自己的域名 | 通过系统 DNS 服务器直连查询的真实地址 |
规则指向 REJECT | 拒绝(REFUSED) |
规则指向代理,mode = "fake-ip"(默认) | 从 fake-ip-range(默认 198.18.0.1/16)分配的 Fake-IP |
规则指向 DIRECT,mode = "fake-ip" | 通过系统 DNS 服务器查询的真实地址 |
任意名字,mode = "fake-ip-all" | Fake-IP |
任意名字,mode = "real-ip" | 通过系统 DNS 服务器查询的真实地址 |
- 之后连接发往某个 Fake-IP 时,Core 准确知道它背后的名字,并用这个名字匹配规则。最终走
DIRECT的 Fake-IP 连接,由 Core 重新解析一次。 - 走代理的名字需要真实应答时,经该代理向
nameserver-proxy查询。Core 同样会记住这些地址,之后连向它们的连接 也能按名字匹配。 - 在 Linux eBPF 下,没有域名或 IP 规则能决定去向的名字也会拿到 Fake-IP,这样它们的连接会被接管,并能带着进程信息匹配。
- 应答会被缓存。节点、代理组或规则变化的重新加载会清空缓存,因为缓存的应答里带着路由决定。
DNS 查询来自系统解析器而不是程序本身,所以进程规则永远不会决定 DNS 应答。走本地端口时,程序通常自己发送主机名, 不需要 DNS 这一步。见 DNS。
4. 嗅探
对增强模式或路由器网关接管的连接,Core 可以从开头几个字节里读出主机名:HTTP 的 Host 头,或 TLS 握手里的 服务器名(SNI)。只在 http-ports 和 tls-ports 列出的端口上嗅探;目标是 Fake-IP 时跳过,因为 Fake-IP 已经 指明了主机。嗅探到的名字参与规则匹配。override-destination = true 时,还会让代理去连接嗅探到的名字而不是 IP (DIRECT 除外)。本地端口不做嗅探。见嗅探。
5. 规则匹配
此时 Core 已经知道目标(名字和/或 IP、端口)、网络类型(TCP 或 UDP)、进程(如果有),网关流量还有来源设备。 它按以下顺序决定:
[route] bypass:命中的名字或地址直接DIRECT,先于一切。这对增强模式、网关,以及 Global 和 Direct 模式下的本地端口有效。Rule 模式下的本地端口目前不检查bypass。- 路由模式:
direct全部直连,global全部交给global-proxy。 - 规则(
rule模式):按书写顺序检查,第一条命中的规则生效。域名规则和进程规则之间只比位置先后。 在应用里关掉的规则会被跳过。 FINAL:什么都没命中。final-mixed和final-enhanced可以分别为本地端口和增强模式指定兜底出站。
resolve-unknown-domains = true 时,没有规则命中的主机名会被解析,再用解析出的地址重新匹配,让 IP 和 GeoIP 规则 有机会命中。在本地端口上,这只对携带主机名的 SOCKS5 请求生效,而且要有 DNS 模块在运行。
只按域名或只按 IPv4 的查询结果会被缓存(各 4096 条);缓存属于规则表,重新加载时随规则表一起替换。 见分流规则。
6. 选择代理组成员
出站是代理组时,代理组在建立连接时挑选成员:
| 代理组 | 挑选方式 |
|---|---|
select | 应用里选中的成员(没选过时是第一个) |
url-test | 测得延迟最低的成员(还没测过时是第一个);只有另一个成员快出 tolerance 毫秒时才切换 |
fallback | 最近一次健康检查通过的第一个成员;都没通过时用第一个 |
load-balance | consistent-hashing:同一主机名(或进程路径)固定用同一成员;round-robin:轮流使用 |
健康检查每 interval 秒访问一次 url;不写 interval 就没有健康检查。在 Linux eBPF 下,指向代理组的进程规则 会一直使用第一次选中的成员,见成员固定。详见代理组。
7. 拨号
选定的出站开始连接:
DIRECT直接连接目标。目标是 Fake-IP 时,Core 先解析出名字对应的地址。REJECT关闭连接。- 节点 先连接它的服务器,再让服务器去连目标。节点设置了
dialer-proxy时,Core 先连到那个节点(或代理组成员), 再经由它连接本节点的服务器。链从内向外构建:A设置dialer-proxy = "B",路径就是 你 →B→A→ 目标。 见代理链。
交给代理的主机:Core 知道原始主机名时用主机名(来自程序、Fake-IP,或开启了 override-destination 的嗅探), 否则用 IP。
8. 统计
连接进行期间,Core 记录:
- 连接本身,包括入口、进程、命中的规则、路由、代理组和节点,供 Connections 页显示;
- 每条规则的命中次数和流量,显示在 Rules 页;
- 每个节点、每个代理组的连接数、延迟和流量;
- 概览图表用的总流量;
- 日志:保存在内存中;
log-file = true时还按天写入文件,保留 7 天。
重新加载 Profile
在一个 Profile 运行时激活另一个 Profile,Core 会就地重新加载:比较新旧配置,只改动有差异的部分。 不重启任何东西,正在进行的连接继续。
| 改动 | 结果 |
|---|---|
log-level、log-file | 立即生效 |
route-mode、global-proxy | 按新模式运行;在应用里切换的模式会一直保留,直到文件里这两项之一发生变化 |
port、protocols、allow-lan | 监听迁移到新设置,已有连接继续 |
api-listen | TCP 控制接口迁移;旧监听再服务约 2 秒 |
节点、代理组、[route] | 用新的节点表和规则表替换旧的,见下文 |
[dns] | 重建 DNS 模块,增强模式随之重建 |
[sniffer]、[enhanced-mode] | 重建增强模式的接管 |
节点、代理组或规则变化时:
- 仍然存在的代理组和成员,保留其选择和健康检查结果;
- 设置没变的节点保持原样运行;
- Fake-IP 映射保留,除非
fake-ip-range变了; - 清空 DNS 应答缓存,增强模式重新计算要接管的流量。
在 Linux eBPF 下,监听、DNS、增强模式或嗅探的改动会重建整个运行时,因为 eBPF 直接使用监听和 DNS 模块。
重新加载要么全部成功,要么全部不做。某一步失败时,前面的步骤会被撤销,之前的 Profile 继续运行。加载或校验失败的 Profile 完全不会影响正在运行的那个。应用里的增强模式开关只改变正在运行的 Core;再次激活 Profile 时, 按文件里写的 [enhanced-mode] enable 生效。
Profile 文件如何变成运行中的配置,见架构。
