Skip to content
English下载

DNS ​

Specola 需要 DNS 只为一件事:知道一条连接对应哪个域名,好让域名规则能匹配。在本地 HTTP/SOCKS5 端口上,应用会直接把域名发过来。 增强模式下,应用先解析域名再连地址,所以 Core 要替它应答 DNS 查询,并记住每个应答属于哪个域名。

一开始不写 [dns] 就好,默认值适合大多数情况。

toml
[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。

字段默认值说明
ipv6false是否应答 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 按下面的顺序处理每个查询:

  1. ipv6 = false 时的 AAAA 查询:返回空结果。
  2. 给域名做路由决策。 路由模式先生效(direct → DIRECT,global → 全局节点)。rule 模式下只用域名去匹配规则 (见哪些规则决定 DNS 应答),都不命中就用 FINAL(被接管的流量用 final-enhanced)。 这里不检查 bypass,它作用在连接上。你的 [[proxy]] 服务器域名跳过路由,始终用系统 DNS 服务器解析。
  3. REJECT:返回 REFUSED。(Linux eBPF 改为返回 Fake-IP,等连接到来时再做决定。)
  4. hosts:在 [dns].hosts 或系统 hosts 文件里有记录就直接用。
  5. Fake-IP:被接管流量的查询按 mode 决定,见 Fake-IP。
  6. 转发给上游,见解析器。

哪些规则决定 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.8UDP53
tcp://8.8.8.8TCP53
https://dns.example.com/dns-queryDNS over HTTPS443
  • 加 :端口 可以改端口;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-allFake-IPFake-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 时使用
应答 TTL300 秒
映射数量上限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 ​

toml
[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
域名规则把它送往 REJECTFake-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 ​

toml
[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 监听 ​

toml
[dns]
listener = { enable = true, address = "127.0.0.1:1053" }
字段默认值说明
enablefalse
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。