Pi-hole v6 中CNAME记录导入问题的分析与解决

问题背景

在Pi-hole v6开发版本中，用户发现从v5版本通过Teleport功能导入配置时，原有的CNAME记录无法正确导入。这一问题主要出现在从v5升级到v6的过程中，特别是在使用Docker容器部署的环境中。

技术分析

Pi-hole v6对DNS记录存储机制进行了重大重构，特别是CNAME记录的存储方式与v5版本有显著差异。在v5中，CNAME记录存储在单独的文件中，而v6则采用了全新的配置管理方式，使用pihole.toml文件统一管理所有配置。

问题的核心在于v6的Teleporter导入功能未能正确处理v5备份文件中的CNAME记录部分。当用户尝试导入v5的Teleport备份文件时，虽然其他配置能够正常导入，但CNAME记录部分却被完全忽略，导致pihole.toml文件中的cnameRecords数组为空。

解决方案的演进

开发团队针对此问题进行了多轮修复尝试：

1. 最初尝试通过FTL分支(fix/teleporter_v5_cnames)修复导入逻辑，但由于Docker环境的特殊性，普通用户难以直接应用这一修复。

2. 对于Docker用户，团队提供了自定义构建方案，指导用户通过修改构建参数来包含修复分支。这一过程需要用户：

   • 克隆docker-pi-hole仓库
   • 使用buildx工具构建自定义镜像
   • 指定FTL_BRANCH参数为修复分支

3. 在后续版本中，团队进一步简化了构建流程，提供了专门的build.sh脚本，使构建过程更加友好。

验证与确认

经过多轮测试和修复，在最新开发版本(Core: vDev 9cd32bf2, Web: vDev 2ec7895b, FTL: vDev e3304ac0)中，这一问题已得到解决。用户现在可以正常从v5 Teleport备份文件中导入CNAME记录。

经验总结

这一问题的解决过程展示了开源项目协作的优势：

• 用户及时反馈使用中的问题
• 开发团队快速响应并提供解决方案
• 通过多轮迭代不断完善修复方案

对于Pi-hole用户而言，这一案例也提醒我们：

1. 在主要版本升级时，应充分测试所有功能的兼容性
2. 对于Docker等容器化部署，可能需要特殊处理某些功能
3. 关注开发团队提供的最新修复方案和构建指导

随着Pi-hole v6的持续开发，类似的数据迁移问题将得到更系统的解决，为用户提供更平滑的升级体验。