Linux 可执行文件 (.tar)

在 Linux 上通过 tarball 安装 Neo4j 并将其作为控制台应用程序或服务运行之前，请检查系统要求以确认您的环境是否适用。如果尚未安装，请获取 OpenJDK 21 或 Oracle Java 21。从 Neo4j 2025.10 版本开始，也支持 Java 25。

通过 tarball 安装 Neo4j

从 Neo4j 部署中心下载最新的 Neo4j tarball 并解压
```
tar zxf neo4j-enterprise-2026.03.1-unix.tar.gz
```

将解压后的文件移动到服务器的 /opt 目录，并为其创建符号链接

mv neo4j-enterprise-2026.03.1 /opt/
ln -s /opt/neo4j-enterprise-2026.03.1 /opt/neo4j

创建 neo4j 用户和组

groupadd neo4j
useradd -g neo4j neo4j -s /bin/bash

使用其中一个选项为该目录赋予正确的权限

Ubuntu

chown -R neo4j:adm /opt/neo4j-enterprise-2026.03.1

RedHat

chown -R neo4j /opt/neo4j-enterprise-2026.03.1

（推荐）通过设置环境变量 NEO4J_CONF 以及相应的 server.directories.* 设置指向所需位置，更改 data、conf、certificates、licenses 和 plugins（如果您计划使用自定义插件）目录的默认位置。

将 Neo4j 文件存储在 NEO4J_HOME 之外可以简化后续的升级过程，因为您可以替换 DBMS 二进制文件而不影响配置和状态。否则，这些 Neo4j 文件将保留在旧的安装文件夹中，可能会在升级过程中被意外覆盖，或在后续卸载时被删除。

企业版 (Enterprise Edition) 请接受商业或评估许可协议。如果您使用的是社区版 (Community Edition)，则可以跳过此步骤。
- 使用以下选项之一来接受商业许可协议。有关可用协议的详细信息，请参阅 Neo4j 许可页面。
  - 设置环境变量 NEO4J_ACCEPT_LICENSE_AGREEMENT=yes。
  - 运行 <NEO4J_HOME>/bin/neo4j-admin server license --accept-commercial
- 使用以下选项之一来接受 Neo4j 软件评估协议。
  - 设置环境变量 NEO4J_ACCEPT_LICENSE_AGREEMENT=eval。
  - 运行 <NEO4J_HOME>/bin/neo4j-admin server license --accept-evaluation。
在首次启动数据库之前，建议使用 neo4j-admin 的 set-initial-password 命令为原生用户 neo4j 设置密码。

如果未通过此方法显式设置密码，系统将使用默认密码 neo4j。在这种情况下，您将在首次登录时被要求更改默认密码。
有关详细信息，请参阅设置初始密码。
启动 Neo4j
- 要将 Neo4j 作为控制台应用程序运行，请使用：$NEO4J_HOME/bin/neo4j console。
- 要在后台进程中运行 Neo4j，请使用：$NEO4J_HOME/bin/neo4j start。

配置 Neo4j 在系统启动时自动运行

您可以创建一个 Neo4j 服务，并配置其在系统启动时自动运行。

创建文件 /lib/systemd/system/neo4j.service，内容如下

[Unit]
Description=Neo4j Graph Database
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/opt/neo4j/bin/neo4j console
Restart=on-abnormal
User=neo4j
Group=neo4j
Environment="NEO4J_CONF=/opt/neo4j/conf" "NEO4J_HOME=/opt/neo4j"
LimitNOFILE=60000
TimeoutSec=120

[Install]
WantedBy=multi-user.target

重新加载 systemctl 以加载新的服务文件
```
systemctl daemon-reload
```
配置 Neo4j 在启动时运行
```
systemctl enable neo4j
```
在首次启动数据库之前，建议使用 neo4j-admin 的 set-initial-password 命令为原生用户 neo4j 设置密码。

