NAS, Docker, AI, OKX, Telegram, Logs
✅ 이 글에서 얻는 것 – 시스템 아키텍처를 한 장으로 정리 – 6가지 핵심 요소의 역할/선택 이유 – 데이터가 흐르는 순서(Workflow)로 “어떻게 굴러가는지” 이해
이전 글에서 우리는 “왜 자동매매를 하는가(Why)”와 “무엇을 증명할 것인가(What)”를 이야기했습니다.
이제는 “어떻게(How) 굴러가는지”, 시스템의 뼈대를 공개합니다.
Rappa Lab의 시스템은 RSI/볼린저만 보고 사고파는 ‘지표 봇’이 아닙니다.
NAS가 24시간 실행하고, Docker가 환경을 고정하며, Gemini가 맥락을 읽고, OKX가 주문을 집행하고, Telegram이 보고하고, Logs가 전부를 기록합니다.
1) 전체 구조도 (Architecture)
시스템은 아래 5개 역할로 분해하면 한 번에 이해됩니다.
- 실행하는 몸: NAS / Docker
- 생각하는 뇌: Gemini
- 거래하는 손: OKX
- 보고하는 입: Telegram
- 블랙박스(블랙박스): Logs
이 그림 한 장이, 우리가 구축할 시스템의 전부입니다.
2) 6가지 핵심 요소 (The 6 Pillars)
① Synology NAS (물리적 서버)
- 역할: 24/7 전원이 꺼지지 않는 ‘베이스캠프’
- 선택 이유: PC를 상시 가동하는 부담 없이, 저전력으로 수개월 안정 운영이 가능한 나만의 리눅스 서버입니다.
② Docker (실행 환경)
- 역할: 코드가 돌아가는 컨테이너(격리된 실행 공간)
- 선택 이유: 봇이 죽어도 NAS(호스트)에 영향을 주지 않도록 분리합니다. 또한 장비를 바꾸거나 NAS를 옮겨도 이미지/컴포즈만 있으면 동일 환경을 빠르게 복제할 수 있습니다.
③ Google Gemini API (AI 참모/지능)
- 역할: 데이터를 요약하고, 뉴스/이슈 등 ‘맥락’을 붙여 최종 판단을 보조
- 선택 이유: 전통적인 알고리즘은 “올랐다/내렸다”는 숫자만 압니다. 반면 Gemini는 “왜 움직였는지(뉴스/이슈)”를 해석하고, 복잡한 매매 기록을 “오늘의 한 줄 평”으로 정리해줍니다.
- 단, AI는 ‘승인(Judge)’ 역할에 집중하고
- 손절/포지션 사이즈/청산 방지 등 리스크 관리는 룰 기반이 최우선입니다.
④ OKX API (거래소/주문 집행)
- 역할: 실제 주문(Buy/Sell)을 전송하고 체결되는 시장
- 선택 이유: 앱을 켜지 않습니다. API 통신으로 시세 조회 → 주문/정정/취소까지 자동으로 처리합니다.
⑤ Telegram Bot (상황실/관제탑)
- 역할: 시스템 상태를 실시간으로 알리는 알림 센터
- 선택 이유: 봇에는 모니터가 없습니다. 시작/중단, 매수·매도 신호, 체결, 에러를 스마트폰으로 즉시 받습니다.
⑥ Logs (블랙박스/기록)
- 역할: 모든 행동과 판단의 근거를 남기는 기록 저장소
- 선택 이유: 기록이 없으면 개선도 없습니다.
수익이 났다면 어떤 조건이 먹혔는지, 손실이 났다면 전략 문제인지/서버 문제인지/AI 판단인지, 원인을 특정해야 다음 버전이 나옵니다. 그래서 봇의 모든 호흡을 텍스트로 남깁니다.
3) 데이터의 흐름 (Workflow)
6가지 요소는 매 순간 아래 순서로 데이터를 주고받습니다.
1. Wake Up (NAS): NAS가 Docker 컨테이너를 깨웁니다. 2. Collect (Code): 시장 데이터(가격·거래량 등)를 수집합니다. 3. Analyze (AI): Gemini가 데이터 + 뉴스/이슈를 요약해 시장 맥락을 판단합니다. 4. Execute (OKX): 전략 조건이 충족되면 OKX API로 주문을 전송합니다. 5. Notify (Telegram): 예) “AI 분석: 상승 우위 → 매수 주문 전송”을 즉시 보고합니다. 6. Record (Logs): AI 코멘트, 신호 근거, 체결 결과를 로그에 저장해 후일 복기합니다.
한 줄로 요약하면NAS/Docker(24/7) → Collect → Rule Engine → Gemini(Judge) → OKX(Execute) → Telegram(Notify) → Logs(Record)
4) 마치며: AI와 함께하는 자동화
거창한 서버실은 필요 없습니다.
방구석의 NAS 한 대 + Docker + Gemini만 있으면, 월 이용료 0원으로 24시간 인공지능 트레이딩 시스템을 굴릴 수 있습니다.
이제 뼈대를 이해했으니, 다음 글부터는 살을 붙여보겠습니다.
실패해도 무너지지 않게 만드는 건 ‘전략’이 아니라 운영 규칙이니까요.
Next Step
👉 04. 운영 규칙 7개: 시스템이 멈추지 않으려면 (작성 예정)
| 항목 | 값 |
|---|---|
| 상태 | 초안(draft) |
| 마지막 업데이트 | 2026-02-10 |
| 포함 범위 | NAS / Docker / Gemini / OKX / Telegram / Logs |