Hermes Agent 可视化面板一键部署｜Docker 快速搭建 Hermes WebUI（Windows+Linux 双平
【摘要】 Hermes Agent 原生仅支持命令行操作，上手门槛高，本文提供 Docker 一键部署 Hermes WebUI 可视化面板完整教程，覆盖 Linux 云服务器、Windows 本地双平台部署步骤；WebUI 提供可视化流程编排、图形化定时调度、排队任务一键取消、执行日志查询等核心能力，解决纯命令行运维痛点，同时附上访问失败、接口连通异常等常见故障排查方案，搭配云负载均衡可对外发布服务，零基
一、前言
Hermes Agent 是轻量自动化运维调度工具，原生仅支持命令行交互，对新手不友好，批量管理任务、查看执行日志、配置定时调度都需要敲大量指令，门槛很高。
Hermes WebUI 可视化面板应运而生，依托 Docker 容器一键部署，图形化界面完成 Hermes 全生命周期管理：任务编排、定时规则配置、执行日志查看、排队任务取消、节点监控，无需再操作黑框命令行，Windows、Linux 环境均可快速搭建。
本文完整覆盖两种操作系统部署流程，零基础可跟着落地。
二、前置环境要求
- Linux / Windows 系统已安装 Docker + Docker Compose
- 服务器开放 80 端口（WebUI 访问端口，可自定义）
- 服务器安全组放行对应端口，外网可正常访问
- Hermes Agent 服务正常运行，监听本地接口
三、Linux 云服务器部署教程（华为云 / 阿里云通用）
1. 安装 Docker 环境（未安装执行）
bash
运行
# 安装docker
dnf install -y docker docker-compose
# 开机自启并启动
systemctl enable --now docker
# 验证
docker -v
2. 新建部署目录与编排文件
bash
运行
mkdir -p /opt/hermes-webui
cd /opt/hermes-webui
vim docker-compose.yml
粘贴完整配置：
yaml
version: "3"
services:
hermes-webui:
image: hermesagent/webui:latest
container_name: hermes-web
restart: always
ports:
- "80:80"
environment:
# 填写Hermes Agent本地API地址
HERMES_API_URL: http://127.0.0.1:9090
volumes:
- ./web-config:/etc/webui
3. 启动容器并验证
bash
运行
# 拉取镜像启动
docker-compose up -d
# 查看运行状态
docker ps
# 查看实时日志（排错用）
docker logs -f hermes-web
4. 本地验证访问
bash
运行
curl http://127.0.0.1/
返回前端 HTML 代码代表部署成功，浏览器访问
服务器公网IP 即可打开 Hermes 可视化面板。四、Windows 本地部署教程
- 安装 Docker Desktop，启动并等待引擎就绪
- 新建本地文件夹
D:\hermes-webui，新建docker-compose.yml，内容和上文一致，修改HERMES_API_URL为你的 Hermes 服务地址 - 打开 PowerShell，进入目录执行启动：
powershell
cd D:\Users\Administrator\hermes-webui
docker-compose up -d
- 浏览器访问
http://127.0.0.1打开 WebUI；如需外网访问，放行本机 80 端口。
五、WebUI 核心功能亮点（解决运维痛点）
1. 可视化流程编排
替代命令行编写任务脚本，拖拽式创建自动化流程，支持 Shell、API、Ansible 批量任务。
2. 定时调度可视化配置
无需手写 Cron 表达式，图形化选择执行周期（每小时 / 每日 / 自定义），后台自动生成定时任务，对应底层调度能力。
3. 任务排队与一键取消
- 多任务并发限制，超出阈值自动进入排队队列；
- 排队中任务支持一键取消，运行中任务可终止；
- 区分三种任务状态：排队等待、运行中、已完成 / 取消 / 失败，一目了然。
4. 全量执行日志可视化
每条任务执行输出完整保存在面板，支持按时间、任务名称检索，不用反复查看服务器日志文件。
5. 多节点集群管理
单面板接入多台 Hermes Agent 节点，统一查看集群任务、批量下发运维指令。
六、常见问题排错
1. 浏览器访问页面 404
- 检查容器是否正常运行
docker ps； - 确认 docker-compose 端口映射
80:80； - 重载容器
docker-compose restart。
2. WebUI 无法连接 Hermes 服务
- 核对环境变量
HERMES_API_URL地址、端口； - 服务器内 curl 验证 Hermes 接口
curl http://127.0.0.1:9090； - 防火墙放行 Agent 端口。
3. 定时任务不触发
- 检查 Hermes Agent 调度服务是否正常；
- WebUI 定时任务是否开启启用开关；
- 查看容器日志
docker logs hermes-web排查报错。
七、结尾
Hermes WebUI 彻底降低 Hermes Agent 使用门槛，Docker 一键部署零复杂编译，图形化管理定时任务、排队任务、自动化流程，不管是个人测试还是企业集群运维都适用。搭配云负载均衡 ELB，还可对外网发布 WebUI 服务，随时随地管理运维集群。
后续会更新 Hermes 权限管控、多用户账号、HTTPS 加密部署教程，感兴趣可以收藏关注。
【声明】本内容来自华为云开发者社区博主，不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源（华为云社区）、文章链接、文章作者等基本信息，否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱：
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论（0）