macOS 安装

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

安装并启动 Neo4j

您可以通过下载并解压 TAR 归档文件，或者使用 Homebrew 包管理器在 macOS 上安装 Neo4j。

使用 TAR 归档文件安装 Neo4j

  1. 从 Neo4j 部署中心下载 Linux / Mac 可执行文件 2026.03.1 (tar) 版本。

  2. 使用 tar -xf <filename> 命令或通过双击文件来解压归档内容。

  3. 将解压后的文件放置在服务器上的永久主目录下，并设置环境变量 NEO4J_HOME 指向该目录（例如，export NEO4J_HOME=/path/to/_<NEO4J_HOME>），以便日后引用。

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

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

  5. 企业版 (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。

  6. 在首次启动数据库之前，建议使用 neo4j-admin 的 set-initial-password 命令为原生用户 neo4j 设置密码。

    如果未通过此方法显式设置密码，系统将使用默认密码 neo4j。在这种情况下，您将在首次登录时被要求更改默认密码。
    更多信息，请参阅设置初始密码。

  7. 启动 Neo4j

    • 要以控制台应用程序运行 Neo4j，请使用：$NEO4J_HOME/bin/neo4j console。

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

将 Neo4j 安装为 macOS 服务

在 macOS 上将 Neo4j 安装为服务的最简单方法是使用 Homebrew 包管理器（请参阅 Homebrew 安装指南）。

  1. 使用 Homebrew 安装 Neo4j

    brew install neo4j

    此命令将安装 Neo4j 社区版并将其设置为可以使用 Homebrew 管理的服务。

  2. （推荐）如果您想更改默认目录或其他设置，可以在位于 /opt/homebrew/Cellar/neo4j/2026.03.1/libexec/conf/neo4j.conf 的 neo4j.conf 文件中进行修改。如果服务已经启动，对配置文件的更改需要使用 brew services restart neo4j 重启 Neo4j 服务后才会生效。

  3. 启动 Neo4j macOS 服务

    brew services start neo4j

    此命令将启动 Neo4j 服务，并将其设置为在系统启动时自动运行。

  4. 要检查 Neo4j 服务的状态，请使用

    brew services list

或者，如果您想安装 Neo4j 企业版或更倾向于使用原生的服务控制方式，可以使用标准的 macOS 系统工具（如 launchd）基于 neo4j 命令创建服务。

访问 Neo4j

默认情况下，Neo4j 社区版不包含可视化、数据探索和监控等图工具。但是，您可以免费使用 Neo4j Aura 控制台访问这些功能。无需订阅。

  1. 注册或登录 Aura 控制台。

  2. 在实例 (Instances) 页面上，单击 Self-managed 选项卡，然后单击 + Add deployment 按钮。

  3. 选择 URL Connection。

  4. 提供名称 (Name) 和连接 URL (Connection URL)。如果您已在本地安装了 Neo4j，则可以连接到 bolt://:7687。

  5. 单击 Connect 下拉菜单以启动各种图工具，例如 Query、Explore 和 Dashboards。

  6. 输入用户名 neo4j 和您的密码或默认密码 neo4j。在首次登录时，系统将提示您更改默认密码。

    Aura add self-managed deployment

现在您已连接，可以使用 Aura 控制台运行 Cypher 查询、可视化图表，并可选择在 Neo4j Aura 中监控本地 Neo4j 数据库。详情请参阅 Neo4j 入门。

或者，您可以使用 Neo4j Browser，这是 Neo4j 安装附带的一个基于 Web 的交互界面。要访问 Neo4j Browser，请打开 Web 浏览器并导航至 https://:7474。使用用户名 neo4j 和您的密码或默认密码 neo4j 进行连接。如果使用默认密码，系统将在首次登录时提示您进行更改。

日志记录

Neo4j 日志写入 NEO4J_HOME 下的 logs 目录。有关日志文件的详细信息，请参阅日志记录。

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

macOS 文件描述符限制

如果数据库有许多索引或有大量数据库连接，可能需要增加打开文件描述符的限制。您可以使用 launchctl limit maxfiles 命令查看 macOS 系统当前配置的打开文件描述符限制。更改限制的方法可能因 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