Neo4j如何进行分布式部署

Neo4j分布式部署实践

一 版本与架构选择

• 仅Neo4j 企业版原生支持分布式集群；社区版不支持集群，只能做单实例或通过外部组件实现高可用。企业版提供两种集群形态：
  • 因果集群（Causal Clustering，4.x/5.x）：由Core 节点（处理写、参与 Raft 共识）与Read Replica 节点（只读扩展）组成，支持因果一致性、自动故障切换与在线扩容读能力。
  • HA 集群（3.x 企业版）：主从复制模型，写入由主节点处理，从节点提供读扩展。
• 典型用途：Core 负责强一致写入与元数据共识，Read Replica 负责水平扩展读负载；对外通过负载均衡暴露读写端点。

二 因果集群部署步骤（企业版 4.x/5.x）

• 准备与端口
  • 至少准备3 台服务器作为Core；可按需增加Read Replica。
  • 开放端口：7687（Bolt）、7474/7473（HTTP/HTTPS）、5000（Discovery）、6000（Transaction）、7000（Raft）。
• 核心节点配置（示例）
  • 在 neo4j.conf 或环境变量中设置：
    • dbms.mode=CORE
    • causal_clustering.initial_discovery_members=core1:5000,core2:5000,core3:5000
    • causal_clustering.discovery_listen_address=0.0.0.0:5000
    • causal_clustering.transaction_listen_address=0.0.0.0:6000
    • causal_clustering.raft_listen_address=0.0.0.0:7000
    • dbms.connectors.default_listen_address=0.0.0.0
    • dbms.connector.bolt.listen_address=:7687；dbms.connector.http.listen_address=:7474
• 只读副本配置（示例）
  • dbms.mode=READ_REPLICA
  • causal_clustering.initial_discovery_members=core1:5000,core2:5000,core3:5000
• Docker 快速示例（Core）
  • docker run --name=neo4j-core -d
    –publish=7474:7474 --publish=7687:7687
    –publish=5000:5000 --publish=6000:6000 --publish=7000:7000
    –env=NEO4J_dbms_mode=CORE
    –env=NEO4J_causal__clustering_initial__discovery__members=10.0.0.11:5000,10.0.0.12:5000,10.0.0.13:5000
    –env=NEO4J_dbms_connector_bolt_enabled=true
    –env=NEO4J_ACCEPT_LICENSE_AGREEMENT=yes
    –volume=$HOME/data:/data --volume=$HOME/logs:/logs
    neo4j:enterprise
• 启动顺序与验证
  • 先启动全部 Core，待集群形成法定人数后再启动 Read Replica。
  • 浏览器访问 http://<任一Core>:7474，使用 neo4j/neo4j 登录并修改初始密码；通过 :sysinfo 或浏览器检查集群成员与角色。

三 3.x 企业版 HA 集群部署（历史版本）

• 适用场景：仍在使用 Neo4j 3.x 企业版的环境。
• 基本配置（各节点 neo4j.conf）
  • dbms.mode=HA
  • ha.server_id=<唯一ID，如 1/2/3>
  • ha.initial_hosts=host1:5001,host2:5001,host3:5001
  • 监听地址与连接器端口按实际网络开放（如 7687/7474）。
• 启动与验证
  • 依次启动各实例，主从将通过 5001 端口进行复制与健康检查；在管理界面或命令行检查集群状态。

四 社区版实现高可用的可选方案

• 社区版不支持官方集群，可通过外部机制实现高可用与故障切换：
  • 共享存储 + 虚拟 IP：如 DRBD 做块设备级复制，Keepalived 提供 VIP 与故障切换；Neo4j 实例指向共享存储上的数据目录。
  • 应用侧主写路由：写操作固定指向主实例，读操作可轮询或按权重分发到多个实例。
• 注意：该方式属于“主备”或“共享存储”形态，非 Neo4j 原生分布式集群，运维复杂度与一致性保障需自行评估。

五 运维与安全要点

• 网络与地址
  • 正确配置 listen_address 与 advertised_address，确保跨主机可达；在容器/云环境中避免将 127.0.0.1 作为对外广告地址。
• 数据与备份
  • 定期执行离线/在线备份（neo4j-admin dump/backup），跨可用区存放备份；Read Replica 不承担写一致性职责，不能替代备份。
• 监控与调优
  • 暴露 Bolt 7687 与必要的 HTTP 7474/7473；可按需开启监控端点（如 Prometheus），结合页面缓存与堆内存进行性能调优。
• 升级与变更
  • 遵循官方升级路径（先备份、再滚动升级 Core，最后升级 Read Replica），变更前在测试环境验证。