Sing-box 1.11版本DNS路由配置迁移指南

Sing-box作为一款功能强大的网络工具，在1.11版本中对DNS路由配置进行了重大更新。本文将详细介绍如何从旧版配置迁移到新版，帮助用户顺利完成升级。

配置变更概述

Sing-box 1.11版本弃用了原有的DNS路由选项，转而采用更简洁高效的规则动作(action)机制。这一变更主要影响以下几个方面：

1. 移除了专门的DNS出站类型
2. 取消了block类型的出站
3. 将DNS劫持功能整合到路由规则中
4. 简化了嗅探配置

具体迁移步骤

1. 删除过时的出站配置

旧版中常见的DNS相关出站配置需要完全移除：

{
  "type": "dns",
  "tag": "dns-out"
},
{
  "type": "block",
  "tag": "block"
}

2. 更新路由规则

将原有的DNS路由规则转换为新的动作机制：

DNS劫持配置迁移： 旧版：

"route": {
  "rules": [
    {
      "outbound": "dns-out"
    }
  ]
}

新版：

"route": {
  "rules": [
    {
      "action": "sniff"
    },
    {
      "protocol": "dns",
      "action": "hijack-dns"
    }
  ]
}

拦截规则迁移： 旧版使用block出站的规则，现在可以直接使用reject动作：

{
  "action": "reject"
}

3. 更新嗅探配置

嗅探相关的监听字段也已过时，需要迁移到action中：

旧版：

"sniff": true

新版：

"action": "sniff"

注意事项

1. 迁移过程中建议先备份原有配置
2. 可以设置环境变量ENABLE_DEPRECATED_LEGACY_DNS_ROUTE_OPTIONS=true临时启用旧功能
3. 1.12版本将完全移除旧版DNS路由功能
4. 迁移后务必测试DNS解析功能是否正常

最佳实践建议

1. 对于简单场景，可以直接使用内置的hijack-dns动作
2. 复杂的DNS分流可以通过多个规则组合实现
3. 考虑使用geoip和geosite规则集优化DNS解析
4. 合理设置TTL值以提高DNS缓存效率

通过以上步骤，用户可以顺利完成从Sing-box旧版到1.11版本的DNS配置迁移，享受更简洁高效的DNS路由功能。