Sing-box DNS hosts_server模块predefined配置失效问题分析

问题背景

在Sing-box项目1.12.0-alpha13版本中，用户发现dns.hosts_server模块的predefined配置项未能按预期工作。该功能本应允许用户预定义特定域名到IP地址的映射，但在实际使用中却无法生效。

技术细节分析

hosts_server模块设计原理

Sing-box的hosts_server模块设计用于提供本地hosts文件功能，允许用户通过配置直接定义域名解析结果，而无需依赖外部DNS服务器。该模块支持两种配置方式：

1. 文件路径配置：通过指定hosts文件路径加载解析规则
2. 预定义配置：直接在配置文件中通过predefined字段定义域名映射

问题根源

通过分析源码发现，在1.12.0-alpha13版本中，hosts_server模块虽然接收了predefined配置参数，但在实际处理过程中并未正确加载和使用这些预定义规则。具体表现为：

1. 模块初始化时未将predefined内容写入内部存储结构
2. 查询处理流程中未检查predefined映射表
3. 最终导致所有预定义规则被忽略，返回NXDOMAIN(域名不存在)响应

影响范围

该问题影响所有使用以下配置方式的用户：

• 在dns配置中使用hosts_server类型
• 依赖predefined字段定义域名映射
• 版本为1.12.0-alpha13及之前版本

解决方案

项目维护者在后续提交中修复了此问题(修复提交6358fd6a08ad63ddbc011844e44213f9530e0003)。修复内容包括：

1. 完善predefined配置的解析逻辑
2. 确保预定义规则被正确加载到内存映射表
3. 在DNS查询处理流程中加入predefined映射检查

最佳实践建议

对于需要使用hosts_server功能的用户，建议：

1. 更新到修复后的版本
2. 对于暂时无法升级的用户，可考虑使用文件方式配置hosts规则
3. 测试时确保配置格式正确，域名需包含末尾点(如"pan.baidu.com.")
4. 结合日志验证规则是否生效

总结

DNS本地解析功能是网络工具中的重要组成部分，hosts_server模块的稳定性直接影响用户体验。此次predefined配置失效问题的发现和修复，体现了开源社区协作解决技术问题的典型流程，也为用户提供了更可靠的本地DNS解析能力。