Hermes WebUI Docker 部署指南：20 分钟跑通聊天、会话与文件管理

Hermes WebUI Docker 部署指南20 分钟跑通聊天、会话与文件管理【免费下载链接】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 界面在浏览器或手机里就能对话、回看会话、管理项目文件。本教程面向第一次用 Docker 部署它的你单容器方案约 20 分钟跑通多容器扩展与生产加固再各留 5 分钟。部署完成后的样子启动成功后打开 http://localhost:8787你会看到三栏主界面左侧会话列表、中间对话区、右侧工作区文件树。会话历史与项目文件都落在宿主机的两个目录里容器只是入口随时可以重建。准备工作3 项检查一张表过完检查项命令通过标准Docker 引擎可用docker --version输出一行版本号Compose 插件可用docker compose version输出版本号Linux 提示命令不存在时需单独安装拿到宿主用户身份id -u和id -g各得一个数字。macOS 常见 501Linux 常见 1000首次启动一条命令拉起来 拉取仓库并复制配置模板git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui cp .env.docker.example .env.env只改三处UID/GID填上一步查到的两个数字再取消注释设置强密码UID1000 GID1000 HERMES_WEBUI_PASSWORDchange-me-to-something-strong然后启动首次会自动构建镜像约 3 分钟docker compose up -d预期结果命令安静结束docker compose ps里 hermes-webui 状态为 Up浏览器打开 http://localhost:8787 出现登录页和三栏界面。没起来就用docker compose logs -f hermes-webui看实时日志权限与端口类问题都会直接给出原因。数据持久化删容器不丢会话 原理一句话compose 把~/.hermes会话、配置、状态和~/workspace项目文件两个目录挂进容器数据始终写在宿主机容器删了重建都不影响。想换存储位置先设变量再启动之后的写入都进新目录export HERMES_HOME/data/hermes export HERMES_WORKSPACE/data/projects docker compose up -d备份就一条命令建议配成每周任务并放到另一块磁盘tar -czf hermes-backup-$(date %Y%m%d).tar.gz ~/.hermes/进阶扩展双容器与三容器怎么选 ⚙️仓库预置两套编排切换都是一条命令docker compose -f docker-compose.two-container.yml up -d docker compose -f docker-compose.three-container.yml up -d双容器把网关CLI、定时任务、消息通道与聊天界面拆成两个容器适合要跑定时任务、或需要故障隔离的团队。单容器没有网关守护进程做调度定时任务会一直待命——这是最典型的升级理由。启用后记得在.env设一个 16 字符以上的API_SERVER_KEY网关 API8642 端口才会对 WebUI 开放。三容器在双容器基础上多一个 9119 端口的监控仪表盘适合需要资源占用与会话量运维视角的团队。起步建议先跑单容器验证功能确有需要再升级多容器默认用命名卷UID/GID 权限问题从结构上被消掉。生产加固3 条硬性建议 给容器设资源上限在 compose 的hermes-webui服务下追加三容器文件里 agent 服务已内置同款配置可直接照抄数值deploy: resources: limits: memory: 4G cpus: 2.0锁住访问入口端口要暴露到局域网或公网时两个条件缺一不可——.env设置HERMES_WEBUI_PASSWORD且ports保留127.0.0.1:前缀确需远程访问时套一层反代。没有密码的开放端口等于把 Agent 的执行权交出去。每月回收磁盘跑docker system prune -a --volumes清理无用镜像与悬空卷执行前确认没有正在使用的容器。运维速查表场景命令说明看状态与端口docker compose ps确认 hermes-webui 为 Up看实时日志docker compose logs -f hermes-webuiCtrlC 退出停止服务docker compose down数据卷保留启动服务docker compose up -d后台运行升级到新版本git pull后docker compose down docker compose up -d --build有短暂中断挑低峰期执行故障排查速查 症状常见原因解决办法启动时报端口冲突8787 已被占用ports左侧改成空闲端口如127.0.0.1:8888:8787重新docker compose up -d容器内的 8787 不动日志 Permission denied、工作区显示为空容器 UID 与宿主文件属主不一致.env设UID$(id -u)、GID$(id -g)后重建容器提示.env: permission denied启动钩子把凭据文件强制成 0600与宿主的 0640 冲突.env加HERMES_SKIP_CHMOD1或HERMES_HOME_MODE0640WebUI 提示 config.yaml not found用 sudo 启动${HOME}被展开成 /root用自己的用户跑 compose必须用 sudo 时配绝对路径并加-E定时任务创建了却不触发单容器缺少网关守护进程做 60 秒一跳的调度换双容器编排并设 16 字符以上的API_SERVER_KEY对话返回 429 配额错误服务商限流按错误卡片指引充值、等待额度窗口重置或切换服务商部署后3 个验证任务新建会话问它当前工作区里有哪些文件——确认右侧工作区确实接的是你的项目目录。给这条会话改个标题再用顶部搜索框把它找回来——熟悉会话管理。把一个文件拖进输入框让它总结——体会文件浏览器与 Agent 的组合。更细的内容有两处完整部署参考见 docs/docker.md更多故障模式与排错手法见 docs/troubleshooting.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），仅供参考