📈 Freqtrade 설치 가이드: 초보자부터 전문가까지

📈 Freqtrade 설치 가이드: 초보자부터 전문가까지

Freqtrade는 파이썬 기반의 강력한 암호화폐 자동매매 봇입니다. 설치 방법은 크게 두 가지가 있습니다.

1. Docker 이용 (추천 ⭐): 가장 깔끔하고 오류가 적습니다.
2. 소스 코드 설치: 파이썬 개발자나 코드를 수정하고 싶은 분들께 적합합니다.

---

1. 사전 준비 사항 (Prerequisites)

설치를 시작하기 전에 다음 프로그램들이 컴퓨터에 설치되어 있어야 합니다.

• Git: 소스 코드를 다운로드하기 위해 필요합니다. (설치 링크)
• Python (3.9 ~ 3.11): 소스 코드 설치 시 필요합니다. (최신 3.12는 호환성 문제가 있을 수 있음)
• Docker Desktop: Docker 방식으로 설치할 경우 필수입니다. (설치 링크)

💡 Windows 사용자 필독:
윈도우에서는 반드시 WSL2 (Windows Subsystem for Linux 2) 환경에서 진행하는 것을 강력 권장합니다. 일반 CMD나 PowerShell에서는 의존성 오류가 발생할 확률이 매우 높습니다.

---

2. 방법 A: Docker로 설치하기 (가장 쉬움)

환경 설정 충돌 걱정 없이 가장 빠르게 시작하는 방법입니다. 도커에 익숙하지 않으시다면 다음 글을 먼저 보시고 진행해보세요.

도커(Docker) 입문편 컨테이너 기초부터 서버 배포까지

1단계: 프로젝트 클론(다운로드)

터미널(또는 PowerShell)을 열고 폴더를 만들 곳으로 이동한 뒤 명령어를 입력합니다.

git clone https://github.com/freqtrade/freqtrade.git
cd freqtrade

2단계: 설정 파일 생성

Freqtrade가 실행되려면 config.json 파일이 필요합니다. Docker 명령어로 마법사를 실행해 쉽게 만들 수 있습니다.

# 최신 이미지를 먼저 가져옵니다
docker compose pull

# 설정 마법사 실행
docker compose run --rm freqtrade new-config

설정 마법사 질문 가이드:

• Do you want to enable Dry-run? -> Yes (처음에는 가상 매매로 시작하세요)
• Please insert your stake currency: -> USDT (주로 사용하는 기축 통화)
• Select exchange: -> binance (사용할 거래소 선택)

3단계: 봇 실행

설정이 완료되면 아래 명령어로 봇을 실행합니다.

docker compose up -d

• -d 옵션은 백그라운드에서 실행한다는 뜻입니다.

4단계: 실행 확인

브라우저를 열고 http://127.0.0.1:8080에 접속해보세요. Freqtrade UI가 보이면 성공입니다! (초기 로그인 ID/PW는 터미널 로그에서 확인 가능)

---

3. 방법 B: 소스 코드로 설치하기 (개발자용)

직접 전략 코드를 수정하거나 파이썬 환경을 제어하고 싶을 때 사용합니다.

1단계: 설치 스크립트 실행

Freqtrade 폴더 내에 있는 설치 스크립트를 사용하면 편리합니다.

Linux / MacOS / WSL2:

git clone https://github.com/freqtrade/freqtrade.git
cd freqtrade
./setup.sh -i

2단계: 가상 환경 활성화

설치가 끝나면 .venv라는 가상 환경이 만들어집니다.

source .venv/bin/activate

3단계: 봇 실행

freqtrade trade --config config.json

---

4. 자주 묻는 질문 (FAQ)

Q. 설치하다가 에러가 너무 많이 나요.
A. 파이썬 버전 문제거나 C++ 빌드 도구 누락일 가능성이 높습니다. 이 과정이 복잡하게 느껴지신다면, Docker 방식을 사용하시거나 저희가 준비 중인 클라우드 호스팅 서비스(사전 예약 중)를 이용하시면 클릭 한 번으로 봇을 생성할 수 있습니다.

Q. 거래소 API 키는 어디에 넣나요?
A. 생성된 config.json 파일을 메모장이나 VS Code로 열어 "exchange" 섹션의 "key"와 "secret" 부분에 입력하면 됩니다.

---