macOS 安装

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

Unix 控制台应用程序

  1. 如果尚未安装,请获取 OpenJDK 21ZuluJDK 21

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

    为您的平台选择合适的 tar.gz 发行版。

  3. 请务必从 Neo4j 部署中心下载 Neo4j,并始终检查下载文件的 SHA 哈希是否正确。

    1. 要查找正确的 SHA 哈希,请前往 Neo4j 部署中心并点击您下载文件下方的 SHA-256

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

    3. 确保两者一致。

  4. 使用 tar -xf <filename> 解压归档文件。例如,tar -xf neo4j-community-2025.05.0-unix.tar.gz

  5. 将提取的文件放置在服务器的永久位置,并设置环境变量 NEO4J_HOME 指向提取的目录,例如 export NEO4J_HOME=/path/to/_<NEO4J_HOME>,以便将来更方便地引用它。

  6. 通过设置环境变量 NEO4J_CONF 和相应的 server.directories.* 设置来指向所需位置,从而更改 dataconfcertificateslicensesplugins(如果您计划使用自定义插件)目录的默认位置

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

  7. 在运行 Neo4j Enterprise Edition 之前,请接受商业许可协议或评估许可协议。如果您使用的是 Community Edition,则可以跳过此步骤。

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

      • 设置环境变量 NEO4J_ACCEPT_LICENSE_AGREEMENT=yes

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

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

      • 设置环境变量 NEO4J_ACCEPT_LICENSE_AGREEMENT=eval

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

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

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

  9. 启动 Neo4j

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

    • 要在后台进程中运行 Neo4j,请使用:$NEO4J_HOME/bin/neo4j start

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

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

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

当 Neo4j 在控制台模式下运行时,日志会打印到终端。

macOS 服务

使用标准的 macOS 系统工具创建基于 neo4j 命令的服务。

macOS 文件描述符限制

如果数据库有许多索引或存在许多到数据库的连接,则可能需要增加打开文件描述符的限制。您 macOS 系统上当前配置的打开文件描述符限制可以通过 launchctl limit maxfiles 命令进行检查。更改限制的方法可能因 macOS 版本而异。请查阅您的操作系统文档以查找适当的命令。

如果将限制提高到 10240 以上,则还必须将以下设置添加到您的 neo4j.conf 文件中

server.jvm.additional=-XX:-MaxFDLimit

如果没有此设置,JVM 的文件描述符限制将不会超过 10240。但请注意,这仅适用于 macOS。在所有其他操作系统上,您应始终保持 MaxFDLimit JVM 设置启用。

卸载 Neo4j

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

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

  2. 停止所有正在运行的 Neo4j 服务

    ---
    sudo systemctl stop neo4j
    sudo systemctl disable neo4j
    ---
  3. 删除 NEO4J_HOME 和文件 /lib/systemd/system/neo4j.service

    ---
    rm /lib/systemd/system/neo4j.service
    rm -rf NEO4J_HOME
    ---
© . All rights reserved.