Hermes WebUI Docker 部署教程4 步在浏览器里用上 AI 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-webuiHermes WebUI 是 Hermes Agent 的 Web 界面让聊天会话、文件管理和定时任务都能通过浏览器或手机访问。跟着本教程操作你会在本地得到一台跑在 Docker 里的实例会话和配置持久保存在磁盘上。准备2 条命令验环境1 条命令拿代码Docker 和 Compose 装对之后整个部署只差几条命令。先验证环境是否就绪docker --version docker compose version再拉取项目代码到本地git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui快速上手4 步完成 Hermes WebUI 容器部署输入完命令几分钟之后浏览器里就是三栏聊天界面——单容器方案是这条最快路径一共 4 步。第 1 步生成配置文件。把模板复制成 .env后面改端口、密码都写在这里cp .env.docker.example .env第 2 步启动容器。首次运行要构建镜像可能需要几分钟docker compose up -d第 3 步查状态。STATUS列显示Up就说明服务已经就绪docker compose ps第 4 步打开浏览器。访问 http://localhost:8787。⚠️ 默认只监听 127.0.0.1其他设备要访问需先改端口映射并设置密码。打开后界面长什么样三栏布局左侧是会话列表和导航中间是聊天区右侧是工作区文件浏览器模型、资料库和工作区控制都在输入框底部的 composer 栏所有设置入口在侧栏底部的 Hermes Control Center。工作区面板能直接预览、编辑项目文件相当于把文件管理器搬进了 Agent 对话旁边选对部署方案单容器 / 双容器 / 三容器对比三个 compose 文件到底选哪个按“适合谁”一句话判断方案文件适合谁单容器docker-compose.yml初次部署、配置项最少、Agent 与界面放一起的人双容器docker-compose.two-container.yml想隔离 Agent 与 Web 界面、或已在别处单独跑 Agent 的人三容器docker-compose.three-container.yml还需要监控面板、想在独立页面查看 Agent 活动的人切换方案只需加一个-f参数指定文件docker compose -f docker-compose.three-container.yml up -d一个已知取舍要说在前面双容器模式下从 Web 界面触发的工具运行在 WebUI 容器里如果你依赖 git、node 这类工具单容器最省事。三个关键设置改端口、开密码、对应用户 ID九成用户只需要关心 .env 里的三个值每个都按“干什么 / 何时改 / 怎么改”说清楚。端口干什么浏览器访问 WebUI 的端口默认 8787何时改8787 被占用或你想让局域网设备访问怎么改在 docker-compose.yml 里把宿主机一侧的端口换掉ports: - 8888:8787密码干什么登录口令对应HERMES_WEBUI_PASSWORD何时改只要端口不再只绑 127.0.0.1就必须设否则任何能连上端口的人都能操作你的 Agent怎么改echo HERMES_WEBUI_PASSWORDchange-me .env docker compose up -d --force-recreate用户 IDUID/GID干什么容器内进程的身份和宿主机文件属主不一致就读不了配置何时改macOS 上UID 从 501 开始或遇到权限报错时怎么改把当前用户的真实值写进 .envecho UID$(id -u) .env echo GID$(id -g) .env让数据持久化两个目录挂载与迁移方法想删掉容器重部署又不想丢掉聊了几个月的会话记录靠的就是卷挂载——容器删了挂载目录里的数据还在。本项目只有两个挂载点.hermes 目录会话、配置、技能、状态数据这是必须保留的那个workspace 目录你的工作文件对应界面右侧的文件浏览器默认指向宿主机的~/.hermes和~/workspace。想挪位置不用动 compose 文件在 .env 里加两行变量即可HERMES_HOME/opt/hermes-data HERMES_WORKSPACE/home/me/projects改完执行docker compose up -d --force-recreate让新挂载生效。运维与排障看日志、一条命令更新、三个常见问题日常运维就是三组命令docker compose logs -f hermes-webui # 跟踪实时日志 docker compose down # 停止并移除容器 docker system prune # 清理闲置镜像和容器升级到新版本git pull docker compose up -d --build最可能碰到的三个问题每个都按“现象 → 原因 → 解决”说明。启动时报权限错误现象日志出现PermissionError或 .hermes 里的 .env 读不了原因容器进程的 UID/GID 与宿主机文件属主不一致解决把id -u、id -g的真实值写入 .env 的 UID/GID 后重建容器看不到 .hermes提示使用默认配置现象界面显示config.yaml (not found, using defaults)原因用 sudo 跑 compose 时${HOME}展开成了 root 的家目录挂载错了位置解决用当前用户运行 compose或给HERMES_HOME、HERMES_WORKSPACE传绝对路径后再 sudo8787 端口被占用现象服务起不来或提示端口已在使用原因宿主机上别的进程已经占着 8787解决在 docker-compose.yml 里把映射的宿主机端口换成 8888 之类的空端口更多情况可查 docs/troubleshooting.md。部署完成两个下一步建议至此你已经拥有一个在任何设备浏览器都能打开、数据可随时备份迁移的 Hermes WebUI 实例。接下来建议做两件事读 docs/docker.md了解反向代理、HTTPS 和多容器迁移等进阶选项想让手机端连上 Agent 网关时看 docs/remote-access.md 与 api/gateway_chat.py 里的相关配置【免费下载链接】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），仅供参考 Hermes WebUI Docker 部署教程：4 步在浏览器里用上 AI Agent
Hermes WebUI Docker 部署教程4 步在浏览器里用上 AI 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-webuiHermes WebUI 是 Hermes Agent 的 Web 界面让聊天会话、文件管理和定时任务都能通过浏览器或手机访问。跟着本教程操作你会在本地得到一台跑在 Docker 里的实例会话和配置持久保存在磁盘上。准备2 条命令验环境1 条命令拿代码Docker 和 Compose 装对之后整个部署只差几条命令。先验证环境是否就绪docker --version docker compose version再拉取项目代码到本地git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui快速上手4 步完成 Hermes WebUI 容器部署输入完命令几分钟之后浏览器里就是三栏聊天界面——单容器方案是这条最快路径一共 4 步。第 1 步生成配置文件。把模板复制成 .env后面改端口、密码都写在这里cp .env.docker.example .env第 2 步启动容器。首次运行要构建镜像可能需要几分钟docker compose up -d第 3 步查状态。STATUS列显示Up就说明服务已经就绪docker compose ps第 4 步打开浏览器。访问 http://localhost:8787。⚠️ 默认只监听 127.0.0.1其他设备要访问需先改端口映射并设置密码。打开后界面长什么样三栏布局左侧是会话列表和导航中间是聊天区右侧是工作区文件浏览器模型、资料库和工作区控制都在输入框底部的 composer 栏所有设置入口在侧栏底部的 Hermes Control Center。工作区面板能直接预览、编辑项目文件相当于把文件管理器搬进了 Agent 对话旁边选对部署方案单容器 / 双容器 / 三容器对比三个 compose 文件到底选哪个按“适合谁”一句话判断方案文件适合谁单容器docker-compose.yml初次部署、配置项最少、Agent 与界面放一起的人双容器docker-compose.two-container.yml想隔离 Agent 与 Web 界面、或已在别处单独跑 Agent 的人三容器docker-compose.three-container.yml还需要监控面板、想在独立页面查看 Agent 活动的人切换方案只需加一个-f参数指定文件docker compose -f docker-compose.three-container.yml up -d一个已知取舍要说在前面双容器模式下从 Web 界面触发的工具运行在 WebUI 容器里如果你依赖 git、node 这类工具单容器最省事。三个关键设置改端口、开密码、对应用户 ID九成用户只需要关心 .env 里的三个值每个都按“干什么 / 何时改 / 怎么改”说清楚。端口干什么浏览器访问 WebUI 的端口默认 8787何时改8787 被占用或你想让局域网设备访问怎么改在 docker-compose.yml 里把宿主机一侧的端口换掉ports: - 8888:8787密码干什么登录口令对应HERMES_WEBUI_PASSWORD何时改只要端口不再只绑 127.0.0.1就必须设否则任何能连上端口的人都能操作你的 Agent怎么改echo HERMES_WEBUI_PASSWORDchange-me .env docker compose up -d --force-recreate用户 IDUID/GID干什么容器内进程的身份和宿主机文件属主不一致就读不了配置何时改macOS 上UID 从 501 开始或遇到权限报错时怎么改把当前用户的真实值写进 .envecho UID$(id -u) .env echo GID$(id -g) .env让数据持久化两个目录挂载与迁移方法想删掉容器重部署又不想丢掉聊了几个月的会话记录靠的就是卷挂载——容器删了挂载目录里的数据还在。本项目只有两个挂载点.hermes 目录会话、配置、技能、状态数据这是必须保留的那个workspace 目录你的工作文件对应界面右侧的文件浏览器默认指向宿主机的~/.hermes和~/workspace。想挪位置不用动 compose 文件在 .env 里加两行变量即可HERMES_HOME/opt/hermes-data HERMES_WORKSPACE/home/me/projects改完执行docker compose up -d --force-recreate让新挂载生效。运维与排障看日志、一条命令更新、三个常见问题日常运维就是三组命令docker compose logs -f hermes-webui # 跟踪实时日志 docker compose down # 停止并移除容器 docker system prune # 清理闲置镜像和容器升级到新版本git pull docker compose up -d --build最可能碰到的三个问题每个都按“现象 → 原因 → 解决”说明。启动时报权限错误现象日志出现PermissionError或 .hermes 里的 .env 读不了原因容器进程的 UID/GID 与宿主机文件属主不一致解决把id -u、id -g的真实值写入 .env 的 UID/GID 后重建容器看不到 .hermes提示使用默认配置现象界面显示config.yaml (not found, using defaults)原因用 sudo 跑 compose 时${HOME}展开成了 root 的家目录挂载错了位置解决用当前用户运行 compose或给HERMES_HOME、HERMES_WORKSPACE传绝对路径后再 sudo8787 端口被占用现象服务起不来或提示端口已在使用原因宿主机上别的进程已经占着 8787解决在 docker-compose.yml 里把映射的宿主机端口换成 8888 之类的空端口更多情况可查 docs/troubleshooting.md。部署完成两个下一步建议至此你已经拥有一个在任何设备浏览器都能打开、数据可随时备份迁移的 Hermes WebUI 实例。接下来建议做两件事读 docs/docker.md了解反向代理、HTTPS 和多容器迁移等进阶选项想让手机端连上 Agent 网关时看 docs/remote-access.md 与 api/gateway_chat.py 里的相关配置【免费下载链接】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），仅供参考