Hermes Agent Control Room VPS 创建指南:用 create-vps 技能一键搭建 Hetzner 服务器与 SSH 别名

原创2026-10-29 13:38:062,134 阅读

Hermes Agent Control Room VPS 创建指南:用 create-vps 技能一键搭建 Hetzner 服务器与 SSH 别名

Hermes Agent Control Room 是一套「控制室优先」的开源模板,帮助你把 Hermes 智能体像操作系统一样管理起来。本指南将带你用内置的 create-vps 技能,一键在 Hetzner Cloud 上创建 VPS 服务器、生成 SSH 密钥并配置本地 SSH 别名,为后续部署智能体团队打好第一块基石 🚀

Hermes Agent Control Room 控制室架构示意图

为什么需要 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

在触发技能前,需要确保本地环境满足两个前提:

  1. 已安装 hcloud CLI(Hetzner 官方命令行工具)
  2. 拥有一个 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 章节,实际执行顺序是:

  1. 询问项目名 PROJECT_NAME(这是唯一需要你提供的输入)
  2. 由 PROJECT_NAME 派生 SERVER_NAME、SSH_ALIAS、SSH_KEY_FILE、SSH_KEY_NAME
  3. 创建本地项目文件夹,写入 .env、.gitignore、scripts/provision.sh、scripts/destroy.sh
  4. 提示你如何创建 Hetzner API Token
  5. 等你把 Token 粘贴进 .env 的 HCLOUD_TOKEN= 后确认
  6. 加载 .env,运行 hcloud server-type list 和 hcloud location list 拉取实时可选型号与机房
  7. 让你基于实时结果挑选服务器类型与位置
  8. 把所选值写回 .env
  9. 运行 scripts/provision.sh 完成开机器
  10. 用下面这条命令验证连通性
  11. 若触发词要求「agent vps」,则携带 SSH_ALIAS 进入 setup-control-room
  12. 否则询问你是否要引导 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 推荐给你的、最稳妥的起步姿势。

登录后查看全文
hermes-agent-control-room