Red Hat, CentOS, Fedora, 和 Amazon Linux (.rpm)

您可以使用 Neo4j RPM 包在 Red Hat、CentOS、Fedora 或 Amazon Linux 发行版上部署 Neo4j。

Java 前置要求

Neo4j 2025.x 需要 Java 21 运行时（默认）。从 Neo4j 2025.10 开始，同时也支持 Java 25。

OpenJDK Java 21

大多数受支持的 Linux 发行版默认都提供 OpenJDK Java 21。因此，如果您使用 OpenJDK Java，则无需额外设置，安装 Neo4j 时，包管理器会自动安装正确的 Java 依赖项。

Zulu JDK 21 或 Corretto 21

如果您想使用非默认的 JDK，必须在开始安装 Neo4j 之前安装它。否则，您的包管理器将为您的操作系统安装默认的 Java 发行版，通常是 OpenJDK。

安装说明可在制造商的网站上找到

在 Red Hat、CentOS 或 Amazon Linux 上安装

设置存储库

  1. 将 Neo4j GPG 公钥导入到系统的 RPM 密钥环中。此密钥用于验证您将要安装的 Neo4j 包的真实性。

    rpm --import https://debian.neo4j.com/neotechnology.gpg.key

  2. 在 /etc/yum.repos.d/ 目录下创建一个 neo4j.repo 文件。该文件包含 Neo4j 的存储库配置。

    cat <<EOF > /etc/yum.repos.d/neo4j.repo
[neo4j]
name=Neo4j RPM Repository
baseurl=https://yum.neo4j.com/stable/latest
enabled=1
gpgcheck=1
EOF

    如果您是从 Neo4j 5.x 或更早版本升级，在 Neo4j 包可用之前，您可能需要清除包管理器缓存

    yum clean dbcache

  3. 通过列出可用的 Neo4j 包版本来验证 Neo4j 存储库是否设置正确

    yum list neo4j --showduplicates

安装 Neo4j

根据您使用的版本，以 root 用户身份使用以下命令安装 Neo4j

  • Neo4j 社区版

    yum install neo4j-2026.03.1

  • Neo4j 企业版

    在运行 Neo4j 企业版之前，请接受商业许可协议或评估许可协议。以下是使用交互式提示和非交互式安装的示例

    商业许可下企业版的交互式安装
    yum install neo4j-enterprise-2026.03.1

    在允许完成交互式安装之前，您必须选择 商业许可 或 评估许可。

    对于非交互式安装，您可以将环境变量 NEO4J_ACCEPT_LICENSE_AGREEMENT 设置为 yes（针对商业许可）或 eval（针对评估许可）。这应该与安装包在同一行完成，以确保 bash 正确地将环境变量传递给安装程序进程。如下例所示

    商业许可下企业版的非交互式安装
    NEO4J_ACCEPT_LICENSE_AGREEMENT=yes yum install neo4j-enterprise-2026.03.1

在 SUSE 上安装

对于基于 SUSE 的发行版，步骤如下

  1. 以 root 身份使用以下命令添加存储库

    zypper addrepo --refresh https://yum.neo4j.com/stable/latest neo4j-repository

  2. 根据您使用的版本，以 root 用户身份使用以下命令安装 Neo4j

    • 社区版

      zypper install neo4j-2026.03.1

    • 企业版

      在运行 Neo4j 企业版之前，请接受商业许可协议或评估许可协议。以下是使用交互式提示和非交互式安装的示例

      商业许可下企业版的交互式安装
      zypper install neo4j-enterprise-2026.03.1

      在允许完成交互式安装之前，您必须选择 商业许可 或 评估许可。

      对于非交互式安装，您可以将 NEO4J_ACCEPT_LICENSE_AGREEMENT 设置为 yes（针对商业许可）或 eval（针对评估许可），如下例所示

      商业许可下企业版的非交互式安装
      NEO4J_ACCEPT_LICENSE_AGREEMENT=yes zypper install neo4j-enterprise-2026.03.1

离线安装

