Hermes WebUI 三容器部署完整指南Agent WebUI Dashboard 用 Docker Compose 一次跑通【免费下载链接】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却被一堆容器配置卡住Hermes WebUI 的三容器部署方案用 Docker Compose 把 Agent、WebUI、Dashboard 一键部署起来全程不用手写配置照着做大约三分钟就能跑完。为什么把 Hermes WebUI 拆成三个容器解耦每个组件单独一个容器出问题只重启对应的那一个。资源隔离各服务内存、CPU 有明确配额谁忙谁慢互不拖累。可单独扩展只想多开 WebUI 或 Dashboard 实例不用动 Agent。免手动配置Docker Compose 一次把网络和卷都接好实现一键部署。⚡ 三分钟跑起来Docker Compose 一键启动命令先对照下表确认机器条件都满足就直接执行下面两条命令。项目最低要求Docker Engine20.10Docker Compose2.0可用内存4GB磁盘空间10GB网络用于拉取 Docker 镜像git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui这条命令把项目下载到本地并进入目录部署文件 docker-compose.three-container.yml 就在里面。docker compose -f docker-compose.three-container.yml up -d这条命令拉取所需镜像并在后台启动三个容器首次运行要等几分钟取决于网速。三个容器只用两个镜像nousresearch/hermes-agent:latestAgent 和 Dashboard 共用和ghcr.io/nesquena/hermes-webui:latestWeb 界面。端口与容器速查表容器职责端口是否只绑定本机hermes-agent核心代理提供 API 和工具支持127.0.0.1:8642是hermes-webuiWeb 聊天界面127.0.0.1:8787是hermes-dashboard系统监控面板127.0.0.1:9119是三个容器通过 Docker Compose 创建的内部网络通信互相按容器名调用不需要对外暴露端口。数据则靠hermes-home、hermes-agent-src两个命名卷在容器间共享配置、会话和状态因此保持一致。✅ 启动后先做这 3 项健康检查浏览器打开 http://localhost:8787 聊天页应能加载左侧是会话列表右侧是工作区文件面板。打开 http://localhost:9119 Dashboard 的 System health 区域能看到 CPU、内存、磁盘的实时占用。翻一遍日志对三个容器分别执行docker logs末尾没有报错即正常。 三个建议改的配置设置访问密码。准备远程访问的话先给 WebUI 加上密码保护写进.env即可。echo HERMES_WEBUI_PASSWORDyour-secure-password .env这条命令把访问密码写入.env改完后重建容器生效。UID/GID 对齐宿主用户。挂载宿主机目录时容器内用户和宿主机用户不一致会读写不了文件把 UID/GID 设成你自己的。echo UID$(id -u) .env echo GID$(id -g) .env这条命令查出宿主机用户的 UID 和 GID 并写入.env三个容器之后就以这个身份访问文件。自定义工作目录。WebUI 默认用${HOME}/workspace当工作目录想指向自己的项目目录设一个环境变量就行。export HERMES_WORKSPACE/path/to/your/workspace这条命令在启动前指定工作目录WebUI 会把它挂进容器在页面里直接浏览和编辑这些文件。 日常运维三件事看日志、升级步骤、备份数据看日志docker logs hermes-agent这条命令输出 Agent 的日志末尾的容器名换成hermes-webui或hermes-dashboard即可看另外两个。升级步骤hermes-agent-src卷在首次启动时初始化之后 Docker 会一直复用旧内容所以升级前要先删掉它再按顺序执行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这条命令组依次停止服务、删除旧源码卷、拉取最新镜像、重新启动漏掉删卷那步新版 Agent 不会生效。备份数据配置、会话和记忆都放在hermes-home卷里把它打包出来就是一次完整备份。docker run --rm -v hermes-webui_hermes-home:/source -v $(pwd):/backup alpine tar -czf /backup/hermes-backup.tar.gz -C /source .这条命令把卷内容打包成当前目录下的 tar.gz 文件妥善保存即可。 遇到问题先查这张表症状先查什么Permission denied.env里 UID/GID 是否已设置、是否与宿主机用户一致端口被占、服务起不来8642、8787、9119 是否被占用改 docker-compose.three-container.yml 里的端口映射运行缓慢宿主机可用内存是否充足建议 4GB 以上拉镜像很慢重跑一次up -d或检查网络与镜像源设置跑通之后你的 Hermes Agent 就能在浏览器和手机里随时使用了后续维护就是上面这套看日志、升级、备份的固定动作。想深入了解架构设计往下看参考文档。参考文档架构文档ARCHITECTURE.md部署文件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），仅供参考