sing-box DNS劫持功能配置问题排查指南

问题背景

在使用sing-box进行网络代理配置时，用户遇到了DNS劫持功能未生效的问题。该用户尝试通过配置hijack-dns规则来拦截并修改特定域名的DNS解析结果，但发现配置未能按预期工作。

配置分析

用户最初尝试了两种不同的DNS劫持配置方案：

方案一：预定义DNS应答

{
  "dns": {
    "servers": [{"tag": "public-dns", "type": "local"}],
    "rules": [
      {
        "domain_suffix": ["netflix.com", "nflxext.com"],
        "action": "predefined",
        "answer": [
          "*.netflix.com. IN A x.x.x.x",
          "*.nflxext.com. IN A x.x.x.x"
        ]
      }
    ],
    "final": "public-dns"
  },
  "route": {
    "rules": [
      {"action": "sniff"},
      {"protocol": "dns", "action": "hijack-dns"}
    ],
    "auto_detect_interface": true,
    "final": "direct-out"
  }
}

方案二：自定义DNS服务器

{
  "dns": {
    "servers": [
      {
        "tag": "local-dns",
        "address": "udp://127.0.0.1:5353",
        "detour": "direct-out"
      }
    ],
    "final": "local-dns"
  },
  "route": {
    "rules": [
      {"action": "sniff"},
      {"protocol": "dns", "action": "hijack-dns"}
    ],
    "auto_detect_interface": true,
    "final": "direct-out"
  }
}

问题排查过程

1. 日志分析：从日志中可以看到DNS查询确实经过了sing-box处理，但返回的是真实的DNS解析结果而非预期的劫持结果。

2. 配置验证：

   • 确认DNS劫持规则语法正确
   • 检查路由规则中的hijack-dns动作配置无误
   • 验证DNS服务器配置合理

3. 系统层面检查：最终发现问题根源在于系统的TUN模式流量接管存在问题，导致DNS请求未被正确拦截。

解决方案

对于类似问题，建议采取以下排查步骤：

1. 验证TUN设备工作状态：

   • 确认TUN设备已正确创建
   • 检查系统路由表是否已将流量正确导向TUN设备

2. DNS劫持配置要点：

   • 确保hijack-dns规则位于路由规则的适当位置
   • 验证DNS服务器配置是否与路由规则匹配
   • 检查是否有其他网络配置覆盖了sing-box的设置

3. 系统级调试：

   • 使用tcpdump等工具捕获网络流量，确认DNS请求路径
   • 检查系统DNS解析设置是否被其他应用修改

经验总结

DNS劫持功能失效通常涉及多个层面的问题，需要系统性地排查：

1. 配置层面：仔细检查sing-box配置文件的语法和逻辑关系
2. 网络层面：确认网络流量流向是否符合预期
3. 系统层面：检查操作系统网络栈配置是否支持所需功能

特别值得注意的是，在macOS系统上使用TUN模式时，可能需要额外的权限或配置才能确保所有网络流量被正确接管。建议用户在遇到类似问题时，先从最简单的配置开始测试，逐步增加复杂度，以便快速定位问题根源。