Hermes WebUI Docker 部署完整指南从单容器到生产环境的落地路径【免费下载链接】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 是为 Hermes Agent 打造的浏览器/手机 Web 界面左侧会话列表、中间对话区、右侧工作区支持文件预览与拖拽。本文覆盖 Hermes WebUI Docker 部署的完整路径从环境检查到生产环境加固。怎么把它跑起来Hermes WebUI 是一个 Python 编写的 Web 服务手动安装要自己处理 Python 版本、依赖包与端口占用容器化安装后这些琐事全部封进镜像你只需维护一个编排文件。先做两项环境预检docker --version docker compose version各输出一行版本号即过关。Compose 插件 Docker Desktop 自带Linux 上若提示找不到命令需单独安装。接着拉取代码并生成配置git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui cp .env.docker.example .env仓库里已备好 Dockerfile 与三套编排文件无需另装任何运行时依赖。打开.env核对三个关键值UID/GID必须与宿主机一致运行id -u和id -g实测后填入端口默认映射127.0.0.1:8787:8787本机被占用时改到空闲端口HERMES_WEBUI_PASSWORD建议一开始就设置尤其是端口要对外暴露时。然后启动docker compose up -d-d表示后台运行首次执行会先构建镜像耗时几分钟。打开浏览器访问http://localhost:8787看到左侧会话列表、中间对话区、右侧工作区的三栏界面即部署成功若没起来用下面的命令实时滚动日志定位根因docker compose logs -f hermes-webui数据怎么不丢删除容器时容器内部的东西会一并消失。Hermes WebUI 用两个卷挂载化解这个问题${HERMES_HOME:-${HOME}/.hermes}:/home/hermeswebui/.hermes存放会话记录、配置与系统状态${HERMES_WORKSPACE:-${HOME}/workspace}:/workspace对应界面右侧的工作区文件。容器内的一切变化都写回宿主机这两个目录删除或重启容器数据不丢。想把数据收进其他分区覆盖变量再启动即可export HERMES_HOME/data/hermes/config export HERMES_WORKSPACE/data/projects docker compose up -d数据卷备份只需一条命令$(date %Y%m%d)自动带上日期建议配合定时任务每周执行并把备份文件放到另一块磁盘tar -czf hermes-backup-$(date %Y%m%d).tar.gz ~/.hermes/怎么长期用得好日常三件套与升级顺序docker compose ps # 容器状态与端口映射 docker compose logs -f hermes-webui # 实时日志 docker compose down # 优雅停止数据卷保留升级时按此顺序执行先拉新代码再重建镜像最后重启git pull docker compose down docker compose up -d --build⚠️ 升级期间服务会短暂中断建议挑低峰期执行。从单容器到多容器一个升级决策点单容器够用就不必动。团队使用或需要更高隔离性时仓库预置了两套进阶编排切换成本只有一条命令双容器docker-compose.two-container.yml把聊天界面与 Hermes 网关拆成两个容器网关承担 CLI、定时任务等后台工作一边崩溃不牵连另一边资源也能分开限制三容器docker-compose.three-container.yml在此之上增加监控仪表盘用于查看系统状态、资源占用与日志聚合适合需要运维视角的团队。建议先跑单容器验证功能确有需要再升级起步就上三容器会扩大排障面。生产环境加固三件事给容器设资源上限防止异常进程吃满宿主机内存在docker-compose.yml的hermes-webui服务下追加deploy: resources: limits: memory: 2G cpus: 1.0锁住访问入口⚠️ 若把端口暴露给局域网或公网必须同时设置HERMES_WEBUI_PASSWORD并保留ports里的127.0.0.1前缀。没有密码的暴露端口等于把终端权限交到陌生人手里。定期清理回收镜像与悬空卷会随时间膨胀每月执行一次执行前确认没有正在运行的容器docker system prune -a --volumes出问题了怎么办高频问题集中在下表其中端口冲突处理是启动阶段最常见的先看表定位再动手现象原因与处理启动时报端口冲突8787 被占用。只改docker-compose.yml中ports映射冒号左侧为空闲端口如127.0.0.1:8888:8787容器内部的 8787 不要动再执行docker compose up -d挂载目录无法写入、保存失败UID/GID 与宿主机不一致。回到.env核对id -u与id -g的输出修改后重启容器macOS 上 UID 通常从 501 起步而非 Linux 常见的 1000务必实测。仍不生效时检查日志中是否有 chmod 相关报错使用中弹出 429 限流界面会直接给出错误卡片列出三条出路充值、等待额度窗口重置、切换其他服务商展开卡片还能看到 HTTP 状态码与错误类型便于判断走哪条路部署完成后立刻做的三件事先别急着研究全部设置让 AI 做几件真事来验证链路新建一个会话问它当前工作区里有哪些文件——验证右侧工作区是否与你挂载的项目目录联动给这次对话打一个标签再用顶部搜索框把它找回来——熟悉会话管理把一个文件拖进对话窗口让它总结内容——体会文件浏览器 AI的组合。需要更深入的细节时看官方文档Docker 部署的完整参考在 docs/docker.md高频问题的排查方法在 docs/troubleshooting.md设计理念在 docs/why-hermes.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），仅供参考