Hermes Agent 怎么容器化部署?Docker Compose 快速上手完整指南

Hermes Agent 怎么容器化部署?Docker Compose 快速上手完整指南 Hermes Agent 怎么容器化部署Docker Compose 快速上手完整指南【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Agent 是一个自带学习闭环的 AI 代理它会从经验中生成技能、跨会话记住你的偏好还能通过 Telegram、Discord 等渠道随时对话。用 Hermes Agent Docker 部署一条命令就能在隔离环境里跑起完整的代理栈不污染宿主机升级回滚都干净利落。正在被环境依赖折腾把 Hermes Agent 搬进容器如果你正在遇到这些情况本机 Python、Node 版本和 Hermes 要求打架装一次坏一次想给代理开一个随便执行命令的沙箱又不放心直接跑在宿主机上换了台机器之前的配置、记忆、技能全丢容器化就是最省心的解法。Hermes Agent 仓库自带 Dockerfile镜像基于 Debian 13 Python 3.13 Node 26内置 s6-overlay 进程管理主进程、Web 面板和消息网关都会被自动拉起和守护。数据统一落在/opt/data卷里容器可以随时销毁重建状态不受影响。部署前快速自检Docker 环境前提清单检查项要求Docker Engine20.10Docker Composev2磁盘空间≥ 20 GB首次构建含 Node、Python、Playwright 依赖权限用户在 docker 组或有 sudo跑两条命令确认docker --version docker compose version都正常输出就可以继续。构建过程会拉取并编译依赖官方 CI 里一次完整构建约 15~45 分钟所以第一遍 build 慢是正常的之后有层缓存就快了。Hermes Agent Docker 最小可运行配置克隆仓库在根目录写一个docker-compose.yml这就是能直接跑通的完整配置git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agentservices: hermes: build: . # 使用仓库根目录的 Dockerfile image: hermes-agent:local container_name: hermes volumes: - hermes-data:/opt/data # 配置、记忆、技能、会话数据都持久化在这里 environment: - HERMES_UID1000 # 改成宿主机用户 UID避免挂载卷权限问题 - HERMES_GID1000 restart: unless-stopped # 主进程挂了 s6 会拉起容器整体也自动重启 volumes: hermes-data:要点HERMES_UID/HERMES_GID用id -u和id -g查宿主机用户容器启动钩子会自动把数据卷 chown 到对应用户用命名卷hermes-data而不是绑定挂载权限问题最少API 密钥通过环境变量或 .env.example 里列出的变量注入不要写进镜像然后docker compose up -d --build docker compose exec hermes hermes # 进容器直接开始对话第一次进 CLI 后用hermes setup走一遍配置向导选模型、开工具或hermes doctor自检依赖是否齐全。按需选配按场景调整 Hermes Agent 容器场景做法限制 CPU / 内存compose 里加deploy.resources.limits如cpus: 2、memory: 4G让代理用 Docker 后端执行命令挂载宿主 Docker 套接字- /var/run/docker.sock:/var/run/docker.sock镜像已内置 docker-cli仅信任环境启用接入模型/搜索/TTS 等密钥参照 .env.example 设置对应环境变量或用 Docker secrets启用网关健康指标导出镜像已内置 OTLP 支持按变量说明接入你的 Collector多配置文件profile网关容器内 s6 会为每个 profile 动态注册网关服务重启后自动恢复无需额外配置容器生命周期管理启动、日志、停止与更新命令表操作命令构建并启动docker compose up -d --build实时看日志docker compose logs -f hermes进容器执行命令docker compose exec hermes hermes gateway start停止保留数据docker compose stop停止并删除容器数据卷仍在docker compose down升级git pull docker compose up -d --build彻底清理含数据卷慎用docker compose down -vdocker exec进容器执行hermes时会自动降权到 hermes 用户不会把数据卷里的文件写成 root 属主这点镜像已处理。Hermes Agent Docker 部署故障速查表症状原因解法数据目录出现 Permission denied容器内 UID默认 10000和宿主机用户不一致设置HERMES_UID/HERMES_GID为宿主机用户 ID 后重建容器首次构建特别慢需要装 Node、Python、Playwright 浏览器等大依赖15~45 分钟属正常重跑可命中缓存docker compose exec里找不到 hermes没用 compose 的 PATH 环境用docker compose exec hermes hermes ...镜像已把可执行文件挂到 PATH 前部容器反复重启主进程启动即崩溃docker compose logs -f hermes看 s6 日志多为配置或密钥问题先docker compose run --rm hermes hermes doctor自检安全边界容器化运行的几条底线默认非 root 运行镜像内置 hermes 用户UID 10000别用--user root覆盖安装目录只读/opt/hermes在发布镜像中密封为只读可写状态只允许落在/opt/data运行期不会偷偷改依赖密钥走环境变量API 密钥用 env 或 secrets 注入不进镜像、不进 compose 文件提交最小挂载只在需要 docker 终端后端时才挂docker.sock它等于把宿主 Docker 权限交给了容器定期重建git pull后重新构建及时拿到基础镜像和依赖的安全修复跑通之后Hermes Agent 的记忆、技能和配置都安稳地躺在hermes-data卷里——删容器、换机器、升级版本都不受影响。下一步可以看看 Dockerfile 里的构建细节或按 README.md 把 Telegram、Discord 网关接上让代理从终端扩展到你的手机。【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考