← 모든 튜토리얼
VPS에서 AI 에이전트를 실행하고 휴대폰으로 제어하기
4달러짜리 VPS를 문자로 대화 가능한 에이전트로 바꾸세요. Terminull은 Linux에서 헤드리스로 실행되며, 비밀 정보를 암호화된 상태로 유지하고, 웹훅을 받고, 예약 작업을 실행합니다 — 이 모든 것을 휴대폰에서 승인하거나 방향을 바꿀 수 있습니다.
-
작은 VPS 하나 빌리기
1 vCPU / 1 GB면 충분합니다. 한 줄 설치 후, 설치 스크립트가 터미널에 출력하는 QR로 페어링하세요 — GUI도, 케이블도 필요 없습니다.
-
비밀 정보는 암호화된 상태로
환경 변수 키는
~/.config/terminull/.env에 있으며 실행 중 프로세스 내부에서만 사용됩니다. 모든 세션은 휴대폰과 서버 사이에서 종단간 암호화되므로, 민감한 정보는 릴레이를 타지도, 평문 로그에 남지도 않습니다. -
웹훅 받고 제어하기
에이전트에게
create_webhook을 요청하면 비밀 URL을 받습니다. GitHub, CI, 모니터링 도구를 그 URL로 연결하세요 — 인바운드 POST는 휴대폰으로 알림이 오거나, 서버에서 에이전트 실행을 시작합니다. 언제든지 취소할 수 있습니다. -
서버에서 예약 작업 실행하기
크론 방식의 스크립트 또는 에이전트 예약: 야간 백업, 인증서 갱신, 로그 로테이션, 헬스체크. 주목할 만한 실행만은 정말 주의가 필요할 때까지 조용히 있게 해줍니다.
-
주머니 속에서 자동화하기
에이전트가 VPS에서 명령을 실행하고 출력을 카드로 스트리밍합니다. 실행 도중 승인하거나, 방향을 바꾸거나, 중단할 수 있고, 완료되거나 판단이 필요한 시점에 알림을 받습니다.
병합 시 배포, 휴대폰으로 응답
GitHub push 웹훅이 실행을 트리거해 pull, 빌드, 서비스 재시작을 수행하고 결과를 알려줍니다 — 이후에는 스크립트 예약이 안전망 역할의 헬스체크를 수행합니다.
# 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)
준비되셨나요?
Mac이나 VPS에 Terminull Service를 설치하고, 앱을 받아 1분 안에 페어링하세요.