主机资讯与使用指南

Hermes Agent VPS 部署：Docker 安装、初始化与消息网关

使用 Hermes 官方 Docker 镜像初始化模型和渠道，将数据保存到宿主机并运行消息网关。

先安装 Docker，再准备模型凭据

Hermes Agent 的 Docker 方式适合已经有 Docker 的 Linux VPS。模型通过配置的提供方调用，本文不部署本地大模型。准备好模型凭据；需要通过 Telegram 等渠道使用时，再准备对应渠道的 token。

建立数据目录并进入设置

mkdir -p ~/.hermes
sudo docker run -it --rm -v "$HOME/.hermes:/opt/data" nousresearch/hermes-agent setup

setup 进入交互设置，按提示选择模型与渠道。/opt/data 是容器内数据位置，宿主机 ~/.hermes 用于保留配置；临时设置容器结束后，这个目录仍需保留。

启动长期运行的网关

sudo docker run -d --name hermes --restart unless-stopped -v "$HOME/.hermes:/opt/data" nousresearch/hermes-agent gateway run
sudo docker logs --tail=100 hermes

向已配置的消息渠道发送一条简单任务，查看是否能收到回复。首次拉取镜像需要连接镜像仓库；若容器退出，先阅读日志，再检查凭据和配置目录权限。

不需要 API 服务时，不添加端口映射

消息网关通过渠道连接工作，示例没有向公网发布 API 端口。官方文档中的可选 API 服务需另外启用，只有确实要接入它时才配置监听与访问方式。

这里采用官方镜像默认标签。长期运行可记录实际镜像版本，在升级前备份数据目录，避免无法回到之前的环境。

更新时保留配置目录

拉取新版后重新建立容器时，继续挂载同一个 ~/.hermes。容器本身可以替换，模型凭据、渠道配置和会话数据不能随容器一并丢弃。