Hermes Agent Docker 部署实战：Docker Compose 十分钟跑通全流程

Hermes Agent Docker 部署实战：Docker Compose 十分钟跑通全流程

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent

Hermes Agent 是一个会跟着你成长的个人 AI 代理，同一套内核同时驱动 CLI、Telegram/Discord 等消息网关、定时任务和真实终端。在裸机上装它，你大概率要先和 Python 版本、Node 版本、系统库冲突搏斗一轮。换个思路：把整个运行环境装进容器，一条命令拉起整套环境，这就是 Hermes Agent 的容器化部署路线。

为什么不让依赖直接在宿主机上跑

把这件事想象成住酒店：你的行李（配置和代码）挂在门后，房间里的设备（Python、Node、浏览器内核）全部由酒店提供。Hermes Agent 的终端后端原生支持local、docker、ssh、modal、singularity等多种模式，选 docker 意味着代理执行命令时默认落进隔离容器——既省得你本机装环境，又让危险命令被沙箱住。环境一致性、资源控制、版本回滚，这三件事容器顺手都办了。

30 秒把 Hermes Agent 容器跑起来

先花十秒确认工具链到位：

docker --version # 需要 20.10+ docker compose version # 需要 v2+

版本没问题就直接拉代码启动，别纠结细节，先让它跑：

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent docker compose up -d docker compose logs -f hermes-agent # 看到正常输出即可 Ctrl+C

第一条命令拿源码，第二条启动容器，第三条盯日志确认服务活着。此时你的 Hermes Agent 已经在容器里待命了。

左侧的会话列表就是部署成功后的样子：Cron 定时任务、各消息平台、Webui 会话各归其位。

配置里最值得看懂的三行

Hermes Agent 的行为开关集中在~/.hermes/config.yaml，其中和容器化部署直接相关的只有三行：

terminal: backend: "docker" # 命令在隔离容器里执行 docker_image: "python:3.11" # 指定沙箱用的镜像 cwd: "/app" # 容器内工作目录

• backend: "docker"：告诉代理"别碰宿主机的终端"，所有命令进沙箱。什么时候改？你想回归本机执行时切回local即可。
• docker_image：沙箱的基础环境。你的代理任务需要什么运行时就换什么镜像。
• cwd：代理干活的地方。挂载项目目录时，这里要和挂载点对上，否则代理"找不到文件"。

进阶选项菜单：按需取用，不必照抄

下面三个增强项各对应一种真实场景，对号入座即可。

多用户并发，加资源限制——防止代理任务吃满 CPU：

deploy: resources: limits: cpus: '2' memory: 4G

要被外部访问，才映射端口——比如挂了 Web 界面时加ports: - "8000:8000"，纯命令行用法完全不用碰这一节。

权限报错了，再映射用户 ID——加上user: "${UID}:${GID}"，启动前export UID=$(id -u) && export GID=$(id -g)。单人开发机默认 root 跑容器也够用，不必提前优化。

我踩过的三个坑，直接抄答案

坑一：文件权限报错现象：容器里写文件报 Permission denied。 原因：容器内进程用户和宿主机文件属主对不上。 解决：按上一节映射 UID/GID，或统一chown挂载目录。

坑二：重启后配置全丢现象：docker compose down再up，代理像失忆一样。 原因：~/.hermes没挂出来，配置随容器销毁。 解决： volumes 里加- ~/.hermes:/root/.hermes，数据持久化靠的就是这一行。

坑三：升级后行为异常现象：git pull后容器表现和文档对不上。 原因：旧容器还在跑旧代码，没重建。 解决：docker compose up -d --build重建，平时用docker compose exec hermes-agent bash进容器内验证状态。

下一步

到这里，Hermes Agent 的 Docker Compose 部署已经从零走到了可维护：环境隔离、配置持久化、升级重建都各归其位。建议的下一步只有一件事——往~/.hermes/config.yaml里补上你要用的消息平台密钥，然后丢给它一个真实任务，看看这位"会成长的代理"接得怎么样。

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent