Hostinger VPS Docker에서 Hermes Agent 24시간 업무 시스템 만들기

로컬 PC를 꺼도 Hermes가 계속 일하게 만들려고 Hostinger VPS에 Docker 환경을 잡았습니다. 설치만 끝내면 채팅은 되지만 Gateway와 메신저 연결까지 살아 있어야 업무 시스템으로 씁니다.

개요

이번 구성은 Hostinger 계정 가입부터 VPS 생성, Docker 템플릿 선택, Hermes Agent 운영까지 이어지는 흐름입니다. OpenAI 모델 인증, Telegram 봇 연결, Gateway 재시작도 같이 확인했습니다.
실행 환경은 Hostinger VPS의 Docker 컨테이너입니다.

저는 로컬 PC 대신 VPS를 골랐습니다. PC 절전이나 재부팅에 묶이지 않아 메신저에서 바로 일을 시킬 수 있기 때문입니다.

실제 문제 상황

로컬 PC에 설치하면 PC가 꺼진 동안 Telegram 요청과 예약 작업도 멈춥니다. 그래서 실행 위치를 VPS로 옮기고 Docker 안의 Hermes와 Gateway를 계속 켜 두는 구성을 잡았습니다.

사전 준비 사항

• Hostinger 계정 이메일과 결제 수단
• SSH 접속용 공개키 또는 임시 root 비밀번호
• OpenAI API 키와 Telegram 봇 토큰
• 로컬 PC의 VS Code와 Remote-SSH 확장

결제 전 확인 포인트: 요금제 갱신가, 서버 위치, Docker 또는 Hermes 템플릿 지원 여부입니다. 프로모션 가격만 보고 고르지 말고 갱신가를 먼저 봅니다.

전체 구성 흐름

계정: Hostinger 가입과 결제 확인. VPS: 요금제, 서버 위치, OS/Application 템플릿 선택.
Docker와 접속: Hermes 컨테이너 실행, SSH, Web Terminal, VS Code Remote-SSH, Dev Containers.

운영: OpenAI 인증, Telegram Gateway, SOUL.md/USER.md/MEMORY.md 구성.

1. Hostinger 가입

가입과 결제는 다음 순서로 진행합니다.

• Hostinger VPS Hosting 페이지로 이동합니다.
• Choose plan으로 요금제 선택 화면을 엽니다.
• 계정이 없으면 이메일로 가입하고 결제 안내 메일을 확인합니다.
• 이미 계정이 있으면 로그인 후 결제 단계로 이어집니다.

가입 직후 2FA를 켜고 결제 영수증 메일 주소도 맞춰 두시면 됩니다.

2. VPS 요금제와 서버 위치 선택

Hostinger VPS는 KVM 계열 플랜을 고르는 구조입니다. 개인 Hermes 운영이면 낮은 사양부터 시작하고 모델 호출 부하가 커질 때 올리는 순서가 무난합니다.

• 요금제: CPU, RAM, NVMe 용량을 비교합니다.
• 결제 주기: 월 환산 가격보다 갱신가를 먼저 봅니다.
• 서버 위치: 본인 또는 자주 쓰는 네트워크와 가까운 지역을 고릅니다.
• 부가 옵션: 백업, 스냅샷, AI 크레딧 묶음은 필요 여부만 확인합니다.

가격은 시점마다 바뀝니다. 결제 직전 화면의 갱신 조건을 확인합니다.

3. OS와 Application 템플릿 선택

결제 후 hPanel에서 VPS 생성 또는 재설치 단계가 이어집니다. 여기서 OS와 Application을 고릅니다.

• Application 경로: Application Catalog에서 Docker 또는 Hermes Agent를 고릅니다.
• Plain OS 경로: Ubuntu 같은 기본 OS를 설치한 뒤 Docker를 직접 올립니다.
• 관리 계정: 배포 중 입력한 관리자 사용자명과 비밀번호를 안전한 곳에 저장합니다.

Hermes Agent는 Application Catalog에서 배포합니다. 배포가 끝나면 컨테이너가 뜨고 터미널에서 Hermes CLI로 들어갑니다.

4. SSH와 Web Terminal 접속

VPS 상태가 Running이면 접속부터 확인합니다.

ssh root@<서버_IP>

또는 hPanel의 Web Terminal / AI Web Terminal로 바로 들어갑니다. 접속이 되면 패키지 업데이트와 Docker 상태부터 봅니다.

docker ps

Hermes 템플릿을 썼다면 Docker Manager 화면에서 Hermes 프로젝트 옆 터미널 버튼으로 CLI를 엽니다. 첫 실행 때는 설정 마법사가 뜨므로 방향키와 Enter로 모델 제공자를 고르면 됩니다.

5. Hermes 운영 설정

• Docker 안에서 Hermes 프로세스가 실행되는지 확인했습니다.
• OpenAI 모델 인증 뒤 일반 대화가 정상 응답하는지 확인했습니다.
• Telegram 봇이 요청을 받고 답하는지 살펴봤습니다.
• Gateway를 재시작한 뒤에도 서비스가 다시 올라오는지 점검했습니다.

인증 값과 봇 토큰은 config.yaml이 아니라 .env 같은 비공개 설정에 두시면 됩니다. VPS 화면을 캡처할 때도 토큰, 서버 IP, 계정명은 먼저 가려야 합니다.

Gateway가 멈추면 Telegram 연결도 같이 끊깁니다. 운영 전에는 상태 명령부터 확인해주시면 됩니다.

hermes gateway status
hermes gateway restart
hermes doctor

hermes gateway status에서 서비스가 active (running)으로 보이면 Gateway 프로세스가 살아 있는 상태입니다. hermes doctor는 설치와 설정 상태를 같이 점검합니다.

계속 켜 둘 Linux 서버라면 Gateway를 서비스로 등록하는 편이 낫습니다. 사용자 세션이 끝난 뒤에도 서비스가 유지돼야 합니다.

hermes gateway install
hermes gateway start

6. VS Code Remote-SSH와 정체성 파일

VPS의 Docker 환경은 웹 콘솔보다 VS Code Remote-SSH가 편했습니다. 로컬 VS Code에서 VPS에 SSH로 붙고 Dev Containers로 컨테이너 내부를 열어 설정 파일과 로그를 같은 편집기에서 다룹니다.

SOUL.md, USER.md, MEMORY.md도 이 경로에서 관리했습니다. 작업 기준과 기억을 파일로 남기면 대화가 바뀌어도 비서 역할이 유지됩니다.

• SOUL.md: 말투와 판단 기준
• USER.md: 사용자 기준
• MEMORY.md: 이어서 기억할 업무 정보

AI 에이전트가 여러 작업을 나눠 처리하는 구조는 Codex Micro AI 에이전트 컨트롤러 기능 정리에서도 확인됩니다.

적용 대상

개인 PC를 계속 켜 두기 어렵고 Telegram에서 서버 작업을 요청하고 싶은 경우에 맞습니다. 반대로 단순 채팅만 가끔 쓴다면 VPS와 Docker까지 올릴 필요는 없습니다. 먼저 운영 목적이 있는지 확인하시면 됩니다.

확인

hermes gateway status

서비스가 active (running)으로 표시되고 Telegram 봇이 응답하면 VPS에서 Hermes 업무 환경이 실행 중입니다.