5 分钟跑通 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-webui想在浏览器或手机上随手指挥 Hermes AgentHermes WebUI Docker 部署是最省事的办法不用装 Python 环境、不用纠结依赖一个命令就能把整套服务跑起来。跟着走一遍大约 5~10 分钟就能打开网页开始和 Agent 对话。开始之前你只需要两样东西一台能跑 Docker 的机器Linux、macOS、装了 WSL2 的 Windows 都可以Docker 本体 Compose 插件Docker Desktop 自带打开终端敲一条命令自检docker compose version能看到版本号就说明环境没问题如果提示命令不存在去 Docker 官网装一下 Docker Desktop 或 Docker Engine 再回来。怎么选部署方式三种容器方案对比仓库里自带了三份 Compose 文件对应三种玩法方案适合谁特点单容器docker-compose.yml绝大多数个人用户一个容器跑全部从当前目录构建配置最简单权限问题最少双容器docker-compose.two-container.yml想隔离 agent 和聊天界面的人agent 与 WebUI 分两个容器用命名卷共享数据镜像直接拉取不用构建三容器docker-compose.three-container.yml还想盯监控面板的进阶用户在双容器基础上多一个 Dashboard9119 端口可对 agent 做资源限额拿不准就直接选第一个。单容器是最不容易出权限和路径问题的路径后续想升级再换文件即可。标准部署流程 下面按单容器模式走全程在克隆下来的目录里操作。1. 克隆仓库git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui成功后ls能看到docker-compose.yml和.env.docker.example。2. 准备环境变量文件cp .env.docker.example .env打开.env把UID和GID改成你自己的值终端敲id -u和id -g各取一个数填进去。macOS 上用户 ID 从 501 开始这一步必做。⚠️ 易错提醒UID/GID 填错是最常见的翻车点——容器会以这个 ID 读写你挂载的~/.hermes目录对不上就会出现Permission denied或文件变成 root 所有。3. 一条命令拉起docker compose up -d首次运行会从当前目录构建镜像需要几分钟期间没有输出属正常现象。4. 检查容器状态docker compose ps看到hermes-webui一行显示Up且健康状态为 healthy就说明服务起来了。⚠️ 易错提醒如果构建阶段报网络错误多半是基础镜像拉取被墙或代理未生效给 Docker 配好镜像加速后重新执行上一步即可。值得知道的配置项不用全看这几个是真正影响日常使用的参数默认值什么时候改UID/GID1000macOS 用户多为 501必改Linux 一般默认就对HERMES_HOME~/.hermes你的配置、会话、状态实际存在哪就指到哪默认不用动HERMES_WORKSPACE~/workspace想让 Agent 操作你的代码目录时改成对应路径HERMES_WEBUI_PASSWORD空无密码只要端口要暴露给 127.0.0.1 以外就必须设置否则等于裸奔API_SERVER_KEY空双/三容器模式下想让 WebUI 探测到 gateway 时才需要16 位以上随机串顺带一句原理卷挂载就像把数据放进一块不会随容器删除而丢的外置硬盘~/.hermes和 workspace 就是这两块硬盘。怎么确认它跑起来了命令行层面已经用docker compose ps确认过了再看一眼浏览器打开http://localhost:8787出现登录或直接进入会话页就算彻底跑通。界面分三块各管一摊事左侧边栏会话列表和模型选择器新对话、置顶、切换 profile 都在这里中间聊天区你和 Agent 的对话工具调用会以可折叠的卡片形式内联展示右侧工作区面板直接浏览、管理你在HERMES_WORKSPACE里挂载的文件想验证 Agent 真的能干活可以丢一句列出当前 workspace 下的文件右侧面板里出现的文件清单就是活证据。出问题先查这几种1. 端口被占用现象docker compose up -d报port is already allocated浏览器也打不开排查sudo lsof -i :8787看谁占着修复把 compose 里的端口映射改成127.0.0.1:8888:8787这种形式容器端口不动换掉主机侧端口再docker compose up -d重建2. 权限被拒Permission denied / 文件读不到现象容器反复重启日志里大量 permission 报错或.hermes里的文件变成 root 属主排查docker logs hermes-webui找具体报错路径再id -u对照.env里的UID修复把.env里的 UID/GID 改成宿主机真实值后重建macOS 用户尤其注意这一步。多容器模式遇到此问题官方建议退回单容器或保持命名卷用法详见 docs/docker.md3. 容器起不来或反复重启现象docker compose ps里状态是Restarting或Exit 1排查docker compose logs -f hermes-webui看最后几行真实报错修复构建失败一般是基础镜像没拉下来docker compose up -d --build重来一次启动即崩且日志指向挂载路径9 成是 UID 问题回到上一条处理最后到这里一台干净机器上 5 分钟就能拥有一个能对话、能管文件的 Hermes Agent 网页端。数据落在挂载的卷里容器随时可删可重建——这正是容器化部署的全部价值。【免费下载链接】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），仅供参考
5 分钟跑通 Hermes WebUI Docker 部署：从零到可用的完整指南
5 分钟跑通 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-webui想在浏览器或手机上随手指挥 Hermes AgentHermes WebUI Docker 部署是最省事的办法不用装 Python 环境、不用纠结依赖一个命令就能把整套服务跑起来。跟着走一遍大约 5~10 分钟就能打开网页开始和 Agent 对话。开始之前你只需要两样东西一台能跑 Docker 的机器Linux、macOS、装了 WSL2 的 Windows 都可以Docker 本体 Compose 插件Docker Desktop 自带打开终端敲一条命令自检docker compose version能看到版本号就说明环境没问题如果提示命令不存在去 Docker 官网装一下 Docker Desktop 或 Docker Engine 再回来。怎么选部署方式三种容器方案对比仓库里自带了三份 Compose 文件对应三种玩法方案适合谁特点单容器docker-compose.yml绝大多数个人用户一个容器跑全部从当前目录构建配置最简单权限问题最少双容器docker-compose.two-container.yml想隔离 agent 和聊天界面的人agent 与 WebUI 分两个容器用命名卷共享数据镜像直接拉取不用构建三容器docker-compose.three-container.yml还想盯监控面板的进阶用户在双容器基础上多一个 Dashboard9119 端口可对 agent 做资源限额拿不准就直接选第一个。单容器是最不容易出权限和路径问题的路径后续想升级再换文件即可。标准部署流程 下面按单容器模式走全程在克隆下来的目录里操作。1. 克隆仓库git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui成功后ls能看到docker-compose.yml和.env.docker.example。2. 准备环境变量文件cp .env.docker.example .env打开.env把UID和GID改成你自己的值终端敲id -u和id -g各取一个数填进去。macOS 上用户 ID 从 501 开始这一步必做。⚠️ 易错提醒UID/GID 填错是最常见的翻车点——容器会以这个 ID 读写你挂载的~/.hermes目录对不上就会出现Permission denied或文件变成 root 所有。3. 一条命令拉起docker compose up -d首次运行会从当前目录构建镜像需要几分钟期间没有输出属正常现象。4. 检查容器状态docker compose ps看到hermes-webui一行显示Up且健康状态为 healthy就说明服务起来了。⚠️ 易错提醒如果构建阶段报网络错误多半是基础镜像拉取被墙或代理未生效给 Docker 配好镜像加速后重新执行上一步即可。值得知道的配置项不用全看这几个是真正影响日常使用的参数默认值什么时候改UID/GID1000macOS 用户多为 501必改Linux 一般默认就对HERMES_HOME~/.hermes你的配置、会话、状态实际存在哪就指到哪默认不用动HERMES_WORKSPACE~/workspace想让 Agent 操作你的代码目录时改成对应路径HERMES_WEBUI_PASSWORD空无密码只要端口要暴露给 127.0.0.1 以外就必须设置否则等于裸奔API_SERVER_KEY空双/三容器模式下想让 WebUI 探测到 gateway 时才需要16 位以上随机串顺带一句原理卷挂载就像把数据放进一块不会随容器删除而丢的外置硬盘~/.hermes和 workspace 就是这两块硬盘。怎么确认它跑起来了命令行层面已经用docker compose ps确认过了再看一眼浏览器打开http://localhost:8787出现登录或直接进入会话页就算彻底跑通。界面分三块各管一摊事左侧边栏会话列表和模型选择器新对话、置顶、切换 profile 都在这里中间聊天区你和 Agent 的对话工具调用会以可折叠的卡片形式内联展示右侧工作区面板直接浏览、管理你在HERMES_WORKSPACE里挂载的文件想验证 Agent 真的能干活可以丢一句列出当前 workspace 下的文件右侧面板里出现的文件清单就是活证据。出问题先查这几种1. 端口被占用现象docker compose up -d报port is already allocated浏览器也打不开排查sudo lsof -i :8787看谁占着修复把 compose 里的端口映射改成127.0.0.1:8888:8787这种形式容器端口不动换掉主机侧端口再docker compose up -d重建2. 权限被拒Permission denied / 文件读不到现象容器反复重启日志里大量 permission 报错或.hermes里的文件变成 root 属主排查docker logs hermes-webui找具体报错路径再id -u对照.env里的UID修复把.env里的 UID/GID 改成宿主机真实值后重建macOS 用户尤其注意这一步。多容器模式遇到此问题官方建议退回单容器或保持命名卷用法详见 docs/docker.md3. 容器起不来或反复重启现象docker compose ps里状态是Restarting或Exit 1排查docker compose logs -f hermes-webui看最后几行真实报错修复构建失败一般是基础镜像没拉下来docker compose up -d --build重来一次启动即崩且日志指向挂载路径9 成是 UID 问题回到上一条处理最后到这里一台干净机器上 5 分钟就能拥有一个能对话、能管文件的 Hermes Agent 网页端。数据落在挂载的卷里容器随时可删可重建——这正是容器化部署的全部价值。【免费下载链接】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），仅供参考