需启用docker后端模式以实现强隔离与跨设备一致性，步骤包括验证docker环境、配置启动参数、拉取运行官方镜像、compose编排及构建自定义镜像。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在隔离环境中运行Hermes Agent并确保跨设备行为一致，则需启用其Docker后端模式。该模式通过容器命名空间实现文件系统、网络与进程的强隔离，避免依赖冲突与系统级干扰。以下是具体部署步骤：
一、验证Docker运行时环境
Docker后端依赖本地Docker引擎正常工作，且当前用户具备容器操作权限。缺失任一条件将导致Agent无法初始化Docker终端会话。
1、执行命令检查Docker守护进程是否活跃：sudo systemctl is-active docker
2、确认当前用户已加入docker组：groups | grep docker
3、若未加入，执行添加操作并重新登录：sudo usermod -aG docker $USER
二、配置Docker后端启动参数
Hermes Agent通过terminal.docker_image配置项指定运行时镜像，支持直接使用预构建镜像或自定义构建，确保运行环境与预期完全一致。
1、编辑environments/default.yaml，在terminal:节点下添加配置：
docker_image: "nousresearch/hermes-agent:latest"
2、设置挂载路径以持久化记忆数据：docker_volumes: ["~/.hermes:/root/.hermes"]
3、启用网络桥接模式以复用宿主机代理配置：docker_network_mode: "host"
三、拉取并运行官方Docker镜像
跳过本地构建环节，直接获取经测试的可信镜像，适用于快速验证Docker后端功能可用性及基础交互流程。
1、从Docker Hub拉取最新稳定版镜像：docker pull nousresearch/hermes-agent:latest
2、启动容器并绑定必要资源：docker run -d --name hermes-docker --restart unless-stopped -v ~/.hermes:/root/.hermes -p 3000:3000 nousresearch/hermes-agent:latest
3、进入容器执行终端初始化：docker exec -it hermes-docker hermes --terminal docker
四、基于Docker Compose声明式编排
当需集成日志收集、监控探针或配套服务（如Prometheus exporter）时，Docker Compose可统一管理网络拓扑、卷挂载与环境变量，提升部署可复现性。
1、创建docker-compose.yml文件，定义服务依赖关系：
version: '3.8'\nservices:\n hermes-docker:\n image: nousresearch/hermes-agent:latest\n container_name: hermes-docker\n restart: unless-stopped\n ports: ["3000:3000"]\n volumes: ["hermes-data:/root/.hermes"]\n environment:\n - HERMES_MODEL_PROVIDER=deepseek\n - TZ=Asia/Shanghai\nvolumes:\n hermes-data:
2、执行编排启动：docker compose up -d
3、确认容器状态与网络就绪：docker compose ps | grep running
五、构建并注入自定义Docker镜像
针对边缘设备或安全合规场景，需剔除非必要组件、嵌入定制CA证书或启用seccomp策略，此时应基于源码构建专属镜像，确保最小攻击面与策略可控性。
1、克隆源码仓库并切换至稳定分支：git clone https://gitcode.com/GitHub_Trending/he/hermes-agent && cd hermes-agent
2、修改Dockerfile基础层为alpine:3.20并禁用交互式shell：
FROM alpine:3.20\nRUN apk add --no-cache openjdk17-jre-headless\nCOPY hermes-agent.jar /app.jar\nENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]
3、构建带签名标签的镜像：docker build -t hermes-agent:edge-202604 --build-arg BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ') .
4、运行时强制启用只读根文件系统：docker run --read-only --tmpfs /tmp --tmpfs /run -v ~/.hermes:/root/.hermes hermes-agent:edge-202604
