Hermes Agent Control Room VPS 创建指南:用 create-vps 技能一键搭建 Hetzner 服务器与 SSH 别名
Hermes Agent Control Room VPS 创建指南:用 create-vps 技能一键搭建 Hetzner 服务器与 SSH 别名
Hermes Agent Control Room 是一套「控制室优先」的开源模板,帮助你把 Hermes 智能体像操作系统一样管理起来。本指南将带你用内置的 create-vps 技能,一键在 Hetzner Cloud 上创建 VPS 服务器、生成 SSH 密钥并配置本地 SSH 别名,为后续部署智能体团队打好第一块基石 🚀
为什么需要 Control Room?
在开始搭建前,先理解 create-vps 在整个体系中的位置。Hermes Agent Control Room 的核心理念是:先搭控制室,再插智能体。
它提供了一条清晰的成长路径:
一个智能体 → 直接专家 → 编排器 → 自动化智能体团队
而 docs/starter-guide.md 中明确推荐的启动顺序是:
1. 创建一台 VPS(或选择已有 VPS)
2. 引导(Bootstrap)Agent Control Room
3. 注册第一个 Hermes 智能体
4. 角色清晰后添加直接专家
5. 需要一个统一入口时加入编排器
6. 手动流程跑通后再谈自动化
create-vps 正是这条路径上的第一步——它负责把「一台能 SSH 进去的服务器」这件事自动化。
💡 小贴士:本技能面向 Hetzner Cloud 用户。如果你已有其他云厂商的 VPS,可直接跳过本文,从 docs/starter-guide.md 的第 2 步开始。
create-vps 技能能帮你做什么
打开 skills/create-vps/SKILL.md 可以看到,这个技能的定位非常明确:从本地机器出发,一键在 Hetzner Cloud 上开出一台干净利落的服务器。
具体来说,它会为你生成:
| 产出物 | 说明 |
|---|---|
| 一台 Hetzner 服务器 | 通过 hcloud server create 创建,默认为 Ubuntu 24.04 |
| 一对 SSH 密钥 | 本地 ssh-keygen 生成 ed25519 密钥对 |
| 本地 SSH 别名 | 写入 ~/.ssh/config,之后只需 ssh <别名> |
| 本地项目文件夹 | 存放 .env、provision.sh、destroy.sh 等幂等脚本 |
| 可选衔接 | 可链式进入 setup-control-room 自动引导控制室 |
更妙的是它的**幂等性(Idempotency)**设计:provision.sh 可以安全地重复运行——密钥已存在就跳过、服务器已存在就跳过、只在最后用最新 IP 刷新 .env 和 SSH 配置块。这意味着你可以放心重试,不会重复扣费或产生孤儿资源。
准备工作:安装 hcloud CLI
在触发技能前,需要确保本地环境满足两个前提:
- 已安装
hcloudCLI(Hetzner 官方命令行工具) - 拥有一个 Hetzner Cloud 账号
如果 hcloud 缺失,技能会停下来并给出安装指引。建议按操作系统选择安装方式,完成后用 hcloud version 验证。
创建 Hetzner API Token
这是整个流程中唯一需要你手动操作的敏感步骤,也是安全规则的重灾区。
⚠️ 安全铁律:永远不要把 Hetzner Token 粘贴到聊天窗口中。技能会明确拒绝在对话中接收 Token。如果误发了,请立即在控制台吊销它并新建一个。
正确的创建路径是:
Hetzner Cloud Console
→ 选择项目
→ Security(安全)
→ API Tokens(API 令牌)
→ Generate API Token
→ 权限选择:Read & Write(读 & 写)
创建后,把 Token 直接粘贴进本地 .env 文件的 HCLOUD_TOKEN= 之后即可。完整的字段模板见 skills/create-vps/assets/env.template,它定义了所有必需变量:
HCLOUD_TOKEN # 你的 API 令牌(绝不可提交到仓库)
SERVER_NAME # 服务器名称(由 PROJECT_NAME 派生)
SERVER_TYPE # 服务器型号
SERVER_IMAGE # 系统镜像,默认 ubuntu-24.04
SERVER_LOCATION # 机房位置
SSH_KEY_NAME # SSH 密钥名
SSH_KEY_FILE # SSH 密钥文件路径
SSH_ALIAS # 本地 SSH 别名
注意 .env 已被 skills/create-vps/assets/gitignore.template 忽略,确保 Token 和密钥永远不进版本库。
触发 create-vps 的完整流程
create-vps 支持两种触发方式,分别对应「只开机器」和「开机器 + 引导控制室」:
独立触发(只创建 VPS)
向你的智能体说以下任意一句即可:
- "create a vps"
- "provision a server"
- "create a hetzner vps"
/create-vps
链式触发(创建 VPS 并引导 Control Room)
- "create an agent vps"
- "create a fully loaded vps"
/create-agent-vps
技能内部的 12 步执行流
参考 skills/create-vps/SKILL.md 中的 Flow 章节,实际执行顺序是:
- 询问项目名
PROJECT_NAME(这是唯一需要你提供的输入) - 由
PROJECT_NAME派生SERVER_NAME、SSH_ALIAS、SSH_KEY_FILE、SSH_KEY_NAME - 创建本地项目文件夹,写入
.env、.gitignore、scripts/provision.sh、scripts/destroy.sh - 提示你如何创建 Hetzner API Token
- 等你把 Token 粘贴进
.env的HCLOUD_TOKEN=后确认 - 加载
.env,运行hcloud server-type list和hcloud location list拉取实时可选型号与机房 - 让你基于实时结果挑选服务器类型与位置
- 把所选值写回
.env - 运行
scripts/provision.sh完成开机器 - 用下面这条命令验证连通性
- 若触发词要求「agent vps」,则携带
SSH_ALIAS进入setup-control-room - 否则询问你是否要引导 Agent Control Room
其中第 10 步的验证命令是:
ssh <别名> 'echo connected as $(whoami) on $(hostname); uname -a'
看到返回 connected as root on <主机名> 加内核信息,说明 SSH 别名已就绪。
服务器类型与位置怎么选
技能不会硬编码型号和价格——因为这些数据会随时变化。正确的做法是信任 hcloud server-type list 的实时输出。
skills/create-vps/references/server-types.md 给出了一份「家族速查表」帮助你在实时列表中快速定位:
| 前缀 | 架构 / 类型 | 适用场景 |
|---|---|---|
cax* |
ARM 共享 CPU | 通常最便宜,区域可用性有差异 |
cx* |
x86 共享 CPU | 大多数小型智能体盒子的稳妥默认 |
cpx* |
x86 共享 CPU | 区域可用性更广 |
ccx* |
独享 CPU | 性能更高,价格更贵 |
技能内置的默认值是 SERVER_TYPE=cx23、SERVER_LOCATION=hel1(赫尔辛基)、SERVER_IMAGE=ubuntu-24.04,对绝大多数新手来说是一个安全的起点。
日常使用:连接、查询与销毁
VPS 建好只是开始。skills/create-vps/references/daily-use.md 列出了日常最高频的几条命令:
# 查询你的服务器列表
hcloud server list
# 查看某台服务器详情
hcloud server describe <服务器名>
# 获取服务器 IP
hcloud server ip <服务器名>
# 通过别名直连(最常用)
ssh <别名>
而项目文件夹里的两个脚本是你最重要的「开关」:
# 重新初始化 / 幂等修复
./scripts/provision.sh
# 销毁 VPS(带二次确认,需手输 DELETE)
./scripts/destroy.sh
destroy.sh 的安全设计值得注意:它会先打印 This will delete Hetzner server: <服务器名>,然后要求你手动输入 DELETE 才会真正执行 hcloud server delete,杜绝误删。
常见问题排查
遇到问题时,skills/create-vps/references/troubleshooting.md 是首选求助手册。以下是四类高频问题:
1. hcloud 提示 unauthorized
Token 缺失、被吊销,或权限不足。回到控制台重新生成一个具备 Read & Write 权限的 Token,粘贴进 .env。
2. SSH 主机密钥告警(host key changed)
当服务器被重建但 IP 被复用时会出现。用这条命令清除旧指纹:
ssh-keygen -R <ip>
3. 服务器类型不可用
hcloud server-type list 和 hcloud location list 的可用性随机房而异。换一个有货的型号或机房即可。
4. SSH 别名连不上
先检查配置,再用调试模式定位:
cat ~/.ssh/config
ssh -v <别名>
-v 的详细输出能帮你快速判断是密钥问题、IP 问题还是网络问题。
下一步:接入 setup-control-room
create-vps 的终点是「一台能 SSH 进去的裸机」。如果你的触发词里带了 "agent vps",技能会自动携带 SSH_ALIAS 把接力棒交给 setup-control-room。
skills/setup-control-room/SKILL.md 会接着做这些事:
- 安装基础包(
curl、git、tmux、htop等) - 安装 Node.js 22
- 安装 Claude Code、Codex CLI
- 安装 Docker
- 尽力安装 Hermes Agent
- 克隆本模板到
/root/agent-control-room - 把内置技能软链接到
~/.claude/skills
引导完成后,SSH 进服务器完成交互式认证:
ssh <别名>
claude /login
codex
hermes
cd /root/agent-control-room
cat README.md
📌 提醒:交互式认证必须在真实 SSH 终端中完成,不要在聊天里粘贴任何 Provider 的 API Key。
总结
create-vps 技能把「开一台 Hetzner VPS」这件原本需要登录控制台点来点去的事,压缩成了一句自然语言指令。它帮你自动处理 SSH 密钥、SSH 别名、幂等脚本和销毁确认,让你能心无旁骛地进入真正的智能体建设。
记住这条主线:
create-vps → 创建服务器与 SSH 别名
setup-control-room → 安装工具链并克隆模板
agent-control-room → 在控制室内注册并管理智能体
先跑通 Level 1(控制室 + 一个智能体),再逐步升级,就是 Hermes Agent Control Room 推荐给你的、最稳妥的起步姿势。
