Neo4j安装(无root，Ubuntu，服务器端)及dump文件导入_neo4j dump

概述

本教程将从零开始，在服务器端安装neo4j服务，并导入一个dump文件。本教程主要针对小白，因此讲解较为详细；大神可以直接跳转至感兴趣的部分。

前言

负责的项目中有某个存于neo4j中的图数据需要从我的个人电脑迁移至项目的服务器上。不幸的是，同大部分工程一样 （笑），手头只有一个服务器的用户账号，毕竟老板的服务器还要负责其他项目，当然也不能让我乱来。于是，折腾到了半夜，只能在个人目录下操作的我，算是取得了一定成效。

Neo4j介绍

和MySQL一样，neo4j其实就是一个数据库服务，只不过它主要针对的数据类型是图数据。值得一提的是，和免费的neo4j desktop版不同，能免费部署在服务器上的neo4j社区版功能有限，其中详细还请各位慢慢从官方文件中体会。

安装步骤

下载Java套件

neo4j基于java提供服务，在下载neo4j之前我们需要确保服务器具有java环境。我此处选取的是neo4j官方推荐的OpenJDK进行下载。从官网跳转至下载界面：

根据服务器架构和OS选择对应版本，复制其下载链接，在服务器使用wget命令下载。

我下载后是得到文件openjdk-21.0.2_linux-x64_bin.tar.gz。键入以下命令解压：

tar zxf openjdk-21.0.2_linux-x64_bin.tar.gz
1

我解压后得到以下文件：

经验丰富的朋友已经知道接下来需要做什么了：主要是要将bin中的内容添加至PATH环境变量。在.zshrc文件中添加：

export PATH="~/jdk-21.0.2/bin:$PATH"
1

再输入以下命令执行更改：

source ./.zshrc
1

如果输入java --version出现以下结果，说明安装成功。

Tips：我这里因为默认shell是zsh，所以在.zshrc文件中添加PATH；如果你的默认shell是bash，请在.bashrc中添加PATH。如果你不知道什么是shell以及你的默认shell是什么，请自行百度。

下载Neo4j

进入官网，根据自己的服务器OS和架构选择合适的版本，同样在服务器端使用wget指令下载。

下载完成后，使用如下命令对下载文件进行解压：

tar zxf neo4j-community-5.16.0-unix.tar.gz
1

同样，需要将解压得到的文件夹中的bin目录加入PATH路径。在.zshrc文件中添加：

export PATH="~/neo4j-community-5.16.0/bin:$PATH"
1

再使用source ./.zshrc执行更改。

然后输入neo4j --version，若和我一样得到版本号，则说明安装成功。

配置Neo4j

作为一项网络服务，在我们正式使用前对其进行一些配置是必不可少的，以下将介绍一些重要的配置项：

# 默认监听地址：
# 通过该项可以划定能连接至本机neo4j服务的IP地址，只有被设定的IP地址可以连接至noe4j服务。
# 建议设定为0.0.0.0（表示所有IP均可连接）或自己工作时的IP。
server.default_listen_address=0.0.0.0

# 默认广播地址：
# 新手可以忽略该项，它主要用于在集群或端口映射中，用于方便客户端正确识别或访问服务。
# 建议使用“#”将其注释，以保持默认值。
server.default_advertised_address=localhost

# Bolt连接配置：
# 用于配置Bolt协议的相关参数。
server.bolt.enabled=true    # 是否允许Bolt连接，建议设定为true
server.bolt.tls_level=DISABLED    # 是否启用TLS加密Bolt连接，建议“#”注释以保持默认值
server.bolt.listen_address=:7687    # Bolt连接的监听地址，建议“#”注释以保持默认值
server.bolt.advertised_address=:7687    # Bolt连接的广播地址，建议“#”注释以保持默认值

