sing-box项目中关于第三方DoH DNS提供商的使用问题分析

问题背景

在使用sing-box 1.12.0 alpha4版本时，用户尝试配置nextdns.io提供的DoH(DNS over HTTPS)服务时遇到了技术障碍。nextdns.io作为第三方DNS提供商，其服务需要特定的标识符作为URL路径的一部分，这与标准的DoH实现方式有所不同。

技术细节

标准DoH实现

通常情况下，配置DoH服务只需要指定服务器地址即可。例如Google的DoH服务可以这样配置：

{
  "tag": "google",
  "type": "https",
  "server": "8.8.8.8",
  "detour": "proxy"
}

这种配置下，sing-box会自动在服务器地址后添加/dns-query路径，形成完整的DoH请求URL。

nextdns.io的特殊要求

nextdns.io的服务需要用户特定的标识符作为URL路径的一部分，例如https://dns.nextdns.io/b733r1。用户最初尝试直接在server字段中包含路径：

{
  "tag": "nextdns-doh",
  "type": "https",
  "server": "dns.nextdns.io/b733r1",
  "domain_resolver": "nextdns-tcp",
  "detour": "proxy"
}

这导致了URL编码问题，sing-box将/编码为%2F，并仍然尝试添加/dns-query后缀，最终形成无效的URL。

解决方案

正确的配置方式应该是使用单独的path字段来指定自定义路径：

{
  "tag": "nextdns-doh",
  "type": "https",
  "server": "dns.nextdns.io",
  "path": "/b733r1",
  "domain_resolver": "nextdns-tcp",
  "detour": "proxy"
}

这样sing-box会正确构建URL而不会产生编码问题。

技术启示

1. 配置规范性：在配置网络服务时，应严格遵循软件的配置规范，理解每个字段的用途。

2. URL构建逻辑：了解软件如何构建完整URL很重要。许多工具会自动添加标准路径，因此需要提供机制来覆盖或补充这些默认行为。

3. 错误诊断：从错误日志中可以清晰看到URL构建过程的问题，这是诊断配置问题的关键。

4. 第三方服务适配：不同DNS提供商可能有不同的实现方式，需要灵活调整配置以适应这些差异。

总结

这个案例展示了在使用网络工具时理解其配置逻辑的重要性。对于需要特殊URL路径的DoH服务，正确的方式是使用专门的path字段而非将其包含在server字段中。这种配置方式既保持了规范性，又能满足特定服务的需求。