安装

Neo4j Desktop 可免费下载安装，并附带 Neo4j Enterprise Edition 开发者许可证。该许可证让您能够使用 Neo4j Enterprise Edition 的全部功能和特性，唯一限制是只能由您本人在单台机器上使用。

系统要求

表 1. 软件要求

macOS

10.10+ (Yosemite)

Ubuntu

22.04

Debian

11

Windows

Windows 10，使用 PowerShell 5.1 以上

Desktop 捆绑了最新的 Neo4j Enterprise Edition DBMS 版本以及该 DBMS 所需的 Java JDK 版本。对于 macOS，不会预先捆绑，而是在需要时运行时下载。

下载并安装

Neo4j Desktop 可在 Neo4j 部署中心获取，支持 macOS、Linux 和 Windows。

前往 部署中心 下载，然后参见下文说明

第一步，在 Downloads 文件夹中找到 .dmg 文件并双击。此操作将打开 Neo4j Desktop 安装程序。

第二步，将 Neo4j Desktop 拖拽到 Applications 文件夹。

最后，打开 Applications 文件夹，双击 Neo4j 图标启动 Neo4j Desktop。

第一步，定位新下载的 Neo4j Desktop 的 AppImage 文件。通过运行以下命令 chmod +x FILE_NAME 为文件添加可执行权限。第二步，双击下载的文件以启动 Neo4j Desktop 应用。

第一步，找到新下载的文件并双击以开始安装。随后按照屏幕上的步骤完成安装。

代理设置

有时您需要使用代理来访问互联网或外部网站。Desktop 可在侧边栏的 Settings 菜单中配置代理设置。设置代理共有三种方式

  • HTTP

  • 本地 PAC 文件

  • 远程 PAC 文件

默认情况下，设置为 No Proxy，若系统已配置代理则使用系统代理。要配置代理，请点击 Create proxy 按钮并相应设置。

自定义数据路径

如果需要将数据存放在其他位置，可以设置自定义数据路径。这需要将环境变量 NEO4J_DESKTOP_DATA_PATH 设置为您希望的目录。请注意，已有的实例不会自动迁移到新位置。当前路径可在实例卡上查看，详情请参见 Data path。

设置/取消自定义数据路径

设置时

  1. 创建一个新的 LaunchAgent plist 文件，/$HOME/Library/LaunchAgents/com.neo4j.desktop2.plist

  2. 编辑该文件，填入自定义路径

    <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
    "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
     <key>Label</key>
     <string>com.neo4j.desktop2.env</string>

     <key>ProgramArguments</key>
     <array>
       <string>/Applications/Neo4j Desktop 2.app/Contents/MacOS/Neo4j Desktop 2</string>
     </array>

     <key>EnvironmentVariables</key>
     <dict>
       <key>NEO4J_DESKTOP_DATA_PATH</key>
       <string>/[your custom path]/</string>
     </dict>

     <key>RunAtLoad</key>
     <true/>
   </dict>
   </plist>

  3. 在终端或您选择的命令行 Shell 中使用 launchctl 加载该 plist

    launchctl load ~/Library/LaunchAgents/com.neo4j.desktop2.plist

  4. 重新启动 Desktop

取消设置（即恢复为默认）

launchctl unload ~/Library/LaunchAgents/com.neo4j.desktop2.plist

在 .bashrc 或 .zshrc 中添加以下行

export NEO4J_DESKTOP_DATA_PATH=<path to custom location>

或者，在启动应用时提供路径

NEO4J_DESKTOP_DATA_PATH=<path to custom location> ./path/to/neo4j-desktop-2*.AppImage

要取消（即恢复默认），请从 .bashrc 或 .zshrc 中删除该行并重新加载终端。或者，若采用第二种方式，启动 Desktop 时不设置该环境变量即可。

  1. 使用 Windows 键，查找 Environment Variables（环境变量），然后选择 Edit the system environment variables（编辑系统环境变量）。

  2. 点击 Environment Variables 按钮，新增一个用户变量或系统变量，名称为 NEO4J_DESKTOP_DATA_PATH，值设为您自定义的路径，例如 C:\Your\Custom\Path。

  3. 点击 OK 关闭所有对话框。

  4. 重新启动 Desktop

从 Desktop 1.x 克隆实例

Desktop 2.x 能检测到您在 Desktop 1.x 安装中已有的实例，并提供将其克隆至 Desktop 2.x 的选项。该功能位于侧边栏的 Settings 菜单中。Desktop 2.x 与 DBMS 版本 5.1.0 及以上兼容。如若使用的 DBMS 版本早于 5.1.0，需先在 Desktop 1.x 中升级后才能克隆至 Desktop 2.x。

clone
图 1. 从 Desktop 1.x 克隆实例

卸载 Desktop

要彻底卸载 Desktop，除了删除应用本身外，还需手动清除 Desktop 数据路径中的内容。该路径可在实例卡上查看，详情请见 Data path。默认路径因平台而异，且通常是隐藏的。

/$HOME/Library/Application Support/neo4j-desktop/Application/*
$HOME/.config/neo4j-desktop/Application/
C:\%USERPROFILE%\.Neo4jDesktop2\