如何 5 分钟用 Docker 部署 Hermes WebUI三种容器模式完整指南【免费下载链接】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 部署就是最省事的路子用 Docker Compose 把 Hermes WebUI 装进一个容器它就是 Hermes Agent 的网页入口负责会话、聊天和工作区管理。5 分钟从零到可访问先花 10 秒确认环境里装了 Docker 和 Compose 工具docker --version docker compose version两条命令都能输出版本号就够用了。接着克隆仓库并启动容器git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui docker compose up -d这里默认走单容器模式一个 WebUI 容器把 agent 一并跑起来agent 就是替你执行任务的 AI 程序。首次启动会自动构建镜像多等几分钟很正常。想改端口或密码也不用改 YAML把模板拷一份再编辑即可cp .env.docker.example .env浏览器打开http://localhost:8787能看到会话列表和聊天框就说明部署成功一步确认成功docker compose ps判定标准只有一条hermes-webui状态为Up端口映射显示8787→8787。状态在restarting或exited直接用下一节的命令查日志定位原因。选对模式三种容器化部署对比部署跑通后再考虑选型Hermes WebUI 提供了三套 Docker Compose 文件配置文件容器组成适合谁一句话区别docker-compose.yml1 个 WebUI 容器个人尝鲜、快速上手agent 和界面同容器最省事docker-compose.two-container.ymlagent webui想让两者故障互不拖累agent 独立成容器经共享卷通信docker-compose.three-container.ymlagent webui dashboard需要独立监控面板多一个 dashboard 容器多数人用单容器模式就够了升级时机见后文。用 .env 定制一行命令改默认端口打开 .env只有三个参数值得动参数怎么取 / 怎么设作用UID/GID执行id -u、id -g把结果填进去让容器内进程和宿主机同一身份能读写挂载的目录端口把端口映射改成127.0.0.1:8888:8787换掉默认 8787避开端口冲突HERMES_WEBUI_PASSWORD填任意你记得住的字符串给 WebUI 加登录密码端口对外暴露时必填改完保存docker compose up -d重新加载即可生效。两个关键挂载数据不随容器消失容器删了数据就没了Docker 部署里靠卷挂载解决这个问题。Hermes WebUI 默认挂两个目录.hermes会话、配置和状态数据的家宿主机默认在~/.hermesworkspace工作区文件也就是聊天界面里浏览和编辑的项目文件默认在~/.workspace同级的~/workspace。两个路径都可以用环境变量改不用动 compose 文件export HERMES_HOME/data/hermes export HERMES_WORKSPACE/data/my-workspace docker compose up -d什么时候才需要升级多容器单容器能满足绝大多数个人场景出现下面情况再考虑升级你已经在独立容器里跑 agent或希望 agent 网关和 WebUI 故障互不影响用双容器docker compose -f docker-compose.two-container.yml up -d还要一个独立的 dashboard 容器做监控管理用三容器docker compose -f docker-compose.three-container.yml up -d⚠️ 避坑清单权限报错Permission denied现象容器起不来或读写挂载目录失败原因容器内 UID/GID 与宿主机用户不一致解决.env 写入UID$(id -u)、GID$(id -g)的值再docker compose up -d端口被占用现象启动即报错提示 8787 端口已绑定原因机器上已有程序占着 8787解决把 docker-compose.yml 的映射改为127.0.0.1:8888:8787改docker compose up -d后用http://localhost:8888访问启动失败现象docker compose ps显示restarting或exited原因日志里写明了多数是挂载目录权限或 .env 拼写问题解决docker compose logs hermes-webui定位后修复再docker compose up -d维护速查docker compose logs -f hermes-webui # 跟踪实时日志 docker compose down # 停止全部容器 git pull docker compose down docker compose up -d --build # 更新到最新代码并重建 docker system prune # 清理无用镜像和容器上手之后界面分三个区域左侧是会话列表和模型选择中间是聊天框支持文字输入和文件上传右侧是工作区文件浏览器项目的文件都从这里管理个人在笔记本上开一个团队在同一台机器上共用一个都是这条最短路径能覆盖的用法。【免费下载链接】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），仅供参考