news 2026/7/6 16:09:44

如何快速部署 Hermes Studio：桌面应用、npm 和 Docker 三种方式完整教程

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何快速部署 Hermes Studio：桌面应用、npm 和 Docker 三种方式完整教程

如何快速部署 Hermes Studio：桌面应用、npm 和 Docker 三种方式完整教程

【免费下载链接】hermes-studioWeb dashboard for Hermes Agent — multi-platform AI chat, session management, scheduled jobs, usage analytics项目地址: https://gitcode.com/gh_mirrors/he/hermes-studio

Hermes Studio 是一个功能强大的 AI 智能体管理平台，提供多平台 AI 聊天、会话管理、定时任务和数据分析等完整解决方案。无论你是 AI 开发者还是普通用户，都能通过本文介绍的三种部署方式快速上手使用 Hermes Studio。本文将详细介绍桌面应用、npm 和 Docker 三种部署方法，帮助你选择最适合自己的部署方案。

📦 桌面应用部署（推荐新手使用）

桌面应用是最简单快捷的部署方式，适合想要快速体验 Hermes Studio 所有功能的用户。

下载安装包

访问官方发布页面下载对应操作系统的安装包：

  • Windows：下载.exe或.msi安装程序
  • macOS：下载.dmg或.pkg安装包
  • Linux：下载.AppImage、.deb或.rpm包

安装完成后，Hermes Studio 会自动启动并创建必要的配置文件。

数据存储位置

桌面应用会自动管理数据存储：

  • Windows：%LOCALAPPDATA%\hermes（备用路径：%APPDATA%\hermes）
  • macOS/Linux：~/.hermes

Web UI 状态数据存储在：~/.hermes-web-ui（可通过HERMES_WEB_UI_HOME环境变量自定义）

命令行工具集成

安装后，系统会添加以下命令工具：

  • hermes-studio- 打开 Hermes Studio 桌面应用
  • hermes-studio cli ...- 运行捆绑的 Hermes Agent CLI
  • hermes-studio web ...- 运行捆绑的hermes-web-ui命令
  • hermes-studio-mcp- 运行托管的 Web UI MCP 桥接器

自动更新机制

桌面应用支持自动更新：

  1. 优先从https://download.ekkolearnai.com/latest获取更新
  2. 备用方案：GitHub Releases 最新版本
  3. Windows 升级时会尝试关闭现有进程后替换文件

🔧 npm 命令行部署（适合开发者）

如果你习惯使用命令行工具，npm 部署方式提供了最大的灵活性。

安装步骤

# 全局安装 Hermes Web UI npm install -g hermes-web-ui # 启动服务 hermes-web-ui start

启动后访问：http://localhost:8648

常用命令

命令说明
hermes-web-ui start后台启动（守护进程模式）
hermes-web-ui start --port 9000在自定义端口启动
hermes-web-ui stop停止后台进程
hermes-web-ui restart重启后台进程
hermes-web-ui status检查运行状态
hermes-web-ui update更新到最新版本并重启
hermes-web-ui -v显示版本号
hermes-web-ui -h显示帮助信息

环境变量配置

通过环境变量可以自定义 Hermes Studio 的行为：

# 设置端口和绑定主机 export PORT=9000 export BIND_HOST=0.0.0.0 # 设置数据目录 export HERMES_WEB_UI_HOME=/path/to/your/data # 设置认证令牌 export AUTH_TOKEN=your-custom-token # 启动服务 hermes-web-ui start

维护命令

# 清除登录锁定记录 hermes-web-ui clear-login-locks # 清除登录锁定并重启运行中的 Web UI 进程 hermes-web-ui clear-login-locks --restart # 创建或重置默认超级管理员登录（admin / 123456） hermes-web-ui reset-default-login

🐳 Docker 容器化部署（适合生产环境）

Docker 部署提供了最好的隔离性和可移植性，适合在生产环境中使用。

快速开始

使用预构建镜像（推荐）：

# 使用预构建镜像启动 WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d # 查看日志 docker compose logs -f hermes-webui

