基于 Debian 的发行版 (.deb)

您可以使用 Neo4j Debian 软件包在 Debian 以及基于 Debian 的发行版（如 Ubuntu）上安装 Neo4j。

Java 先决条件

Neo4j 2025.05 需要 Java 21 运行时环境。

OpenJDK Java 21

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

Oracle JDK、Zulu JDK 或 Corretto JDK

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

Java 下载和安装说明可在制造商网站上找到

处理多个已安装的 Java 版本

您必须将默认 Java 版本配置为指向 Java 21，否则 Neo4j 2025.05.0 将无法启动。请使用 update-java-alternatives 命令进行设置。

  1. 使用 update-java-alternatives --list 列出所有已安装的 Java 版本。

    您的结果可能会有所不同，但这是一个输出示例

    java-1.21.0-openjdk-amd64 2111 /usr/lib/jvm/java-1.21.0-openjdk-amd64
java-1.17.0-openjdk-amd64 1711 /usr/lib/jvm/java-1.17.0-openjdk-amd64

  2. 从已安装的 Java 列表中识别您的 Java 21 版本。在此示例中，它是 java-1.21.0-openjdk-amd64。

  3. 将 <java21name> 替换为其名称，将 Java 21 设置为默认版本

    sudo update-java-alternatives --jre --set <java21name>

  4. 使用 java -version 确认默认的 Java 版本。

安装

添加仓库

Debian 软件包可从 https://debian.neo4j.com 获取。

  1. 要将 Neo4j 仓库添加到包管理器，请以 sudo 用户身份运行以下命令

    wget -O - https://debian.neo4j.com/neotechnology.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/neotechnology.gpg
echo 'deb [signed-by=/etc/apt/keyrings/neotechnology.gpg] https://debian.neo4j.com stable latest' | sudo tee -a /etc/apt/sources.list.d/neo4j.list
sudo apt-get update

  2. 将仓库添加到 apt 后，您可以通过运行以下命令来验证哪些 Neo4j 版本可用

    apt list -a neo4j

    在 Ubuntu 服务器安装中，您还需要确保已启用 universe 仓库。如果 universe 仓库不存在，Neo4j 安装将失败，并显示错误 Depends: daemon but it is not installable。

    可以通过运行以下命令解决此问题

    sudo add-apt-repository universe

安装 Neo4j

要安装 Neo4j，请根据您要安装的版本运行以下命令之一

  • Neo4j 社区版

    sudo apt-get install neo4j=1:2025.05.0

  • Neo4j 企业版

    sudo apt-get install neo4j-enterprise=1:2025.05.0

请注意，版本包含一个 epoch 版本组件 (1:)，遵循 Debian 版本策略。

安装 Neo4j 企业版时，系统将提示您接受许可协议。接受许可协议后，安装开始。您对许可协议提示的回答将存储，以供在同一系统上将来安装时使用。

要清除存储的答案并在后续安装时再次触发许可协议提示，请使用 debconf-communicate 清除存储的答案

echo purge | sudo debconf-communicate neo4j-enterprise

Neo4j 企业版非交互式安装

对于 Neo4j 企业版，许可协议以交互式提示显示。如果您需要非交互式安装 Neo4j 企业版，可以使用 debconf-set-selections 表明您已阅读并接受许可协议

echo "neo4j-enterprise neo4j/accept-license select Accept commercial license" | sudo debconf-set-selections

离线安装

如果您无法访问 https://debian.neo4j.com，可能是由于防火墙，您需要通过一台可访问的机器获取 Neo4j，然后手动移动软件包。

需要注意的是，使用此方法意味着离线机器将不会收到通常在使用 apt 安装 Neo4j 时自动下载和安装的依赖项；Cypher Shell 和 Java（如果尚未安装）

  1. 运行以下命令以下载所需的 Debian 软件包

    • Neo4j 企业版

      curl -O https://dist.neo4j.org/deb/neo4j-enterprise_2025.05.0_all.deb

      要列出 Debian 软件包 (.deb 文件) 安装的所有文件

      dpkg --contents neo4j_2025.05.0_all.deb

    • Neo4j 社区版

      curl -O https://dist.neo4j.org/deb/neo4j_2025.05.0_all.deb

  2. 手动将下载的 Debian 软件包移动到离线机器。

  3. 在离线机器上运行以下命令以安装 Neo4j

    sudo dpkg -i <deb file name>

文件位置

所有 Neo4j 软件包的文件位置记录在此处。

操作

大多数 Neo4j 配置都位于neo4j.conf 中。

对于使用 systemd 的操作系统，一些软件包特定的选项设置在 neo4j.service 中，可以使用 systemctl edit neo4j.service 进行编辑。

对于不使用 systemd 的操作系统，一些软件包特定的选项设置在 /etc/default/neo4j 中。

环境变量 默认值 详细信息

NEO4J_SHUTDOWN_TIMEOUT

120

等待 Neo4j 停止的超时时间（秒）。如果超过此时间，则认为关机失败。如果系统处理长时间运行的事务，可能需要增加此值。

NEO4J_ULIMIT_NOFILE

60000

Neo4j 进程可以打开的文件句柄的最大数量。

系统启动时自动启动服务

在基于 Debian 的发行版上，运行以下命令以确保 Neo4j 在启动时自动启动

sudo systemctl enable neo4j

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

如果未通过此方法明确设置密码，则密码将设置为默认密码 neo4j。在这种情况下，首次登录时会提示您更改默认密码。

有关更多信息，请参阅 设置初始密码。

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

卸载 Neo4j

按照以下步骤卸载 Neo4j

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

  2. 卸载 Neo4j

    ---
sudo apt remove neo4j
---
© . All rights reserved.