← 모든 튜토리얼

VPS에서 AI 에이전트를 실행하고 휴대폰으로 제어하기

4달러짜리 VPS를 문자로 대화 가능한 에이전트로 바꾸세요. Terminull은 Linux에서 헤드리스로 실행되며, 비밀 정보를 암호화된 상태로 유지하고, 웹훅을 받고, 예약 작업을 실행합니다 — 이 모든 것을 휴대폰에서 승인하거나 방향을 바꿀 수 있습니다.

  1. 작은 VPS 하나 빌리기

    1 vCPU / 1 GB면 충분합니다. 한 줄 설치 후, 설치 스크립트가 터미널에 출력하는 QR로 페어링하세요 — GUI도, 케이블도 필요 없습니다.

  2. 비밀 정보는 암호화된 상태로

    환경 변수 키는 ~/.config/terminull/.env에 있으며 실행 중 프로세스 내부에서만 사용됩니다. 모든 세션은 휴대폰과 서버 사이에서 종단간 암호화되므로, 민감한 정보는 릴레이를 타지도, 평문 로그에 남지도 않습니다.

  3. 웹훅 받고 제어하기

    에이전트에게 create_webhook을 요청하면 비밀 URL을 받습니다. GitHub, CI, 모니터링 도구를 그 URL로 연결하세요 — 인바운드 POST는 휴대폰으로 알림이 오거나, 서버에서 에이전트 실행을 시작합니다. 언제든지 취소할 수 있습니다.

  4. 서버에서 예약 작업 실행하기

    크론 방식의 스크립트 또는 에이전트 예약: 야간 백업, 인증서 갱신, 로그 로테이션, 헬스체크. 주목할 만한 실행만은 정말 주의가 필요할 때까지 조용히 있게 해줍니다.

  5. 주머니 속에서 자동화하기

    에이전트가 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)
다른 역할: 📱 iOS 개발자 🤖 Android 🌐 웹 / 프론트엔드 ⚙️ 백엔드 / API

준비되셨나요?

Mac이나 VPS에 Terminull Service를 설치하고, 앱을 받아 1분 안에 페어링하세요.