OpenWrt中dnsmasq的addnhosts配置问题解析

问题背景

在OpenWrt系统中，dnsmasq是一个常用的DNS和DHCP服务组件。用户经常通过addnhosts配置项来添加额外的hosts文件，用于实现域名解析的重定向或屏蔽。然而，近期有用户反馈在OpenWrt 23.05.4版本中，通过addnhosts指定的hosts文件未能生效，导致域名解析未按预期工作。

问题现象

用户尝试通过以下步骤配置dnsmasq：

1. 创建包含"0.0.0.0 github.com"条目的hosts文件
2. 在LuCI界面或通过uci命令设置addnhosts指向该文件
3. 重启dnsmasq服务

然而，测试发现github.com仍然解析到真实IP而非预期的0.0.0.0。通过检查发现，虽然uci配置中显示了addnhosts设置，但实际的dnsmasq配置文件(/var/etc/dnsmasq.conf*)中并未包含相应的addn-hosts指令。

问题根源

深入分析后发现，问题的根源在于uci配置的语法类型错误。在OpenWrt中，addnhosts应该被定义为list类型而非option类型。这是因为：

1. dnsmasq本身支持同时指定多个hosts文件或目录
2. OpenWrt的uci系统对于多值配置项需要使用list类型
3. 当使用option类型时，配置无法正确转换为dnsmasq的启动参数

解决方案

方法一：通过LuCI界面修改

1. 进入LuCI的"网络"→"DHCP/DNS"页面
2. 在"高级设置"中找到"Additional hosts files"选项
3. 确保添加的是hosts文件所在的目录而非单个文件
4. 保存并应用更改

方法二：通过命令行修改

对于需要脚本化配置的情况，正确的做法是使用uci add_list命令而非简单的uci set：

uci add_list dhcp.@dnsmasq[0].addnhosts='/path/to/your/hosts/file'
uci commit dhcp
service dnsmasq restart

方法三：直接编辑配置文件

也可以直接编辑/etc/config/dhcp文件，确保addnhosts以list形式出现：

config dnsmasq
    list addnhosts '/path/to/hosts/file'

技术原理

dnsmasq的--addn-hosts参数设计上支持两种形式：

1. 直接指定hosts文件路径
2. 指定目录路径，此时会按字母顺序加载目录下所有文件

OpenWrt的uci系统在处理这类多值配置时，需要明确区分option(单值)和list(多值)。当配置项被错误地定义为option类型时，虽然uci命令可以设置值，但在生成实际服务配置时会被忽略。

最佳实践

1. 对于hosts文件管理，建议创建一个专用目录(如/etc/hosts.d/)
2. 将需要加载的hosts文件放入该目录
3. 配置addnhosts指向该目录而非单个文件
4. 使用list类型确保配置正确传递

总结

OpenWrt系统中dnsmasq的addnhosts配置问题主要源于uci配置类型的使用不当。理解uci系统中option和list的区别对于正确配置网络服务至关重要。通过本文介绍的方法，用户可以确保hosts文件按预期加载，实现精确的域名解析控制。