如何在Docker中部署Hermes Agent

  发布时间:2026-05-19 10:34:02   作者:小锋学长生活大爆炸   我要评论
本文给大家介绍在Docker中部署Hermes Agent的方法,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧

如果这是你第一次运行 Hermes Agent,请在主机上创建一个数据目录,并以交互方式启动容器以运行设置向导:

mkdir -p ~/.hermes
docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent setup

/opt/data 卷是 Hermes 所有状态的唯一数据源。它映射到主机上的 ~/.hermes/ 目录,并包含:

Path 内容
.envAPI 密钥和密钥
config.yaml所有Hermes的配置
SOUL.md Agent个性/身份
sessions/对话历史
memories/持久内存存储
skills/已安装技能
cron/计划作业定义
hooks/事件钩子
logs/运行时日志
skins/自定义 CLI  skins

切勿同时对同一数据目录运行两个 Hermes 网关容器——会话文件和内存存储并非设计用于并发写入访问。与网关并行运行仪表盘容器是安全的,因为仪表盘仅读取数据。

这将引导你进入设置向导,该向导会提示你输入 API 密钥并将其写入 ~/.hermes/.env 文件。你只需执行此操作一次。强烈建议你此时为网关设置一个聊天系统。

配置完成后,将容器作为持久网关在后台运行。

创建 hermes目录,并在里面创建 docker-compose.yaml:

mkdir  -p  ~/hermes
cd  ~/hermes
vim  docker-compose.yaml

写入以下内容:

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    command: gateway run
    ports:
      - "8642:8642"
    volumes:
      - ~/.hermes:/opt/data
    networks:
      - hermes-net
    deploy:
      resources:
        limits:
          memory: 4G
          cpus: "2.0"
  dashboard:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-dashboard
    restart: unless-stopped
    command: dashboard --host 0.0.0.0
    ports:
      - "9119:9119"
    volumes:
      - ~/.hermes:/opt/data
    environment:
      - GATEWAY_HEALTH_URL=http://hermes:8642
    networks:
      - hermes-net
    depends_on:
      - hermes
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: "0.5"
networks:
  hermes-net:
    driver: bridge
  • 如果不需要dashboard (比如只是Channel访问),可以把上面dashboard那部分给删了。
  • 端口 8642 暴露了网关的OpenAI 兼容 API 服务器和健康检查端点。如果你仅使用聊天平台(例如 Telegram、Discord 等),则此端口为可选;但如果你希望仪表盘或外部工具能够访问网关,则此端口为必需。在面向互联网的计算机上打开任何端口都存在安全风险。除非你了解这些风险,否则不应这样做。
Environment variableDescriptionDefault
GATEWAY_HEALTH_URL网关 API 服务器的基本 URL,例如 http://gateway:8642(未设置 — 仅进行本地 PID 检查)
GATEWAY_HEALTH_TIMEOUT健康探测超时时间(秒)3
  • 如果没有 GATEWAY_HEALTH_URL ,仪表板将回退到本地进程检测——这仅在网关在同一容器或同一主机上运行时才有效

然后构建镜像:

docker compose down
docker compose up -d 

可以监控启动日志:

docker compose logs -f

要针对正在运行的数据目录打开交互式聊天会话:

docker run -it --rm \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent

到此这篇关于在Docker中部署Hermes Agent的文章就介绍到这了,更多相关Docker部署Hermes Agent内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!

相关文章

最新评论