从源码构建：

# 从源码构建并启动 docker compose up -d --build # 查看日志 docker compose logs -f hermes-webui

启动后访问：http://localhost:6060

配置文件详解

查看docker-compose.yml文件了解完整的配置选项：

services: hermes-webui: build: context: . dockerfile: Dockerfile image: ${WEBUI_IMAGE:-hermes-web-ui-local:latest} ports: - "${PORT:-6060}:${PORT:-6060}" volumes: - ${HERMES_DATA_DIR:-./hermes_data}:/home/agent/.hermes - ${HERMES_DATA_DIR:-./hermes_data}/hermes-web-ui:/home/agent/.hermes-web-ui

数据持久化配置

Docker 部署的数据存储结构：

路径说明
./hermes_dataHermes 运行时数据（会话、配置、配置文件）
./hermes_data/hermes-web-uiWeb UI 数据（认证令牌等）

认证令牌会在首次运行时自动生成，并打印到容器日志中。

环境变量配置

创建.env文件来自定义配置：

# 使用预构建镜像 WEBUI_IMAGE=ekkoye8888/hermes-web-ui # 自定义端口 PORT=8080 # 自定义绑定主机 BIND_HOST=0.0.0.0 # 自定义数据目录 HERMES_DATA_DIR=/path/to/hermes/data

🔄 部署方式对比

特性桌面应用npm 部署Docker 部署
安装难度⭐⭐⭐⭐⭐（最简单）⭐⭐⭐⭐（需要 Node.js）⭐⭐⭐（需要 Docker）
配置灵活性⭐⭐（有限）⭐⭐⭐⭐⭐（完全可配置）⭐⭐⭐⭐（环境变量配置）
系统资源⭐⭐⭐（中等）⭐⭐⭐⭐（可控）⭐⭐⭐⭐⭐（最佳隔离）
更新维护⭐⭐⭐⭐⭐（自动更新）⭐⭐⭐⭐（命令行更新）⭐⭐⭐（手动更新镜像）
适合场景个人用户、快速体验开发者、自定义部署生产环境、服务器部署

🛠️ 常见问题解决

1. 端口冲突问题

如果默认端口被占用，可以修改启动端口：

# npm 方式 hermes-web-ui start --port 9000 # Docker 方式 PORT=9000 docker compose up -d

2. 认证令牌获取

首次启动后，认证令牌会自动生成：

# Docker 方式查看令牌 docker compose logs hermes-webui | grep token # 或直接查看文件 cat ./hermes_data/hermes-web-ui/.token

3. 数据备份与迁移

所有部署方式的数据都存储在指定目录中：

  • 桌面应用：~/.hermes和~/.hermes-web-ui
  • npm 部署：~/.hermes和~/.hermes-web-ui（或HERMES_WEB_UI_HOME指定目录）
  • Docker 部署：./hermes_data挂载目录

📊 部署后的功能体验

成功部署 Hermes Studio 后，你可以享受以下核心功能：

AI 聊天功能

  • 实时聊天流式传输，支持文件上传下载
  • 多会话管理，支持创建、重命名、删除和切换会话
  • 本地 SQLite 会话数据库存储
  • 按来源（Telegram、Discord、Slack 等）分组会话

平台通道集成

  • 统一配置 8 个平台：Telegram、Discord、Slack、WhatsApp、Matrix、飞书、微信、企业微信
  • 凭据管理写入~/.hermes/.env
  • 通道行为设置写入~/.hermes/config.yaml

自动化管理

  • 创建、编辑、暂停、恢复和删除定时任务
  • 看板板用于规划和跟踪智能体工作
  • 多智能体聊天室，支持 @提及路由和上下文压缩

模型管理

  • 自动从凭据池发现可用模型
  • 添加、更新和删除提供商（预设和自定义 OpenAI 兼容）
  • OpenAI Codex 和 Nous Portal OAuth 登录支持

🚀 进阶配置技巧

自定义 Hermes Agent 运行时

