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。本文带你走通 Hermes WebUI Docker部署一条命令拉起容器.env 调端口和持久化挂载三个常见坑一次解决。Hermes WebUI Docker部署三条命令跑通Docker Compose 一键启动你只需要机器上装好 Docker 和 Compose。先确认环境没问题两条命令都应能输出版本号docker --version docker compose version哪条报错就按 Docker 官方文档补齐对应组件装好回来继续。接下来把代码拿下来进到项目目录git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webuiclone 完成后目录里已带好 docker-compose.yml不用自己手写配置。如果你什么都不想改可以跳过 .env想改端口或开密码先复制一份模板出来cp .env.docker.example .env然后启动容器首次会现场构建镜像给它几分钟docker compose up -d命令返回后看一眼容器状态STATUS显示Up就正常docker compose ps最后打开浏览器访问 http://localhost:8787页面出来即成功。Hermes WebUI Docker部署按需调改端口、开密码、数据持久化挂载只想跑起来 → 本节整体跳过。下面是几个分支命中哪个做哪个。想改端口比如 8787 被占→ 编辑 docker-compose.yml把ports里冒号前的宿主机端口换掉ports: - 127.0.0.1:8888:8787 # 宿主机端口改成 8888改完docker compose up -d重跑一次即生效。想开密码保护→ 在.env里写上密码。注意只要端口放开到127.0.0.1之外这一步就是必做项省得陌生人拿到端口就能替你指挥 agentHERMES_WEBUI_PASSWORD换成你的强密码想让删容器时数据不丢→ compose 文件默认已挂好两个目录不用额外操作volumes: - ${HERMES_HOME:-${HOME}/.hermes}:/home/hermeswebui/.hermes - ${HERMES_WORKSPACE:-${HOME}/workspace}:/workspace.hermes会话、配置和状态数据默认对应宿主机的~/.hermesworkspaceWebUI 文件浏览器里展示的项目文件默认对应~/workspace目录不在默认位置的话在.env里用环境变量覆盖即可compose 文件不用动HERMES_HOME/path/to/your/.hermes HERMES_WORKSPACE/path/to/your/workspace遇到文件权限报错→ 把容器的 UID/GID 对齐到宿主机用户。macOS 的用户 ID 从 501 开始这一条基本必配echo UID$(id -u) .env echo GID$(id -g) .env升级选项从双容器到三容器单容器跑顺之后想要更强隔离或监控仓库里还有两份现成 compose 文件可以切换。双容器agent webui把 agent 和 webui 拆成两个独立容器适合想把 gateway 和聊天界面隔离开、或 agent 本来就在单独容器里跑的用户docker compose -f docker-compose.two-container.yml up -d三容器agent webui dashboard在双容器基础上多加一个 dashboard看 agent 活动和资源占用聊天仍在 http://localhost:8787监控面板在 http://localhost:9119docker compose -f docker-compose.three-container.yml up -d两种方案默认用命名卷开箱即用。完整选型表和升级流程见 完整 Docker 文档。 日常运维命令速查日常维护基本就这四件事# 看实时日志CtrlC 退出 docker compose logs -f hermes-webui # 停止并删除容器挂载目录里的数据不受影响 docker compose down # 更新到最新代码并重建 git pull docker compose down docker compose up -d --build # 清理无用镜像和容器 docker system prunedown只删容器宿主机的.hermes和workspace都还在数据不会跟着丢。⚠️ 常见坑速解权限、端口冲突、启动失败文件访问权限报错症状容器读挂载文件报Permission denied或页面起不来修复.env里补上UID$(id -u)和GID$(id -g)再docker compose up -d --build重建验证docker compose ps状态为Up浏览器打开 8787 文件能正常读写8787 端口冲突症状启动时报Bind for 127.0.0.1:8787 failed: port is already allocated修复docker-compose.yml 里把映射改成127.0.0.1:8888:8787写法见上面改端口分支验证浏览器访问 http://localhost:8888 页面能打开启动失败或页面空白症状容器起不来或起来后页面打不开修复docker compose logs hermes-webui看具体报错排除后docker compose up -d重启验证日志里没有错误输出页面正常加载更多疑难杂症去 故障排查文档 里按图索骥。跑起来之后界面与功能一览页面一共三个区域分工很清晰左侧导航栏会话管理和模型选择随时切换会话中央聊天区文本输入和文件上传直接跟 Hermes Agent 对话右侧工作区面板浏览、上传和管理项目文件整个 Hermes WebUI Docker部署链路到这就齐了三条命令跑起来.env 管端口和密码挂载管数据持久化。照抄命令即可踩坑按速解对号入座。【免费下载链接】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），仅供参考