sing-box default_domain_resolver 缺失报错怎么办
把 sing-box 升级到 1.12.0 以后,不少人发现旧配置开始报和 DNS 解析器有关的提示,或者日志里提醒 outbound DNS 规则已弃用。核心原因是 1.12.0 重构了 DNS 服务器,解析出站服务器域名的方式换成了 domain_resolver。这一页讲怎么判断、怎么改。
先弄清 default_domain_resolver 管什么
结论:它决定出站在连接前,用哪个 DNS 服务器解析服务器地址里的域名。
路由页对 route.default_domain_resolver 的说明是「Since sing-box 1.12.0」,具体字段见 Dial Fields,且「Can be overridden by outbound.domain_resolver.」也就是说,它是全局默认值,每个出站还能用自己的 domain_resolver 覆盖。
生效范围在 Dial Fields 页有一张表:direct 出站作用于请求里的域名;其他出站作用于服务器地址里的域名。如果把它直接写成字符串,相当于只设置了 server 这一项;写成对象时,格式和路由 DNS 规则动作相同,只是去掉 action 字段。
判断你是不是这个问题
结论:版本在 1.12.0 以上、DNS 服务器不止一个、出站服务器地址是域名,三条都满足就该补上。
文档写明:「domain_resolver or route.default_domain_resolver is optional when only one DNS server is configured.」这条放宽来自 1.12.0-alpha.16 的更新记录。只配一个 DNS 服务器的人,不写也能跑。
DNS 服务器有两个以上时情况不同。Dial Fields 页写的是:outbound DNS 规则已弃用,将在 sing-box 1.14.0 移除,所以从 1.14.0 起,服务器地址使用域名的出站和端点必须写 domain_resolver。在 1.12.0 与 1.14.0 之间缺写时程序具体怎样表现、提示的原文是什么,文档没有给出,我也不替它编一段报错文字。
旧写法长什么样
结论:配置里还有 dns.rules 里的 outbound 规则,就是要迁移的对象。
1.12.0 之前,常见做法是在 dns.rules 里写一条按出站匹配的规则,让解析服务器域名时走本地 DNS。弃用页 1.12.0 段原文是「Legacy outbound DNS rules are deprecated and can be replaced by dial fields」,同一段还写着 DNS 服务器已重构,旧格式在 sing-box 1.14.0 移除。
{
"dns": {
"servers": [{ "type": "local", "tag": "local" }],
"rules": [{ "outbound": "any", "server": "local" }]
}
}改成 domain_resolver 的三种写法
结论:删掉旧的 outbound DNS 规则,改在 route 或出站里指定解析器。
迁移页给了三种新写法。全局写在 route 里:
{
"route": {
"default_domain_resolver": { "server": "local", "rewrite_ttl": 60, "client_subnet": "1.1.1.1" }
}
}只想给某个出站单独指定时,在该出站里写对象形式,或直接写成字符串 "domain_resolver": "local"。三种写法的 server 都要对应 dns.servers 里一个已有的 tag,迁移页示例用的是 type 为 local、tag 为 local 的服务器。
顺手处理 domain_strategy 和 address_resolver
结论:这两个旧字段也要一起迁,否则行为和你以为的不一样。
迁移页专门提醒:1.12.0 的新 DNS 服务器也使用 Dial Fields,有人误以为出站里的 domain_strategy 和旧 DNS 服务器里的同名选项作用相同。迁移写法是把 "domain_strategy": "prefer_ipv4" 改成 "domain_resolver": {"server": "local", "strategy": "prefer_ipv4"}。strategy 可选 prefer_ipv4、prefer_ipv6、ipv4_only、ipv6_only。
DNS 服务器自身如果用域名地址,例如 type 为 https、server 为 dns.google,旧配置里的 address_resolver 要改成服务器内的 domain_resolver,指向另一个能直接解析的服务器 tag。另外 dns.final 是默认 DNS 服务器的 tag,留空时用列表里第一个服务器。
还不行时看哪里
把 log.level 调到 debug 重新启动,看启动阶段输出的警告和报错,再对照 sing-box 文档站的 Migration 与 Deprecated 两页逐项检查。图形客户端里用的是订阅生成的配置时,问题可能在订阅这一侧,可以先按 机场订阅问题排查 确认订阅能正常拉取;想了解订阅与单节点配置的区别,可以看 订阅和单节点有什么不同。
常见问题
default_domain_resolver 是从哪个版本开始有的?
route.default_domain_resolver 自 sing-box 1.12.0 起提供,作用是给出站解析服务器地址里的域名指定默认 DNS 服务器。
什么时候可以不写 domain_resolver?
只配置了一个 DNS 服务器时,domain_resolver 和 route.default_domain_resolver 都是可选的,这条行为在 1.12.0-alpha.16 的更新记录里写明。
从哪个版本开始必须写?
文档写明 outbound DNS 规则将在 sing-box 1.14.0 移除,所以从 1.14.0 起,服务器地址使用域名的出站和端点需要 domain_resolver。
default_domain_resolver 和出站里的 domain_resolver 谁优先?
出站里的 outbound.domain_resolver 可以覆盖 route.default_domain_resolver,没单独写的出站用全局默认值。
旧配置里的 domain_strategy 怎么改?
迁移页给的写法是把 "domain_strategy": "prefer_ipv4" 改成 "domain_resolver": {"server": "local", "strategy": "prefer_ipv4"}。
报错的原文是什么?
sing-box 文档没有给出缺失时的报错原文。判断时看版本是否在 1.12.0 以上、配置里是否有多个 DNS 服务器、出站服务器地址是否为域名。