在离线 Ubuntu 环境下部署双 Neo4j 实例（Prod & Dev）

Anarkh_Lee2025-04-23 10:52

在许多开发和生产场景中，我们可能需要在同一台服务器上运行多个独立的 Neo4j 数据库实例，例如一个用于生产环境 (Prod)，一个用于开发测试环境 (Dev)。本文将详细介绍如何在 离线 的 Ubuntu 服务器上，使用 tar.gz 包部署两个 Neo4j 4.4 实例，并配置不同的端口以供外部访问，同时涵盖了部署过程中可能遇到的常见问题及其解决方案。

1. 需求：

ubuntu系统下，离线环境，我想要部署两套neo4j的数据库（一套prod（服务端口17687，浏览器端口17474），一套dev（服务端口17688，浏览器端口17475），都需要别的主机能访问到）(下载的neo4j版本为neo4j-community-4.4.42-unix.tar.gz)

**前提条件：**Java 11 运行环境

2. 场景目标

  • 环境: 离线 Ubuntu 服务器。
  • 软件: Neo4j Community Edition 4.4.42 (以 neo4j-community-4.4.42-unix.tar.gz 形式提供)。
  • 目标:
    • 部署一个生产实例 (Prod)，服务端口 17687 ，浏览器端口 17474 。
    • 部署一个开发实例 (Dev)，服务端口 17688 ，浏览器端口 17475 。
    • 两个实例均需配置为可从其他主机访问。
    • 解决部署过程中可能遇到的常见问题。

3. 准备工作

在开始部署之前，请确保满足以下前提条件：

  1. 操作系统: Ubuntu Server (本文以 Ubuntu 为例，其他 Linux 发行版类似)。
  2. Neo4j 安装包: 已将 neo4j-community-4.4.42-unix.tar.gz 文件传输到目标服务器。
  3. Java 运行环境 (JRE/JDK): 至关重要的一点 ，Neo4j 4.4.x 版本明确要求 Java 11 。由于是离线环境，你需要预先将 Java 11 的安装包（例如 OpenJDK 11 JRE/JDK 的 .deb 包或压缩包）传输到服务器并完成安装。可以通过 java -version 命令检查当前 Java 版本。版本不匹配是导致启动失败或功能异常的常见原因。

4. 部署步骤

4.1 必须的配置

**4.1.1 创建安装目录: **为 prod 和 dev 环境分别创建独立的目录。建议放在 /opt 目录下。

bash 复制代码 
sudo mkdir -p /opt/neo4j-prod
bash 复制代码 
sudo mkdir -p /opt/neo4j-dev

**4.1.2 解压 Neo4j: **将 neo4j-community-4.4.42-unix.tar.gz 分别解压到对应的目录。假设你的压缩包位于当前用户的 home 目录下 ( ~ )。

bash 复制代码 
tar -xzf neo4j-community-4.4.42-unix.tar.gz -C /opt/neo4j-prod --strip-components=1
bash 复制代码 
tar -xzf neo4j-community-4.4.42-unix.tar.gz -C /opt/neo4j-dev --strip-components=1
  • --strip-components=1 用于去除压缩包内顶层的目录结构。

4.1.3 创建数据和日志目录: 为两个实例分别创建数据和日志存储目录，并确保 Neo4j 进程有权限访问（如果使用特定用户运行 Neo4j，需要调整权限）。

bash 复制代码 
sudo mkdir -p /var/lib/neo4j-prod/data
bash 复制代码 
sudo mkdir -p /var/log/neo4j-prod
bash 复制代码 
sudo mkdir -p /var/lib/neo4j-dev/data
bash 复制代码 
sudo mkdir -p /var/log/neo4j-dev

**4.1.4 配置 Prod 实例: **编辑 prod 实例的配置文件 /opt/neo4j-prod/conf/neo4j.conf 。你可以使用 nano 或 vim 编辑器。

bash 复制代码 
sudo nano /opt/neo4j-prod/conf/neo4j.conf

找到并修改或取消注释以下行：

plain 复制代码 
# ... 其他配置 ...

# Bolt connector
# Bolt 监听地址和端口，0.0.0.0 表示监听所有网络接口
dbms.connector.bolt.listen_address=0.0.0.0:17687

# HTTP connector
# HTTP 浏览器监听地址和端口
dbms.connector.http.listen_address=0.0.0.0:17474

# HTTPS connector
# HTTPS 浏览器监听地址和端口 (如果启用HTTPS)
# dbms.connector.https.listen_address=0.0.0.0:17473 # 可以保持注释或配置一个不同于dev的端口

# 数据目录
dbms.directories.data=/var/lib/neo4j-prod/data

# 日志目录
dbms.directories.logs=/var/log/neo4j-prod

# 导入目录 (如果需要)
# dbms.directories.import=/path/to/prod/import

