---
title: 自托管
summary: 通过 Docker 在你自己的基础设施上运行 HeartBeatAgents，而不是使用桌面安装方式。
date: 2026-09-11
---

# 自托管

通过 Docker 在你自己的基础设施上运行 HeartBeatAgents，而不是使用桌面安装方式。

HeartBeatAgents 的本地优先设计（参见[安全](/zh/docs/guides/security)）自然而然地延伸到了在你自己的服务器而非桌面设备上运行：无论哪种方式，采用的都是相同的容器化隔离模型。

## 要求

自托管使用与桌面安装程序相同的基于 Docker 的部署方式（参见[安装](/zh/docs/getting-started/installation)和[系统要求](/zh/docs/getting-started/system-requirements)）：一个可同时用于 x64 和 arm64 Linux 主机的 Docker 镜像。

## 验证你所运行的内容

Docker 镜像通过 GitHub OIDC 使用 `cosign` 签名，因此你可以在部署前验证其来源：这一点在 HeartBeatAgents 在你所负责的基础设施上无人值守运行时尤为重要。出于同样的原因，每个下载文件也都附带 SHA-256 校验和。

## 为什么选择自托管

- **数据驻留**：自托管部署不会将数据发送到 HeartBeatAgents 本身尚未保留的任何地方：你的设备（或你的服务器）就是“数据中心”。
- **团队级访问控制**：位于你自己网络边界之内的自托管实例，可让你在 HeartBeatAgents 自身按智能体划分的 API 密钥之上，叠加你现有的基础设施访问控制。
- **常驻在线的常驻指令**：服务器托管的实例可以持续运行，以支持按计划/cron 触发的[常驻指令](/zh/docs/features/standing-orders)，而夜间会休眠的笔记本电脑则无法做到这一点。

## 对外暴露

如果你需要从自己的网络之外访问自托管实例（例如用于基于 webhook 的集成），请使用 Cloudflare 隧道，而不是直接开放入站端口。

## 备份

除非你另行配置，否则自托管实例就是一切数据的唯一副本。有关快照、复制到你自己存储桶的异地复制，以及为什么恢复工具包而非单纯的复制才是让备份能够在不同硬件上恢复的关键，请参见[备份与恢复](/zh/docs/features/backup-recovery)。

## 相关内容

- [安全](/zh/docs/guides/security)：无论部署在哪里都同样成立的隔离保证
- [高级配置](/zh/docs/guides/advanced-configuration)：在你的实例运行起来后进一步调整其行为