Hermes WebUI 多容器部署实战：1 条命令跑通 Agent、聊天界面与监控面板

Hermes WebUI 多容器部署实战1 条命令跑通 Agent、聊天界面与监控面板【免费下载链接】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 部署可以简单到一条命令用 Docker Compose 做多容器部署Hermes Agent、WebUI、Dashboard 三个容器各管一段——Agent 出 APIWebUI 出聊天界面Dashboard 盯资源全部跑在本地。 一条命令启动三容器这节走完浏览器就能打开 Hermes 的聊天界面。先过一遍环境要求Docker Engine 20.10.0、Docker Compose 2.0.0、至少 4GB 内存、10GB 以上空闲磁盘加上能拉取镜像的网络。然后克隆仓库并启动git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui docker compose -f docker-compose.three-container.yml up -d首次运行会自动拉取nousresearch/hermes-agent和ghcr.io/nesquena/hermes-webui两个镜像稍等几分钟。起来之后打开两个地址验证WebUI 聊天界面http://localhost:8787Dashboard 监控面板http://localhost:9119Dashboard 的 Insights 页里System health 的 CPU、RAM、Disk 实时占用条在动说明 Agent 已启动并被成功接上再回 WebUI左侧会话列表加载出来就算齐活。三件套各管什么职责、端口、启动命令记住这张表后面排障基本只靠它。容器职责端口镜像 / 启动命令hermes-agent核心代理网关 API、定时任务、工具调用8642默认仅本机回环nousresearch/hermes-agent:latestgateway runhermes-webui浏览器聊天界面可浏览、编辑工作区文件8787ghcr.io/nesquena/hermes-webui:latesthermes-dashboard监控面板会话、用量分析、资源占用9119nousresearch/hermes-agent:latestdashboard --host 0.0.0.0 --insecure三者共用hermes-net桥接网络内部通信WebUI 经HERMES_API_URL找到 AgentDashboard 经GATEWAY_HEALTH_URL拉健康数据8642 端口默认只绑 127.0.0.1。关键配置项只读这 8 行 compose部署文件 docker-compose.three-container.yml 有 190 多行核心就这几行其余配置从略services: hermes-agent: image: nousresearch/hermes-agent:latest command: gateway run ports: [127.0.0.1:8642:8642] volumes: [hermes-home:/home/hermes/.hermes, hermes-agent-src:/opt/hermes] # hermes-dashboard 与 hermes-webui 的定义从略 volumes: [hermes-home, hermes-agent-src]两个命名卷分工明确卷挂载位置作用hermes-home三个容器共享配置、会话、技能、状态重启不丢hermes-agent-srcAgent 的 /opt/hermesWebUI 侧只读Agent 源码WebUI 启动时从中安装 Python 依赖其余是网络、资源限制和 depends_oncompose 给 agent 限了 4G 内存、2 核Dashboard 只给 512M、0.5 核。按你的需求调一调工作目录、权限与密码三项都在.env里改改完重新up -d即生效HERMES_WORKSPACE工作目录默认${HOME}/workspace你的项目放别处就指过去UID/GID跑id -u和id -g拿到值。用绑定挂载时各容器必须同权限不一致就会 Permission deniedHERMES_WEBUI_PASSWORD把 8787 开放到 127.0.0.1 之外时必设的访问密码。echo UID$(id -u) .env echo GID$(id -g) .env echo HERMES_WORKSPACE/path/to/your/workspace .env echo HERMES_WEBUI_PASSWORDyour-secure-password .env日常运维速查日志、升级与备份三条命令覆盖大部分日常操作。看日志docker logs hermes-agent、docker logs hermes-webui、docker logs hermes-dashboard出问题先看这里WebUI 里的日志页也能翻事件记录。升级down 之后先删hermes-agent-src卷再 pull 拉新镜像、重新 up。删卷是关键一步——Docker 会一直复用旧卷只 pull 不会把新镜像里的源码带进来卷名前缀默认是项目目录名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-home卷里是全部关键数据用 alpine 容器加 tar 打包带走docker run --rm -v hermes-webui_hermes-home:/source -v $(pwd):/backup \ alpine tar -czf /backup/hermes-backup.tar.gz -C /source .踩坑急救三种报错对号入座Permission denied→ 容器内 UID/GID 与宿主机不一致或状态目录被 root 初始化→ 在.env写入宿主机id -u/id -g的值。端口被占用、容器起不来→ 8787 / 9119 / 8642 与本地服务冲突 → 改 compose 里的端口映射把冒号左边的号换掉。运行缓慢、频繁 OOM→ 资源不够 → 调大deploy.resources.limits里的 memory / cpus或放宽 Docker 守护进程的资源上限。一条命令起步剩下的交给 ComposeAgent 崩了界面还在升级只动一个卷备份只带一个卷。想深入细节看 ARCHITECTURE.md、docs/docker.md 和 docs/troubleshooting.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），仅供参考