Pi-hole Docker版中Local DNS菜单选项消失问题解析

问题现象

近期有用户反馈在Pi-hole Docker容器(v6.0.6)中，Web管理界面左侧导航栏的"Local DNS"选项突然消失。该功能原本位于主菜单中，用于管理本地DNS记录（即hosts文件条目），是网络管理员常用的重要功能之一。

环境配置

• 运行平台：Ubuntu 24.04系统上的Docker容器
• Pi-hole版本：核心组件v6.0.6，Web界面v6.1，FTL引擎v6.1
• 使用Watchtower进行自动更新

功能变更说明

经过分析发现，这并非真正的功能缺失，而是Pi-hole在v6.x版本中对界面布局进行了优化调整：

1. 菜单结构调整：原先独立的"Local DNS"选项已被整合到"Settings"菜单的子项中
2. 新的访问路径：现在需要通过"Settings" → "DNS" → "Local DNS Records"来访问
3. 设计优化目的：这样的调整使相关DNS功能更加集中，提升了界面组织逻辑性

解决方案

对于习惯旧版界面的用户，可以按照以下步骤操作：

1. 登录Pi-hole管理界面
2. 点击左侧导航栏的"Settings"（设置）
3. 选择"DNS"选项卡
4. 在DNS设置页面中找到"Local DNS Records"区域
5. 在此处可继续添加、编辑或删除本地DNS记录

技术背景

Pi-hole的本地DNS功能本质上是通过管理/etc/hosts文件实现的，它允许用户：

• 为内网设备设置易记的主机名
• 实现特定域名的本地解析
• 绕过DNS查询直接指定IP地址

在Docker环境中，这些配置会持久化存储在volume中，即使容器重启也不会丢失。

最佳实践建议

1. 版本升级注意：使用Watchtower等自动更新工具时，应注意检查功能位置变更
2. 配置备份：定期导出Local DNS记录，防止意外丢失
3. 文档查阅：升级前建议查看版本变更日志，了解界面调整情况
4. 权限检查：如确实找不到选项，可检查用户权限是否足够

总结

Pi-hole项目在不断优化用户体验的过程中，可能会调整功能的位置布局。遇到类似"功能消失"的情况时，建议先查看相关设置菜单的子项。这种设计变更通常是为了更好的功能组织，而非真正的功能移除。掌握新版界面布局后，管理员仍可高效管理本地DNS记录。