---
title: Docker Desktop 无法启动
summary: 首次运行时最常见的故障：HeartBeatAgents 需要 Docker Desktop 处于运行状态，才能启动任何智能体。
date: 2026-09-03
---

# Docker Desktop 无法启动

首次运行时最常见的故障：HeartBeatAgents 需要 Docker Desktop 处于运行状态，才能启动任何智能体。

HeartBeatAgents 使用 Docker 来隔离每个智能体的执行环境（参见[安全](/zh/docs/guides/security)）：这在所有平台上都是一项硬性要求，而非可选项。如果应用在启动时卡住，或智能体无法启动，最有可能的原因就是 Docker 尚未运行。

## 检查 Docker Desktop 是否确实在运行

在系统托盘（Windows）或菜单栏（macOS）中查找 Docker 鲸鱼图标。如果没有看到，请手动启动 Docker Desktop，并等待其显示“Docker Desktop is running”后再重新打开 HeartBeatAgents。

## 常见原因

- **未启用虚拟化**：在 Windows 上，Docker Desktop 需要 WSL 2 或 Hyper-V。请在 Windows 功能中检查“虚拟机平台”和“适用于 Linux 的 Windows 子系统”是否已启用。
- **资源不足**：Docker Desktop 自身的设置（首选项 → 资源）会限制其可使用的 CPU/内存上限。如果设置得过低，容器在负载下可能会启动失败。
- **先前的 Docker 进程未正常退出**：请完全重启 Docker Desktop（从系统托盘/菜单栏图标退出，而不仅仅是关闭窗口），而不是在一个卡住的实例上重新启动。

## 仍然无法解决？

请查看 Docker Desktop 自身的诊断日志（Docker Desktop → Troubleshoot → Get support）。大多数启动失败发生在 Docker 层面，而非 HeartBeatAgents 层面，Docker 自身的诊断通常会准确指出具体原因。

## 相关内容

- [安装](/zh/docs/getting-started/installation)：Docker Desktop 前提条件
- [系统要求](/zh/docs/getting-started/system-requirements)：支持的平台和架构