자동매매 봇 24시간 무중단 운영 완전 가이드 — VPS·systemd·Docker·모니터링

자동매매 봇을 만든 분들이 가장 자주 겪는 사고는 "봇이 만든 줄 알았는데 새벽에 멈춰 있었다"입니다. 노트북은 절전으로 잠들고, 윈도우는 업데이트로 재부팅하고, 집 인터넷은 가끔 끊깁니다. 그 사이 손절 신호가 떴는데 봇이 멈춰 있으면 손실이 그대로 커집니다.

이 글은 알고랩이 봇 제작 후 운영 단계에서 가장 많이 안내하는 무중단 운영 셋업을 그대로 정리했습니다. 파이썬 입문·거래소별 30분 가이드로 봇을 만든 다음, 이 글로 운영 단계를 완성하면 됩니다. 리눅스를 처음 만지는 분도 따라할 수 있게 명령어 단위로 적었습니다.

노트북·집 PC가 봇을 멈추는 7가지

• 절전 모드 — 일정 시간 후 자동 슬립 → 봇 정지
• 윈도우 자동 업데이트 — 새벽에 강제 재부팅
• 인터넷 끊김 — 가정용 회선의 순간 단절
• 정전 — 데스크톱은 즉시 종료
• 실수로 종료 — 다른 작업 하다 PC 끔
• 발열·과부하 — 장시간 가동 시 불안정
• IP 변동 — 가정용 IP가 바뀌면 거래소 화이트리스트 막힘

VPS가 필요한 경우 vs PC도 괜찮은 경우

리전(서버 위치) 선택

• 한국 주식 (키움·KIS) → 서울 리전 (지연 최소)
• 코인 (바이낸스·바이비트·OKX) → 도쿄 또는 싱가포르 (거래소 서버 근처)
• 업비트·빗썸 → 서울 리전
• 다거래소 동시 → 도쿄가 평균 가장 무난

1. SSH 접속

# Windows는 PowerShell, Mac은 터미널에서
ssh root@서버IP
# 예: ssh [email protected]

2. 파이썬 + 기본 도구 설치 (Ubuntu 기준)

apt update && apt upgrade -y
apt install -y python3 python3-pip python3-venv git
python3 --version   # 3.10+ 확인

3. 봇 코드 올리기

# 방법 A: git (권장)
git clone https://github.com/본인/봇저장소.git
cd 봇저장소
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 방법 B: scp로 직접 전송 (로컬에서)
# scp -r ./bot root@서버IP:/home/bot

4. 기본 보안 (필수)

• 일반 사용자 생성 — root로 봇 돌리지 않기
• 방화벽(ufw) — SSH(22)만 열고 나머지 차단
• SSH 키 인증 — 비밀번호 대신 키 사용

# 일반 사용자 생성
adduser algolab
usermod -aG sudo algolab

# 방화벽
ufw allow 22
ufw enable

systemd 서비스 파일 만들기

# /etc/systemd/system/algobot.service
sudo nano /etc/systemd/system/algobot.service

[Unit]
Description=AlgoLab Trading Bot
After=network.target

[Service]
Type=simple
User=algolab
WorkingDirectory=/home/algolab/bot
ExecStart=/home/algolab/bot/venv/bin/python bot.py
Restart=always
RestartSec=10
StandardOutput=append:/home/algolab/bot/bot.log
StandardError=append:/home/algolab/bot/bot.log

[Install]
WantedBy=multi-user.target

등록 + 시작

sudo systemctl daemon-reload
sudo systemctl enable algobot      # 부팅 시 자동 시작
sudo systemctl start algobot       # 지금 시작
sudo systemctl status algobot      # 상태 확인

핵심 옵션 설명

자주 쓰는 명령어

sudo systemctl restart algobot     # 코드 수정 후 재시작
sudo systemctl stop algobot        # 정지
sudo journalctl -u algobot -f      # 실시간 로그 보기
tail -f /home/algolab/bot/bot.log  # 로그 파일 보기

언제 Docker를 쓰나

• 봇이 여러 개라 환경을 격리하고 싶을 때
• 로컬에서 테스트한 환경을 그대로 서버에 옮기고 싶을 때
• 의존성이 복잡하거나 시스템 라이브러리가 필요할 때

Dockerfile 예시

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "bot.py"]

실행 (자동 재시작 포함)

docker build -t algobot .
docker run -d --name algobot \
  --restart unless-stopped \
  --env-file .env \
  algobot
# --restart unless-stopped = systemd의 Restart=always 와 같은 역할

입문자는 systemd, 멀티 봇·복잡 환경은 Docker — 둘 다 자동 재시작이 핵심입니다.

봇 자체 알림 (매매·에러)

import requests, os

def send_telegram(msg):
    token = os.getenv("TG_BOT_TOKEN")
    chat = os.getenv("TG_CHAT_ID")
    if token and chat:
        requests.post(
            f"https://api.telegram.org/bot{token}/sendMessage",
            json={"chat_id": chat, "text": msg})

# 봇 코드 곳곳에서
send_telegram("✅ 봇 시작됨")
send_telegram(f"📈 매수 체결 BTCUSDT @ {price}")
send_telegram(f"⚠️ 에러: {e}")

텔레그램 봇 토큰 받기 (3분)

