Pi-hole v6迁移后自定义DNS列表加载失败问题解析

问题背景

Pi-hole是一款流行的开源DNS服务器和广告拦截工具。在从v5版本升级到v6版本后，部分用户报告其自定义DNS记录（存储在dns.hosts文件中）无法正常加载，导致内部主机名解析失败，出现NXDOMAIN错误。

问题现象

用户配置的内部主机记录在v6版本中无法正常解析，具体表现为：

• 通过dig或nslookup查询返回NXDOMAIN错误
• FTL服务日志中显示"ERROR: Cannot install custom.list: Permission denied"
• 自定义DNS记录未被正确加载

根本原因分析

经过深入调查，发现问题源于Pi-hole v6版本中的一个脚本处理逻辑缺陷。具体来说：

1. 在Pi-hole v6中，/etc/pihole目录被设计为指向/var/lib/pihole的符号链接
2. 预处理脚本pihole-FTL-prestart.sh中的find命令在处理符号链接时存在路径格式问题
3. 由于缺少尾部斜杠(/)，find命令无法正确识别目录结构
4. 导致自定义DNS列表文件(custom.list)无法被正确安装和加载

技术细节

问题的核心在于Unix/Linux系统中符号链接和路径处理的特殊性：

1. 当/etc/pihole是符号链接时，find命令需要明确的目录标识
2. 缺少尾部斜杠会使find命令将符号链接视为普通文件而非目录
3. 这导致脚本无法遍历目录内容，进而无法处理自定义DNS记录
4. 权限问题实际上是路径解析失败导致的次级错误

解决方案

Pi-hole开发团队迅速响应并修复了此问题：

1. 在find命令路径参数中添加了必要的尾部斜杠
2. 确保无论/etc/pihole是实体目录还是符号链接都能正确处理
3. 修复已包含在后续版本中(v6.0.3之后)

用户应对措施

对于遇到此问题的用户，可以采取以下步骤：

1. 升级到最新版本的Pi-hole
2. 检查/etc/pihole目录属性：ls -ld /etc/pihole
3. 验证自定义DNS文件权限：确保pihole用户有读取权限
4. 重启Pi-hole FTL服务使更改生效

经验总结

此案例提供了几个有价值的经验教训：

1. 符号链接处理在系统工具中需要特别注意
2. 路径格式规范化在脚本开发中至关重要
3. 版本升级时的兼容性测试应包含各种配置场景
4. 完善的错误日志有助于快速定位问题根源

对于Pi-hole用户而言，保持系统更新和关注官方发布说明是避免类似问题的有效方法。