如果您因防火墙等原因无法访问 https://yum.neo4j.com/stable/2026.03 来使用 RPM 安装 Neo4j，则需要通过有相应访问权限的替代机器获取 Neo4j，然后手动移动 RPM 包。

需要注意的是，使用此方法意味着离线机器无法获取使用 yum 安装 Neo4j、Neo4j Cypher Shell 和 Java 时通常会自动下载并安装的依赖项。

  1. 从 部署中心 (Deployment Center) 下载 Neo4j 和 Cypher Shell RPM 安装程序，或运行以下命令来获取所需的包

    • Cypher Shell

      curl -O https://dist.neo4j.org/cypher-shell/cypher-shell-2026.03.1-1.noarch.rpm

    • Neo4j 社区版

      curl -O https://dist.neo4j.org/rpm/neo4j-2026.03.1-1.noarch.rpm

    • Neo4j 企业版

      curl -O https://dist.neo4j.org/rpm/neo4j-enterprise-2026.03.1-1.noarch.rpm

  2. 手动将下载的 RPM 包移动到离线机器。在安装 Neo4j 之前，您必须手动安装所需的 Java 21 包。

  3. 根据您使用的版本，以 root 用户身份使用以下命令安装 Neo4j 和 Cypher Shell

    如果您是从 Neo4j 5.x 或更早版本升级，由于 Neo4j 和 Cypher Shell 之间存在严格的依赖关系，必须同时升级这两个包。这必须是一条单一命令，并且 Neo4j Cypher Shell 必须是命令中的第一个包。

    • Neo4j 社区版

      rpm --install cypher-shell-2026.03.1-1.noarch.rpm neo4j-2026.03.1-1.noarch.rpm

    • Neo4j 企业版

      在运行 Neo4j 企业版之前，请接受商业许可协议或评估许可协议。以下示例使用交互式提示

      rpm --install cypher-shell-2026.03.1-1.noarch.rpm neo4j-enterprise-2026.03.1-1.noarch.rpm

      在允许完成交互式安装之前，您必须选择 商业许可 或 评估许可。对于非交互式安装，您可以将 NEO4J_ACCEPT_LICENSE_AGREEMENT 设置为 yes（针对商业许可）或 eval（针对评估许可），如下例所示

      NEO4J_ACCEPT_LICENSE_AGREEMENT=yes rpm --install cypher-shell-2026.03.1-1.noarch.rpm neo4j-enterprise-2026.03.1-1.noarch.rpm

在系统启动时自动启动 Neo4j 服务

要使 Neo4j 在系统启动时自动启动，请运行以下命令

systemctl enable neo4j

在首次启动数据库之前，建议使用 neo4j-admin 的 set-initial-password 命令为原生用户 neo4j 设置密码。

如果未通过此方法显式设置密码，系统将使用默认密码 neo4j。在这种情况下，您将在首次登录时被要求更改默认密码。

有关详细信息，请参阅 设置初始密码。

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

位于 /etc/rc.d/init.d/ 或 /etc/init.d 中的 System V (SysV) 初始化脚本包含在 Neo4j 软件包安装中。但是，从 2026.01 开始，它们已被弃用，并将在未来的版本中移除。

访问 Neo4j

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

  1. 注册或登录 Aura 控制台。

  2. 在实例 (Instances) 页面上，单击 Self-managed 选项卡，然后单击 + Add deployment 按钮。

  3. 选择 URL Connection。

  4. 提供名称 (Name) 和连接 URL (Connection URL)。如果您已在本地安装了 Neo4j，则可以连接到 bolt://:7687。

  5. 单击 Connect 下拉菜单以启动各种图工具，例如 Query、Explore 和 Dashboards。

  6. 输入用户名 neo4j 和您的密码或默认密码 neo4j。在首次登录时，系统将提示您更改默认密码。

    Aura add self-managed deployment

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

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

卸载 Neo4j

请按照以下步骤卸载 Neo4j

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

  2. 卸载 Neo4j

    sudo yum remove neo4j