Pi-hole Docker容器DNS查询问题解决方案：非本地网络请求被忽略

问题现象

在升级Pi-hole Docker容器至最新版本后，本地网络中的DNS查询请求被错误地识别为非本地网络请求并被忽略。具体表现为：

• 从局域网内其他设备执行nslookup命令时出现超时
• 日志中显示"ignoring query from non-local network"警告
• 调试信息显示DNSMASQ_WARN类型的错误

问题根源

该问题主要源于Pi-hole v6版本对Docker镜像进行了彻底重构，包括：

1. 基础镜像从Debian改为Alpine
2. 配置迁移机制变更
3. 环境变量命名规范更新

特别值得注意的是，旧版本中使用的DNSMASQ_LISTENING环境变量在新版本中已不再适用。

解决方案

通过以下两种方式之一修改监听模式配置：

方法一：通过Web界面设置

1. 登录Pi-hole管理界面
2. 导航至设置页面
3. 找到DNS监听模式选项
4. 将模式从"All"改为"Single"

方法二：通过Docker环境变量配置

在docker-compose.yml文件中添加以下环境变量配置：

environment:
  FTLCONF_dns_listeningMode: 'SINGLE'

技术背景

Pi-hole v6版本引入了重大架构变更，其中DNS监听模式的配置方式发生了改变：

• 旧版本使用DNSMASQ_LISTENING环境变量
• 新版本统一使用FTLCONF_前缀的环境变量
• SINGLE模式仅监听容器网络接口，避免跨网络请求

最佳实践建议

1. 升级前务必阅读新版本文档
2. 备份原有配置
3. 逐步测试新版本功能
4. 关注官方更新日志中的重大变更说明

总结

Pi-hole v6版本的架构改进带来了更高效的运行机制，但也需要用户注意配置方式的变更。通过正确设置DNS监听模式，可以确保本地网络DNS查询服务的正常运行。对于从旧版本升级的用户，建议全面检查所有自定义配置项，确保其与新版本兼容。