# 内存配置 (根据服务器资源调整)
# dbms.memory.heap.initial_size=1g
# dbms.memory.heap.max_size=1g
# dbms.memory.pagecache.size=2g

# 允许远程访问浏览器 (4.x 版本通常默认允许，但明确设置更保险)
# dbms.security.allow_csv_import_from_urls=true # 如果需要从URL导入CSV
# dbms.security.procedures.unrestricted=my.extensions.example,my.procedures.* # 如果有自定义插件

# ... 其他配置 ...

保存并关闭文件 (在 nano 中是 Ctrl+X , 然后 Y , 然后 Enter )。

4.1.5 配置 Dev 实例: 编辑 dev 实例的配置文件 /opt/neo4j-dev/conf/neo4j.conf 。

bash 复制代码 
sudo nano /opt/neo4j-dev/conf/neo4j.conf

找到并修改或取消注释以下行：

plain 复制代码 
# ... 其他配置 ...

# Bolt connector
dbms.connector.bolt.listen_address=0.0.0.0:17688

# HTTP connector
dbms.connector.http.listen_address=0.0.0.0:17475

# HTTPS connector
# dbms.connector.https.listen_address=0.0.0.0:17476 # 可以保持注释或配置一个不同于prod的端口

# 数据目录
dbms.directories.data=/var/lib/neo4j-dev/data

# 日志目录
dbms.directories.logs=/var/log/neo4j-dev

# 导入目录 (如果需要)
# dbms.directories.import=/path/to/dev/import

# 内存配置 (通常 dev 环境可以配置得比 prod 低)
# dbms.memory.heap.initial_size=512m
# dbms.memory.heap.max_size=512m
# dbms.memory.pagecache.size=1g

# ... 其他配置 ...

保存并关闭文件 (在 nano 中是 Ctrl+X , 然后 Y , 然后 Enter )。

4.1.6 配置防火墙: 如果你的 Ubuntu 服务器启用了防火墙 (如 ufw )，需要允许外部访问配置的端口。

bash 复制代码 
# 允许 Prod 实例端口
sudo ufw allow 17687/tcp
bash 复制代码 
sudo ufw allow 17474/tcp
bash 复制代码 
# 如果启用了 HTTPS for Prod，也需要允许对应端口
# sudo ufw allow 17473/tcp
bash 复制代码 
# 允许 Dev 实例端口
sudo ufw allow 17688/tcp
bash 复制代码 
sudo ufw allow 17475/tcp
bash 复制代码 
# 如果启用了 HTTPS for Dev，也需要允许对应端口
# sudo ufw allow 17476/tcp
bash 复制代码 
# 重新加载防火墙规则使之生效
sudo ufw reload
bash 复制代码 
# 查看防火墙状态和规则
sudo ufw status verbose

**4.1.7 启动 Neo4j 实例: **分别启动两个实例。

启动 Prod 实例：

bash 复制代码 
sudo /opt/neo4j-prod/bin/neo4j start

启动 Dev 实例：

bash 复制代码 
sudo /opt/neo4j-dev/bin/neo4j start

**4.1.8 检查状态: **检查两个实例的运行状态。

检查 Prod 实例：

bash 复制代码 
sudo /opt/neo4j-prod/bin/neo4j status

检查 Dev 实例：

bash 复制代码 
sudo /opt/neo4j-dev/bin/neo4j status

如果看到 "Neo4j is running" 或类似信息，表示启动成功。

4.1.9 访问和初始设置:

至此，就算是部署完成了。

  • **Prod 实例: **在其他机器的浏览器中访问 http://<你的服务器IP>:17474 。
  • **Dev 实例: **在其他机器的浏览器中访问 http://<你的服务器IP>:17475 。

首次连接时，会要求使用默认用户名 neo4j 和默认密码 neo4j 登录。登录后，系统会强制你修改密码。请为每个实例设置不同的强密码。

4.1.10 停止实例 (如果需要):

停止 Prod 实例：

bash 复制代码 
sudo /opt/neo4j-prod/bin/neo4j stop

停止 Dev 实例：

bash 复制代码 
sudo /opt/neo4j-dev/bin/neo4j stop

4.2 可选的配置

可选：配置为 Systemd 服务 (推荐)

为了方便管理（开机自启、后台运行、重启等），建议将 Neo4j 实例配置为 systemd 服务。

4.2.1 创建 Prod 服务文件:

bash 复制代码 
sudo nano /etc/systemd/system/neo4j-prod.service

粘贴以下内容 (如果使用特定用户运行，请修改 User 和 Group ):

plain 复制代码 
[Unit]
Description=Neo4j Graph Database (Prod)
After=network.target

