Neo4j如何备份恢复

Neo4j 的备份与恢复方式取决于版本（社区版 / 企业版）以及部署方式（单机 / 集群）。下面我按常见场景给你一个清晰、可操作的说明。

一、先确认版本（非常重要）

neo4j --version

二、社区版（Community）备份与恢复

⚠️ 社区版只能离线备份

1️⃣ 停止 Neo4j

neo4j stop

2️⃣ 备份数据目录

默认数据目录：

<NEO4J_HOME>/data/

备份示例：

cp -r /var/lib/neo4j/data /backup/neo4j-data-$(date +%F)

✅ 核心目录：

• data/databases
• data/transactions

3️⃣ 恢复（社区版）

1. 停止 Neo4j
2. 删除现有 data 目录（或改名）
3. 拷贝备份回来

neo4j stop
rm -rf /var/lib/neo4j/data
cp -r /backup/neo4j-data-2026-01-21 /var/lib/neo4j/data
neo4j start

三、企业版（Enterprise）备份与恢复（推荐）

✅ 在线备份（不中断服务）

1️⃣ 全量备份

neo4j-admin backup \
  --backup-dir=/backup/neo4j \
  --database=neo4j \
  --verbose

2️⃣ 增量备份（多次执行）

neo4j-admin backup \
  --backup-dir=/backup/neo4j \
  --database=neo4j

企业版会自动做增量

3️⃣ 恢复数据库

方式一：恢复到新数据库

neo4j-admin restore \
  --from=/backup/neo4j/neo4j \
  --database=neo4j-restored

然后在 Neo4j 中创建：

CREATE DATABASE `neo4j-restored`;

方式二：覆盖原数据库

neo4j stop
neo4j-admin restore \
  --from=/backup/neo4j/neo4j \
  --database=neo4j \
  --force
neo4j start

四、Docker 环境备份恢复

1️⃣ 容器数据卷备份

docker cp neo4j-container:/data ./neo4j-backup

恢复：

docker cp ./neo4j-backup/data neo4j-container:/data

2️⃣ Docker + 企业版

docker exec neo4j \
  neo4j-admin backup \
  --backup-dir=/backups \
  --database=neo4j

五、集群（Causal Cluster）备份

企业版集群建议：

• 从 follower 节点备份
• 不影响 leader 性能
• 使用 neo4j-admin backup

neo4j-admin backup \
  --backup-dir=/backup/neo4j \
  --database=neo4j

六、备份策略建议（生产环境）

✅ 推荐组合：

• 每天一次全量备份
• 每小时增量备份
• 备份目录与数据库分离
• 定期验证恢复流程

示例目录结构：

/backup/neo4j/
├── 2026-01-20/
├── 2026-01-21/

七、常见问题

❓ 社区版能热备份吗？

❌ 不能，必须停机

❓ 备份文件能跨版本恢复吗？

⚠️ 不建议，最好同版本

❓ 备份失败常见原因？

• 磁盘空间不足
• 数据库未启动
• 权限不足

如果你愿意，可以告诉我：

• ✅ Neo4j 版本
• ✅ 是否 Docker
• ✅ 单机 / 集群
• ✅ 是否在生产环境

我可以直接给你一套可复制执行的备份恢复方案。