Cypher-shell 是 Neo4j 图数据库的交互式命令行工具，常用于数据迁移、备份和远程操作。本文将演示如何使用 Cypher-shell 实现服务器间的数据转移，涉及 VPS 配置、网络连通性测试、数据导出导入以及安全连接设置。通过实际操作，解决跨服务器数据同步问题。
首先，假设你有两台服务器：源服务器 A（IP: 192.168.1.100）和目标服务器 B（IP: 192.168.1.101），分别运行 Neo4j 数据库。任务是从服务器 A 将图数据库完整迁移到服务器 B。操作步骤如下：
1. **服务器 A 准备**：确保 Neo4j 在服务器 A 上正常运行，且数据库版本兼容。检查端口 7474（HTTP）和 7473（HTTPS）是否开放，这是 Cypher-shell 连接端口。
2. **创建导出文件**：使用 Neo4j 的 `dump` 命令导出数据。打开终端在服务器 A 执行：
neo4j-admin dump --name my-database --output-dir /backup
该命令将数据库 `my-database` 导出为压缩文件到 `/backup` 目录。导出过程可能需要几分钟，取决于数据量。
3. **传输文件**：将导出的文件传输到服务器 B。使用 `scp` 命令：
scp /backup/my-database.zip user@192.168.1.101:/backup
替换 `user` 为你在服务器 B 的登录用户名。传输完成后，在服务器 B 上解压文件：
unzip /backup/my-database.zip -d /var/lib/neo4j/data/databases
注意：路径需根据实际 Neo4j 安装目录调整。
4. **服务器 B 配置**：确保 Neo4j 在服务器 B 上未运行，否则会冲突。停止服务后，覆盖数据库文件，然后启动 Neo4j。
5. **验证数据**：使用 Cypher-shell 连接服务器 B 查询数据：
cypher-shell --host 192.168.1.101 --port 7474 --username neo4j --password your-password
输入 `MATCH (n) RETURN n LIMIT 10;` 确认数据正确迁移。如果查询结果为空，检查文件路径和权限。
如果需要增量同步，可以结合定时任务和日志文件实现。例如，在服务器 A 每日执行导出脚本，并通过 `cron` 定时运行。服务器 B 接收文件后，将新数据追加到数据库。
对于大型数据库，导出可能耗时过长。替代方案是使用 `neo4j-admin import` 命令导入，效率更高。首先在服务器 B 创建空数据库：
neo4j-admin database create my-database
然后导入文件：
neo4j-admin import --database my-database --input-dir /backup
导入完成后，使用 Cypher-shell 验证。
安全连接是远程操作的关键。默认端口 7474 存在安全风险，建议修改为自定义端口，并通过 SSH隧道加密传输。在服务器 A 设置 SSH 隧道：
ssh -L 7474:localhost:7474 user@192.168.1.101 -N
该命令将本地 7474 端口映射到远程服务器 7474。此时，Cypher-shell 可以直接连接本地端口：
cypher-shell --host localhost --port 7474 --username neo4j --password your-password
如果服务器 B 也有数据库，可以双向同步。先在服务器 A 创建空数据库：
cypher-shell --host 192.168.1.101 --port 7474 --username neo4j --password your-password
CREATE DATABASE target-db;
然后从服务器 B 导出并导入到 `target-db`。
如果遇到权限问题，检查 Neo4j 用户权限。确保用户有 `read` 和 `write` 权限。在服务器 A 的 Cypher-shell 中执行：
CALL dbms.security.addLabelUser('read', 'neo4j');
CALL dbms.security.addLabelUser('write', 'neo4j');
此外，确认防火墙允许 7474 端口访问。在服务器 A 执行：
sudo ufw allow 7474/tcp
Q: 为什么导出文件后 Cypher-shell 查询不到数据？
A: 可能是数据库路径错误或文件未完全覆盖。确认服务器 B 的 Neo4j 配置文件 `neo4j.conf` 中的 `dbms.database.default` 路径与解压目录一致。例如：
dbms.database.default=var/lib/neo4j/data/databases/my-database
重启 Neo4j 服务后再次尝试。
Q: 如何实现自动化定时同步？
A: 在服务器 A 创建定时脚本 `sync.sh`：
#!/bin/bash
timestamp=$(date +%Y%m%d%H%M%S)
dump_dir=/backup
export_dir=/tmp/export
mkdir -p $export_dir
neo4j-admin dump --name my-database --output-dir $export_dir --name-prefix $timestamp
scp -r $export_dir user@192.168.1.101:/backup
ssh user@192.168.1.101 'unzip -o /backup/$timestamp.zip -d /var/lib/neo4j/data/databases/my-database && systemctl restart neo4j'
设置 `crontab` 定时执行：
0 0 * * * /path/sync.sh
该脚本每晚 0 点执行导出、传输、解压和重启操作。
Q: 如何处理不同 Neo4j 版本兼容性问题？
A: 低版本数据库可能不支持高版本的特性。使用 `neo4j-admin database dump` 命令时，指定 `–dump-include-labels` 参数导出标签信息。导入时，在 Cypher-shell 执行 `USING PERIODIC COMMIT` 语句优化性能。如果版本差异过大，考虑使用 `neo4j-exporter` 工具进行格式转换。
