Windows 安装

在您在 Windows 上安装 Neo4j 之前,请查看 系统要求 以查看您的设置是否合适。

Windows 控制台应用程序

  1. 如果尚未安装,请获取 OpenJDK 17Oracle Java 17。从版本 5.14 开始,Neo4j 还支持 JDK 21。

  2. Neo4j 部署中心 下载最新版本。

    选择合适的 ZIP 分发版。

  3. 检查下载文件的 SHA 哈希是否正确

    1. 要查找正确的 SHA 哈希,请转到 Neo4j 部署中心并单击 SHA-256,它位于您的下载文件下方。

    2. 使用适合您平台的命令,显示您下载文件的 SHA-256 哈希值。

    3. 确保两者完全相同。

  4. 右键单击下载的文件,然后单击全部解压缩

  5. 将解压缩的文件放置在服务器上的永久位置,并将环境变量 NEO4J_HOME 设置为指向解压缩的目录,例如 export NEO4J_HOME=/path/to/_<NEO4J_HOME>,以便以后更容易引用它。

  6. 从 Neo4j 5.4 开始,您需要在运行 Neo4j 企业版之前接受商业许可协议或评估许可协议。如果您使用的是社区版,则可以跳过此步骤。

    • 使用以下选项之一接受商业许可协议。有关可用协议的详细信息,请参阅 Neo4j 许可 页面。

      • 使用 set NEO4J_ACCEPT_LICENSE_AGREEMENT=yes 将其设置为环境变量。

      • 运行 $NEO4J_HOME\bin\neo4j-admin server license --accept-commercial

    • 使用以下选项之一接受 Neo4j 软件的 Neo4j 评估协议.

      • 使用 set NEO4J_ACCEPT_LICENSE_AGREEMENT=eval 将其设置为环境变量。

      • 运行 $NEO4J_HOME\bin\neo4j-admin server license --accept-evaluation.

  7. (可选) 通过设置环境变量 NEO4J_CONFserver.directories.data 将数据和配置目录与二进制文件分离,指向所需位置。 将您的数据和配置存储在独立的磁盘或分区上可以简化以后的升级过程。

  8. 在首次启动数据库之前,建议使用 neo4j-adminset-initial-password 命令定义本机用户 neo4j 的密码。

    如果未使用此方法显式设置密码,则将设置为默认密码 neo4j。 在这种情况下,系统会提示您在首次登录时更改默认密码。
    有关更多信息,请参见 设置初始密码.

  9. 启动 Neo4j

    • 要将 Neo4j 作为控制台应用程序运行,请使用:$NEO4J_HOME\bin\neo4j console

    • 要将 Neo4j 安装为服务,请使用:$NEO4J_HOME\bin\neo4j windows-service install。 有关其他命令以及了解 Zip 文件中包含的 Windows PowerShell 模块,请参见 Windows PowerShell 模块.

  10. 在您的网络浏览器中打开 http://localhost:7474.

  11. 使用用户名 neo4j 和您的密码或默认密码 neo4j 连接。 然后系统会提示您更改密码。

  12. 通过在控制台中键入 Ctrl-C 来停止服务器。

Windows 服务

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

默认情况下,Neo4j Windows 服务作为 LocalSystem 帐户运行,该帐户对系统拥有完全访问权限。 这是一个安全风险,建议将服务作为没有完全 LocalSystem 权限的用户运行。

安装 Windows 服务

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

bin\neo4j 的可用命令为:versionhelpconsolestartstoprestartstatuswindows-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. 更新服务示例
  1. 安装服务

    bin\neo4j windows-service install
  2. 更改内存配置

    echo server.memory.heap.initial_size=8g >> conf\neo4j.conf
    echo server.memory.heap.initial_size=16g >> conf\neo4j.conf
  3. 更新服务

    bin\neo4j windows-service update
  4. 重新启动服务

    bin\neo4j restart

Windows PowerShell 模块

Neo4j PowerShell 模块允许管理员

  • 安装、启动和停止 Neo4j Windows® 服务。

  • 启动工具,如 Neo4j AdminCypher Shell

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

系统要求

  • 需要 PowerShell v2.0 或更高版本。

  • 支持 32 位或 64 位操作系统。

在 Windows 上管理 Neo4j

在 Windows 上,有时需要在将下载的 ZIP 文件的内容作为模块导入之前解除阻止它。

  1. 右键单击 ZIP 文件并选择属性
    将出现一个带有解除阻止按钮的对话框。

  2. 单击解除阻止按钮以启用模块的导入。

    必须在系统上启用运行脚本。 例如,这可以通过从提升的 PowerShell 提示符执行以下操作来实现

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

    有关更多信息,请参见 关于执行策略.

如果检测到您没有管理权限,PowerShell 模块将显示警告。

导入模块文件

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

  1. 假设 Neo4j 安装在C:\Neo4j中,请运行以下命令导入模块

    Import-Module C:\Neo4j\bin\Neo4j-Management.psd1

    这将向当前会话添加模块。

  2. 导入模块后,您可以启动 Neo4j 服务器的交互式控制台版本

    Invoke-Neo4j console

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

检查模块

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

Get-Command -Module Neo4j-Management

输出应类似于以下内容

CommandType     Name                                Version    Source
-----------     ----                                -------    ------
Function        Invoke-Neo4j                        5.25.1      Neo4j-Management
Function        Invoke-Neo4jAdmin                   5.25.1      Neo4j-Management
Function        Invoke-Neo4jBackup                  5.25.1      Neo4j-Management
Function        Invoke-Neo4jImport                  5.25.1      Neo4j-Management
Function        Invoke-Neo4jShell                   5.25.1      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 参数

模块命令支持常见的 PowerShell 参数 Verbose

卸载 Neo4j

以下是卸载 Windows 上 Neo4j 的步骤

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

  2. 使用任务管理器停止所有 Neo4j 进程。

  3. 卸载 Neo4j Windows 服务

    ---
    bin\neo4j windows-service uninstall
    ---
  4. 删除NEO4J_HOME

    ---
    rmdir NEO4J_HOME
    ---