如果你已经安装了 Hermes Agent，可以配置 Web UI 使用现有的运行时：

# 设置 Hermes CLI 路径 export HERMES_BIN=/path/to/hermes # 设置 Hermes Agent 源码目录 export HERMES_AGENT_ROOT=/path/to/hermes-agent # 启动服务 hermes-web-ui start

多配置文件管理

Hermes Studio 支持多配置文件管理：

  • 创建、重命名、删除和切换 Hermes 配置文件
  • 克隆现有配置文件或从存档导入（.tar.gz）
  • 导出配置文件进行备份或共享
  • 配置文件作用域的配置、缓存、上传、会话、任务等

性能优化配置

# 调整日志级别 export LOG_LEVEL=warn export BRIDGE_LOG_LEVEL=warn # 调整文件大小限制 export MAX_DOWNLOAD_SIZE=500MB export MAX_EDIT_SIZE=20MB # 调整桥接超时设置 export HERMES_AGENT_BRIDGE_TIMEOUT_MS=180000

🎯 总结与建议

Hermes Studio 提供了三种灵活的部署方式，满足不同用户的需求：

  1. 桌面应用：适合想要快速上手、无需配置的个人用户
  2. npm 部署：适合需要高度自定义配置的开发者
  3. Docker 部署：适合在生产环境中需要隔离性和可移植性的团队

无论选择哪种部署方式，Hermes Studio 都能为你提供强大的 AI 智能体管理功能。建议新手从桌面应用开始，开发者使用 npm 部署进行定制，生产环境选择 Docker 部署确保稳定性。

现在就开始部署 Hermes Studio，体验智能 AI 助手带来的高效工作流吧！🚀

【免费下载链接】hermes-studioWeb dashboard for Hermes Agent — multi-platform AI chat, session management, scheduled jobs, usage analytics项目地址: https://gitcode.com/gh_mirrors/he/hermes-studio

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/7/6 16:09:44

linux_kernel_cves数据准确性验证：避免误报的3个方法

linux_kernel_cves数据准确性验证：避免误报的3个方法 【免费下载链接】linux_kernel_cves Tracking CVEs for the linux Kernel 项目地址: https://gitcode.com/gh_mirrors/li/linux_kernel_cves 在Linux内核安全管理中，linux_kernel_cves项目提供…

作者头像 李华
网站建设 2026/7/6 16:08:26

Temboard用户指南：从入门到精通的PostgreSQL远程管理技巧

Temboard用户指南：从入门到精通的PostgreSQL远程管理技巧 【免费下载链接】temboard PostgreSQL Remote Control 项目地址: https://gitcode.com/gh_mirrors/te/temboard Temboard是一款功能强大的PostgreSQL远程管理工具，它提供了直观的界面和丰…

作者头像 李华
网站建设 2026/7/6 16:07:56

MegaDepth代码架构深度解析：理解pytorch-CycleGAN基础框架

MegaDepth代码架构深度解析：理解pytorch-CycleGAN基础框架 【免费下载链接】MegaDepth Code of single-view depth prediction algorithm on Internet Photos described in "MegaDepth: Learning Single-View Depth Prediction from Internet Photos, Z. Li an…

作者头像 李华
网站建设 2026/7/6 16:07:22

git-peek安装与配置：5分钟搭建你的本地代码预览环境

git-peek安装与配置：5分钟搭建你的本地代码预览环境 【免费下载链接】git-peek git repo to local editor instantly 项目地址: https://gitcode.com/gh_mirrors/gi/git-peek 想要快速预览GitHub仓库代码而不需要完整克隆？git-peek就是你的终极解…

作者头像 李华
网站建设 2026/7/6 16:02:10

GraphRAG 实战：从场景选择到效果验证

聊《GraphRAG 实战：从场景选择到效果验证》之前，先说一句实在的：别急着背概念，先看它在真实项目里到底解决什么问题。 摘要 这篇面向需要构建企业知识库和复杂问答系统的开发者，但不会把“GraphRAG 实战：…

作者头像 李华