基于 LinuxServer.io Webtop (Debian KDE) + NousResearch/hermes-agent + Hermes WebUI 打包的一体化 Docker 镜像。
ghcr.io/comedy1024/hermes-agent-desktop:latest
- 🖥️ Linux GUI 桌面 — 通过 noVNC 在浏览器中访问完整 Debian KDE 桌面环境
- 🤖 Hermes Agent — 自演化 AI Agent 框架，支持 OpenAI / Anthropic / DeepSeek / Ollama 等
- 🌐 Hermes WebUI — 社区最活跃的 Hermes Agent Web 管理界面（1.6k+ Stars）
- 🔧 全功能管理 — 流式聊天、文件浏览器、技能管理、记忆编辑、语音输入、7 种主题
- 🔗 CLI 会话桥接 — 终端和 WebUI 共享会话，无缝切换
- 🔒 官方镜像基础 — 基于 LinuxServer.io 官方维护镜像，安全可靠，多架构支持
| 端口 | 服务 | 说明 |
|---|---|---|
3000 |
noVNC | Debian KDE 桌面（浏览器访问，HTTP） |
3001 |
noVNC | Debian KDE 桌面（浏览器访问，HTTPS） |
8787 |
Hermes WebUI | Web 管理界面（聊天/配置/运维） |
8642 |
Hermes Gateway | OpenAI 兼容 API（WebUI 自动管理） |
docker run -d \
--name hermes-agent \
-p 3000:3000 \
-p 3001:3001 \
-p 8787:8787 \
-p 8642:8642 \
-v hermes-data:/config \
ghcr.io/comedy1024/hermes-agent-desktop:latest启动后：
- 打开
http://localhost:8787— Hermes WebUI 管理界面（首次配置 LLM API Key） - 打开
http://localhost:3000— Linux KDE 桌面（noVNC） http://localhost:8642— Hermes Gateway OpenAI 兼容 API
| 变量名 | 说明 | 默认值 |
|---|---|---|
OPENAI_API_KEY |
OpenAI API Key | — |
ANTHROPIC_API_KEY |
Anthropic API Key | — |
OPENROUTER_API_KEY |
OpenRouter API Key | — |
PASSWORD |
KDE 桌面访问密码 | （空，无密码） |
HERMES_HOME |
Hermes 数据目录 | /config/hermes-data |
HERMES_WEBUI_PORT |
WebUI 端口 | 8787 |
HERMES_WEBUI_PASSWORD |
WebUI 访问密码（可选） | — |
GATEWAY_ALLOW_ALL_USERS |
允许所有用户访问 Gateway | false |
API_SERVER_KEY |
Gateway API 鉴权 Key（启用 session 保持） | — |
完整配置项请参考容器内的
/config/hermes-data/.env模板文件。
所有配置、记忆、技能、会话日志均保存在 /config 目录下：
-v hermes-data:/config目录结构：
/config/
├── hermes-data/
│ ├── .env # 环境配置（API Keys、模型配置）
│ ├── config.yaml # Hermes Agent 主配置
│ ├── SOUL.md # Agent 人格定义
│ ├── memories/ # 长期记忆
│ ├── skills/ # 技能库（78 个预装）
│ ├── sessions/ # 会话记录
│ ├── logs/ # 运行日志
│ ├── workspace/ # 工作目录
│ └── .hermes/
│ └── webui-mvp/ # WebUI 状态与配置
└── logs/
└── hermes-webui.log # WebUI 服务日志
在 docker run 时传入 PASSWORD 环境变量：
docker run -d -e PASSWORD=your_password ...这是由于 Gateway 的用户白名单未配置导致的。编辑容器内的 .env 文件：
docker exec -it hermes-agent bash
nano /config/hermes-data/.env添加：
# 允许所有用户访问（本地/私有部署）
GATEWAY_ALLOW_ALL_USERS=true
# 建议同时设置 API Key 以启用 session 保持
API_SERVER_KEY=your_random_secret_key保存后在 WebUI 中重启 Gateway 即可。
在 HF Spaces 设置中开启 Persistent Storage，然后在 Dockerfile 中重定向数据目录：
FROM ghcr.io/comedy1024/hermes-agent-desktop:latest
ENV HERMES_HOME=/data/hermes-data
ENV HERMES_WEBUI_STATE_DIR=/data/hermes-data/.hermes/webui-mvp
ENV HERMES_WEBUI_DEFAULT_WORKSPACE=/data/hermes-data
EXPOSE 7860注意：本镜像基于 linuxserver/webtop，使用 s6-overlay 管理进程（必须以 PID 1 运行）。 从 v2026-04-16 起已内置 PID 1 兼容层（
s6-init.sh），可自动适配云平台环境。
- 在 ModelScope 创建一个新的创空间（SDK 选择 Docker）
- 在创空间仓库中添加
Dockerfile文件：
FROM ghcr.io/comedy1024/hermes-agent-desktop:latest
# ModelScope 创空间要求应用监听 7860 端口
# 我们将 noVNC 桌面映射到 7860（也可改为 8787 映射 WebUI）
EXPOSE 7860- 在创空间「设置」中添加所需环境变量（如
OPENAI_API_KEY） - 点击重启即可自动拉取镜像并部署
创空间默认只暴露 7860 端口。你可以根据需要选择映射哪个服务：
| 映射端口 | 访问内容 | 说明 |
|---|---|---|
7860→3000 |
KDE 桌面 | 浏览器访问完整 Linux 桌面 |
7860→8787 |
Hermes WebUI | 仅使用聊天/管理界面 |
如需同时访问桌面和 WebUI，建议使用 Docker 自行部署（见上方快速开始）。
Q: 创空间启动报错 s6-overlay-suexec: fatal: can only run as pid 1
这是旧版本问题，从 v2026-04-16 起已修复。请拉取最新镜像。如果仍遇到此问题，
说明创空间的容器运行时使用了特殊的 PID 命名空间隔离。请确保使用最新版镜像，
其中包含 s6-init.sh PID 1 兼容层。
在 Spaces 仓库中添加 Dockerfile 文件：
FROM ghcr.io/comedy1024/hermes-agent-desktop:latest
ENV HERMES_HOME=/data/hermes-data
ENV HERMES_WEBUI_STATE_DIR=/data/hermes-data/.hermes/webui-mvp
ENV HERMES_WEBUI_DEFAULT_WORKSPACE=/data/hermes-data
EXPOSE 7860
EXPOSE 8787
EXPOSE 8642镜像通过 GitHub Actions 自动构建：
push到main分支时触发构建- 每天 UTC 02:00（北京时间 10:00）定时检查上游更新（hermes-agent / hermes-webui / 基础镜像）
- 仅上游有变化时才构建，避免无意义重建
- 支持
linux/amd64和linux/arm64双架构
- 基于
lscr.io/linuxserver/webtop:debian-kde（Debian 13 Trixie + KDE） - 使用 uv 安装 hermes-agent[all] 到 /opt/hermes-venv（CLI + WebUI 共享）
- NodeSource 安装 Node.js 22 + npm（Playwright + WhatsApp bridge）
- 设置桌面快捷方式、壁纸、开机自启
- 推送多架构镜像到 ghcr.io
- NousResearch/hermes-agent — Hermes Agent 上游
- nesquena/hermes-webui — Hermes WebUI 上游
- linuxserver/docker-webtop — Linux GUI 桌面基础镜像
本仓库遵循 MIT 协议，与上游 hermes-webui 保持一致。