Docker-Pi-Hole在TrueNAS中DNS失效问题分析与解决方案

问题背景

在TrueNAS ElectricEel-24.10.2系统上部署最新版Pi-hole容器(v6.0)时，用户报告DNS服务无法正常工作。日志中显示关键警告信息："ignoring query from non-local network 192.168.1.50 (logged only once)"。值得注意的是，当回退到2024.07.0版本时，服务恢复正常。

技术分析

此问题源于Pi-hole v6.0版本中DNS监听模式的默认配置变更。新版本默认采用了"LOCAL"监听模式，这种模式仅接受来自容器内部或本地主机的DNS查询请求。而在TrueNAS的多网络接口环境下，来自其他网络接口的DNS请求会被视为"非本地网络"请求而被拒绝。

解决方案

针对TrueNAS环境，需要修改Pi-hole的监听模式配置：

1. 将环境变量FTLCONF_dns_listeningMode设置为'all'，这将允许Pi-hole接受来自所有网络接口的DNS查询
2. 在TrueNAS的Pi-hole应用配置中添加或修改相应环境变量

版本兼容性说明

该问题主要影响：

• Pi-hole v6.0及以上版本
• TrueNAS ElectricEel系统
• 多网络接口环境部署

较早版本(如2024.07.0)由于使用不同的监听模式默认配置，不会出现此问题。

实施建议

对于TrueNAS用户，建议：

1. 更新Pi-hole应用配置前先备份现有设置
2. 确保网络拓扑结构与监听模式配置相匹配
3. 修改配置后重启Pi-hole服务使变更生效

此问题的修复已在TrueNAS应用仓库的相应更新中实现，用户可通过更新应用获取修复。