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

最新推荐文章于 2025-04-25 18:00:48 发布
最新推荐文章于 2025-04-25 18:00:48 发布
阅读量934 收藏 11
点赞数 20
分类专栏： Neo4j 部署 文章标签： ubuntu neo4j postgresql 数据库
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Anarkh_Lee/article/details/147429131
版权

在许多开发和生产场景中，我们可能需要在同一台服务器上运行多个独立的 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 目录下。

sudo mkdir -p /opt/neo4j-prod

sudo mkdir -p /opt/neo4j-dev

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

tar -xzf neo4j-community-4.4.42-unix.tar.gz -C /opt/neo4j-prod --strip-components=1

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，需要调整权限）。

sudo mkdir -p /var/lib/neo4j-prod/data

sudo mkdir -p /var/log/neo4j-prod

sudo mkdir -p /var/lib/neo4j-dev/data

sudo mkdir -p /var/log/neo4j-dev

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

sudo nano /opt/neo4j-prod/conf/neo4j.conf

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

# ... 其他配置 ...

# 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 。

sudo nano /opt/neo4j-dev/conf/neo4j.conf

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

# ... 其他配置 ...

# 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 )，需要允许外部访问配置的端口。

# 允许 Prod 实例端口
sudo ufw allow 17687/tcp

sudo ufw allow 17474/tcp

# 如果启用了 HTTPS for Prod，也需要允许对应端口
# sudo ufw allow 17473/tcp

# 允许 Dev 实例端口
sudo ufw allow 17688/tcp

sudo ufw allow 17475/tcp

# 如果启用了 HTTPS for Dev，也需要允许对应端口
# sudo ufw allow 17476/tcp

# 重新加载防火墙规则使之生效
sudo ufw reload

# 查看防火墙状态和规则
sudo ufw status verbose

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

启动 Prod 实例：

sudo /opt/neo4j-prod/bin/neo4j start

启动 Dev 实例：

sudo /opt/neo4j-dev/bin/neo4j start

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

检查 Prod 实例：

sudo /opt/neo4j-prod/bin/neo4j status

检查 Dev 实例：

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 实例：

sudo /opt/neo4j-prod/bin/neo4j stop

停止 Dev 实例：

sudo /opt/neo4j-dev/bin/neo4j stop

4.2 可选的配置

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

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

4.2.1 创建 Prod 服务文件:

sudo nano /etc/systemd/system/neo4j-prod.service

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

