Pi-hole Docker容器在NFS存储上无法保存配置的解决方案

问题背景

在Pi-hole v6.0版本中，当用户将Docker容器的配置文件存储在NFS共享存储上时，出现了无法保存配置更改的问题。具体表现为在Web界面修改DNS设置后点击保存，页面刷新但配置未实际保存，同时系统日志中显示文件锁定错误。

技术分析

这个问题源于Pi-hole v6.0引入的新文件锁定机制与NFS文件系统的兼容性问题。核心组件FTL（Pi-hole的核心守护进程）在v6.0版本中加强了对配置文件（pihole.toml）的访问控制，要求获取文件的独占锁。然而，当配置文件存储在NFS共享上时，文件锁定操作无法正常工作，导致以下错误：

ERROR: Cannot get exclusive lock for /etc/pihole/pihole.toml: Bad file descriptor

解决方案

Pi-hole开发团队已经针对此问题发布了修复方案，具体包含以下步骤：

1. 构建特殊版本的FTL：使用包含修复代码的tweak/file_locking分支构建Docker镜像

2. 构建自定义镜像：

   • 克隆Pi-hole的Docker仓库
   • 运行构建脚本指定特殊分支：build.sh -f tweak/file_locking
   • 使用生成的本地镜像创建容器

实施效果

测试表明，使用修复后的版本：

• 配置更改能够正常保存
• 系统会重启FTL服务以应用更改
• 虽然仍会显示文件锁定错误，但功能已恢复正常

技术建议

对于生产环境中的用户，建议：

1. 临时解决方案：将配置文件存储在本地存储而非NFS上
2. 等待官方发布包含此修复的正式版本
3. 关注Pi-hole的更新日志，及时升级到修复版本

总结

这个案例展示了文件系统特性对应用程序行为的重要影响。NFS作为一种网络文件系统，在文件锁定机制上与本地文件系统存在差异，开发者在设计跨文件系统的应用程序时需要特别注意这类兼容性问题。Pi-hole团队通过分支开发和快速响应，为用户提供了有效的解决方案。