Pi-hole Docker容器中WebUI显示错误FTL版本问题解析

问题背景

在Pi-hole项目的Docker容器部署环境中，用户发现Web管理界面底部显示的FTL组件版本信息存在异常。虽然实际运行的Pi-hole核心组件均为v6.0版本，但界面却错误地显示为"vDev"版本标识，且相关链接指向了不存在的发布页面。

技术分析

该问题属于前端显示层面的版本标识同步异常，具体表现为：

1. 版本显示不一致：虽然AdminLTE（Web管理界面）和FTL（Pi-hole的核心守护进程）实际版本均为v6.0，但WebUI底部却错误显示为开发版标识"vDev"

2. 功能完整性：值得注意的是，该问题仅影响版本信息的可视化呈现，不影响系统实际功能。通过检查可以发现，底层FTL组件的commit哈希值仍正确指向代码库中的对应位置

问题根源

经过开发团队分析，该问题的产生原因是：

• 版本标签同步机制在构建过程中未能正确提取FTL组件的发布标签
• Web界面版本显示逻辑未正确处理Docker环境下的版本元数据

解决方案

开发团队已通过提交修复该问题：

1. 修正了版本标签的提取逻辑
2. 确保WebUI能够正确显示Docker容器中实际运行的FTL版本号

用户建议

对于遇到此问题的用户：

• 若仅存在版本显示问题，不影响使用则无需特别处理
• 如需更新，建议等待包含修复的新版本发布后升级容器镜像
• 可通过命令行验证实际版本：pihole -v将显示准确的组件版本信息

技术启示

该案例展示了容器化环境中版本管理的复杂性，特别是在多组件协作的场景下。开发团队需要确保：

• 构建系统能正确捕获所有依赖组件的版本信息
• 前端界面具备处理版本元数据异常情况的容错能力
• 版本验证机制需要覆盖全链路检查