# HTTP连接配置：
# 用于配置http协议的相关参数。
server.http.enabled=true    # 是否允许http连接，建议设定为true
server.http.listen_address=:7474    # http连接的监听地址，建议注释掉
server.http.advertised_address=:7474    #http连接的广播地址，建议注释掉

# HTTPS连接配置：
# 启用该项需要设定后续的SSL选项，因此建议此项保持默认的“不启用”。
server.https.enabled=false
server.https.listen_address=:7473
server.https.advertised_address=:7473

# 数据库默认只读：
# 是否将数据库设为默认只读，建议设定为false。
dbms.databases.default_to_read_only=false
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

你可以在neo4j-community-5.16.0/conf/neo4j.conf中找到并更改这些配置项。

启动Neo4j

进行完配置后，使用如下命令以启用neo4j服务。

neo4j console
1

Tips：你也可以使用neo4j start。该命令会将neo4j进程置于后台稳定运行。

shell界面出现以下界面即表示启动成功：

记住这里的两个端口：7474和7687，等下要考(bushi)。

此时启动浏览器，输入X.X.X.X:7474(X.X.X.X为你的服务器地址)即可访问neo4j服务，如下：

初次进入需要输入账密验证身份以建立Bolt连接。默认用户名和密码都是neo4j，首次验证成功后会要求更改密码。图中的Connect URL一栏请将localhost更正为自己的服务器IP。

Tips：如果你不理解什么是Bolt协议，可以查看官方文档。简单来说，我们访问的7474端口通过HTTP协议向我们的浏览器提供了一个控制台（即图中这个页面），而从控制台（7474端口）到数据库（7687端口）需要一个通信，这个通讯使用的就是Bolt协议。我们可以在7474端口提供的控制台中输入各种语句来对数据库进行查询，而这些查询语句与返回的结果就是通过Bolt协议在控制台（7474端口）与数据库（7687端口）间通信的。

出现以下页面，说明登录成功了。

*导入数据

往neo4j中导入数据有很多种方式，这里介绍最简便的一种，适合用于在不同设备的neo4j间快速迁移数据。

如前言所说，现在有一个从其他neo4j导出的.dump文件（至于如何导出为.dump文件请自行百度，应该是比导入简单得多的），我需要将其导入到我刚刚搭建的服务器上的neo4j数据库中。

步骤很简单：

1. 上传该.dump文件至服务器

2. Ctrl+C关闭刚刚启动的neo4j服务，对数据库进行覆写应该在数据库离线状态下进行

3. 使用命令neo4j-admin database load --from-path=./ neo4j --overwrite-destination=true对文件进行导入。（命令原型是neo4j-admin database load --from-path=<your_dump_file_path> <database_name> --overwrite-destination=true，该命令会在<your_dump_file_path>路径下查找<database_name>.dump文件，并覆写<database_name>这一数据库）

4. 使用neo4j console再次启动neo4j服务并查询数据，发现数据已成功导入
   Tips：服务器端的社区版neo4j不允许在一个DBMS中创建多个数据库，因此我们只能使用默认的名称为"neo4j"的数据库。而我原本的文件名称为data.dump。既然无法创建一个名为"data"的数据库，我就将data.dump重命名为neo4j.data，然后将其导入至名为"neo4j"的数据库中。

总结

事实上，neo4j的每次版本更新都会带来不小的变化，因此现在许多网上的许多neo4j安装教程并不具有时效性。再者，neo4j在许多平台支持多种方式部署，具有多个版本，这的确对小白造成了不小的困扰。之后可能会出一篇文章专门介绍不同版本的neo4j。不过，无论什么教程，最终都比不过官方文档来的准确。

最后，本人才疏学浅，欢迎各路大神对本文进行指正和交流！

参考文档

neo4j官方安装教程：https://neo4j.com/docs/operations-manual/current/installation/linux/tarball/
neo4j官方文档：https://neo4j.com/docs/operations-manual/current/backup-restore/restore-dump/