콘텐츠로 이동

로컬 개발

FastAPI 백엔드와 Vite 개발 서버를 직접 실행합니다 — 코드를 수정하기에 가장 좋습니다.

사전 준비

  • Python 3.11+
  • Node.js 20.x는 20.19 이상, 또는 22.12 이상 (CI는 Node.js 24로 검증)
  • yt-dlp-ejs를 포함한 yt-dlp[default] (백엔드 의존성과 함께 설치)
  • PATH에 등록된 Deno 2.3 이상
  • ffmpeg / ffprobe

프런트엔드의 Node.js 프로세스는 백엔드에 JavaScript 실행 환경을 제공하지 않습니다. YouTube 처리에는 Deno와 EJS 패키지를 사용합니다. 백업을 시작하기 전에 설정 → 기술 설정에서 필요한 항목이 있는지 확인하세요.

백엔드

cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
CVN_DB_MIGRATE_ON_STARTUP=true uvicorn app.main:app --host 127.0.0.1 --port 8000

프런트엔드

cd frontend
npm ci --include=dev
VITE_API_BASE_URL=http://127.0.0.1:8000 npm run dev -- --host 127.0.0.1 --port 5173

콘솔 열기

http://127.0.0.1:5173/

헬스 체크

curl http://127.0.0.1:8000/api/health

실제 다운로드 켜기

개발 서버는 워커가 꺼진 상태로 시작합니다. 실제 전송을 하려면 워커 플래그를 설정하고 백엔드를 재시작하세요 — 실제 다운로드 켜기 참고.

다음 단계