如果未通过此方法显式设置密码，系统将使用默认密码 neo4j。在这种情况下，您将在首次登录时被要求更改默认密码。
有关详细信息，请参阅设置初始密码。
启动 Neo4j
```
systemctl start neo4j
```
检查新创建服务的状态
```
systemctl status neo4j
```
重启系统（如果需要）以验证 Neo4j 是否在启动时自动运行
```
reboot
```

有关操作 Neo4j 系统服务的详细信息，请参阅 Neo4j 系统服务。

设置打开文件数限制

Linux 平台对每个用户和会话同时打开的文件数有限制。要检查当前会话的限制，请运行命令 ulimit -n。默认值为 1024。

ulimit -n

但是，如果您遇到 Too many open files（打开文件过多）或 Could not stat() directory（无法 stat 目录）异常，则需要根据使用模式将限制提高到 40000 或更高。当使用大量索引，或者服务器安装涉及过多的网络连接或套接字时，尤其如此。

一个快速的解决方案是执行命令 ulimit -n <the-new-limit>，但这仅会为 root 用户设置新限制，且仅影响当前会话。如果您想在系统范围内设置该值，请遵循您平台的说明。

以下步骤将 Ubuntu 16.04 LTS、Debian 8、CentOS 7 或更高版本下的 neo4j 用户打开文件描述符限制设置为 60000。

将 Neo4j 作为服务运行

以 root 权限打开 neo4j.service 文件。
```
sudo systemctl edit neo4j.service
```
在配置 Neo4j 在系统启动时自动运行中创建的 [Service] 部分中添加以下内容
```
[Service]
...
LimitNOFILE=60000
```

以交互式用户身份运行 Neo4j（例如用于测试目的）

以 root 权限在文本编辑器中打开 user.conf 文件。本例使用 Vim
```
sudo vi /etc/systemd/user.conf
```
取消注释并定义 [Manager] 部分中 DefaultLimitNOFILE 的值。
```
[Manager]
...
DefaultLimitNOFILE=60000
```
打开 /etc/security/limits.conf 文件。
```
sudo vi /etc/security/limits.conf
```

定义以下值

neo4j	soft	nofile	60000
neo4j	hard	nofile	60000

重新加载 systemd 设置。
```
sudo systemctl daemon-reload
```
重启您的机器。

访问 Neo4j

默认情况下，Neo4j 社区版不包含可视化、数据探索和监控等图工具。但是，您可以免费使用 Neo4j Aura 控制台访问这些功能。无需订阅。

注册或登录 Aura 控制台。
在实例 (Instances) 页面上，单击 Self-managed 选项卡，然后单击 + Add deployment 按钮。
选择 URL Connection。
提供名称 (Name) 和连接 URL (Connection URL)。如果您已在本地安装了 Neo4j，则可以连接到 bolt://:7687。
单击 Connect 下拉菜单以启动各种图工具，例如 Query、Explore 和 Dashboards。
输入用户名 neo4j 和您的密码或默认密码 neo4j。在首次登录时，系统将提示您更改默认密码。

现在您已连接，可以使用 Aura 控制台运行 Cypher 查询、可视化图表，并可选择在 Neo4j Aura 中监控本地 Neo4j 数据库。详情请参阅 Neo4j 入门。

或者，您可以使用 Neo4j Browser，这是 Neo4j 安装附带的一个基于 Web 的交互界面。要访问 Neo4j Browser，请打开 Web 浏览器并导航至 https://:7474。使用用户名 neo4j 和您的密码或默认密码 neo4j 进行连接。如果使用默认密码，系统将在首次登录时提示您进行更改。

卸载 Neo4j

请按照以下步骤卸载 Linux 上的 Neo4j

(可选) 创建备份以避免数据丢失。

停止所有运行中的 Neo4j 服务

sudo systemctl stop neo4j
sudo systemctl disable neo4j

删除 NEO4J_HOME 以及文件 /lib/systemd/system/neo4j.service
```
rm /lib/systemd/system/neo4j.service
rm -rf NEO4J_HOME
```