搭配 Hermes webUI 解决 Hermes Agent 没有UI操作界面问题

## 概要：
不关注原理的话直接从第四步开始看

## 第一步，安装官方应用


## 第二步，进入Docker，查看compose配置文件

                               
登录/注册后可看大图

## 第三步，复制dashboard上面的所有内容（dashboard就是Hermes Agent自带的UI配置，只能看用量那些没有界面操作，直接抛弃掉）

                               
登录/注册后可看大图

## 第四步，使用官方的配置，加上hermes-webui的配置，创建新项目

                               
登录/注册后可看大图

配置如下：

1. services:
   
2.   hermes-agent:
   
3.     image: ugreen/hermes-agent:v1
   
4.     container_name: hermes-agent
   
5.     restart: unless-stopped
   
6.     command: gateway run
   
7.     volumes:
   
8.       - /volume1/Docker/Hermes Agent:/opt/data
   
9.     network_mode: host
   
10.     environment:
    
11.       TZ: Asia/Shanghai
    
12.       MODEL_NAME: MiniMax
    
13.       PROVIDER_BASE_URL: http://127.0.0.1:19099
    
14.       API_KEY: 71adbad1268961c154c6d0b17dfd7eb0
    
15.       GATEWAY_INTERNAL_PORT: 18643
    
16.       GATEWAY_INTERNAL_TOKEN: 71adbad1268961c154c6d0b17dfd7eb0
    
17.       API_SERVER_PORT: 18642
    
18.     deploy:
    
19.       resources:
    
20.         limits:
    
21.           memory: 4G
    
22.           cpus: "2.0"
    
23. 
    
24.   hermes-webui:
    
25.     image: ekkoye8888/hermes-web-ui:latest
    
26.     container_name: hermes-webui
    
27.     entrypoint: ["node", "dist/server/index.js"]
    
28.     depends_on:
    
29.       - hermes-agent
    
30.     ports:
    
31.       - "19888:19888"
    
32.     volumes:
    
33.       - /volume1/Docker/Hermes Agent:/home/agent/.hermes
    
34.       - /volume1/Docker/Hermes Agent/hermes-webui:/home/agent/.hermes-web-ui
    
35.     environment:
    
36.       - PORT=19888
    
37.       - UPSTREAM=http://host.docker.internal:18642
    
38.       - HERMES_HOME=/home/agent/.hermes
    
39.       - HERMES_BIN=/opt/hermes/.venv/bin/hermes
    
40.       - AUTH_DISABLED=true
    
41.     restart: unless-stopped
    
42.     # 让绿联Linux容器识别宿主机
    
43.     extra_hosts:
    
44.       - "host.docker.internal:host-gateway"

复制代码

## 第五步：点击hermes-webui配置的端口访问，也可以点右边的三个点-->创建桌面快捷方式-->输入这个配置的端口号-->点击桌面图标访问

                               
登录/注册后可看大图

## 第六步，部署完成（已经可以在webui管理Docker目录下的文件，如果遇到权限问题，参考官方教程ssh登录，赋予读写权限给/volumes1/Docker/Hermes Agent目录）

                               
登录/注册后可看大图

## 第七步，配置自己的API KEY
* 理论上这一步可以用UGREEN赠送的MiniMax的APIKEY（访问容器内的网络），但hermes-webui界面配置必须测试连通性方可添加模型（需要访问公网）
* 考虑到还有几天免费就到期了，没花时间看，选择直接用自己的APIKEY

                               
登录/注册后可看大图

## 第八步，开始使用

                               
登录/注册后可看大图

## 第九步，开通微信渠道（可选）

                               
登录/注册后可看大图

第四步，开始前手动到你配置的「存放目录」下创建一个「hermes-webui」目录，避免配置文件找不到这个目录

* 注意：如果你的存放路径不叫Hermes Agent，亦或者hermes-webui不想放在这个目录，需要对应修改配置文件

楼主，需要删除官方应用中心下载的hermes吗，我通过你的配置显示拉取ugreen/hermes-agent:v1失败，请问这个怎么回事呢

KM2tf4 发表于 2026-4-27 13:35
楼主，需要删除官方应用中心下载的hermes吗，我通过你的配置显示拉取ugreen/hermes-agent:v1失败，请问这个 ...

不需要删除官方的，之前已经处理过配置，而且重名也会提示「项目已存在」，无法继续创建

拉取镜像失败感觉更多是网络问题，是不是没有配镜像加速，可以看下这篇官方教程。

https://support.ugnas.com/knowle ... 2RlIjoiMiYmNDUzIn0=

楼主，应用中心的Hermes更新后，webui用不了，端口占用。