DNS
Specola 需要 DNS 只为一件事:知道一条连接对应哪个域名,好让域名规则能匹配。在本地 HTTP/SOCKS5 端口上,应用会直接把域名发过来。 增强模式下,应用先解析域名再连地址,所以 Core 要替它应答 DNS 查询,并记住每个应答属于哪个域名。
一开始不写 [dns] 就好,默认值适合大多数情况。
[dns]
ipv6 = false
mode = "fake-ip"
fake-ip-range = "198.18.0.1/16"
nameserver-proxy = ["https://1.1.1.1/dns-query", "8.8.8.8"]
hosts = { "nas.lan" = "192.168.1.10" }
listener = { enable = false, address = "127.0.0.1:1053" }字段
[dns] 只接受下面六个键,写其他键会报 Unknown dns field。
| 字段 | 默认值 | 说明 |
|---|---|---|
ipv6 | false | 是否应答 AAAA 查询。为 false 时 AAAA 查询返回空结果。Linux eBPF 下始终关闭 |
mode | "fake-ip" | fake-ip、fake-ip-all 或 real-ip,见 Fake-IP。只影响被接管流量的查询 |
fake-ip-range | "198.18.0.1/16" | Fake-IP 使用的 IPv4 网段,见网段 |
nameserver-proxy | [] | 走代理的域名使用的解析器,经该节点查询。为空时经节点查询系统 DNS 服务器 |
hosts | {} | 固定应答;内联表 |
listener | { enable = false, address = "127.0.0.1:1053" } | 给其他程序用的 DNS 服务;内联表 |
hosts 和 listener 必须写成内联表。写成单独的 [dns.hosts] 或 [dns.listener] 表会加载失败。
Core 什么时候应答 DNS
只有满足下面任一条件时,Core 才会运行 DNS 模块:
| 场景 | 谁把查询发给 Core |
|---|---|
| 增强模式,Windows 上的 TUN | 系统解析器,经 NRPT 规则(见 Windows) |
| 增强模式,macOS 上的 TUN | 系统解析器,被指向 127.0.0.1(见 macOS) |
| 增强模式,Linux eBPF | 被接管程序发出的 DNS 包(见 Linux eBPF) |
| 路由器网关 | 局域网的 DNS 流量 |
listener.enable = true | 你手动指向监听地址的程序 |
都不满足时,Core 没有 DNS 模块。本地端口照常工作:走代理的域名由代理服务器解析,DIRECT 的域名在 Core 发起连接时由操作系统解析。
一个查询怎么应答
Core 按下面的顺序处理每个查询:
ipv6 = false时的 AAAA 查询:返回空结果。- 给域名做路由决策。 路由模式先生效(
direct→DIRECT,global→ 全局节点)。rule模式下只用域名去匹配规则 (见哪些规则决定 DNS 应答),都不命中就用FINAL(被接管的流量用final-enhanced)。 这里不检查bypass,它作用在连接上。你的[[proxy]]服务器域名跳过路由,始终用系统 DNS 服务器解析。 REJECT:返回REFUSED。(Linux eBPF 改为返回 Fake-IP,等连接到来时再做决定。)hosts:在[dns].hosts或系统 hosts 文件里有记录就直接用。- Fake-IP:被接管流量的查询按
mode决定,见 Fake-IP。 - 转发给上游,见解析器。
哪些规则决定 DNS 应答
DNS 查询里只有域名,需要更多信息的规则匹配不了:
- 域名规则可以决定,GeoSite 规则也可以。
- IP 规则(
IP-CIDR、GEOIP等)、DST-PORT、NETWORK和进程规则永远不会命中查询。在AND/OR/NOT里它们按「未知」处理: 含未知条件的AND不会命中。 - 来源规则只对经路由器网关、来自局域网设备的查询起作用。
- 都不决定时,由
FINAL决定。
应答之后的那条连接会带着全部信息重新分流,所以进程规则或 IP 规则仍然可以把它送到别处。进程规则从不决定 DNS 应答, 见进程规则。
解析器
| 域名路由到 | 查询谁 | 经由 |
|---|---|---|
DIRECT | 系统 DNS 服务器 | 直连 |
| 节点或代理组 | nameserver-proxy(为空时用系统 DNS 服务器) | 该节点 |
你的 [[proxy]] 服务器域名 | 系统 DNS 服务器 | 直连 |
任意域名,mode = "real-ip" | 系统 DNS 服务器 | 直连 |
系统 DNS 服务器是 Core 启动时操作系统正在使用的服务器:
- Windows 和 macOS:持有默认路由的网卡上配置的 DNS 服务器。macOS 开启 TUN 时,取 Core 改写系统解析器之前的服务器。
- Linux:
/etc/resolv.conf里的nameserver行,其次/run/systemd/resolve/resolv.conf,再其次 OpenWrt 的/tmp/resolv.conf.d/resolv.conf.auto和/tmp/resolv.conf.auto。本地回环地址(例如本机的 stub 解析器)会被跳过。
nameserver-proxy 按顺序尝试,每次最多等 5 秒。超时、出错,或返回 NXDOMAIN 以外的错误码,都会换下一个。 全部失败时返回 SERVFAIL。
| 写法 | 协议 | 默认端口 |
|---|---|---|
8.8.8.8 或 udp://8.8.8.8 | UDP | 53 |
tcp://8.8.8.8 | TCP | 53 |
https://dns.example.com/dns-query | DNS over HTTPS | 443 |
- 加
:端口可以改端口;IPv6 地址要加方括号(udp://[2606:4700::1111]:53)。 - 其他协议(包括
tls://)会加载失败。 - 条目里的主机名(
https://dns.example.com/...)用系统 DNS 服务器解析。 - 经节点发 UDP 查询时,如果节点不支持 UDP,会改用 TCP;UDP 应答被截断时也会用 TCP 重新查询。
Fake-IP
Fake-IP 是 Core 从一个私有地址池里分配、用来代替真实地址的地址。应用连接这个地址时,Core 把它还原成域名交给代理, 由代理服务器去解析,所以真实地址不必在本机查询。
mode 决定哪些域名拿到 Fake-IP:
mode | 路由到代理的域名 | 路由到 DIRECT 的域名 |
|---|---|---|
fake-ip(默认) | Fake-IP | 真实地址(系统 DNS) |
fake-ip-all | Fake-IP | Fake-IP;连接到来时 Core 再解析一次 |
real-ip | 真实地址(系统 DNS,不经节点) | 真实地址(系统 DNS) |
只有下面这些查询才可能拿到 Fake-IP:
- A 查询,以及
ipv6 = true时的 AAAA 查询; - 来自被接管的流量:TUN、Linux eBPF、路由器网关下的局域网设备,以及增强模式或网关运行期间发到监听地址的查询;
- 不包括你的
[[proxy]]服务器域名,也不包括hosts里的域名。
单独开启的监听(没有增强模式也不是网关)永远不发 Fake-IP。
| 项目 | 值 |
|---|---|
| IPv4 地址池 | fake-ip-range,默认 198.18.0.1/16 |
| IPv6 地址池 | fd00::1/18,固定,仅在 ipv6 = true 时使用 |
| 应答 TTL | 300 秒 |
| 映射数量上限 | 65535 |
real-ip 下域名规则依然有效:Core 会记住每个真实应答属于哪个域名。需要让 IP 规则(例如 GEOIP,CN,DIRECT) 看到真实地址,或者某个应用处理不了 Fake-IP 时,可以用它。代价是:走代理的域名也由本地 DNS 服务器以明文解析, 代理连接的是这个 DNS 返回的地址。
IP 规则与 Fake-IP。 Fake-IP 连接只带域名,没有可用的地址,所以 IP 规则匹配不到它。mode = "fake-ip" 时, 没有被任何域名规则决定、FINAL 又是代理的域名会拿到 Fake-IP,GEOIP,CN,DIRECT 永远看不到它的真实地址。 请改用 GeoSite 或域名规则,或者用 real-ip。
Fake-IP 网段
fake-ip-range 是一个前缀不长于 /30 的 IPv4 CIDR。第一个分配的地址就是你写的地址(或网段的第一个主机地址), 最后一个是广播地址的前一个。
网段必须在 198.18.0.0/15 之内,这是专门留作测试用途的网段(RFC 2544)。写了其他网段的 Profile 会加载失败,报错 dns.fake-ip-range must lie within 198.18.0.0/15:Linux eBPF 和路由器网关会直接放行发往私有 和本地地址的流量,而且这类网段可能和真实的主机冲突。网段也不能和 [enhanced-mode.tun] address(默认 198.19.0.1/30)重叠,否则加载失败,报错 dns.fake-ip-range ... overlaps enhanced-mode.tun.address。
增强模式下的 DNS
Windows TUN
[enhanced-mode.tun]
dns-hijack = true # 默认
dns-namespaces = ["."] # 默认:所有域名dns-hijack = true时,Core 添加一条 NRPT 规则,把dns-namespaces里的域名交给它的虚拟 DNS 服务器,即 TUN 网卡地址的下一个地址(默认198.19.0.2)。不会修改网卡的 DNS 设置。TUN 停止时规则被删除;Core 被强制结束而遗留的规则, 会在下次启动时清掉。dns-hijack = true时,进入 TUN 网卡的所有 UDP DNS 查询(端口 53)都由 Core 应答,不占用本机的 53 端口。dns-namespaces限定哪些域名交给 Core:"."表示所有域名,".example.com"表示这个域名及其子域名。dns-hijack开启时它不能为空。dns-hijack = false时,Core 不为 Windows 应答 DNS。查询作为普通流量发出,域名规则只能依赖嗅探。[dns].listener只有在你启用时才会启动,地址按address。
macOS TUN
- TUN 运行期间,Core 把当前网络服务的系统 DNS 改成
127.0.0.1,并在127.0.0.1:53上提供 UDP 和 TCP 的 DNS 服务。 TUN 正常停止时恢复原来的服务器。 dns-hijack和dns-namespaces在 macOS 上没有作用。- 不使用
[dns].listener.address,Core 总是监听127.0.0.1:53。
Linux eBPF
- 被接管程序的 DNS 查询(UDP 端口 53)会交给 Core 的 DNS 模块。Core 还会监听
127.0.0.1:5353,不使用[dns].listener.address。系统解析器不会被修改。 - IPv6 始终关闭:AAAA 查询返回空结果,因为 eBPF 只接管 IPv4。
mode = "fake-ip"时,eBPF 发 Fake-IP 的范围比 TUN 更广,这样连接才会被接管,并能带着进程信息分流:
| 域名 | 应答 |
|---|---|
域名规则把它送往 DIRECT | 真实地址(fake-ip-all 时为 Fake-IP) |
| 域名规则把它送往代理 | Fake-IP |
域名规则把它送往 REJECT | Fake-IP;连接到来时被拒绝 |
| 没有域名规则决定它 | Fake-IP,不论 FINAL 是什么 |
任意域名,mode = "real-ip" | 真实地址 |
eBPF 接管哪些流量,见 Linux eBPF。
路由器网关
局域网设备的 DNS 查询按被接管流量处理:按 mode 分配 Fake-IP,来源规则(SRC-IP-CIDR、SRC-MAC、SRC-DEVICE) 按设备决定应答。
不开增强模式时
在本地 HTTP/SOCKS5 端口上:
- 域名规则直接匹配应用发来的域名。
- 走代理的域名原样交给代理,由代理服务器解析。
hosts和nameserver-proxy对它不起作用。 DIRECT的域名由操作系统解析。Core 的 DNS 模块在运行时(例如开了监听),改由 Core 用系统 DNS 服务器和hosts解析: 先查 A,再查 AAAA。ipv6 = false时 AAAA 结果为空,所以只有 IPv6 地址的域名无法DIRECT访问。- 只有开启
resolve-unknown-domains时,IP 规则才能看到域名对应的地址。
这时的监听返回真实地址:走代理的域名经该节点查询 nameserver-proxy,DIRECT 的域名查询系统 DNS 服务器, REJECT 的域名返回 REFUSED。Fake-IP 需要增强模式。
IPv6
ipv6 = false(默认)时,每个 AAAA 查询都返回空结果,应用就会使用 IPv4。ipv6 = true 时会应答 AAAA 查询: 返回真实地址,或者在 IPv4 查询会拿到 Fake-IP 的情况下返回 fd00::1/18 里的 Fake-IP。Linux eBPF 始终按 false 处理。 开启前请确认增强模式也接管了 IPv6([enhanced-mode] ip-version)。
hosts
[dns]
hosts = { "nas.lan" = "192.168.1.10", "dev.example.com" = ["10.0.0.5", "fd00::5"] }- 每个键是一个精确的域名,不支持通配符;忽略大小写和末尾的点。
- 每个值是一个 IP 地址,或一个非空的地址列表。地址无效或域名重复会加载失败。
- Core 还会读取系统 hosts 文件(
/etc/hosts或%SystemRoot%\System32\drivers\etc\hosts)。Profile 里的条目会替换文件里 同名的条目。 - hosts 应答的 TTL 为 60 秒,而且永远不是 Fake-IP。只有 IPv6 条目的域名收到 A 查询时返回空结果,反之亦然。
REJECT优先:被拒绝的域名即使在hosts里也返回REFUSED。hosts作用于 Core 应答的查询,以及 Core 为DIRECT连接做的解析;对本地端口交给代理的域名不起作用。
本地 DNS 监听
[dns]
listener = { enable = true, address = "127.0.0.1:1053" }| 字段 | 默认值 | 说明 |
|---|---|---|
enable | false | |
address | "127.0.0.1:1053" | IPv4 地址(或 localhost)加端口,同时提供 UDP 和 TCP |
监听是给你手动指向它的程序用的,增强模式不需要它。macOS 的 TUN 和 Linux eBPF 下,Core 监听自己的固定地址,不使用 address。 DNS 模块绑定不了端口时,Profile 会启动或重载失败,报 Cannot start DNS。绑定 1024 以下的端口需要管理员权限。
缓存与重载
- 应答缓存:按 TTL 缓存,最多 4096 条。空结果和失败缓存 30 秒。
- 域名记忆:每个真实应答对应的域名至少记住 10 分钟,之后连到这个地址的连接仍能按域名匹配。
- Fake-IP 映射:每个租期 300 秒,同时最多 65535 个。
就地重载 Profile 时:
- 节点、代理组或规则有变化时,清空应答缓存,Fake-IP 映射保留。
[dns]或route.resolve-unknown-domains有变化时,DNS 模块连同增强模式的接管一起重建;Linux eBPF 下整个运行时重建。 除非fake-ip-range变了,Fake-IP 映射都会保留。
排错
| 现象 | 可能原因 |
|---|---|
| 增强模式下域名规则从不命中 | 应用用了自己的 DNS(DNS over HTTPS、浏览器的「安全 DNS」),Core 看不到域名。关掉它,或依赖嗅探,或改用进程、IP 规则 |
| 同上,发生在 Windows 上 | dns-hijack = false,或域名不在 dns-namespaces 里 |
| 域名规则有效,IP 或 GeoIP 规则无效 | 域名拿到了 Fake-IP,见 IP 规则与 Fake-IP |
报错 dns.fake-ip-range must lie within 198.18.0.0/15 | 换成 198.18.0.0/15 之内的网段,比如默认的 198.18.0.1/16,见网段 |
Specola 停止后仍出现 198.18.x.x 地址 | 操作系统或应用缓存了 Fake-IP 应答。清空系统 DNS 缓存或重启应用 |
部分域名返回 SERVFAIL | 经节点查询时所有 nameserver-proxy 都失败了。确认节点能访问这些解析器;节点不支持 UDP 时试试 tcp:// 或 https:// |
| 只有 IPv6 的网站打不开 | ipv6 = false;Linux eBPF 下这是预期行为 |
Cannot start DNS | 监听端口(macOS 上是 127.0.0.1:53)被其他程序占用 |
旧文档里出现的 [dns.upstream]、[dns.tun]、[dns.nameserver-policy]、[dns.fallback-filter]、[dns.system-proxy]、 route-resolution、respect-rules、缓存相关字段、use-hosts,以及 enable、listen、nameserver、fallback、 enhanced-mode 这类平铺字段都不存在,写了都会报 Unknown dns field。
另见分流规则、进程规则、嗅探、TUN 和 Linux eBPF。
