Hermes Agent是Nous Research推出的开源AI助手，可以部署在自己的美国VPS上运行。服务器、模型接口和配置文件都由用户管理，还能通过网页控制台查看会话，后续也可以接入Telegram、Discord、Slack等消息平台。
🔗 官网入口：点击访问 RackNerd 官网
这篇教程使用RackNerd 4GB VPS进行演示，系统选择Ubuntu 24.04 LTS。完成部署后，Hermes Agent可以调用OpenRouter提供的模型，通过命令行或网页控制台进行对话。
一、部署前需要准备什么
| 准备项目 | 具体要求 |
|---|---|
| VPS | 建议4GB内存及以上 |
| 操作系统 | Ubuntu 24.04 LTS |
| 本地电脑 | Windows、macOS或Linux均可 |
| SSH工具 | Windows使用PowerShell，macOS和Linux使用终端 |
| 模型接口 | 本教程使用OpenRouter |
| 浏览器 | 用于打开Hermes Agent网页控制台 |
部署过程中会同时使用本地电脑和远程服务器。本地电脑负责运行SSH客户端和浏览器，远程VPS负责安装并运行Hermes Agent。教程中的服务器命令，都需要在SSH连接成功后执行。
二、购买RackNerd 4GB VPS
从下面RackNerd活动方案中购买任意一款，本次使用的RackNerd方案为3核CPU、4GB内存，年付59.99美元，折合约5美元/月。该价格需要按年预付，套餐库存、续费规则和可选机房以RackNerd优惠码显示为准。
| 方案 | CPU | 内存 | SSD存储 | 月流量 | 端口 | 价格 | 购买链接 |
|---|---|---|---|---|---|---|---|
| 1GB KVM VPS | 1核 | 1GB | 20GB SSD | 3TB | 1Gbps | $21.99/年 | 点击购买 |
| 2GB KVM VPS | 2核 | 2GB | 35GB SSD | 5TB | 1Gbps | $35.99/年 | 点击购买 |
| 4GB KVM VPS | 3核 | 4GB | 60GB SSD | 7TB | 1Gbps | $59.99/年 | 点击购买 |
| 6GB KVM VPS | 6核 | 6GB | 100GB SSD | 12TB | 1Gbps | $89.99/年 | 点击购买 |
| 8GB KVM VPS | 7核 | 8GB | 150GB SSD | 20TB | 1Gbps | $119.99/年 | 点击购买 |
下单时选择Ubuntu 24.04 LTS。如果订单页面暂时没有该系统，也可以先选择其他Linux系统，开通后进入控制面板重装。
完成付款后，RackNerd会向注册邮箱发送服务器开通邮件，其中包含以下信息：
- VPS公网IP地址
- root用户名
- root初始密码
- 服务器控制面板信息
- 所在数据中心及网络信息
本文使用YOUR_VPS_IP代替服务器IP，使用YOUR_OPENROUTER_API_KEY代替OpenRouter密钥。实际操作时，需要替换成自己的信息。
三、通过SSH连接RackNerd VPS
Windows用户打开PowerShell，macOS和Linux用户打开终端，输入以下命令：
ssh root@YOUR_VPS_IP
把YOUR_VPS_IP替换为RackNerd邮件中提供的服务器IP。
第一次连接时，终端会询问是否信任服务器指纹，输入以下内容并按回车：
yes
随后输入root密码。粘贴密码时，终端不会显示字符，这是SSH的正常安全设置，粘贴后直接按回车即可。
连接成功后，命令提示符通常会变成类似下面的形式：
root@RackNerd-xxxxxxxx:~#
从下一步开始，所有命令都在这个SSH窗口中执行。
四、安装Hermes Agent所需组件
先更新Ubuntu软件列表，并安装Git、Curl、证书组件和tmux：
apt-get update && apt-get install -y git curl xz-utils ca-certificates tmux
安装过程需要几分钟。命令执行完成并重新出现命令提示符后，即可继续安装Hermes Agent。
五、运行Hermes Agent官方安装脚本
执行Nous Research提供的安装命令：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
这里安装的是Hermes Agent命令行版本，Windows和macOS桌面客户端不在本教程范围内。
如果安装程序自动进入交互式设置向导，可以按Ctrl+C退出，然后按照下一节手动配置模型。VPS环境不建议选择需要浏览器登录的Quick Setup (Nous Portal)。
安装完成后，重新加载环境变量并检查安装状态：
source ~/.bashrc && hermes doctor --fix
如果出现hermes: command not found，可以执行下面的命令重新加载程序路径：
source ~/.bashrc && export PAtd="/usr/local/bin:$HOME/.local/bin:$PAtd" && which hermes
正常情况下，终端会返回Hermes Agent程序的安装路径。
六、配置OpenRouter模型
Hermes Agent需要连接大模型才能回复消息。本教程使用OpenRouter，主要是因为它可以在一个接口中选择多家厂商的模型，部分模型还提供免费调用额度。
免费模型及其额度可能随时调整，正式使用前应查看OpenRouter当前的模型说明和限制。
注册OpenRouter账号
在本地电脑浏览器打开OpenRouter官网，注册并登录账号。随后进入OpenRouter密钥页面，创建一个新的API Key。密钥生成后应立即保存，不要发布在文章、截图、聊天记录或公开代码仓库中。
选择可用免费模型
打开OpenRouter模型页面，查找名称以:free结尾的免费模型。用于Hermes Agent时，可以优先选择上下文长度较大的模型。
本文以openai/gpt-oss-20b:free为例。如果该模型已经下架、取消免费额度或暂时不可用，可以替换成模型页面中其他可用的:free模型。
写入模型配置
回到RackNerd VPS的SSH窗口，依次执行以下命令：
hermes config set OPENROUTER_API_KEY YOUR_OPENROUTER_API_KEY
hermes config set model openai/gpt-oss-20b:free
hermes config set model.provider openrouter
hermes config set model.max_tokens 2048
将YOUR_OPENROUTER_API_KEY替换成刚才创建的真实密钥。如果更换其他模型，也需要把openai/gpt-oss-20b:free替换成对应的完整模型ID。
七、测试Hermes Agent对话
输入以下命令启动Hermes Agent：
hermes
看到欢迎界面和模型名称后，可以输入一条简单消息进行测试：
你好，请简单介绍一下你自己。
如果Hermes Agent能够正常回复，说明程序和模型接口已经配置完成。
需要退出当前会话时，输入以下任意命令：
/quit
或者：
/exit
如果没有收到回复，可以检查OpenRouter密钥是否正确、模型是否仍可调用，以及服务器能否正常访问OpenRouter接口。
八、通过SSH打开网页控制台
Hermes Agent自带网页控制台，默认监听127.0.0.1:9119。为了避免管理界面直接暴露在公网，本教程使用SSH访问。
先在VPS的SSH窗口中启动网页控制台：
hermes dashboard --no-open
–no-open表示只启动服务，不尝试在VPS中打开浏览器。请保持当前SSH窗口运行，然后在本地电脑上再打开一个PowerShell或终端窗口。
Windows、macOS和Linux建立
三个系统使用相同的命令：
ssh -N -L 9119:127.0.0.1:9119 root@YOUR_VPS_IP
输入服务器root密码后，窗口会保持空白，看起来没有继续执行，这是SSH正常运行的状态，不要关闭该窗口。
随后在本地电脑浏览器中打开：
http://127.0.0.1:9119/
这里使用的是http，地址也是本地回环地址。不要使用VPS公网IP访问9119端口，也不需要在服务器防火墙中放行9119端口。
进入控制台后，可以打开Chat页面发送消息，再进入API Keys页面检查OpenRouter是否已经配置。密钥应保持遮挡状态，不要在公开环境中展示完整内容。
九、让Hermes控制台退出SSH后继续运行
如果直接关闭运行控制台的SSH窗口，Hermes Dashboard也会随之停止。可以使用tmux让程序在退出SSH后继续运行。
如果控制台仍在前台运行，先按Ctrl+C停止，然后执行：
tmux new-session -d -s hermes-dash 'hermes dashboard --no-open'
检查tmux会话是否已经创建：
tmux ls
正常情况下会看到以hermes-dash开头的会话。此时可以关闭SSH窗口，Hermes Dashboard仍会在服务器后台运行。
以后需要查看控制台运行状态，可以重新连接VPS并执行：
tmux attach -t hermes-dash
查看完成后，先按Ctrl+B，松开后再按D，即可退出tmux界面，同时保持程序运行。不要直接按Ctrl+C，否则会终止Hermes Dashboard。
需要说明的是，tmux只能保证程序在退出SSH后继续运行。如果VPS重启，tmux中的进程也会停止，需要重新执行启动命令。长期使用可以再配置systemd开机启动。
十、后续可以接入哪些平台
网页控制台确认对话正常后，可以根据实际需要继续配置消息通道。Hermes Agent可接入的平台和配置方式会随版本更新，目前可以重点关注以下渠道：
- Telegram
- Discord
- Slack
接入消息平台通常需要创建机器人、获取Token并设置相应权限。建议先完成命令行和网页控制台测试，再逐个添加消息通道，出现问题时更容易排查。
十一、安全设置建议
Hermes Agent保存了模型密钥和对话信息，部署完成后应做好基本安全设置：
- 不要将9119端口绑定到0.0.0.0
- 不要在云服务器安全组中直接放行9119端口
- 通过SSH访问网页控制台
- 不要公开OpenRouter API Key
- 修改服务器root初始密码
- 定期更新Ubuntu和Hermes Agent
- 重要配置和会话数据应定期备份
- 长期使用时可以改用SSH密钥登录
- 不再使用的API Key应及时删除
如果需要让多人访问控制台，建议增加HTTPS反向代理和身份认证，不要直接把原始管理端口暴露在公网。
常见问题
Hermes Agent需要多大内存
轻量使用建议至少准备4GB内存。消息通道较多、任务复杂或同时运行其他服务时，可以选择8GB及以上方案。
RackNerd 4GB VPS可以运行本地大模型吗
4GB VPS更适合运行Hermes Agent程序并调用OpenRouter等外部模型接口，不适合运行大型本地语言模型。本地推理通常需要更多内存，部分模型还需要GPU。
59.99美元是月付价格吗
不是。59.99美元是年付总价，折合约5美元/月，需要一次支付全年费用。实际售价、库存和续费金额以RackNerd订单页面为准。
OpenRouter免费模型可以长期使用吗
免费模型、调用额度和限速规则会随平台调整，无法保证长期不变。用于正式业务时，建议准备付费模型或备用接口。
为什么浏览器无法打开Hermes控制台
先确认VPS中已经运行hermes dashboard –no-open，再检查本地SSH是否保持连接。浏览器应访问http://127.0.0.1:9119/，不能直接访问VPS公网IP的9119端口。
关闭电脑后Hermes Agent还能运行吗
只要Hermes Agent运行在VPS后台，本地电脑关闭后不会影响服务器进程。不过，通过SSH打开的网页控制台会断开，下次访问时需要重新建立。
