
别重装了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 WebUI 多容器部署就是来解决这件事的Agent、聊天界面、监控面板一个 compose 文件全部拉起浏览器里直接用。下面按顺序带你走一遍。✅ 部署前快速体检Docker Compose 部署 Hermes 之前先对一下这三条硬指标✅ 软件Docker Engine 20.10 与 Docker Compose 2.0✅ 硬件至少 4GB 可用内存、10GB 以上可用磁盘✅ 网络能拉取镜像仓库的镜像首次启动会慢一些正常终端里敲docker compose version能输出版本号就说明这一关过了。接下来拉代码这条命令帮你把项目源码拉到本地并进入目录git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui跑完你就站在了 compose 文件所在的项目根目录里。一张图看懂三个容器容器就是隔离好的程序环境各自一套文件系统互相看不见对方的内存。Hermes WebUI 多容器部署拆成三个hermes-agent— 网关服务接管所有 API 请求和定时任务监听 8642 端口默认仅本机可访问hermes-webui— 浏览器里的聊天界面监听 8787 端口hermes-dashboard— 监控面板看健康状态和资源用量监听 9119 端口Hermes WebUI 端口说明就这一句8642 是内部通信用的你只需要记住 8787 和 9119。整套部署只依赖这一份 compose 文件不用手动配服务——记住端口号其他交给 compose。配置文件只看这几行docker-compose.three-container.yml 不必通读关键的只有这几行image: nousresearch/hermes-agent:latest # agent 与 dashboard 用同一镜像 - 127.0.0.1:8787:8787 # webui 端口聊天界面 - 127.0.0.1:9119:9119 # dashboard 端口监控面板 - hermes-home:/home/hermes/.hermes # 共享数据卷共享磁盘容器删了数据还在 # …其余字段省略完整文件见仓库镜像名决定每个容器里跑什么软件两条端口映射决定你浏览器访问的地址hermes-home 是三个容器共用的数据卷所以无论从哪个界面登录会话和配置都一致。 三步跑起来启动在项目目录直接敲这条命令拉取缺失的镜像并在后台把三个容器全部启动首次可能要几分钟结束后你会看到每个容器对应的 Started 字样docker compose -f docker-compose.three-container.yml up -d访问聊天界面浏览器打开http://localhost:8787你会看到左侧会话列表、中间聊天区、右侧工作区文件若弹出登录页说明你之前设过访问密码。看健康状态再打开http://localhost:9119CPU、内存、磁盘占用一目了然健康项正常即代表部署完成。默认不够用只动这几处如果默认配置不满足你只动这几个地方——都通过环境变量设置compose 文件本身不用改你的场景改哪里怎么改工作区文件想放别的目录HERMES_WORKSPACE启动前export HERMES_WORKSPACE/你的目录默认是${HOME}/workspace文件操作 Permission deniedUID/GIDecho UID$(id -u) .env同理加 GID 一行重启服务聊天界面要开放给远程机器HERMES_WEBUI_PASSWORDecho HERMES_WEBUI_PASSWORD强密码 .env端口默认锁本机踩坑速查 维护备忘出问题先别慌照表查。WebUI 自带日志页但排查跨容器问题时直接看容器日志更快现象原因一条命令搞定Permission denied 起不来宿主机 UID/GID 与容器不一致echo UID$(id -u) .env docker compose -f docker-compose.three-container.yml up -d端口冲突 up 失败8787 或 9119 被占用改 compose 里的端口映射或docker compose -f docker-compose.three-container.yml down释放WebUI 提示 agent 无响应网关 8642 没起API_SERVER_KEY未设在.env写入至少 16 位的 key再docker compose -f docker-compose.three-container.yml up -d升级到新版本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 up -d备份会话与配置重要数据都在hermes-home卷里docker run --rm -v hermes-webui_hermes-home:/source -v $(pwd):/backup alpine tar -czf /backup/hermes-backup.tar.gz -C /source .接下来可以做什么想深入看容器内部细节和官方升级流程→ docs/docker.md想了解三个容器的分工与通信方式→ ARCHITECTURE.md想动手写自己的 Hermes Agent 配置教程、验证每个行为→ 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),仅供参考