如何用 3 个容器和 5 条命令快速完成 Hermes WebUI 多容器部署：Agent + WebUI + Dashboard 教程

如何用 3 个容器和 5 条命令快速完成 Hermes WebUI 多容器部署Agent WebUI Dashboard 教程【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webuiHermes WebUI 是 Hermes Agent 的浏览器端界面让你在网页或手机上直接指挥自己的智能体。多容器部署把 Agent、WebUI、Dashboard 拆进三个独立容器各自升级互不牵连坏了只需重启那一个。照着这篇走一遍用 docker compose 一键部署后你会拿到一个开箱即用的聊天界面加一个资源监控面板。一图看懂三个容器各管什么容器之间通过 Docker 网络互访并共享同一个hermes-home命名卷所以会话、配置、技能在三处看到的是一致的。容器职责对外端口hermes-agent大脑跑 gateway负责 API、定时任务、消息通道8642默认仅本机回环hermes-webui脸面你日常打开的网页聊天界面8787hermes-dashboard体检室看会话数、Token 消耗、CPU/内存/磁盘9119动手前检查清单30 秒确认环境Docker Engine 20.10.0 及以上Docker Compose 2.0.0 及以上终端里能敲出docker compose至少 4GB 空闲内存agent 默认上限 4G至少 10GB 磁盘空间镜像 两个命名卷网络通畅能拉取nousresearch/hermes-agent与ghcr.io/nesquena/hermes-webui镜像确认无误后克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui第一步改配置——三容器编排文件里真正重要的几行三容器方案由 docker-compose.three-container.yml 定义全部细节不用逐行读抓住这几处即可services: hermes-agent: command: gateway run ports: - 127.0.0.1:8642:8642 # 默认只绑定本机远程访问需额外配置 volumes: - hermes-home:/home/hermes/.hermes # 共享状态卷 - hermes-agent-src:/opt/hermes # 源码卷WebUI 启动时读它装依赖 hermes-dashboard: command: dashboard --host 0.0.0.0 --insecure hermes-webui: ports: - 127.0.0.1:8787:8787 volumes: - ${HERMES_WORKSPACE:-${HOME}/workspace}:/workspace # 工作区目录 # 其余配置略两个默认行为值得知道三个端口都绑在127.0.0.1即只允许本机访问工作区默认指向${HOME}/workspace想换路径不用改 YAML后面会用环境变量解决。第二步一键启动三容器在仓库根目录执行docker compose -f docker-compose.three-container.yml up -d首次运行会自动拉取镜像耗时取决于带宽。三个容器都进入 Up 状态后WebUI 会在启动时从共享源码卷安装 Agent 的 Python 依赖首次启动稍慢属正常现象。第三步打开浏览器看结果聊天界面http://localhost:8787监控面板http://localhost:9119部署后验证两个地址 一条自检命令打开 Dashboard 后进入 Insights 页System health 区块会实时显示 CPU、RAM、磁盘占用能看到数字就说明 agent 到 dashboard 的健康链路是通的再用一条命令确认 WebUI 没有异常日志docker logs hermes-webui --tail 50想排查 agent 侧或定时任务把容器名换成hermes-agent或hermes-dashboard即可。Dashboard 自带日志面板支持自动刷新与整页复制进阶玩法工作目录、UID/GID 与 5 分钟配好访问密码三件事都通过.env文件完成不用动 YAML。在仓库根目录追加三行后重建容器即可生效echo HERMES_WORKSPACE/path/to/your/project .env echo UID$(id -u) .env echo GID$(id -g) .env echo HERMES_WEBUI_PASSWORD换一个强密码 .envHERMES_WORKSPACE决定 WebUI 里工作区面板看到哪个目录改前确认该目录存在UID/GID让容器内进程以你本机的用户身份写文件macOS 用户注意 UID 从 501 起步不是 1000HERMES_WEBUI_PASSWORD一旦你把 8787 端口暴露到0.0.0.0供远程访问它就是必选项。追加配置后执行一次重建让环境变量注入docker compose -f docker-compose.three-container.yml up -d踩坑速查三类高频问题一次讲清现象原因解法容器里报Permission denied或PermissionError绑定挂载目录的属主与容器内 UID 不一致按上文把id -u/id -g写入.env或干脆沿用默认的命名卷绕开宿主机权限WebUI 顶部提示 Gateway endpoint not reachable8642 端口未监听——agent 要求API_SERVER_KEY不少于 16 位才会开启该端口在.env里加一行API_SERVER_KEY16位以上密钥后重建容器服务起不来报端口占用8787/9119 已被其他程序占用改宿主机一侧映射如127.0.0.1:18787:8787然后按新端口访问容器运行缓慢或 OOM 退出宿主资源被抢占超出deploy.resources.limits上限调大 YAML 中对应服务的memory/cpus限制或关掉其他吃内存的容器升级与备份各备一段命令升级时最容易踩的坑是hermes-agent-src卷只在首次up时从镜像初始化之后 Docker 会一直复用它导致docker pull到的新镜像代码被旧卷挡住。所以升级要先删这个卷hermes-home卷存着你的会话与配置千万别删docker compose -f docker-compose.three-container.yml down docker volume rm hermes-webui_hermes-agent-src docker compose -f docker-compose.three-container.yml pull docker compose -f docker-compose.three-container.yml up -d注意卷名里的hermes-webui是 Compose 项目名默认取父目录名不确定时用docker volume ls核对。备份只关心hermes-home这一个卷用一次性容器打包即可docker run --rm -v hermes-webui_hermes-home:/source -v $(pwd):/backup alpine tar -czf /backup/hermes-home-backup.tar.gz -C /source .到这里你的 Hermes Agent 已经以三容器形态完整跑起来了聊天在 8787体检在 9119状态都沉淀在共享卷里随时可以升级或整体搬迁。参考文档docker-compose.three-container.yml、docs/docker.md、ARCHITECTURE.md【免费下载链接】hermes-webuiHermes WebUI: The best way to use Hermes Agent from the web or from your phone!项目地址: https://gitcode.com/GitHub_Trending/he/hermes-webui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考