一、部署前环境准备

在正式部署前需完成基础环境配置，建议使用Linux发行版（Ubuntu 20.04+或CentOS 8+）或WSL2（Windows Subsystem for Linux）环境。系统需满足以下要求：

• 内存：建议8GB以上（基础模型运行）
• 磁盘空间：至少20GB可用空间
• 网络：稳定的外网连接（需下载依赖包）
• 权限：具备sudo或root权限

对于Windows用户，推荐通过WSL2创建Linux子系统：

1. 在PowerShell中执行wsl --install安装默认发行版
2. 通过Microsoft Store安装Ubuntu 22.04 LTS
3. 启动终端后执行sudo apt update && sudo apt upgrade -y更新系统

agent-">二、Hermes Agent核心服务部署

2.1 自动化安装脚本执行

通过官方提供的自动化脚本可快速完成基础安装：

# 使用curl下载并执行安装脚本（建议先验证脚本来源）
curl -fsSL [托管仓库地址]/install.sh | bash

脚本执行过程包含以下关键步骤：

1. 依赖检查：验证系统是否满足运行要求
2. 组件下载：从标准仓库获取最新版本二进制文件
3. 服务注册：创建systemd服务单元文件
4. 权限配置：设置工作目录访问权限

2.2 核心参数配置

安装完成后需通过交互式配置界面完成关键设置：

1. 选择API供应商类型（必填项）
2. 输入授权凭证（API Key）：
   - 输入时终端不会显示字符（安全设计）
   - 确认后按Enter提交
3. 配置服务端点地址：
   - 格式示例：https://api.example.com/v1
   - 需包含协议头和路径前缀
4. 模型选择策略：
   - 预设列表：显示已支持的模型名称
   - 自定义输入：支持非标准模型标识符
5. 微信集成选项（可选）：
   - 选择1启用需额外配置机器人凭证
   - 选择2跳过相关功能模块

配置完成后输入Y确认，系统将自动生成config.yaml配置文件并启动服务。可通过journalctl -u hermes-agent -f查看实时日志。

三、Web管理界面部署

3.1 源代码获取与编译

通过版本控制系统获取最新代码：

# 创建工作目录并拉取代码
git clone [托管仓库地址] hermes-webui
cd hermes-webui
# 安装构建依赖（Ubuntu示例）
sudo apt install -y nodejs npm
npm install --production

3.2 服务启动配置

项目包含两种启动方式：

1. 开发模式（适合调试）：

   npm run dev

2. 生产模式（推荐使用）：

   # 创建PM2进程管理配置
   npm install -g pm2
   pm2 start npm --name "hermes-ui" -- start
   pm2 save
   pm2 startup

服务默认监听127.0.0.1:8787，如需修改端口需编辑.env文件中的PORT变量。通过浏览器访问http://localhost:8787即可进入管理界面。

四、高级配置与优化

4.1 服务持久化

建议将工作目录挂载到持久化存储：

# 创建专用目录并修改权限
sudo mkdir /var/lib/hermes
sudo chown -R $USER:$USER /var/lib/hermes
# 修改配置文件中的storage路径
vim config.yaml

4.2 安全加固措施

1. 防火墙配置：

   sudo ufw allow 8787/tcp
   sudo ufw enable

2. 认证集成：
   • 在Web UI目录创建.htpasswd文件
   • 修改nginx.conf添加认证模块
3. 日志轮转：

   /var/log/hermes/*.log {
       daily
       missingok
       rotate 7
       compress
       delaycompress
       notifempty
       create 640 root adm
   }

五、常见问题解决方案

5.1 安装失败处理

现象：脚本执行中断报错”Dependency not found”
解决方案：

1. 检查系统架构是否匹配（仅支持x86_64/ARM64）
2. 手动安装缺失依赖：

   # Ubuntu示例
   sudo apt install -y libssl-dev libffi-dev

5.2 API连接异常

现象：Web界面显示”Model connection failed”
排查步骤：

1. 验证API端点可达性：

   curl -I [API地址]

2. 检查网络策略是否放行出站443端口
3. 查看Agent日志获取详细错误码

5.3 性能优化建议

1. 模型缓存：在配置中启用model_cache: true
2. 并发控制：通过max_concurrent_requests参数限制负载
3. 资源监控：集成Prometheus采集关键指标

六、升级与维护

6.1 版本升级流程

# 停止现有服务
sudo systemctl stop hermes-agent
# 执行升级脚本（官方提供）
curl -fsSL [托管仓库地址]/upgrade.sh | bash
# 验证新版本
hermes-agent --version

6.2 备份策略

建议每日自动备份配置文件和模型数据：

# 创建备份脚本backup.sh
#!/bin/bash
tar -czf /backups/hermes-$(date +%Y%m%d).tar.gz /etc/hermes /var/lib/hermes
# 添加cron任务
(crontab -l 2>/dev/null; echo "0 2 * * * /path/to/backup.sh") | crontab -

通过以上完整部署方案，开发者可在30分钟内完成从环境准备到服务上线的全流程。实际部署时建议先在测试环境验证，再逐步迁移至生产环境。对于企业级部署，可考虑结合容器化技术实现更高效的资源管理和服务编排。