基于 Debian 的发行版 (.deb)

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

Java 前提条件

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

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 或 Java 25（从 Neo4j 2025.10 开始），否则 Neo4j 2026.03.1 将无法启动。请使用 update-java-alternatives 命令进行设置。

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

输出结果可能因系统而异，以下是输出示例

java-1.25.0-openjdk-amd64 2511 /usr/lib/jvm/java-1.25.0-openjdk-amd64
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

从已安装 Java 列表中确定您的 Java 21 版本（默认）。在本例中，它是 java-1.21.0-openjdk-amd64。
通过将 <java21name> 替换为其名称，将 Java 21 设置为默认版本
```
sudo update-java-alternatives --jre --set <java21name>
```
使用 java -version 确认当前默认的 Java 版本。

安装

要使用 Debian 软件包管理器 apt 安装 Neo4j，您需要将 Neo4j 存储库添加到系统的软件包源列表中，然后安装所需的 Neo4j 软件包。Debian 软件包可从 https://debian.neo4j.com 获取。

添加存储库

以 sudo 用户身份运行以下命令，将 Neo4j 存储库添加到软件包管理器中

如果 Neo4j GPG 密钥的密钥环目录尚不存在，请创建它
```
sudo mkdir -p /etc/apt/keyrings
```

下载并安装 Neo4j GPG 密钥

wget -O - https://debian.neo4j.com/neotechnology.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/neotechnology.gpg > /dev/null

确保密钥文件是全局可读的

sudo chmod a+r /etc/apt/keyrings/neotechnology.gpg

添加 Neo4j APT 存储库

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 > /dev/null

更新软件包列表
```
sudo apt-get update
```

将存储库添加到 apt 后，您可以运行以下命令验证哪些 Neo4j 版本可用

apt list -a neo4j

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

可以通过运行以下命令修复此问题

sudo add-apt-repository universe

安装 Neo4j

要安装 Neo4j，请根据您要安装的版本运行以下命令之一。请注意，版本号包含一个 epoch 版本组件 (1:)，遵循 Debian 版本控制策略。

Neo4j 社区版 (CE)
```
sudo apt-get install neo4j=1:2026.03.1
```
Neo4j 企业版 (EE)
```
sudo apt-get install neo4j-enterprise=1:2026.03.1
```
在安装开始之前，系统会提示您接受商业许可协议或评估许可协议。您对许可协议提示的回答将被记住，以便在同一系统的后续安装中使用。

要忘记存储的回答，并触发后续安装时的许可协议提示，请使用 debconf-communicate 清除存储的回答
```
echo purge | sudo debconf-communicate neo4j-enterprise
```
如果您需要非交互式安装 Neo4j 企业版，可以使用 debconf-set-selections 表明您已阅读并接受许可协议
```
echo "neo4j-enterprise neo4j/accept-license select Accept commercial license" | sudo debconf-set-selections
```

离线安装

如果您由于防火墙等原因无法访问 https://debian.neo4j.com，则需要通过拥有相关访问权限的另一台机器获取 Neo4j，然后手动移动该软件包。

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

Cypher Shell 软件包可以从 Neo4j 部署中心下载。
有关受支持 Java 版本的信息，请参阅系统要求。

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

Neo4j 社区版

curl -O https://dist.neo4j.org/deb/neo4j_2026.03.1_all.deb

Neo4j 企业版

curl -O https://dist.neo4j.org/deb/neo4j-enterprise_2026.03.1_all.deb

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

dpkg --contents neo4j_2026.03.1_all.deb

手动将下载的 Debian 软件包移动到离线机器。
在离线机器上运行以下命令以安装 Neo4j
```
sudo dpkg -i <deb file name>
```

文件位置

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

操作

大多数 Neo4j 配置都在 neo4j.conf 中进行。

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

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

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

环境变量	默认值	详细信息
NEO4J_SHUTDOWN_TIMEOUT	120	等待 Neo4j 停止的超时时间（以秒为单位）。如果所用时间超过此值，则视为关机失败。如果系统处理长时间运行的事务，可能需要增加此值。
NEO4J_ULIMIT_NOFILE	60000	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 社区版不包含可视化、数据探索和监控等图工具。但是，您可以免费使用 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

请按照以下步骤卸载 Neo4j

(可选) 创建备份以避免数据丢失。
运行以下命令卸载 Neo4j
```
sudo apt remove neo4j
```