← 全部教程
在 VPS 上运行 AI 代理,并用手机控制
把一台 4 美元的 VPS 变成能发消息交流的助手。Terminull 以无图形界面模式运行在 Linux 上,为你的密钥保持加密,接收 webhook,并执行定时任务 — 你可以随时从手机上批准或调整任何操作。
-
租一台小型 VPS
1 vCPU / 1 GB 就足够。一行命令安装,然后扫描安装脚本在终端打印的二维码完成配对 — 无需图形界面,无需连线。
-
让密钥保持加密
环境密钥保存在
~/.config/terminull/.env中,仅在运行期间于进程内使用。每一次会话都在手机与主机之间端到端加密,因此敏感内容既不会经过中继明文传输,也不会落入明文日志。 -
接收与管理 webhook
让助手执行
create_webhook— 你会得到一个专属的加密链接。把 GitHub、CI 或监控系统指向它:一次入站 POST 请求会以提醒形式送达你的手机,或者在主机上触发一次助手运行。你可以随时撤销它。 -
在主机上运行定时任务
类似 cron 的脚本或助手定时任务:每晚备份、证书续期、日志轮转、健康检查。仅显示重要运行会让它们保持静默,直到真正有需要你关注的事情。
-
从口袋里实现自动化
助手在 VPS 上运行命令,并以卡片形式实时输出;你可以在运行途中批准、调整方向或中断,并在任务完成或到达决策点时收到推送。
范例 · webhook → 助手
合并后自动部署,手机上收到回复
一个 GitHub push webhook 会触发一次运行,拉取代码、构建、重启服务,并把结果推送给你 — 之后还有一个脚本定时任务作为兜底的健康检查。
# GitHub webhook → your Terminull hook URL:
POST https://relay.terminull.dev/hook/<beacon>/<secret>
{ "title": "main pushed", "text": "deploy prod" }
# the agent, on the box:
git pull && docker compose up -d --build && curl -fsS localhost/health
# → push: "Deploy OK · health 200" (or the error, if not)