Pi-hole Docker容器中DHCP选项配置失效问题解析

问题背景

在使用Pi-hole作为Docker容器部署时，特别是当Pi-hole作为DHCP服务器运行且位于Traefik反向代理之后时，可能会遇到一个常见问题：DHCP服务分配的DNS服务器地址不正确。这种情况下，客户端设备会收到Pi-hole容器内部的IP地址作为DNS服务器，而非预期的宿主机IP地址。

问题现象

在Pi-hole容器更新后，原本有效的自定义DNSmasq配置（位于/etc/dnsmasq.d/07-dhcp-options文件中的dhcp-option=option:dns-server,192.168.1.50）突然失效。这导致网络客户端无法通过正确的DNS服务器地址进行解析。

技术原理分析

Pi-hole在Docker容器中运行时，其网络环境与宿主机隔离。当Pi-hole作为DHCP服务器时，默认会将自己的容器IP地址作为DNS服务器地址分配给客户端。但在实际生产环境中，我们通常希望客户端使用宿主机的IP地址（或特定IP）作为DNS服务器地址。

传统解决方案是在容器内创建/etc/dnsmasq.d/07-dhcp-options文件，指定正确的DNS服务器地址。然而，在Pi-hole Docker镜像的更新版本中，这一机制发生了变化。

解决方案

最新版本的Pi-hole Docker镜像引入了一个新的环境变量来控制DNSmasq配置文件的加载行为：

environment:
  FTLCONF_misc_etc_dnsmasq_d: "true"

这个环境变量必须设置为"true"，Pi-hole才会加载/etc/dnsmasq.d/目录下的自定义配置文件。同时，用户还需要注意将所有环境变量更新为新版本的格式要求。

最佳实践建议

1. 避免自动更新关键网络服务：对于Pi-hole这类网络基础设施组件，不建议使用Watchtower等工具进行自动更新，而应该采用可控的更新策略。

2. 环境变量标准化：确保所有Pi-hole相关的环境变量都使用新版本的格式，避免因格式问题导致配置失效。

3. 容器网络设计：在复杂网络环境中，应考虑使用host网络模式或精心设计容器网络，确保DHCP和DNS服务能够正常工作。

4. 配置验证：更新后应验证DHCP分配的DNS服务器地址是否符合预期，可以通过客户端设备获取的IP配置来确认。

总结

Pi-hole Docker容器中DHCP选项配置失效问题通常是由于新版本对配置加载机制的改变所致。通过正确设置FTLCONF_misc_etc_dnsmasq_d环境变量，并遵循新版配置规范，可以确保自定义DNSmasq配置被正确加载。对于生产环境，建议建立完善的配置管理和更新流程，避免因自动更新导致的服务中断。