TUN
在 Windows 和 macOS 上,增强模式会创建一块虚拟网卡(TUN),并添加路由把流量送进去。Core 读取数据包,按规则 直连或经代理转发。Linux 请用 eBPF,在那里写 backend = "tun" 会报错。
[enhanced-mode]
enable = true
backend = "tun" # Windows 和 macOS 上的默认值
[enhanced-mode.tun]
exclude-routes = ["192.168.0.0/16"]每个字段都有默认值,[enhanced-mode.tun] 可以整段不写。
字段
| 字段 | 默认值 | Windows | macOS | 说明 |
|---|---|---|---|---|
auto-route | true | 生效 | 生效 | 把所有流量路由进 TUN:0.0.0.0/1 和 128.0.0.0/1,ip-version 含 IPv6 时再加 ::/1 和 8000::/1 |
routes | [] | 生效 | 生效 | 在 auto-route 之外额外路由进 TUN 的网段 |
exclude-routes | [] | 生效 | 生效 | 从 auto-route 和 routes 中扣除的网段,它们保留系统原有的路由 |
address | "198.19.0.1/30" | 生效 | 不生效 | 网卡地址;下一个地址(198.19.0.2)是 Core 的虚拟 DNS 服务器。IPv4,前缀 8 到 30。macOS 固定使用 10.0.0.1/24 |
dns-hijack | true | 生效 | 不生效 | 把系统解析器指向 Core。macOS 在 TUN 运行期间总是接管系统 DNS |
dns-namespaces | ["."] | 生效 | 不生效 | 系统解析器交给 Core 的域名后缀:"." 表示全部域名,也可以写 ".example.com" 这样的后缀。dns-hijack 开启时不能为空 |
各平台都会做的校验:
routes或exclude-routes里写错的网段会报错,并指出字段名:Invalid enhanced-mode.tun.routes entry: ...。address必须在子网内给 DNS 地址留出位置;198.19.0.1/31或网络地址本身会被拒绝。dns-namespaces的每一项必须是"."或以点开头。- 其他字段一律报错,包括
stack、auto-detect-interface和extra-routes。
ip-version 没有启用的地址族的网段会被忽略:默认的 ipv4 下,routes 里的 IPv6 网段不起作用。
哪些流量进入 TUN
Core 安装的路由依次是:
- Fake-IP 网段
[dns] fake-ip-range(默认198.18.0.1/16),以及[dns] ipv6 = true时的 IPv6 Fake-IP 网段。 它们总是会被路由,exclude-routes扣不掉。 auto-route = true时,上面那四个半区路由。它们比默认路由更具体,所以默认路由本身不会被改动。routes里的每个网段。
exclude-routes 从第 2、3 项中扣除:0.0.0.0/1 减去 10.0.0.0/8 会变成若干条更小的路由,正好绕开 10.0.0.0/8。物理网卡上不会安装任何东西。
auto-route = false 时,只有 Fake-IP 网段和 routes 进入 TUN。这对域名规则已经够用:被规则送往代理的域名会 拿到 Fake-IP,而 Fake-IP 流量总会到达 Core。
哪些流量绕过 TUN
- Specola 自己的连接。 Core 把发出的套接字绑定到物理网卡,所以连接代理服务器的流量和它自己的 DNS 查询不会 绕回 TUN。不需要把代理服务器加进排除列表。
- 在别处有更具体路由的目标:你所在的局域网网段、VPN 的路由(Tailscale 的
100.64.0.0/10、公司 VPN), 以及exclude-routes里的所有网段。 - 回环地址(
127.0.0.1、::1),本地 HTTP/SOCKS5 端口也因此不受影响。 - IPv6,在
ip-version = "ipv4"(默认)时。 - 自己把套接字绑定到某块网卡的程序。
在 TUN 内部,组播和广播包会被丢弃。ICMP Echo(ping)由 Core 自己在 1 到 10 毫秒后应答,所以对任何路由进 TUN 的地址 ping 都会成功,不能用来测试连通性。
Windows 上的 DNS
dns-hijack = true(默认)时:
- Core 安装一条名称解析策略表(NRPT)规则,把
dns-namespaces里的域名交给 Core 的虚拟 DNS 地址 (默认198.19.0.2)。网卡自身的 DNS 服务器也设为这个地址,并把网卡的接口跃点数设为最低。 - 进入网卡的所有 UDP 53 端口查询都由 Core 应答,无论原本发往哪个服务器。发往局域网 DNS 的查询不会进入网卡。
- Core 不占用 53 端口,查询经网卡送达。
[dns.listener]与此无关,只在你开启时才监听。
dns-namespaces 只限制系统解析器交给 Core 的范围。程序自己直接查询某个公网 DNS 服务器时,如果这个服务器被路由进 TUN,应答仍然来自 Core。
NRPT 规则按最长匹配生效,所以 "." 不会盖过 Tailscale 或公司 VPN 安装的后缀规则。如果已经有另一条匹配全部域名的 规则(某个 VPN 的 DNS 覆盖),Core 会记录 another NRPT catch-all rule is active,此时哪条生效是不确定的。 如果组策略里定义了 NRPT 规则,Core 会把规则写进组策略的存储位置,因为这时 Windows 会忽略本地的规则。
dns-hijack = false 时,什么都不重定向,Core 也不应答 TUN 里的查询。DNS 交给你自己的服务器,程序拿到真实地址, 域名规则只能靠嗅探生效(发往 HTTP、TLS 端口的 TCP 连接)。
macOS 上的 DNS
TUN 运行期间,无论 dns-hijack 怎么设,Core 都会把主网络服务(比如 Wi-Fi)的 DNS 服务器改成 127.0.0.1, 并在 127.0.0.1:53 上应答。它把查询转发给这个服务原来的服务器(手动设置的服务器,或 scutil --dns 里 DHCP 下发的服务器),一个都找不到时用 8.8.8.8。TUN 正常停止时恢复原来的设置,包括「自动」。
127.0.0.1的 53 端口必须空闲,否则 DNS 无法启动。dns-namespaces不起作用。程序自己去查询其他 DNS 服务器时,这些查询和其他 UDP 流量一样按规则转发,不由 Core 应答。- TUN 运行期间,
[dns.listener]的地址会被替换成127.0.0.1:53。
Fake-IP 与分流
连到 Fake-IP 的连接按域名分流。如果规则(比如进程规则)把它送往 DIRECT,Core 会重新解析这个域名,连接真实地址。 其他连接按地址分流,HTTP 和 TLS 连接还会用嗅探得到的域名。见 DNS。
TUN 下的进程规则
TUN 按路由接管,而不是按程序:进入 TUN 的每条连接都会带着进程信息参与匹配。
- Core 在系统套接字表里查询所属程序。TCP 是精确的。UDP 是尽力而为:向很多目标发包的套接字,或用完马上关闭的套接字, 可能查不到程序,这时进程规则对它全部跳过。
- 进程规则不固定代理组成员:每条连接都重新向代理组选择。
- Specola 应用不被豁免:它的连接会进入 TUN,和其他程序一样参与分流。Core 自己的连接从不进入 TUN。
include-children沿父进程链查找;在 macOS 上还会看「负责进程」。
详见进程规则。
IPv6
ip-version = "dual" 会加上 IPv6 半区路由。但 Core 自己发出的连接只经物理网卡走 IPv4,所以在当前构建里, 被送往 DIRECT 的 IPv6 目标会连接失败,代理服务器也需要有 IPv4 地址。ip-version = "ipv6" 还会去掉 IPv4 的 Fake-IP 路由,导致 Fake-IP 域名失效,不要使用。没有实际验证过的话,请保持 ip-version = "ipv4" 和 [dns] ipv6 = false。
权限与安装
Windows。 Core 必须以提升权限运行。已安装的 Specola 服务(specola-service,以 LocalSystem 运行)总是满足, 应用连接它时不会弹出提示。手动启动的 Core 需要以管理员身份运行。wintun.dll 随安装包放在 Core 可执行文件旁边。 权限不足时 Core 会报:TUN needs administrator privileges. Use the installed Specola service, or start Core as administrator.
macOS。 Core 必须以 root 运行。用 sudo 启动,或者在 Core 启动时加载的配置里开启 TUN:Core 会申请一次 管理员授权,然后以 root 身份重新启动自己。Core 以非 root 身份运行时再切换到 TUN 配置,只会报错。 见权限。
TUN 运行期间 Core 会修改路由和 DNS,正常停止时撤销这些改动。请退出应用或正常停止 Core,不要强制结束。
排错
| 现象 | 原因和解决办法 |
|---|---|
TUN needs administrator privileges(Windows) | 使用 Specola 服务,或在管理员命令行里启动 |
TUN requires administrator privileges(macOS) | 用 sudo 启动 Core,或在启动配置里开启 TUN 后重启 Core |
wintun.dll cannot be loaded | 重新安装;wintun.dll 必须在 Core 可执行文件旁边 |
| Core 被强制结束后完全无法解析域名(Windows) | 残留了 NRPT 规则。再启动一次 Core(它会清除规则),或以管理员身份运行 specola-service.exe --reset-network |
| Core 被强制结束后完全无法解析域名(macOS) | 主网络服务仍指向 127.0.0.1。运行 networksetup -setdnsservers Wi-Fi Empty(换成你的服务名)。再次开启 TUN 解决不了:Core 会把 127.0.0.1 当作要恢复的设置保存下来 |
Cannot start DNS(macOS) | 有其他程序在监听 53 端口 |
| 访问不了局域网设备、打印机或 NAS | 它们不在你所在的网段内;把它们的网段加进 exclude-routes |
| 某个 VPN 无法使用 | 把它的网段加进 exclude-routes |
在 10.0.0.0/24 网络里出问题(macOS) | macOS 的 TUN 固定使用 10.0.0.1/24,与这个局域网重叠;请换一个局域网网段 |
| 域名规则从不命中 | Windows 上设了 dns-hijack = false,或程序用了自己的加密 DNS;保持嗅探开启 |
| 进程规则漏掉 UDP 流量 | TUN 下 UDP 的进程识别是尽力而为;再加一条域名或 IP 规则 |
| ping 得通但连不上 | ping 是 Core 自己应答的;请用真实连接测试 |
