HeartBeatAgents

安装程序无法运行或验证失败

以 Markdown 查看

Docker 缺失、权限错误、AppImage 启动失败、端口冲突，以及签名验证问题，附各自的解决方法。

“需要 Docker 但未安装”

从 docker.com 安装 Docker Engine（Linux）或 Docker Desktop（macOS/Windows），然后用 docker info 和 docker compose version 验证。

在 Linux 上运行 Docker 提示“权限被拒绝”

你的用户尚未加入 docker 组：运行 sudo usermod -aG docker $USER，然后注销并重新登录，用 groups | grep docker 确认。

AppImage 在 Ubuntu 22.04+ 上无法启动

安装 FUSE 2 兼容库：在 Ubuntu 24.04+ 上运行 sudo apt install libfuse2t64，在 Ubuntu 22.04 上运行 sudo apt install libfuse2。如果你不想安装它，改为使用 --appimage-extract-and-run 运行该 AppImage。

端口冲突（9500、9100 或类似端口已被占用）

install.sh 会自动扫描一个空闲端口，从首选端口开始递增查找。查看 ~/.heartbeatagents/.env 以了解它实际分配了哪些端口。

GPG 签名验证失败

  1. 确认你导入了正确的公钥：gpg --list-keys --fingerprint ops@mosaicsingularity.com。预期指纹：3041 1399 8510 1531 C54B 0498 1009 78CA B0A0 5886。
  2. 如果指纹不匹配，不要信任该软件包。密钥或文件可能已被篡改。
  3. 将疑似篡改情况报告给 ops@mosaicsingularity.com。

macOS 提示应用“已损坏”或“无法打开”

由于该应用已经过 Apple 公证，这种情况不应该发生。如果你看到它：

  1. 确认你是从官方发布页面下载的，而不是镜像站点。
  2. 检查公证凭据：xcrun stapler validate HeartBeatAgents.app。
  3. 如果凭据有效但 macOS 仍然拒绝，下载文件本身很可能已损坏。重新下载并验证其 SHA256 校验和。

Windows SmartScreen 警告

安装程序使用 EV 签名，因此 SmartScreen 应该不会发出警告就接受它。如果你看到警告，在 PowerShell 中用 Get-AuthenticodeSignature HeartBeatAgents-Setup-<version>.exe 验证签名：Status 应显示 Valid，签名者应包含 Mosaic Singularity Inc。如果不是，不要运行该安装程序；将其报告给 ops@mosaicsingularity.com。

相关内容