一条命令跑起 Hermes WebUIDocker 部署最短路径【免费下载链接】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读完后你就能在浏览器 http://localhost:8787 用上 Hermes WebUIdocker compose 启动只需 4 条命令.env 里只改两个变量.hermes 和 workspace 两个目录装下全部数据。先跑通界面再谈配置先克隆仓库到本地git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui把环境变量模板复制为 .env只需确认里面的UID/GID两行是你的宿主机用户值Linux 默认 1000 通常直接可用macOS 从 501 起算运行id -u和id -g取实际值填进去。如果要把端口开放到局域网再取消HERMES_WEBUI_PASSWORD的注释否则任何能访问该端口的人都能以 agent 身份执行命令。cp .env.docker.example .env启动容器。首次运行会用本地代码构建镜像等几分钟属正常docker compose up -d docker compose ps最后打开浏览器访问 http://localhost:8787。看到左侧会话列表、中间聊天区、右侧文件浏览器容器化部署就完成了选一种容器形态匹配你的用法仓库自带 3 份 compose 文件按需挑一个形态适合谁启动命令单容器 docker-compose.yml大多数人agent 和聊天界面同容器运行docker compose up -d双容器 docker-compose.two-container.yml已在独立运行 hermes-agent想让 agent 与 webui 隔离docker compose -f docker-compose.two-container.yml up -d三容器 docker-compose.three-container.yml在双容器基础上加 9119 端口的 dashboard 做监控docker compose -f docker-compose.three-container.yml up -d把数据留在容器外持久数据全部放在宿主机两个目录里由挂载带入容器.hermes会话历史、配置、状态。宿主路径由环境变量HERMES_HOME控制默认~/.hermesworkspace右侧文件浏览器里看到的文件。由HERMES_WORKSPACE控制默认~/workspace容器随时可以删掉重建而这两个目录在宿主机上不动所以重建之后会话和文件都还在。卡住了先看这三处文件读不了权限。现象容器内报 Permission denied 或看不到挂载的文件。修复把id -u/id -g的输出写进 .env 的UID/GID重新docker compose up -d。8787 端口被占用。现象启动时 compose 报端口冲突。修复把 docker-compose.yml 里的宿主端口改成 8888ports: - 127.0.0.1:8888:8787再docker compose up -d之后访问 http://localhost:8888。容器启动即退出。现象docker compose ps状态是 exited。修复调日志看最后几行报错docker compose logs hermes-webui想隔离时再拆分容器单容器用着不顺手就分两步升数据挂载配置不用动agent 与 webui 拆开docker compose -f docker-compose.two-container.yml up -d—— 适合重度使用 CLI、Telegram、cron 等 gateway 场景两容器通过命名卷共享数据再加监控docker compose -f docker-compose.three-container.yml up -d—— 9119 端口多出 dashboard观察 agent 活动与资源占用日常维护记住三条命令跟踪实时日志排障第一手docker compose logs -f hermes-webui停掉并移除容器挂载目录里的数据不受影响docker compose down拉新代码并重新构建镜像上线git pull docker compose down docker compose up -d --build部署完成后右侧文件浏览器直接指向你的 workspace 目录对话和文件管理在同一个页面完成。【免费下载链接】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），仅供参考
