---
title: 安装程序无法运行或验证失败
summary: Docker 缺失、权限错误、AppImage 启动失败、端口冲突，以及签名验证问题，附各自的解决方法。
date: 2026-09-10
---

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

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`。

## 相关内容

- [安装](/zh/docs/getting-started/installation)：这些问题所适用的安装程序和校验和
- [Docker Desktop 无法启动](/zh/docs/troubleshooting/docker-wont-start)：能运行但无法启动的安装，区别于无法安装的情况