Gravity-Sync项目数据库同步失败问题分析与解决

问题背景

Gravity-Sync是一个用于同步Pi-hole实例间Gravity数据库的工具。在Docker容器环境下部署时，用户遇到了从主节点向从节点推送数据库失败的问题，具体表现为在"Pushing the local Gravity Database"步骤时操作中断，而反向的拉取操作却能成功执行。

问题现象分析

从日志信息可以看出几个关键点：

1. 主节点尝试推送时，在比较阶段检测到数据库差异是正常的，但推送过程意外终止
2. 从节点配置中远程Pi-hole目录显示为/etc/pihole，这与Docker环境下的实际路径不符
3. 主节点的配置文件中缺少关键的远程路径设置

根本原因

问题根源在于配置不完整。虽然安装脚本理论上应该自动填充这些配置，但在以下情况下可能出现问题：

1. SSH密钥认证未正确设置时运行安装脚本，导致配置过程不完整
2. Docker环境下的路径与传统安装不同，需要显式指定容器内的挂载路径
3. 主节点配置文件中缺少远程Pi-hole和DNSMASQ目录的定义

解决方案

对于Docker环境下的Gravity-Sync配置，需要特别注意以下几点：

1. 确保SSH互信建立：在运行安装脚本前，必须确保主从节点间可以通过SSH密钥无密码访问

2. 完整配置远程路径：在gravity-sync.conf配置文件中，必须明确指定远程Pi-hole和DNSMASQ目录，这些应该是容器内部的挂载点路径

3. 验证容器配置：确认Docker容器是否正确挂载了Pi-hole的配置目录，且路径与Gravity-Sync配置一致

4. 文件所有权设置：Docker环境下通常使用特定的用户ID(如999)，需要在配置中正确设置

配置示例

正确的Docker环境配置应该包含类似以下内容：

# 主节点配置
REMOTE_PIHOLE_DIRECTORY='/home/pi/dev/docker/pihole/etc-pihole'
REMOTE_DNSMASQ_DIRECTORY='/home/pi/dev/docker/pihole/etc-dnsmasq.d'
REMOTE_FILE_OWNER='999:999'
REMOTE_DOCKER_CONTAINER='pihole'

经验总结

1. 在Docker环境下使用Gravity-Sync时，路径配置尤为关键，必须与实际挂载路径完全一致
2. 安装过程中任何步骤的失败都可能导致后续配置不完整，需要仔细检查
3. 使用gravity-sync info命令可以快速验证当前配置是否正确
4. 对于新建立的同步关系，建议先进行compare操作验证配置，再执行实际同步

项目状态说明

值得注意的是，Gravity-Sync项目已于2024年7月26日宣布停止维护。虽然当前版本仍可使用，但用户需要考虑长期维护的替代方案。该项目从简单的bash脚本发展为功能完善的工具，多年来服务了大量Pi-hole用户，其设计理念和实现方法仍值得学习借鉴。