Windows 安装

在 Windows 上安装 Neo4j 之前，请检查系统要求以确认您的设置是否适用。

Windows 控制台应用程序

如果尚未安装，请获取 OpenJDK 21 或 Oracle Java 21。
从 Neo4j 部署中心下载最新版本。

选择相应的 ZIP 分发包。
检查下载文件的 SHA 哈希值是否正确
1. 要查找正确的 SHA 哈希值，请前往 Neo4j 部署中心并点击您下载文件下方的 SHA-256。
2. 使用适用于您平台的相应命令，显示您下载文件的 SHA-256 哈希值。
3. 确保两者相同。
右键点击下载的文件，然后点击 全部提取。
将提取的文件放置在服务器上的永久位置，并设置环境变量 NEO4J_HOME 指向提取的目录，例如 export NEO4J_HOME=\path\to\_<NEO4J_HOME>，以便将来更方便引用。

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

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

在运行 Neo4j 企业版之前，请接受商业许可协议或评估许可协议。如果您使用的是社区版，可以跳过此步骤。
- 使用以下选项之一接受商业许可协议。有关可用协议的详细信息，请参阅 Neo4j 许可页面。
  - 使用 set NEO4J_ACCEPT_LICENSE_AGREEMENT=yes 将其设置为环境变量。
  - 运行 $NEO4J_HOME\bin\neo4j-admin server license --accept-commercial
- 使用以下选项之一接受 Neo4j 软件评估协议。
  - 使用 set 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 windows-service install。有关其他命令以及了解 Zip 文件中包含的 Windows PowerShell 模块，请参阅Windows PowerShell 模块。
在您的网络浏览器中打开 http://localhost:7474。
使用用户名 neo4j 和您的密码或默认密码 neo4j 进行连接。然后系统会提示您更改密码。
在控制台中输入 Ctrl-C 停止服务器。

Windows 服务

Neo4j 也可以作为 Windows 服务运行。

默认情况下，Neo4j Windows 服务以 LocalSystem 账户运行，该账户对系统拥有完全访问权限。这存在安全风险，建议将服务作为没有完全 LocalSystem 权限的用户运行。

安装 Windows 服务

使用 bin\neo4j windows-service install 安装服务，并使用 bin\neo4j start 启动它。

bin\neo4j 可用的命令有：version、help、console、start、stop、restart、status 和 windows-service。

安装新版本的 Neo4j 时，必须首先对任何先前安装的版本运行 bin\neo4j windows-service uninstall。

更改 Windows 服务配置

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

同样适用于系统上 Java 的安装路径。如果路径发生变化，例如升级到新版本的 Java 时，有必要运行 update-service 命令并重新启动服务。然后，服务将使用新的 Java 位置。

示例 1. 更新服务示例

安装服务
```
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

更新服务
```
bin\neo4j windows-service update
```
重启服务
```
bin\neo4j restart
```

Windows PowerShell 模块

Neo4j PowerShell 模块允许管理员：

安装、启动和停止 Neo4j Windows® 服务。
启动工具，例如 Neo4j Admin 和 Cypher Shell。

PowerShell 模块作为 Neo4j ZIP 文件分发包的一部分进行安装。

系统要求

需要 PowerShell v2.0 或更高版本。
支持 32 位或 64 位操作系统。

在 Windows 上管理 Neo4j

在 Windows 上，有时需要在导入下载的 ZIP 文件作为模块之前对其进行取消阻止操作。

右键点击 ZIP 文件，然后选择属性。
将出现一个带有取消阻止按钮的对话框。
点击取消阻止按钮以启用模块导入。

系统上必须启用运行脚本。例如，这可以通过从提升的 PowerShell 提示符执行以下命令来实现：
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
```
有关更多信息，请参阅关于执行策略。

如果 PowerShell 模块检测到您没有管理员权限，它会显示警告。

导入模块文件

模块文件位于 Neo4j 安装目录的 bin 目录中。

假设 Neo4j 安装在 C:\Neo4j 中，运行以下命令导入模块：
```
Import-Module C:\Neo4j\bin\Neo4j-Management.psd1
```
这会将模块添加到当前会话。
导入模块后，您可以启动 Neo4j 服务器的交互式控制台版本：
```
Invoke-Neo4j console
```

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

检查模块

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

Get-Command -Module Neo4j-Management

输出应类似于：

CommandType     Name                                Version    Source
-----------     ----                                -------    ------
Function        Invoke-Neo4j                        2025.05.0      Neo4j-Management
Function        Invoke-Neo4jAdmin                   2025.05.0      Neo4j-Management
Function        Invoke-Neo4jBackup                  2025.05.0      Neo4j-Management
Function        Invoke-Neo4jImport                  2025.05.0      Neo4j-Management
Function        Invoke-Neo4jShell                   2025.05.0      Neo4j-Management

该模块还支持标准的 PowerShell 帮助命令：

Get-Help Invoke-Neo4j

运行以下命令查看帮助命令的示例：

Get-Help Invoke-Neo4j -examples

使用示例

可用命令列表
```
Invoke-Neo4j
```
Neo4j 服务的当前状态
```
Invoke-Neo4j status
```
安装服务并显示详细输出
```
Invoke-Neo4j windows-service -Verbose
```
管理任务可用命令
```
Invoke-Neo4jAdmin
```

常见 PowerShell 参数

模块命令支持 Verbose 这一常见 PowerShell 参数。

卸载 Neo4j

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

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

卸载 Neo4j Windows 服务

---
bin\neo4j windows-service uninstall
---

删除 NEO4J_HOME
```
---
rmdir NEO4J_HOME
---
```