Skip to content
English下载

增强模式 ​

本地 HTTP/SOCKS5 端口只能处理设置了代理的程序。增强模式接管本机所有程序的连接,并用同一套 [route].rules 分流。

toml
[enhanced-mode]
enable = true
# backend 可以不写:Windows 和 macOS 为 tun,Linux 为 ebpf
ip-version = "ipv4"

请先通过本地端口把配置调通(依次验证 Direct、Global、Rule,见快速开始),再打开增强模式。

后端 ​

每个平台只有一个可用的后端。不写 backend 时,Specola 自动选择。

平台backend接管方式页面
Windowstun(默认)WinTUN 虚拟网卡,靠路由把流量送进去TUN
macOStun(默认)utun 虚拟网卡,靠路由把流量送进去TUN
Linuxebpf(默认)挂在 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)。

字段 ​

字段默认值说明
enablefalse开启增强模式
backendWindows、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)同 WindowsCore 和 Specola 应用;回环、私有网段、链路本地、组播、广播和本机地址(DNS 除外);IPv6
TCP 连接的进程套接字表,精确套接字表,精确内核记录,精确
UDP 的进程尽力而为尽力而为内核记录,精确
进程规则固定代理组成员否否是(成员固定)
Specola 应用被豁免否否是
IPv6ip-version = "dual" 时ip-version = "dual" 时从不
对系统的改动网卡、路由、NRPT 规则网卡、路由、主网络服务的 DNS除 eBPF 程序外无改动
权限提升权限的 Core(服务)rootroot
主要设置[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 网站绕过了 Specolaip-version = "ipv4" 时如此,eBPF 下总是如此。保持 [dns] ipv6 = false