Windows 安装

在 Windows 上安装 Neo4j 之前，请查看系统要求以确认您的环境是否适用。如果尚未安装，请获取 OracleJDK 21 或 ZuluJDK 21。从 Neo4j 2025.10 版本开始，同样支持 Java 25。

安装并启动 Neo4j

您可以通过以下方式在 Windows 上安装 Neo4j：下载并解压 ZIP 归档文件、作为 Windows 服务运行，或使用 Windows PowerShell 模块。

使用 zip 归档文件安装 Neo4j

从 Neo4j 部署中心下载 Windows 可执行文件 2026.03.1 (zip) 版本。
右键单击下载的文件，选择全部解压缩 (Extract All) 以提取归档内容。
将解压后的文件放置在服务器上的永久位置，并将环境变量 NEO4J_HOME 设置为指向该目录（例如：setx NEO4J_HOME "C:\neo4j\neo4j-<NEO4J_VERSION>"），以便日后引用。

（推荐）通过设置环境变量 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_HOME%\bin\neo4j console，以控制台应用程序的形式启动 Neo4j。

将 Neo4j 安装为 Windows 服务

您可以将 Neo4j 安装为 Windows 服务。

默认情况下，Neo4j Windows 服务以 LocalSystem 账户运行，该账户拥有对系统的完全访问权限。这存在安全风险，建议使用不具备完全 LocalSystem 特权的账户来运行该服务。

使用 services.msc 或 sc (Service Control) 命令创建 Neo4j 服务运行所用的用户账户。您可以使用现有用户账户，但该账户必须拥有 作为服务登录 (Log on as a service) 的权限。
按照使用 zip 归档文件安装 Neo4j 一节中的步骤下载并解压 ZIP 归档文件，并设置环境变量。
在命令提示符中运行以下命令以安装服务
```
%NEO4J_HOME%\bin\neo4j windows-service install
```
通过运行 %NEO4J_HOME%\bin\neo4j start 启动 Neo4j 服务。

安装新版本的 Neo4j 时，必须先在之前安装的版本上运行 %NEO4J_HOME%\bin\neo4j windows-service uninstall。然后，使用上述 install 命令安装新版本。

更改 Neo4j Windows 服务配置

当 Neo4j 作为服务安装时，Java 选项存储在服务配置文件中。如果您在服务安装后更改了任何选项或环境变量，则必须更新并重启服务以使更改生效。例如，在默认的 neo4j.conf 文件中更新 server.memory.heap.initial_size 的值，或使用 NEO4J_CONF 环境变量，不会自动应用更改。必须更新并重启服务才能应用这些设置。要更新服务，请运行 %NEO4J_HOME%\bin\neo4j windows-service update。然后重启服务以使用新配置运行。

同样适用于系统中安装 Java 的路径。如果路径发生变化（例如升级到新版本的 Java），则需要运行 %NEO4J_HOME%\bin\neo4j windows-service update 命令并重启服务。随后，服务将使用新的 Java 位置。

示例 1. 更新服务示例

安装服务

%NEO4J_HOME%\bin\neo4j windows-service install

更改内存配置

echo server.memory.heap.initial_size=8g >> conf\neo4j.conf
echo server.memory.heap.initial_size=16g >> conf\neo4j.conf

更新服务

%NEO4J_HOME%\bin\neo4j windows-service update

重启服务
```
%NEO4J_HOME%\bin\neo4j restart
```

使用 PowerShell 安装 Neo4j

Neo4j PowerShell 模块允许管理员安装、启动和停止 Neo4j Windows® 服务，并使用 Neo4j Admin 和 Cypher Shell 执行各种管理任务。PowerShell 模块作为 Neo4j ZIP 文件发行版的一部分安装。它需要 PowerShell 5.1 或更高版本（推荐 PowerShell 7.x），并支持 64 位 Windows 操作系统。

如果需要导入该模块，请解除对已下载的 Neo4j ZIP 文件的锁定
1. 右键单击 ZIP 文件并选择属性 (Properties)。
  会出现一个带有解除锁定 (Unblock) 按钮的对话框。
2. 单击解除锁定 (Unblock) 按钮以启用模块导入。
3. 单击应用 (Apply) 然后单击确定 (OK) 关闭对话框。
右键单击下载的文件，选择全部解压缩 (Extract All) 以提取归档内容。
以管理员身份运行 PowerShell 提示符，执行以下命令以启用脚本执行
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
```
更多信息，请参阅关于执行策略。

如果 PowerShell 模块检测到您没有管理员权限，它会显示警告。
设置环境变量 NEO4J_HOME 指向您安装 Neo4j 的目录。例如，假设您已将 Neo4j 安装在 C:\Neo4j 中，您可以在 PowerShell 会话中运行以下命令
```
$env:NEO4J_HOME = "C:\Neo4j"
```
通过运行以下命令导入 Neo4j PowerShell 模块
```
Import-Module $env:NEO4J_HOME\bin\Neo4j-Management.psd1
```
这将把模块添加到当前会话中。
模块导入后，您可以启动 Neo4j 服务器的交互式控制台版本
```
Invoke-Neo4j console
```

要停止服务器，请在命令创建的控制台窗口中使用 Ctrl-C。

检查模块

运行以下命令获取模块中所有可用的命令

Get-Command -Module Neo4j-Management

输出应类似于以下内容

CommandType  Name              Version    Source
-----------  ----              -------    ------
Function     Get-Args          3.0.0      Neo4j-Management
Function     Invoke-Neo4j      3.0.0      Neo4j-Management
Function     Invoke-Neo4jAdmin 3.0.0      Neo4j-Management

通过运行以下命令查看每个命令的功能，将 <command-name> 替换为您要检查的命令名称，例如 Invoke-Neo4j
```
Get-Help <command-name>
```

运行以下命令查看该命令的一些使用示例

Get-Help <command-name> -examples

表 1. 使用示例
命令	描述
`Invoke-Neo4j`	输出可用命令。
`Invoke-Neo4j status`	Neo4j 服务的当前状态。
`Invoke-Neo4j windows-service`	安装服务。
`Invoke-Neo4jAdmin`	管理任务的可用命令。

模块命令支持常见的 PowerShell 参数 Verbose。您可以将 -Verbose 添加到任何命令以获得更详细的输出。

访问 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

以下是在 Windows 上卸载 Neo4j 的步骤

（可选）创建备份以避免丢失数据。
使用任务管理器停止所有 Neo4j 进程。

卸载 Neo4j Windows 服务

%NEO4J_HOME%\bin\neo4j windows-service uninstall

删除 NEO4J_HOME
```
rmdir NEO4J_HOME
```