docker容器化部署是运行hermes agent的最优选择，具环境隔离、配置一致、资源可控、数据持久及一键重建等优势；需先验证docker version，再拉取轩辕加速镜像，接着用docker run单容器启动或docker-compose编排部署，并定期备份数据卷。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在隔离、可控且可复现的环境中运行 Hermes Agent，Docker 容器化部署是最优选择——它能避免系统依赖冲突、保障服务长期稳定，并支持资源精细化管控。以下是基于当前最新实践的完整部署流程：
一、容器化运行 Hermes Agent 的核心优势
Docker 部署并非仅是技术选型，而是保障 Hermes Agent 长期演化的基础设施基础。其核心价值体现在环境完全隔离、配置一次全平台生效、资源使用可精确约束、数据卷独立持久化、以及故障时一键重建能力。所有操作均不侵入宿主机系统，确保服务器上其他服务不受影响。
1、执行命令验证 Docker 是否就绪：docker version
2、若返回客户端与服务端版本信息，则说明 Docker 已正确安装并运行；否则需先完成 Docker 环境准备。
二、拉取 Hermes Agent 官方镜像（含国内加速）
为规避网络延迟与拉取失败，推荐使用轩辕镜像加速地址获取最新稳定版镜像。该镜像由 Nous Research 官方维护，标签为 latest，已适配 x86_64 与 ARM64 架构。
1、执行拉取命令：docker pull docker.xuanyuan.run/nousresearch/hermes-agent:latest
2、拉取完成后，运行 docker images | grep hermes-agent 确认镜像存在且状态正常。
三、单容器部署：使用 docker run 直接启动
该方式适用于快速验证、测试环境或轻量级生产部署，所有参数通过命令行显式声明，便于调试与审计。
1、创建本地持久化目录：mkdir -p ~/.hermes
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
2、执行容器启动命令：docker run -d --name hermes-agent --restart unless-stopped -v ~/.hermes:/root/.hermes -p 3000:3000 -e HERMES_MODEL_PROVIDER=deepseek -e HERMES_API_KEY=your-api-key nousresearch/hermes-agent:latest
3、检查容器运行状态：docker ps | grep hermes-agent，确认 STATUS 列显示 “Up”。
四、编排部署：使用 Docker Compose 管理服务
Docker Compose 提供声明式配置，将环境变量、卷挂载、端口映射、资源限制等全部集中定义于 YAML 文件中，适合生产环境长期维护与团队协作。
1、创建 docker-compose.yml 文件，内容包含 services、volumes、environment 及 deploy.resources 配置项。
2、在同一目录下创建 .env 文件，写入 HERMES_API_KEY=your-api-key，确保密钥不硬编码于 YAML 中。
3、执行启动命令：docker-compose up -d，容器将以后台模式运行并自动重启。
五、数据卷备份与恢复操作
Hermes Agent 的记忆、技能、会话历史等关键数据均存储于挂载的数据卷中，必须定期备份以防止意外丢失。备份过程不依赖容器运行状态，可离线执行。
1、执行备份命令：docker run --rm -v hermes-data:/data -v $(pwd):/backup alpine tar czf /backup/hermes-backup-$(date +%Y%m%d).tar.gz /data
2、执行恢复命令（需先停止容器）：docker run --rm -v hermes-data:/data -v $(pwd):/backup alpine tar xzf /backup/hermes-backup-20260425.tar.gz -C /
