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-webuiHermes WebUI 是 Hermes Agent 的 Web 界面让你在浏览器或手机里直接使用 Agent。Hermes WebUI Docker 部署省掉 Python 环境搭建、依赖安装和版本维护一个 compose 文件就能跑起来。单、双、三容器哪种拓扑适合你仓库自带三份 docker-compose 配置区别只在 agent 进程放在哪。拓扑Compose 文件适用场景取舍代价单容器docker-compose.yml个人使用、初次部署一个文件跑通agent 与 UI 同容器排查面最小无进程隔离工具与界面共用一个环境双容器docker-compose.two-container.yml要求 agent 与 UI 隔离隔离更干净状态经命名卷共享排查面变大多一个服务要盯三容器docker-compose.three-container.yml还要 Dashboard 监控面板监控独立资源限额写死、互不抢镜像和内存开销最大agent 单限 4G推荐单容器起步因为一个 compose 文件就能跑通出问题排查面小。要进程隔离或独立监控时再上双容器、三容器。换拓扑只换 up 命令的文件名docker compose -f docker-compose.two-container.yml up -d三容器版本把文件名换成docker-compose.three-container.yml即可其余不动。五分钟跑通 Hermes WebUI Docker 部署的最小路径先验证 Docker 与 Compose 是否就位docker --version docker compose version两条命令都输出版本号即通过。然后克隆仓库并启动容器首次构建要拉基础镜像去倒杯水回来正好git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui docker compose up -ddocker compose ps里状态为 Up ✅ 就成功了。浏览器打开http://localhost:8787看到下图这个界面。这个阶段先别碰任何配置看到界面就算赢。先改哪三处UID/GID、端口、密码三个配置项不按文件顺序按不领会踩坑的顺序讲访问密码HERMES_WEBUI_PASSWORD必须改只要对外暴露。默认 compose 只把 8787 绑在 127.0.0.1仅本机访问没问题。一旦端口对局域网或服务器开放就必须设密码否则能连上端口的人就能操作你的 agent。⚠️UID/GID推荐改。容器以你指定的 UID/GID 运行必须和宿主机挂载目录的所有者一致。Linux 首个用户通常是 1000和默认值对得上macOS 从 501 开始不改必出权限错误。端口映射可不改。默认本机 8787只有被占用时才需要动。这些值写进.env而不是直接改 compose。复制模板再填cp .env.docker.example .env id -u id -g把id输出的两个数字写进.env的UID、GID需要密码就加一行HERMES_WEBUI_PASSWORD。全部变量含义见 .env.docker.example。8787 被占用时改 docker-compose.yml 里 ports 那一行只改第一个数字ports: - 127.0.0.1:8888:8787改完复用上面的 up 命令重建容器访问端口变成 8888。这就是 Hermes WebUI 端口配置的全部。容器删了数据还在两个持久化挂载点Hermes WebUI 数据持久化靠 compose 里两个挂载点写死在 volumes 段volumes: - ${HERMES_HOME:-${HOME}/.hermes}:/home/hermeswebui/.hermes - ${HERMES_WORKSPACE:-${HOME}/workspace}:/workspace.hermes 目录会话、配置、状态数据默认在用户主目录~/.hermes容器重启或删除都不受影响。workspace 目录你的工作文件默认~/workspaceWebUI 的文件浏览器展示的就是它。想换存储位置在.env里设HERMES_HOME或HERMES_WORKSPACE不用动 yaml。双容器、三容器模式下 .hermes 一侧换成 Docker 命名卷hermes-home升级 agent 镜像后的清卷流程写在 docs/docker.md。端口被占、权限拒绝、反复重启对着现象修报错别慌按现象对号入座。诊断命令只有两条一条看状态、一条看日志docker compose ps docker compose logs -f hermes-webui启动报 port is already allocated8787 被别的程序占了。把 ports 行改成其他主机端口写法见上面的 8888 例子。Permission denied 或提示找不到 config.yamlUID/GID 和宿主机对不上。把id的数字写进.env再用 up 命令重建容器。容器反复重启Restarting进程启动即崩溃多为环境或权限问题。读日志末尾几行错误基本都在那里。界面打不开、连接被拒默认绑定 127.0.0.1只能本机访问。手机或别的机器要访问去掉 ports 行的127.0.0.1:前缀同时务必设好密码。还有个隐形坑别用 sudo 跑 compose。${HOME}会展开成/root挂载错的.hermes目录表现就是配置怎么都看不见。升级、查日志、清理日常操作三件套升级新版本就三行数据挂载不受影响git pull docker compose down docker compose up -d --build跑完容器重建完成会话和配置都在。日常查日志复用上一节两条命令即可清理悬空镜像用docker system prune。双三容器拓扑下所有命令都加-f指向对应 compose 文件流程一样。跑起来之后界面三个区域速览部署成功后页面分三区左侧是会话列表加模型选择中间是聊天界面支持文本和文件上传右侧是工作区文件浏览器直接操作挂载的 workspace 目录。想再深入多容器 Dashboard 监控和远程访问的完整做法都在 docs/docker.md 里。到这里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创作声明：本文部分内容由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-webuiHermes WebUI 是 Hermes Agent 的 Web 界面让你在浏览器或手机里直接使用 Agent。Hermes WebUI Docker 部署省掉 Python 环境搭建、依赖安装和版本维护一个 compose 文件就能跑起来。单、双、三容器哪种拓扑适合你仓库自带三份 docker-compose 配置区别只在 agent 进程放在哪。拓扑Compose 文件适用场景取舍代价单容器docker-compose.yml个人使用、初次部署一个文件跑通agent 与 UI 同容器排查面最小无进程隔离工具与界面共用一个环境双容器docker-compose.two-container.yml要求 agent 与 UI 隔离隔离更干净状态经命名卷共享排查面变大多一个服务要盯三容器docker-compose.three-container.yml还要 Dashboard 监控面板监控独立资源限额写死、互不抢镜像和内存开销最大agent 单限 4G推荐单容器起步因为一个 compose 文件就能跑通出问题排查面小。要进程隔离或独立监控时再上双容器、三容器。换拓扑只换 up 命令的文件名docker compose -f docker-compose.two-container.yml up -d三容器版本把文件名换成docker-compose.three-container.yml即可其余不动。五分钟跑通 Hermes WebUI Docker 部署的最小路径先验证 Docker 与 Compose 是否就位docker --version docker compose version两条命令都输出版本号即通过。然后克隆仓库并启动容器首次构建要拉基础镜像去倒杯水回来正好git clone https://gitcode.com/GitHub_Trending/he/hermes-webui cd hermes-webui docker compose up -ddocker compose ps里状态为 Up ✅ 就成功了。浏览器打开http://localhost:8787看到下图这个界面。这个阶段先别碰任何配置看到界面就算赢。先改哪三处UID/GID、端口、密码三个配置项不按文件顺序按不领会踩坑的顺序讲访问密码HERMES_WEBUI_PASSWORD必须改只要对外暴露。默认 compose 只把 8787 绑在 127.0.0.1仅本机访问没问题。一旦端口对局域网或服务器开放就必须设密码否则能连上端口的人就能操作你的 agent。⚠️UID/GID推荐改。容器以你指定的 UID/GID 运行必须和宿主机挂载目录的所有者一致。Linux 首个用户通常是 1000和默认值对得上macOS 从 501 开始不改必出权限错误。端口映射可不改。默认本机 8787只有被占用时才需要动。这些值写进.env而不是直接改 compose。复制模板再填cp .env.docker.example .env id -u id -g把id输出的两个数字写进.env的UID、GID需要密码就加一行HERMES_WEBUI_PASSWORD。全部变量含义见 .env.docker.example。8787 被占用时改 docker-compose.yml 里 ports 那一行只改第一个数字ports: - 127.0.0.1:8888:8787改完复用上面的 up 命令重建容器访问端口变成 8888。这就是 Hermes WebUI 端口配置的全部。容器删了数据还在两个持久化挂载点Hermes WebUI 数据持久化靠 compose 里两个挂载点写死在 volumes 段volumes: - ${HERMES_HOME:-${HOME}/.hermes}:/home/hermeswebui/.hermes - ${HERMES_WORKSPACE:-${HOME}/workspace}:/workspace.hermes 目录会话、配置、状态数据默认在用户主目录~/.hermes容器重启或删除都不受影响。workspace 目录你的工作文件默认~/workspaceWebUI 的文件浏览器展示的就是它。想换存储位置在.env里设HERMES_HOME或HERMES_WORKSPACE不用动 yaml。双容器、三容器模式下 .hermes 一侧换成 Docker 命名卷hermes-home升级 agent 镜像后的清卷流程写在 docs/docker.md。端口被占、权限拒绝、反复重启对着现象修报错别慌按现象对号入座。诊断命令只有两条一条看状态、一条看日志docker compose ps docker compose logs -f hermes-webui启动报 port is already allocated8787 被别的程序占了。把 ports 行改成其他主机端口写法见上面的 8888 例子。Permission denied 或提示找不到 config.yamlUID/GID 和宿主机对不上。把id的数字写进.env再用 up 命令重建容器。容器反复重启Restarting进程启动即崩溃多为环境或权限问题。读日志末尾几行错误基本都在那里。界面打不开、连接被拒默认绑定 127.0.0.1只能本机访问。手机或别的机器要访问去掉 ports 行的127.0.0.1:前缀同时务必设好密码。还有个隐形坑别用 sudo 跑 compose。${HOME}会展开成/root挂载错的.hermes目录表现就是配置怎么都看不见。升级、查日志、清理日常操作三件套升级新版本就三行数据挂载不受影响git pull docker compose down docker compose up -d --build跑完容器重建完成会话和配置都在。日常查日志复用上一节两条命令即可清理悬空镜像用docker system prune。双三容器拓扑下所有命令都加-f指向对应 compose 文件流程一样。跑起来之后界面三个区域速览部署成功后页面分三区左侧是会话列表加模型选择中间是聊天界面支持文本和文件上传右侧是工作区文件浏览器直接操作挂载的 workspace 目录。想再深入多容器 Dashboard 监控和远程访问的完整做法都在 docs/docker.md 里。到这里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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考