[Service]
Type=forking
User=root  # 或者你创建的专用用户，如 neo4j
Group=root # 或者你创建的专用用户组，如 neo4j
ExecStart=/opt/neo4j-prod/bin/neo4j start
ExecStop=/opt/neo4j-prod/bin/neo4j stop
ExecStatus=/opt/neo4j-prod/bin/neo4j status
PIDFile=/opt/neo4j-prod/run/neo4j.pid # 确认 PID 文件路径是否正确，可能在 /var/run/neo4j-prod 等
Restart=on-failure
LimitNOFILE=65536 # 增加文件描述符限制

[Install]
WantedBy=multi-user.target

注意: PIDFile 的路径可能需要根据实际情况调整，检查 Neo4j 启动后 run 目录下的 neo4j.pid 文件位置。如果以非 root 用户运行，确保该用户对 /opt/neo4j-prod 及其子目录有读写执行权限，特别是 run , logs , data 目录。

4.2.2 创建 Dev 服务文件:

bash 复制代码 
sudo nano /etc/systemd/system/neo4j-dev.service

粘贴以下内容 (同样注意 User 和 Group ):

plain 复制代码 
[Unit]
Description=Neo4j Graph Database (Dev)
After=network.target

[Service]
Type=forking
User=root  # 或者你创建的专用用户
Group=root # 或者你创建的专用用户组
ExecStart=/opt/neo4j-dev/bin/neo4j start
ExecStop=/opt/neo4j-dev/bin/neo4j stop
ExecStatus=/opt/neo4j-dev/bin/neo4j status
PIDFile=/opt/neo4j-dev/run/neo4j.pid # 确认 PID 文件路径
Restart=on-failure
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

4.2.3 启用和管理服务:

bash 复制代码 
# 重新加载 systemd 配置
sudo systemctl daemon-reload
bash 复制代码 
# 启动 Prod 服务
sudo systemctl start neo4j-prod
bash 复制代码 
# 启动 Dev 服务
sudo systemctl start neo4j-dev
bash 复制代码 
# 查看 Prod 服务状态
sudo systemctl status neo4j-prod
bash 复制代码 
# 查看 Dev 服务状态
sudo systemctl status neo4j-dev
bash 复制代码 
# 设置 Prod 服务开机自启
sudo systemctl enable neo4j-prod
bash 复制代码 
# 设置 Dev 服务开机自启
sudo systemctl enable neo4j-dev
bash 复制代码 
# 停止服务 (示例: 停止 prod)
# sudo systemctl stop neo4j-prod
bash 复制代码 
# 重启服务 (示例: 重启 dev)
# sudo systemctl restart neo4j-dev

5. 总结

通过以上步骤，我们成功地在离线的 Ubuntu 服务器上部署了两个独立的 Neo4j 实例，并配置了不同的端口供外部访问。关键在于为每个实例提供独立的安装、数据和日志目录，并仔细配置 neo4j.conf 文件中的监听地址、端口和目录路径。同时，确保运行环境满足 Neo4j 的要求（特别是 Java 11），并掌握了通过检查日志、访问地址和端口监听状态来排查启动问题的基本方法。使用 systemd 服务管理 Neo4j 实例是推荐的最佳实践，可以大大简化运维工作。

6. 附录

Neo4j下载地址：

neo4j.com/deployment-...

相关推荐
机器之心3 分钟前
业内首次! 全面复现DeepSeek-R1-Zero数学代码能力，训练步数仅需其1/10
人工智能
新智元3 分钟前
大学文凭成废纸？AI 暴击美国 00 后！他哥大退学成千万富翁，我却还要还学贷
人工智能·openai
财经汇报4 分钟前
媒体关注：联易融聚焦AI+业务，重塑供应链金融生态
人工智能·金融·媒体
姚家湾6 分钟前
闲聊人工智能对媒体的影响
人工智能·媒体
一个小坑货8 分钟前
Docker 部署 MySQL 数据库
数据库·mysql·docker
程序员安仔12 分钟前
Trae 新版发布！除了支持联网搜索、 MCP 外，还能创建智能体！
人工智能·trae
新智元18 分钟前
Transformer 原作打脸 DeepSeek 观点？一句 Wait 就能引发反思，RL 都不用
人工智能·openai
曾经的三心草29 分钟前
博客系统-邮件发送-nginx-服务部署
java·数据库·nginx·邮件发送·服务部署
timer_01733 分钟前
百度 Al 智能体心响 App 上线
人工智能
热门推荐
01KGG转MP3工具|非KGM文件|解密音频02从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑03我决定放弃搞 Java 了04YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】05DeepSeek各版本说明与优缺点分析06RAG 实践- Ollama+RagFlow 部署本地知识库07苍穹外卖面试总结08yolov8，yolo11，yolo12 服务器训练到部署全流程 笔记09如何在WPS和Word/Excel中直接使用DeepSeek功能10组基轨迹建模 GBTM的介绍与实现（Stata 或 R）