Hermes WebUI 三容器部署AgentDashboardWebUI 一键搭建端口 8787 完整指南【免费下载链接】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想在浏览器里用上 Hermes Agent 并配好监控面板用官方提供的三容器 Compose 方案一条docker compose命令即可把 Agent、WebUI、Dashboard 全部拉起本文带你从克隆仓库到验证成功全程免踩坑。30 秒环境自检前提确认方式Docker Engine 20.10 且 Compose 插件可用docker compose version至少 4GB 可用内存Agent 容器限额 4Gfree -h或 Docker Desktop 设置里查看10GB 以上可用磁盘镜像卷df -h能拉取镜像ghcr.io 与 Docker Hubdocker pull ghcr.io/nesquena/hermes-webui:latest试拉未占用端口 8787 / 9119 / 8642ss -lntp | grep -E 8787|9119|8642核心部署流程准备克隆仓库并拉取镜像只需两步拿到部署所需的一切三个 compose 文件就放在仓库根目录git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui docker compose -f docker-compose.three-container.yml pull启动一键启动全部服务执行下面这条命令即可拉起全部服务docker compose -f docker-compose.three-container.yml up -d首次运行会自动拉取镜像需要几分钟。三个服务分工如下服务镜像来源角色端口hermes-agentnousresearch/hermes-agent:latest网关 APICLI、Telegram、cron、工具执行8642hermes-webuighcr.io/nesquena/hermes-webui:latest浏览器聊天界面8787hermes-dashboardnousresearch/hermes-agent:latest系统监控面板9119三者通过命名卷hermes-home共享配置、会话与状态hermes-agent-src卷存放 Agent 源码供 WebUI 启动时安装依赖默认全部绑定 127.0.0.1无需额外网络暴露。验证打开哪个地址算成功打开 http://localhost:8787 看到左侧会话列表、中间聊天区、右侧工作区文件面板的三栏界面说明 WebUI 部署成功图 1Hermes WebUI 部署完成后的会话界面左侧会话列表、中间聊天区、右侧工作区文件再打开 http://localhost:9119 看到 CPU、内存、磁盘的资源面板说明 Dashboard 也正常接入图 2Dashboard 系统健康监控界面显示 CPU、内存和磁盘使用情况按需调优三容器方案默认用命名卷绕开 UID/GID 问题多数情况无需改配置。以下三项按需加到仓库根目录的.env文件中改完执行docker compose -f docker-compose.three-container.yml up -d使变量生效即可。自定义工作目录echo HERMES_WORKSPACE/path/to/your/project .env对齐主机用户 UID/GIDecho UID$(id -u) .env echo GID$(id -g) .env开启 WebUI 访问密码端口要暴露到局域网或远程时必须设密码echo HERMES_WEBUI_PASSWORDyour-secure-password .env日常运维速查看日志docker logs hermes-agent docker logs hermes-webui备份数据核心数据都在hermes-home卷里docker run --rm -v hermes-webui_hermes-home:/source -v $(pwd):/backup alpine tar -czf /backup/hermes-backup.tar.gz -C /source .升级 Agent 镜像注意hermes-agent-src卷会缓存旧源码必须删掉再重建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遇到问题怎么办现象原因一条命令/操作启动报PermissionError或 workspace 里文件是空的绑定挂载的目录属主与容器内 UID 不一致echo UID$(id -u) .env后重建容器WebUI 提示 Hermes agent is not responding8642 网关未开启Agent 需要 16 位以上的 API_SERVER_KEY 才会监听在.env加API_SERVER_KEY填 16 字符再重建日志页打不开或看不到日志内容容器还没起来或 Dashboard 网关探针失败docker compose -f docker-compose.three-container.yml ps看哪个容器没 Running远程机器访问 Dashboard默认只绑 127.0.0.1.env加HERMES_DASHBOARD_BIND0.0.0.0并把 Dashboard 放到反向代理/认证后面WebUI 内置的日志面板也可以直接查系统事件图 3WebUI 日志查看界面显示系统事件和错误信息总结三容器方案让你用一条命令获得隔离的 Agent 网关、聊天界面和监控面板共享卷保证状态一致升级与备份都有明确路径。延伸阅读Docker 完整参考docs/docker.md三容器 Compose 配置docker-compose.three-container.yml部署回归测试tests/【免费下载链接】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），仅供参考