如何快速部署 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-studioHermes 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%\hermesmacOS/Linux~/.hermesWeb UI 状态数据存储在~/.hermes-web-ui可通过HERMES_WEB_UI_HOME环境变量自定义命令行工具集成安装后系统会添加以下命令工具hermes-studio- 打开 Hermes Studio 桌面应用hermes-studio cli ...- 运行捆绑的 Hermes Agent CLIhermes-studio web ...- 运行捆绑的hermes-web-ui命令hermes-studio-mcp- 运行托管的 Web UI MCP 桥接器自动更新机制桌面应用支持自动更新优先从https://download.ekkolearnai.com/latest获取更新备用方案GitHub Releases 最新版本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 PORT9000 export BIND_HOST0.0.0.0 # 设置数据目录 export HERMES_WEB_UI_HOME/path/to/your/data # 设置认证令牌 export AUTH_TOKENyour-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_IMAGEekkoye8888/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_IMAGEekkoye8888/hermes-web-ui # 自定义端口 PORT8080 # 自定义绑定主机 BIND_HOST0.0.0.0 # 自定义数据目录 HERMES_DATA_DIR/path/to/hermes/data 部署方式对比特性桌面应用npm 部署Docker 部署安装难度⭐⭐⭐⭐⭐最简单⭐⭐⭐⭐需要 Node.js⭐⭐⭐需要 Docker配置灵活性⭐⭐有限⭐⭐⭐⭐⭐完全可配置⭐⭐⭐⭐环境变量配置系统资源⭐⭐⭐中等⭐⭐⭐⭐可控⭐⭐⭐⭐⭐最佳隔离更新维护⭐⭐⭐⭐⭐自动更新⭐⭐⭐⭐命令行更新⭐⭐⭐手动更新镜像适合场景个人用户、快速体验开发者、自定义部署生产环境、服务器部署️ 常见问题解决1. 端口冲突问题如果默认端口被占用可以修改启动端口# npm 方式 hermes-web-ui start --port 9000 # Docker 方式 PORT9000 docker compose up -d2. 认证令牌获取首次启动后认证令牌会自动生成# Docker 方式查看令牌 docker compose logs hermes-webui | grep token # 或直接查看文件 cat ./hermes_data/hermes-web-ui/.token3. 数据备份与迁移所有部署方式的数据都存储在指定目录中桌面应用~/.hermes和~/.hermes-web-uinpm 部署~/.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_LEVELwarn export BRIDGE_LOG_LEVELwarn # 调整文件大小限制 export MAX_DOWNLOAD_SIZE500MB export MAX_EDIT_SIZE20MB # 调整桥接超时设置 export HERMES_AGENT_BRIDGE_TIMEOUT_MS180000 总结与建议Hermes Studio 提供了三种灵活的部署方式满足不同用户的需求桌面应用适合想要快速上手、无需配置的个人用户npm 部署适合需要高度自定义配置的开发者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），仅供参考