Hermes Agent 部署用 Docker Compose 容器化跑通一个 AI Agent 的完整流程【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Agent 是 Nous Research 的开源 AI Agent支持终端 CLI、Telegram/Discord 等消息网关和定时任务。这篇 Hermes Agent 部署教程演示如何用 Docker Compose 容器化它宿主机零依赖配置和数据独立持久化。谁需要这样部署如果你装过 Python 项目大概率被依赖版本和系统库坑过——Hermes Agent 依赖 Python 3.11、Node、ripgrep、ffmpeg 等一整套工具链手动装很容易漏。 容器化后这些全锁在镜像里你只需要 Docker。适合想长期挂一个 Agent 在 VPS 上跑定时任务的人也适合不想污染本机环境的开发者。3 分钟跑起来第 1 步确认环境。两条命令都要有输出即可docker --version docker compose version第 2 步拿代码。项目根目录自带 Dockerfile直接基于它构建不用找外部镜像git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent第 3 步一条命令启动。首次会构建镜像并拉取依赖耐心等待几分钟docker compose up -d --build配置文件怎么写一份 compose 就够项目仓库没有现成的 compose 文件但下面这份最小配置覆盖所有关键点放进仓库根目录即可services: hermes: build: . image: hermes-agent:local container_name: hermes volumes: - hermes-data:/opt/data ports: - 8642:8642 environment: - HERMES_UID${UID:-10000} restart: unless-stopped volumes: hermes-data:关键参数说明参数默认值作用build: .—用仓库自带的 Dockerfile 构建镜像内含 Node 26、修复版 SQLite 等全部依赖HERMES_UID10000容器内非 root 用户的 UID设为宿主机用户 UID 可避免数据目录权限问题8642:8642仅本机可访问映射 dashboard 端口浏览器访问http://localhost:8642hermes-data:/opt/data命名卷配置、记忆、会话全部落在/opt/data删容器不丢数据restart无崩溃或宿主机重启后自动拉起按需进阶三个最常见的改动资源限制。什么时候需要共享机器或 Agent 长时间跑批量任务时不想让它吃满内存。deploy: resources: limits: { cpus: 2, memory: 4g }网络可达。什么时候需要想从局域网另一台设备打开 dashboard。ports: - 0.0.0.0:8642:8642数据目录改为宿主机路径。什么时候需要想直接备份或编辑数据文件。把命名卷换成~/.hermes-data:/opt/data其余不变。日常运维速查表场景命令首次构建并启动docker compose up -d --build实时看日志docker compose logs -f hermes确认容器状态docker compose ps停止服务保留数据docker compose down拉新代码后升级git pull docker compose up -d --build进入容器排查docker compose exec -it hermes bash高频坑位现象构建慢到像卡死或中途失败。原因镜像首建要下载 Python、Node 26、Playwright 浏览器等大量依赖。 解决重跑docker compose up -d --build断点续传用docker compose logs hermes观察进度。现象数据目录里的文件突然变成 root 属主服务读写报错。原因docker exec默认以 root 进容器写文件与受监管进程UID 10000冲突。 解决日常操作通过hermes命令进镜像自带降权 shim或 exec 时加-u hermes宿主机 UID 不匹配就传HERMES_UID。现象手机或同网段另一台设备打不开 dashboard。原因8642:8642只绑定在127.0.0.1。 解决改成0.0.0.0:8642:8642后docker compose up -d重建。现象重建容器后配置和记忆全没了。原因compose 里没挂hermes-data卷/opt/data随容器销毁。 解决补上卷挂载数据在命名卷里时docker compose down不会清数据只有docker volume rm才会。安全清单只从官方仓库源码构建不拉取来路不明的同名镜像保持镜像默认非 root 用户运行通过HERMES_UID对齐宿主机API 密钥写进config.yaml或.env不硬编码在 compose 文件里8642 端口不要暴露公网跨网访问走 Tailscale 或带鉴权反代设置资源上限防止失控任务占满宿主机定期git pull重建镜像同步安全补丁Hermes Agent 部署到这一步日常就是一句docker compose up -d --build的事。如果后面要加缓存或数据库配合它跑更重的流水线在同一个 compose 文件里多声明一个 service 即可。【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考