增强模式
本地 HTTP/SOCKS5 端口只能处理设置了代理的程序。增强模式接管本机所有程序的连接,并用同一套 [route].rules 分流。
[enhanced-mode]
enable = true
# backend 可以不写:Windows 和 macOS 为 tun,Linux 为 ebpf
ip-version = "ipv4"请先通过本地端口把配置调通(依次验证 Direct、Global、Rule,见快速开始),再打开增强模式。
后端
每个平台只有一个可用的后端。不写 backend 时,Specola 自动选择。
| 平台 | backend | 接管方式 | 页面 |
|---|---|---|---|
| Windows | tun(默认) | WinTUN 虚拟网卡,靠路由把流量送进去 | TUN |
| macOS | tun(默认) | utun 虚拟网卡,靠路由把流量送进去 | TUN |
| Linux | ebpf(默认) | 挂在 cgroup v2 socket hook 上的 eBPF 程序把套接字重定向给 Core;不建虚拟网卡,不改路由 | Linux eBPF |
两种后端都知道连接是哪个程序发起的。TUN 在系统的套接字表里查询所属程序,eBPF 在内核创建套接字时就记录下来。 参见哪些连接带有进程信息。
配置接受哪些值:
backend只能是tun或ebpf。其他值(wfp、windivert、netfilter、network-extension等) 都会报错:enhanced-mode.backend must be tun or ebpf。- 在 Linux 上,
enable = true且backend = "tun"会报错:enhanced-mode.backend=tun is not supported on Linux; use ebpf or disable enhanced mode。 - 在 Windows 和 macOS 上,
backend = "ebpf"能通过校验,但 Core 拒绝启动增强模式:Enhanced mode requires the TUN backend on Windows(或on macOS)。 - 不带 eBPF 的 Linux 构建(OpenWrt)没有增强模式:
This Linux build has no enhanced mode; capture LAN traffic with the transparent gateway (--gateway)。
字段
| 字段 | 默认值 | 说明 |
|---|---|---|
enable | false | 开启增强模式 |
backend | Windows、macOS 为 tun,Linux 为 ebpf | 见后端 |
ip-version | "ipv4" | ipv4、ipv6 或 dual,见下表 |
ip-version 在不同后端下的效果:
| 取值 | TUN(Windows、macOS) | eBPF(Linux) |
|---|---|---|
ipv4 | 只添加 IPv4 路由;IPv6 流量照常走原网络 | 接管 IPv4;IPv6 永远不接管 |
dual | 同时添加 IPv4 和 IPv6 路由 | 与 ipv4 相同 |
ipv6 | 只添加 IPv6 路由。IPv4 的 Fake-IP 网段也不再路由,拿到 Fake-IP 的域名会全部失效。不要使用 | Core 拒绝启动:eBPF process proxy requires IPv4; set enhanced-mode.ip-version to ipv4 |
没有特别理由就保持 ipv4,并保持 [dns] ipv6 = false,让程序拿到 IPv4 地址。
后端专属子表:[enhanced-mode.tun] 见 TUN,[enhanced-mode.ebpf] 见 Linux eBPF。一个配置里可以同时写两张表,只有所选后端的那张生效;在 Linux 上 [enhanced-mode.tun] 仍会做校验。[enhanced-mode] 下出现其他字段(包括旧的 type)会报 Unknown enhanced-mode field。
权限
增强模式需要管理员权限;只用本地端口的普通代理模式不需要。
| 平台 | 需要什么 | 怎么做 |
|---|---|---|
| Windows | 以提升权限运行的 Core | 使用已安装的 Specola 服务(specola-service,以 LocalSystem 运行),或以管理员身份启动 Core。wintun.dll 必须和 Core 可执行文件放在一起 |
| macOS | 以 root 运行的 Core | 用 sudo 启动,或让 Core 自己申请,见下文 |
| Linux | 以 root 运行的 Core | 用 sudo、systemd 服务启动,或让 Core 自己申请,见下文 |
在 macOS 和 Linux 上,如果 Core 启动时加载的配置开启了增强模式,而 Core 不是 root,它会申请一次授权, 然后以 root 身份重新启动自己:macOS 弹出管理员授权对话框,Linux 弹出桌面认证对话框(polkit,pkexec)。 拒绝授权的话 Core 会退出。Core 已经在运行时再切换到这样的配置,不会弹出授权,只会报错,例如 TUN requires administrator privileges. Restart specola-core with sudo, or enable TUN in the startup profile and restart Core to request authorization.
与 Specola 其他部分的配合
本地端口。 开启增强模式后,本地 HTTP/SOCKS5 端口照常可用。
- TUN 不依赖本地端口。连到本地端口的连接来自
127.0.0.1,不会进入 TUN。 - eBPF 借用本地端口的端口号把被接管的 TCP、UDP 连接交给 Core,所以
[general] port必须大于 0。protocols = "none"时端口仍为 eBPF 保留,但不接受 HTTP、SOCKS5 客户端。port = 0时 eBPF 无法启动 (Linux eBPF inbound setup failed)。
DNS。 域名规则需要知道被接管的连接对应哪个域名。增强模式自己应答本机的 DNS 查询,对规则送往代理的域名 返回 Fake-IP(取自 [dns] fake-ip-range);连到 Fake-IP 的连接按域名分流。查询到达 Core 的方式各不相同:
| 后端 | DNS 接管方式 |
|---|---|
| TUN,Windows | 用 NRPT 规则把系统解析器指向 Core 的虚拟 DNS 地址;进入网卡的所有 UDP 53 端口查询都由 Core 应答。dns-hijack = false 关闭这两项 |
| TUN,macOS | 把主网络服务的 DNS 服务器改成 127.0.0.1,TUN 停止时恢复;Core 监听 127.0.0.1:53 |
| eBPF | 发往任何服务器 53 端口的 TCP、UDP 查询都重定向给 Core(监听 127.0.0.1:5353);不改系统 DNS 设置 |
应答如何选择见 DNS,细节见各后端页面。
嗅探。 对被接管的 TCP 连接,Core 可以读取 HTTP Host 头或 TLS SNI,把得到的域名用于域名规则, 即使程序自己解析了域名(比如用了 DNS over HTTPS)。默认开启,只作用于增强模式和路由器网关,不作用于本地端口。 连到 Fake-IP 的连接不嗅探,因为域名已经知道了。见 Sniffer。
兜底出站。 没有规则命中的被接管连接,走 [route] final-enhanced(需要是已存在的节点或代理组), 否则走规则列表里的 FINAL。见分流规则。
进程规则两种后端都能用,但在 UDP、成员固定和哪些程序被豁免上有差别,见进程规则。
热重载
重新激活配置时,改动会就地生效,不必重启 Core:
- 打开或关闭增强模式,或修改
[enhanced-mode]、[sniffer]下的任何内容,只会停止并重新启动接管部分 (TUN 网卡或 eBPF 程序)。如果[dns]有改动,或 DNS 的工作方式变了(例如打开或关闭增强模式),DNS 也会重建。 - 修改规则、节点、代理组时,接管部分保持运行。在 eBPF 下,内核交给 Core 的连接范围会就地重新计算。
- Linux eBPF: 修改本地端口、
[dns]、[enhanced-mode]或[sniffer]会重建整个运行时,因为 eBPF 和本地端口、DNS 模块共用资源。已经打开的连接可能会断开。
新的接管部分启动失败时,会恢复原来的配置。校验不通过的配置不会影响正在运行的配置。
平台对比
| Windows(TUN) | macOS(TUN) | Linux(eBPF) | |
|---|---|---|---|
| 接管范围 | 路由送进网卡的流量 | 路由送进网卡的流量 | Core 所在网络命名空间里所有进程的套接字 |
| 永不接管 | Specola 自己发出的连接;在别处有更具体路由的目标(局域网、VPN、exclude-routes) | 同 Windows | Core 和 Specola 应用;回环、私有网段、链路本地、组播、广播和本机地址(DNS 除外);IPv6 |
| TCP 连接的进程 | 套接字表,精确 | 套接字表,精确 | 内核记录,精确 |
| UDP 的进程 | 尽力而为 | 尽力而为 | 内核记录,精确 |
| 进程规则固定代理组成员 | 否 | 否 | 是(成员固定) |
| Specola 应用被豁免 | 否 | 否 | 是 |
| IPv6 | ip-version = "dual" 时 | ip-version = "dual" 时 | 从不 |
| 对系统的改动 | 网卡、路由、NRPT 规则 | 网卡、路由、主网络服务的 DNS | 除 eBPF 程序外无改动 |
| 权限 | 提升权限的 Core(服务) | root | root |
| 主要设置 | [enhanced-mode.tun] | [enhanced-mode.tun](生效的字段更少) | [enhanced-mode.ebpf] |
安全地停止
请正常停止 Core(退出应用、Ctrl+C、停止服务、systemctl stop),让它撤销自己的改动。不要用 kill -9, 也不要在任务管理器里结束进程。
- Windows:网卡和路由随进程一起消失,只有 NRPT DNS 规则可能残留。Core 每次启动都会清除残留规则;服务被异常结束时, 系统会运行
specola-service.exe --reset-network。见 TUN 排错。 - macOS:强制结束后,主网络服务的 DNS 服务器仍是
127.0.0.1。见 TUN 排错。 - Linux:进程结束时 eBPF 程序就会卸下,无论以什么方式结束。
排错
| 报错或现象 | 原因和解决办法 |
|---|---|
Unknown enhanced-mode field: type | 字段名是 backend |
enhanced-mode.backend must be tun or ebpf | 当前构建没有 WFP、WinDivert、NetFilter、Network Extension 后端 |
enhanced-mode.backend=tun is not supported on Linux | 删掉 backend 或写 ebpf |
Enhanced mode requires the TUN backend on Windows / on macOS | 删掉 backend 或写 tun |
... requires administrator privileges | 见权限 |
| 被接管流量的域名规则从不命中 | 程序用了自己的加密 DNS。保持嗅探开启,或改用 IP、进程规则 |
| IPv6 网站绕过了 Specola | ip-version = "ipv4" 时如此,eBPF 下总是如此。保持 [dns] ipv6 = false |
