Docker-Pi-hole容器中本地DNS域名解析异常问题分析

问题现象

在Docker环境下运行的Pi-hole 6.0版本中，管理员发现通过本地DNS域名pihole.lan无法访问Web管理界面，而直接使用IP地址(10.0.0.6)可以正常访问。值得注意的是，其他使用.lan后缀的本地域名均能正常解析。

环境配置

• 运行平台：Ubuntu系统上的Docker容器
• 网络模式：macvlan网络
• 上游DNS：Unifi UDM Pro
• 容器IP：10.0.0.6

排查过程

1. 基础检查：

   • 确认Pi-hole版本为v6.0
   • 检查了容器内的/etc/hosts文件，包含正确的IP映射
   • 验证了其他.lan域名解析正常

2. 配置验证：

   • 设置了FTLCONF_dns_revServers环境变量
   • 配置了webserver.domain为pihole.lan
   • 检查了DNS转发设置

3. 关键发现： 通过调试日志发现Pi-hole配置中存在特殊设置：

   [dns.reply.host]
   force4 = true
   IPv4 = ""
   

   这个配置强制Pi-hole对自身主机名的查询返回固定IPv4地址，但未指定具体IP地址。

问题根源

在Pi-hole 6.0版本中，当从v5.x升级时，如果原配置中包含LOCAL_IPV4设置，迁移过程会自动将force4参数设为true。然而，如果未正确设置对应的IPv4地址值，就会导致Pi-hole对自身域名的查询返回空响应(0.0.0.0)。

解决方案

有两种解决方法可选：

1. 指定固定IP： 在配置中明确指定Pi-hole的IPv4地址：

   [dns.reply.host]
   force4 = true
   IPv4 = "10.0.0.6"
   

2. 禁用强制响应： 将force4参数改回默认值：

   [dns.reply.host]
   force4 = false
   

最佳实践建议

1. 升级Pi-hole时，建议检查所有自动迁移的配置项
2. 对于Docker部署，确保网络配置与DNS设置一致
3. 定期验证关键功能，如本地域名解析
4. 对于生产环境，建议在升级前进行充分测试

总结

这个案例展示了Pi-hole升级过程中可能遇到的配置迁移问题。理解Pi-hole的DNS响应机制对于排查类似问题至关重要。通过分析调试日志和了解配置项的相互作用，可以快速定位和解决DNS解析异常问题。