🤖
什么是 Hermes Service API?
Hermes Agent 是一个功能强大的 AI 工作台,除了 Web UI 交互界面外,还内置了 Service API——你可以在自己的程序、网站或 APP 中直接调用它,让它帮你干活。
一
二
安装 Hermes Agent
- 连接服务器 — 使用 SSH 登录你的 VPS
- 部署 Hermes Agent — 一行命令完成安装:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash - 启用 Service API — 编辑
~/.hermes/.env,添加API_SERVER_ENABLED=true并重启 Agent 即可(不需要安装 Web UI)
💡 部署教程:查看教程
三
启用 Hermes Service API
Hermes Agent 内置了 Service API 功能,无需安装 Web UI。编辑 ~/.hermes/.env 添加 API_SERVER_ENABLED=true 并重启 Agent,即可获取以下信息:
🏗️ Base URL
http://localhost:8642/v1🔑 API Key
xxxxxxxxxxxxxxxx🧠 Model ID
hermes🔗 外部调用:绑定域名
如果需要从 VPS 之外调用,需要:
- 在宝塔面板中为端口 8642 添加反向代理
- 域名解析 A 记录 → VPS IP
- Nginx
proxy_pass 127.0.0.1:8642
同服务器内调用用 http://host.docker.internal:8642/v1
四
商用安全:限制工作目录
⚠️ 为什么需要限制目录?
Hermes Agent 具备操作文件系统和执行命令的能力。如果不限制它的工作目录,它可以访问服务器上任何文件——等同于拥有 root 权限,商用场景存在严重风险。
🔒 最佳实践
- 创建独立用户 — 新建低权限 Linux 用户
hermes,只给必要目录权限 - 限制工作区 — Web UI 中设置工作区为
/home/hermes/workspace/ - Nginx 路径限制 — 配置
location规则限制只能操作指定目录 - 定期审计 — 查看日志,监控执行了什么操作
🎯 总结
Hermes Service API 就像你的私人 AI 员工,随时待命。通过四步——买服务器 → 装 Agent → 开 API → 设权限——就能在任何地方调用它。
评论区
0 条评论 · 评论需审核通过后显示
发表评论