【零基础部署】Docker 部署 Hermes Agent 保姆级教程

Hermes Agent 是 Nous Research 推出的 AI 智能助手平台，支持对话、任务规划、工具调用等多种能力。相比直接在系统上安装，用 Docker 部署的好处是环境隔离、升级方便、不怕搞乱系统。这篇教程会带你从零开始，用 Docker 把 Hermes Agent 跑起来。

1. 前置条件

在开始之前，确保你的机器满足以下条件：

• 已安装 Docker（如果没有，可以参考我们之前的《Ubuntu 安装 Docker 保姆级教程》）
• 有一个可用的 API Key（用于连接 AI 模型）
• 有基本的终端操作能力（会执行命令就行）

验证 Docker 是否已安装：

docker --version
# 输出类似：Docker version 24.x.x, build xxxxxx

2. 拉取镜像

从 Docker Hub 拉取 Hermes Agent 的官方镜像：

docker pull nousresearch/hermes-agent:latest

镜像大约 1 到 2 GB，取决于你的网速，可能需要等几分钟。如果拉取速度很慢，建议配置镜像加速器。

3. 初始化配置

首先创建一个数据目录，用来持久化 Hermes 的配置和数据：

mkdir -p ~/.hermes

然后运行初始化命令，它会引导你完成基本配置（比如选择 AI 模型提供商、输入 API Key 等）：

docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent:latest setup

参数说明：

• -it：以交互模式运行，方便你输入配置信息
• --rm：容器退出后自动删除，不占空间
• -v ~/.hermes:/opt/data：把本地的 ~/.hermes 目录挂载到容器里，这样配置会持久保存

按照提示一步步操作即可。配置完成后，所有信息都保存在 ~/.hermes 目录下。

4. 启动 Gateway 服务

Gateway 是 Hermes 的核心服务，负责处理请求、管理会话。先创建一个 Docker 网络：

docker network create hermes-net

然后启动 Gateway：

docker run -d \
  --name hermes \
  --restart unless-stopped \
  --network hermes-net \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent:latest gateway run

参数说明：

• -d：后台运行
• --name hermes：给容器取个名字，方便后续操作
• --restart unless-stopped：除非手动停止，否则容器异常退出后会自动重启
• -p 8642:8642：把容器的 8642 端口映射到宿主机

验证是否启动成功：

docker ps

如果能看到 hermes 容器且状态是 Up，就说明启动成功了。

5. 启动 Dashboard 面板（可选）

Hermes 提供了一个 Web 面板，可以在浏览器里查看状态和管理配置：

docker run -d \
  --name hermes-dashboard \
  --restart unless-stopped \
  --network hermes-net \
  -v ~/.hermes:/opt/data \
  -p 127.0.0.1:9119:9119 \
  -e GATEWAY_HEALTH_URL=http://hermes:8642 \
  nousresearch/hermes-agent:latest dashboard --host 0.0.0.0 --insecure

这里用 127.0.0.1:9119 而不是 0.0.0.0:9119，是因为面板一般只在本机访问，不建议暴露到公网。

启动后在浏览器打开 http://localhost:9119 就能看到面板了。

6. 进入容器执行命令

有时候你需要进入容器内部执行 Hermes 的命令行操作：

# 进入容器
docker exec -it hermes bash

# 激活虚拟环境
source /opt/hermes/.venv/bin/activate

# 现在可以执行 hermes 命令了
hermes config
hermes setup

退出容器用 exit 或者 Ctrl + D。

7. 常用运维操作

# 重启服务
docker restart hermes
docker restart hermes-dashboard

# 查看日志
docker logs -f hermes

# 停止所有服务
docker stop hermes hermes-dashboard

# 修改重启策略
docker update --restart=no hermes

8. 进阶：挂载自定义工作目录

如果你希望 Hermes 能访问宿主机上的代码目录，可以在启动时多挂载一个卷：

docker stop hermes && docker rm hermes

docker run -d \
  --name hermes \
  --restart unless-stopped \
  --network hermes-net \
  -v ~/.hermes:/opt/data \
  -v ~/my-project:/workspace \
  -p 8642:8642 \
  nousresearch/hermes-agent:latest gateway run

这样在容器里就能通过 /workspace 访问你的项目代码了。

9. 小结

用 Docker 部署 Hermes Agent 的核心流程就是：拉镜像 → 初始化配置 → 启动 Gateway → 可选启动 Dashboard。整个过程不超过 10 分钟。

Docker 的好处是升级时只需要拉新镜像重新启动容器就行，不用担心依赖冲突。如果遇到问题，直接删掉容器重来也很方便，数据都保存在 ~/.hermes 里不会丢失。