使用Docker和虚拟IP在一台服务器上灵活部署多个Neo4j实例

前言

在现代应用开发中，图数据库Neo4j因其强大的关系处理能力而备受青睐。但有时候我们需要在同一台服务器上运行多个Neo4j实例，比如用于开发测试、多租户环境或者A/B测试。传统的端口映射方式需要修改大量配置，而使用虚拟IP方案则更加优雅和灵活。

本文将介绍如何使用Docker和虚拟IP技术，在一台服务器上部署多个Neo4j实例，并实现按需启动的灵活管理。

方案优势

• 端口一致性：所有实例使用相同的标准端口(7474/7687)
• IP隔离：通过不同虚拟IP地址区分实例
• 灵活启动：可根据资源情况按需启动单个或多个实例
• 配置简单：使用Docker Compose和环境变量管理
• 性能优化：使用主机网络模式，减少网络开销

环境准备

首先确保服务器已安装Docker和Docker Compose：

点击进入docker安装方法

步骤一：配置虚拟IP

在服务器上设置两个虚拟IP地址：

# 添加虚拟IP（根据实际网卡名称调整，通常是ens33或ens33）
sudo ip addr add 192.168.10.100/24 dev ens33
sudo ip addr add 192.168.10.101/24 dev ens33# 验证IP配置
ip addr show ens33# 设置开机自动添加虚拟IP（可选）
echo 'ip addr add 192.168.10.100/24 dev ens33' | sudo tee -a /etc/rc.local
echo 'ip addr add 192.168.10.101/24 dev ens33' | sudo tee -a /etc/rc.local
sudo chmod +x /etc/rc.local

步骤二：创建项目结构

创建项目目录并组织文件结构：

mkdir neo4j-cluster
cd neo4j-cluster
mkdir -p {data1,data2,logs1,logs2,import1,import2}

步骤三：配置环境变量

创建 .env 配置文件：

# Neo4j实例启动控制
START_INSTANCE1=true
START_INSTANCE2=false# 虚拟IP配置
VIP1=192.168.10.100
VIP2=192.168.10.101# Neo4j认证信息
NEO4J_PASSWORD1=password1
NEO4J_PASSWORD2=password2# 公共配置
NEO4J_VERSION=5.13.0

步骤四：创建Docker Compose配置

创建 docker compose.yml 文件：

version: '3.8'services:neo4j-instance1:image: neo4j:${NEO4J_VERSION}container_name: neo4j-instance1network_mode: hostenvironment:- NEO4J_AUTH=neo4j/${NEO4J_PASSWORD1}- NEO4J_apoc_export_file_enabled=true- NEO4J_apoc_import_file_enabled=true- NEO4J_apoc_import_file_use__neo4j__config=true- NEO4JLABS_PLUGINS=["apoc"]- NEO4J_server_bolt_listen__address=${VIP1}:7687- NEO4J_server_http_listen__address=${VIP1}:7474- NEO4J_server_https_listen__address=${VIP1}:7473volumes:- ./data1:/data- ./logs1:/logs- ./import1:/var/lib/neo4j/importrestart: unless-stoppedprofiles: ["instance1"]healthcheck:test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://${VIP1}:7474"]interval: 30stimeout: 10sretries: 3neo4j-instance2:image: neo4j:${NEO4J_VERSION}container_name: neo4j-instance2network_mode: hostenvironment:- NEO4J_AUTH=neo4j/${NEO4J_PASSWORD2}- NEO4J_apoc_export_file_enabled=true- NEO4J_apoc_import_file_enabled=true- NEO4J_apoc_import_file_use__neo4j__config=true- NEO4JLABS_PLUGINS=["apoc"]- NEO4J_server_bolt_listen__address=${VIP2}:7687- NEO4J_server_http_listen__address=${VIP2}:7474- NEO4J_server_https_listen__address=${VIP2}:7473volumes:- ./data2:/data- ./logs2:/logs- ./import2:/var/lib/neo4j/importrestart: unless-stoppedprofiles: ["instance2"]healthcheck:test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://${VIP2}:7474"]interval: 30stimeout: 10sretries: 3

步骤五：管理脚本

创建管理脚本 manage-neo4j.sh：

#!/bin/bashset -e# 加载环境变量
if [ -f .env ]; thenexport $(cat .env | grep -v '#' | awk '/=/ {print $1}')
ficase "$1" in"start")echo "正在启动Neo4j实例..."if [ "$START_INSTANCE1" = "true" ]; thenecho "启动实例1 (${VIP1})..."docker compose --profile instance1 up -dfiif [ "$START_INSTANCE2" = "true" ]; thenecho "启动实例2 (${VIP2})..."docker compose --profile instance2 up -dfi;;"stop")echo "正在停止Neo4j实例..."docker compose down;;"restart")echo "正在重启Neo4j实例..."$0 stopsleep 2$0 start;;"status")echo "Neo4j实例状态:"docker ps --filter "name=neo4j-instance";;"logs")shiftdocker compose logs $@;;"config")echo "当前配置:"echo "实例1: START_INSTANCE1=$START_INSTANCE1, VIP=$VIP1"echo "实例2: START_INSTANCE2=$START_INSTANCE2, VIP=$VIP2";;"update-env")shiftif [ "$1" = "instance1" ]; thensed -i "s/START_INSTANCE1=.*/START_INSTANCE1=$2/" .envelif [ "$1" = "instance2" ]; thensed -i "s/START_INSTANCE2=.*/START_INSTANCE2=$2/" .envelseecho "用法: $0 update-env {instance1|instance2} {true|false}"fi;;*)echo "用法: $0 {start|stop|restart|status|logs|config|update-env}"echo ""echo "命令说明:"echo "  start       启动配置的实例"echo "  stop        停止所有实例"echo "  restart     重启实例"echo "  status      查看实例状态"echo "  logs        查看日志"echo "  config      显示当前配置"echo "  update-env  更新启动配置"exit 1;;
esac

给脚本执行权限：

chmod +x manage-neo4j.sh

步骤六：使用和管理

启动实例

如docker compose不可用，可以替换为docker compose

# 查看当前配置
./manage-neo4j.sh config# 启动配置的实例
./manage-neo4j.sh start# 查看状态
./manage-neo4j.sh status

动态调整配置

# 只启动实例1
./manage-neo4j.sh update-env instance1 true
./manage-neo4j.sh update-env instance2 false
./manage-neo4j.sh restart# 只启动实例2
./manage-neo4j.sh update-env instance1 false
./manage-neo4j.sh update-env instance2 true
./manage-neo4j.sh restart# 启动两个实例（资源充足时）
./manage-neo4j.sh update-env instance1 true
./manage-neo4j.sh update-env instance2 true
./manage-neo4j.sh restart

访问实例

• 实例1: http://192.168.10.100:7474 (用户名: neo4j, 密码: password1)
• 实例2: http://192.168.10.101:7474 (用户名: neo4j, 密码: password2)

故障排除

虚拟IP无法访问

# 检查虚拟IP是否设置
ip addr show ens33# 检查防火墙规则
sudo ufw status
sudo ufw allow from any to 192.168.10.100 port 7474,7687
sudo ufw allow from any to 192.168.10.101 port 7474,7687

端口冲突

如果端口已被占用，可以检查并终止冲突进程：

sudo lsof -i :7474
sudo lsof -i :7687