1. 텔레그램에서 @BotFather 검색 → /newbot → 토큰 발급
2. 만든 봇과 대화 시작 → 아무 메시지 전송
3. https://api.telegram.org/bot<토큰>/getUpdates 접속 → chat.id 확인

외부 헬스체크 (cron + 죽으면 알림)

# crontab -e 에 추가: 5분마다 봇 생존 확인
*/5 * * * * systemctl is-active --quiet algobot || \
  curl -s "https://api.telegram.org/bot토큰/sendMessage" \
  -d "chat_id=챗ID&text=🚨 봇이 멈췄습니다!"

VPS 자체 다운 감지 — UptimeRobot

systemd·cron은 VPS가 살아있을 때만 작동합니다. VPS 자체가 다운된 경우는 외부 모니터링이 필요합니다. UptimeRobot 같은 무료 서비스로 봇의 헬스체크 엔드포인트(또는 간단한 핑 서버)를 5분마다 외부에서 확인하면, VPS 다운도 즉시 알림 받습니다.

로그가 디스크를 채우는 문제

봇이 오래 돌면 로그 파일이 수 GB까지 커져 디스크가 꽉 차고 봇이 멈춥니다. logrotate로 자동 정리:

# /etc/logrotate.d/algobot
/home/algolab/bot/bot.log {
    daily
    rotate 14
    compress
    missingok
    notifempty
    copytruncate
}
# 14일치만 보관, 매일 압축

거래 기록은 별도 저장 (세금용)

운영 로그와 별개로, 모든 매매를 JSONL·CSV로 따로 저장해야 합니다. 한국 가상자산 양도세 신고에 필수입니다. 자세히는 → 자동매매 세금·신고 완전 가이드.

장애 대응 5단계

1. 알림 수신 — 텔레그램으로 "봇 멈춤" 또는 에러
2. 로그 확인 — journalctl -u algobot -n 100 또는 bot.log
3. 원인 분류 — API 오류 / 네트워크 / 코드 버그 / 잔고 부족
4. 임시 조치 — systemd가 이미 재시작했는지 확인, 안 됐으면 수동
5. 근본 수정 — 같은 장애 재발 방지 코드 추가

키움 OpenAPI+ 예외 — 리눅스 VPS 불가

16단계 체크리스트

VPS 준비 (4)

• ☐ VPS 선택 (입문 Vultr 도쿄 5$ / 무료 Oracle Free)
• ☐ 리전 = 거래소 위치 근처 (코인 도쿄, 한국주식 서울)
• ☐ SSH 접속 + 파이썬 설치
• ☐ 일반 사용자 + 방화벽(ufw) + SSH 키

봇 배포 (4)

• ☐ git clone 또는 scp로 코드 업로드
• ☐ 가상환경 + requirements 설치
• ☐ .env에 API 키 (gitignore 확인)
• ☐ 페이퍼 모드로 1회 수동 실행 테스트

무중단 (4)

• ☐ systemd 서비스 등록 (Restart=always)
• ☐ enable로 부팅 시 자동 시작
• ☐ 재부팅 테스트 (봇 자동 부활 확인)
• ☐ 일부러 봇 죽여보고 10초 후 재시작 확인

모니터링 (4)

• ☐ 텔레그램 알림 (시작·매매·에러)
• ☐ cron 헬스체크 (5분마다 죽으면 알림)
• ☐ UptimeRobot (VPS 자체 다운 감지)
• ☐ logrotate (로그 디스크 관리) + 거래기록 별도 저장

자주 묻는 질문

Q. 꼭 VPS에서 돌려야 하나요?

코인·분봉 전략이면 사실상 필수. 일봉 하루 1회면 PC도 가능하나 안정성 떨어짐. 월 5천~3만원이 가장 싼 보험.

Q. 어느 VPS?

입문 Vultr 도쿄 5$, 무료 Oracle Free(가입 까다로움), AWS 사용자 Lightsail. 코인은 도쿄·싱가포르, 한국주식은 서울 리전.

Q. 봇이 죽으면 자동 재시작?

systemd Restart=always + enable. Docker는 --restart unless-stopped.

Q. 멈춘 걸 빨리 알려면?

텔레그램 알림 + cron 헬스체크 + UptimeRobot(VPS 다운 감지) 조합.

Q. 키움 봇도 VPS에서?

키움 OpenAPI+는 Windows Server VPS 필요(고가). KIS·코인 거래소는 저렴한 리눅스 VPS로 충분.

Q. VPS 운영도 외주 가능?

가능. 모니터링만 월 5만~15만원, 예외 대응 포함 월 15만~30만원. 1~3개월 위탁 후 인수 권장.

마무리

무중단 운영은 "봇이 죽어도 자동으로 살아나고, 죽으면 즉시 아는 시스템"입니다. 핵심은 단 두 가지 — systemd 자동 재시작 + 텔레그램 헬스체크. 이 둘만 갖춰도 노트북 운영 대비 안정성이 비교할 수 없이 올라갑니다.

봇 제작은 1~3주면 되지만, 안정적 무중단 운영 체계를 갖추는 것은 또 다른 일입니다. 직접 하기 부담스럽다면 알고랩이 봇 제작과 함께 VPS 세팅·무중단 운영·모니터링까지 통합 제공합니다.