使用 Docker 部署 Neo4j 图数据库

执行任何导入或导出操作前，必须先停止正在运行的容器（注意是 stop 而非 rm）：

docker stop neo4j

导出数据

使用临时容器挂载数据卷进行备份。注意临时容器名称不能与已存在的容器重名：

docker run --interactive --tty --rm \
  --volume=/home/neo4j/data:/data \
  --volume=/home/neo4j/backups:/var/lib/neo4j/import \
  --name neo4j_demo \
  neo4j:5.26.2 \
  neo4j-admin database dump neo4j --to-path=/var/lib/neo4j/import/

关键点：

• --interactive --tty：允许与容器交互进行实时调试。
• --rm：操作完成后自动删除临时容器。
• 备份文件最终会保存在宿主机的 /home/neo4j/backups 目录下。

导入数据

根据 Neo4j 版本不同，导入命令有所区别。

5.1 版本及以上（新版本） 如果数据库存在，直接导入会报错，需添加覆盖参数：

docker run -it --rm \
  --volume=/home/neo4j/data:/data \
  --volume=/home/neo4j/import:/var/lib/neo4j/import \
  neo4j:5.26.2 \
  neo4j-admin database load --from-path=/var/lib/neo4j/import/ neo4j --overwrite-destination=true

5.1 版本以下（旧版本） 旧版本使用 load 命令且路径格式略有不同：

docker run -it --rm \
  --volume=/home/neo4j/data:/data \
  --volume=/home/neo4j/import:/var/lib/neo4j/import \
  neo4j:4.4.40 \
  neo4j-admin load --from=/var/lib/neo4j/import/neo4j.dump --database=neo4j --force

跨版本迁移 若需将旧版本数据强制导入新版本数据库，可使用组合命令：

docker run -it --rm \
  --volume=/home/neo4j/data:/data \
  --volume=/home/neo4j/import:/var/lib/neo4j/import \
  neo4j:5.26.2 \
  sh -c "neo4j-admin database load --from-path=/var/lib/neo4j/import/ neo4j --overwrite-destination=true && neo4j-admin database migrate neo4j --force-btree-indexes-to-range"

重启容器

数据导入完成后，重新启动主容器即可生效：

docker start neo4j