RackNerd VPS部署Hermes Agent教程：Ubuntu 24.04自建AI助手

Hermes Agent是Nous Research推出的开源AI助手，可以部署在自己的VPS上运行。服务器、模型接口和配置文件都由用户管理，还能通过网页控制台查看会话，后续也可以接入Telegram、Discord、Slack等消息平台。

这篇教程使用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
WhatsApp

接入消息平台通常需要创建机器人、获取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打开的网页控制台会断开，下次访问时需要重新建立。