Hermes Agent容器化部署15分钟跑通【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agentHermes Agent是一个能自己长技能的AI代理支持CLI、消息网关、定时任务和子代理。本文带你用Docker Compose把它装进容器挂好数据目录配好用户权限做完你有一条命令拉起服务的部署能力不用再手动折腾Python、Node这些依赖。前置检查硬性依赖只有两个Docker Engine 20.10 和 Docker Compose v2。跑一条命令确认docker --version docker compose version输出了两个版本号就行缺什么按Docker官方文档装这里不展开。分步实战拉取代码先拿到源码镜像会直接从仓库里的Dockerfile构建依赖层都有缓存设计构建速度比想象快。git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent写Compose文件在项目根目录建docker-compose.yml核心就三件事本地构建镜像、挂数据卷、声明重启策略。services: hermes-agent: build: . # 直接用仓库里的 Dockerfile 构建 image: hermes-agent:latest volumes: - ./hermes-data:/opt/data # 数据卷挂到宿主目录容器重建不丢 environment: - HERMES_UID1000 # 匹配你宿主用户UID解决文件权限 ports: - 8642:8642 # Dashboard端口按需保留 restart: unless-stopped这里让容器把宿主机目录映射进/opt/data所有配置、会话、记忆都落在这一卷里改配置不用重启容器。构建并启动docker compose up -d --build docker compose psps里hermes-agent状态为running即构建成功。首次构建会拉取基础镜像并编译依赖耐心等待。验证服务进容器跑两条命令确认agent可用。docker compose exec hermes-agent hermes --version docker compose exec hermes-agent hermes doctordoctor输出无报错即跑通。注意别手动source虚拟环境镜像已把venv的bin写进PATH。挂载持久化目录上面volumes已经挂上了/opt/data。如果你之前是裸跑docker run现在补上挂载后老数据拷进./hermes-data目录再docker compose up -d即可无缝切换。原理点睛镜像里跑服务的是非root的hermes用户默认UID 10000启动钩子会按HERMES_UID重映射用户并chown数据卷所以这个环境变量不是可选项是权限正确性的前提。另外代码目录/opt/hermes被烤成只读可变状态全部收进/opt/data这就是只挂一个卷的原因。细节可看 Dockerfile。踩坑速查现象容器重建后配置和会话全丢。原因/opt/data没挂卷状态留在容器层里。 修复补上Compose里的volumes段docker compose up -d。现象exec进去写文件后服务读不到报权限错误。原因直接exec默认以root写文件而服务进程是hermes用户。 修复走镜像内置的hermes入口命令它会自动降权执行或设HERMES_UID$(id -u)重建容器。现象容器内让agent执行docker命令失败。原因agent的docker后端需要宿主机docker socket镜像已带docker-cli但没有socket。 修复Compose加一行- /var/run/docker.sock:/var/run/docker.sock后重启。收尾到这里服务已在容器里稳定跑着数据、权限、升级三件事都有着落。后续想接消息网关或多开profile在同一Compose里加service或环境变量即可。【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考