[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 服务文件:

sudo nano /etc/systemd/system/neo4j-dev.service

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

[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 启用和管理服务:

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 启动 Prod 服务
sudo systemctl start neo4j-prod

# 启动 Dev 服务
sudo systemctl start neo4j-dev

# 查看 Prod 服务状态
sudo systemctl status neo4j-prod

# 查看 Dev 服务状态
sudo systemctl status neo4j-dev

# 设置 Prod 服务开机自启
sudo systemctl enable neo4j-prod

# 设置 Dev 服务开机自启
sudo systemctl enable neo4j-dev

# 停止服务 (示例: 停止 prod)
# sudo systemctl stop neo4j-prod

# 重启服务 (示例: 重启 dev)
# sudo systemctl restart neo4j-dev

5. 总结

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

6. 附录

Neo4j下载地址：

https://neo4j.com/deployment-center/

Laravel Homestead
蛐蛐的博客
10-31 1491
1.简介 Laravel努力使整个PHP开发体验（包括您的本地开发环境）令人愉悦。 Vagrant提供了一种简单，优雅的方式来管理和配置虚拟机。 Laravel Homestead是一个官方的，预包装的Vagrant盒子，它为您提供了一个不错的开发环境，而无需您在本地计算机上安装PHP，Web服务器和任何其他服务器软件。 无需担心搞砸您的操作系统！ Vagrant boxes是完全一次性的。 如果出了问题，您可以在几分钟内销毁并重新创建盒子！ Homestead可在任何Windows，Mac或.
DataHub调研&数据血缘
美丽的毛毛草
04-04 6650
​ 在DataHub中可以通过GraphQL API轻松的创建和添加任何实体标签，这样随着时间的推移，实体的属性回越来越丰富。当有一天我们想要查看某一标签的相关实体信息时，只需要在标签位置点击该标签，就会将所有相关的实体数据 列出来。
Spring Boot系列 - 2. Spring Boot提供的特性
Think Different
11-18 9104
Spring Boot系列 - 2. Spring Boot提供的特性
Spring Boot参考指南
w_wensan的博客
04-16 6072
Spring Boot参考指南作者菲利普· 韦伯，戴夫 Syer，约什 长，斯特凡 尼科尔，罗布 绞车，安迪· 威尔金森，马塞尔 Overdijk，基督教 杜普伊斯，塞巴斯蒂安· 德勒兹，迈克尔· 西蒙斯1.5.2.RELEASE版权所有©2012-2017本文档的副本可以为您自己使用并分发给其他人，前提是您不收取这些副本的任何费用，并进一步规定每份副本均包含此版权声明，无论是以印刷版还是电子版分...
Docker命令大全
我的博客
01-18 1816
docker hello world docker run ubuntu:15.10 /bin/echo "Hello world" 各个参数解析： docker: Docker 的二进制执行文件。 run: 与前面的 docker 组合来运行一个容器。 ubuntu:15.10 指定要运行的镜像，Docker 首先从本地主机上查找镜像是否存在，如果不存在，Docker 就会从镜像仓库 Doc...
Spring Boot 3.0.0-M1 Reference Documentation(Spring Boot中文参考文档) 9-16
dzq584462393的专栏
07-01 3885
Spring Boot参考文档
Spring Boot启动参考指南(官方版)
开发猫
10-03 6994
Spring Boot启动参考指南 作者 Phillip Webb, Dave Syer, Josh Long, Stéphane Nicoll, Rob Winch, Andy Wilkinson, Marcel Overdijk, Christian Dupuis, Sébastien Deleuze, Michael Simons, VedranPavić, Jay Bryant, Ma...
Spring Boot 1.5.2.RELEASE中文版
杰子的世界
08-01 2928
Spring Boot 1.5.2.RELEASE中文版 Part I. Spring Boot 文档 本节简要介绍了Spring Boot文档，是整个文档的参考指南。 您可以完整阅读本参考指南，或者如果您不感兴趣的话可以跳过该部分。 1. 关于文档 Spring Boot参考指南可以以 html，pdf 和 epub 文档的形式获取。 最新版本的文档可在 http://docs.spring.i...
Spring Boot中文文档（官方文档翻译 基于1.5.2.RELEASE）
热门推荐
geekidentity
04-06 8万+
Spring Boot官方文档中文翻译（更新至 26. 日志）
双系统下 ubuntu 20.04 突然 开机黑屏报错 hdaudioC0D2: unable to configure disabling
qq_48717745的博客
04-23 328
今天在开实验室开双系统台式机时，ubuntu 20.04 系统下，突然在某次关机后再开机时，本来启动好好的，但是在进行图形化启动时，本来应该是显示输入账号和密码时，直接黑屏报错了，内容为 hdaudioC0D2: unable to configure disabling ，这里是记录了报错的解决全过程
Ubuntu18.04配置C++环境和Qt环境
最新发布
qq_62435866的博客
04-25 490
Ubuntu配置C++和Qt环境
Docker安装（Ubuntu22版）
m0_61990598的博客
04-25 336
你是否还在为Linux上配置Docker而感到烦恼？你是否还在为docker search，docker pull连接不上，而感到沮丧？本文将解决以上你的所有烦恼！快速安装好docker！
Linux-06 ubuntu 系统截图软件使用简单记录
不疯狂不成魔
04-25 259
原先使用的 Flameshot 截图软件，在ubuntu 18.04下可以正常使用。安装过后重新安装，反而打不开了，但是快捷键还是有用的，但是没有修改已有的问题。（PS：按照AI说的修改还崩了一次 ubuntu 系统，进入不了界面操作）系统升级到22.04 后，安装后的只能截图，不能标注，想着修复下。界面不喜欢，还需要再点击一次才能截图，没找到标注的按钮。以下是个人备忘录记录，如何使用需要客官自己研究。截图后保存不了 ，可能我不会使用。安装后可以界面操作，找到图标打开。安装时间比较长，四五分钟左右要的。
解决ubuntu server修改为中文后乱码问题（改回英文）
秋窗的博客
04-22 397
基本修复了将语言更改为中文后的乱码问题，但是还有一个小问题，就是在启动之后显示的ubuntu旗标中还是会有中文乱码，这让人很不爽。这会强制系统重新加载英文语言包。，若输出显示的所有变量均为。重启系统：reboot。
Ubuntu 22.04安装IGH
rosemary512的专栏
04-22 243
文中使用ec_generic通用驱动，需换为ec_r8169。端口enp2s0连接的EtherCAT设备。
ubuntu--汉字、中文输入
m0_60274660的博客
04-21 353
(这种方式安装的中文输入法不是很智能，不好用)。
关于ubuntu密码正确但是无法登录的情况
weixin_51552032的博客
04-22 204
如果用户是L状态，那么就是lock了。
ROS2 安装详细教程，Ubuntu 22.04.5 LTS 64 位 操作系统
Stuomasi_xiaoxin的博客
04-22 227
ubuntu 22.04系统安装ros 2详细步骤流程。
【ROS2】机器人操作系统安装到Ubuntu简介
进一寸有一寸的欢喜
04-23 377
ROS2: 第二代机器人操作系统，2022年5月底，迎来了ROS2第一个长期支持版——ROS2 Humble。 多机器人系统\跨平台\实时性
离线部署docker的neo4j
01-15
### 离线环境下的 Docker 容器中部署 Neo4j 图数据库 #### 准备工作 为了在离线环境中成功部署 Neo4j 数据库，需提前准备必要的文件和资源。这包括但不限于： - **Docker 镜像**：预先下载所需的 `neo4j` Docker 镜像并保存到本地存储介质上。 - **依赖项**：确保拥有所有必需的操作系统包和其他软件组件。 #### 下载镜像 在网络可用时执行如下操作获取所需镜像，并将其导出至 `.tar` 文件以便后续导入： ```bash docker pull neo4j:latest docker save -o /path/to/save/neo4j.tar neo4j:latest ``` 之后将此 `.tar` 文件传输给目标机器，在那里通过下面这条指令加载回 Docker 中： ```bash docker load &lt; /path/to/load/neo4j.tar ``` #### 启动容器 一旦镜像被正确加载入 Docker，则可以通过以下命令创建一个新的 Neo4j 实例[^2]: ```bash docker run -d \ --name neo4j-offline \ -v /local/path/data:/data \ -v /local/path/logs:/logs \ -p 7474:7474 \ -p 7687:7687 \ neo4j ``` 这里 `-v` 参数用于指定主机上的目录作为卷挂载点，从而实现持久化存储；而端口映射部分允许外部访问 Web 控制台 (HTTP) 和 Bolt 协议接口。 #### 初始化设置 首次运行后应立即进入容器内部完成初始化配置： ```bash docker exec -it neo4j-offline bash ``` 接着按照官方文档指导修改默认密码等安全选项，以及调整其他参数以适应具体应用场景需求。 #### 备份机制 考虑到数据保护的重要性，建议定期实施自动化的备份流程。对于在线状态而言，可利用内置工具来进行热备份操作[^1]: ```bash docker exec --interactive --tty neo4j-offline neo4j-admin backup --database=neo4j --to=/backups/$(date +%Y%m%d_%H:%M).backup ``` 上述脚本会把当前时间戳附加于输出路径名之中，便于区分不同时间节点产生的副本集。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值