知识库

在 Linux 上排查 Neo4j Desktop 问题

此页面介绍了用户在 Linux 上运行 Neo4j Desktop 时可能遇到的常见问题。

错误:已找到 SUID 沙盒助手二进制文件,但配置不正确。

The SUID sandbox helper binary was found, but is not configured correctly.
Rather than run without sandboxing I'm aborting now.
You need to make sure that /tmp/.mount_neo4j-0qHCJ1/chrome-sandbox is owned by root and has mode 4755.

说明

Neo4j Desktop 是一个 Electron 应用程序。

Electron 使用 Linux 内核中的一项功能,该功能在某些发行版 (例如 Debian) 中被禁用。

它们针对这些情况有一个备用二进制文件,但似乎 electron-builder 使用错误的权限对其进行打包,因此出现了权限错误。

此评论 更详细地解释了这个问题。

解决方案

使用 --no-sandbox 标志执行 Neo4j Desktop (作为普通用户),或运行以下命令以启用 Electron 使用的内核功能

$ sysctl kernel.unprivileged_userns_clone=1

错误:org.freedesktop.secrets 名称未由任何 .service 文件提供。

App initialization error: Error: The name org.freedesktop.secrets was not provided by any .service files {
  constructor: 'Error',
  stack: 'Error: The name org.freedesktop.secrets was not provided by any .service files'
}

说明

Neo4j Desktop 使用系统密钥环来存储凭据。在 Linux (无论发行版或桌面环境如何) 上,这是 gnome-keyring。在之前版本中,如果没有 gnome-keyring,应用程序将无法启动。现在,如果找不到 gnome-keyring,它会切换到内置的 keyctl 实用程序。

解决方案

更新到最新的 Neo4j Desktop 或安装并启用 gnome-keyring

错误:生成 keyctl ENOENT

Error: spawn keyctl ENOENT

说明

keyctl 是一种密钥管理实用程序,在 gnome-keyring 不可用作为系统密钥环时用作后备。

此实用程序包含在大多数发行版的核心软件包中,但是如果您看到此错误,则表示您尚未安装它。

解决方案

安装 keyutilsgnome-keyring

错误:Neo4j Desktop 未显示在应用程序菜单中。

Neo4j Desktop 未显示在应用程序菜单中。

说明

Neo4j Desktop 以 AppImage 的形式分发。

解决方案

安装 AppImageLauncher 并集成 Neo4j Desktop AppImage。