2.4 KiB
2.4 KiB
09. 배포 · 운영
구성
인터넷 → NPMplus (192.168.10.3:443, mquiz.tkrmagid.kr, Let's Encrypt)
→ 192.168.10.9:2974 → 컨테이너 music_quiz-app:3000 (Bun)
├─ /data/app.db (SQLite, WAL)
└─ /data/audio-cache (음원 캐시, 상한 5GB)
↘ Lavalink 192.168.10.6:2333 (유튜브 검색·재생 가능 확인, 읽기 전용 사용)
- 위치: .9
/home/claude/projects/music_quiz(joke-app과 같은 방식) - compose 프로젝트
music_quiz, 볼륨music_quiz_app-data, 포트2974:3000 - 갱신:
git pull && cd deploy && docker --context default compose -f docker-compose.proxy.yml up -d --build(--context default필수 — 기본 컨텍스트가 docker5라서) - 컨테이너 메모리 상한 1GB, 수집기는 별도 프로세스(상한 2GB)
환경변수 (deploy/.env, 권한 600, 커밋 금지)
| 이름 | 값 |
|---|---|
PUBLIC_ORIGIN |
https://mquiz.tkrmagid.kr |
APP_PORT |
2974 |
SESSION_SECRET |
새로 생성(32자 이상) |
DISCORD_CLIENT_ID |
1561284577564037140 |
DISCORD_CLIENT_SECRET |
비밀 저장소에서 주입 |
SUPERADMIN_DISCORD_IDS |
293719842274541579,1352267557213573160 |
LAVALINK_URL / LAVALINK_PW |
music_bot_v2 설정 재사용 |
YT_COOKIE_PATH |
(A안일 때) 유튜브 쿠키 파일 경로 |
AUDIO_CACHE_MAX_GB |
5 |
프록시 · 인증서
- DNS:
mquiz.tkrmagid.kr→ CNAMEtkrmagid.kr(이미 등록돼 있음 확인) - NPMplus에 프록시 호스트 추가: 대상
192.168.10.9:2974, WebSocket 켜기, joke-app과 같은 보안 헤더(npmplus-advanced.conf기반, CSP에 음원 주소 허용) - 인증서: Let's Encrypt, joke-app 때 쓴 인증서 스크립트 방식 그대로
백업
- 매일 새벽 SQLite
VACUUM INTO스냅샷 → 7일 보관(.9) + 주 1회 Nextcloud/claude/music_quiz/로 복사 - 음원 캐시는 백업하지 않음(다시 받으면 됨)
모니터링
/healthz(DB·디스크·Lavalink 연결 상태), 컨테이너 healthcheck- 관리자 대시보드에 수집 작업 실패, 유튜브 차단 신호, 캐시 사용량 표시
- 주 1회 유튜브 주소 재확인(삭제·지역제한 감지 → "재생 불가"로 표시 후 재매칭)
디스크
- .9 남은 공간이 약 140GB(권장 150GB 이상보다 적음). 음원 캐시는 상한 5GB로 시작, 늘리려면 Q15 결정에 따름