708e20f747
Some checks failed
CI Pipeline / Code Quality & Typecheck (push) Waiting to run
CI Pipeline / Test Suite (macos-latest) (push) Blocked by required conditions
CI Pipeline / Test Suite (ubuntu-latest) (push) Blocked by required conditions
CI Pipeline / Test Suite (windows-latest) (push) Blocked by required conditions
CI Pipeline / Build Validation (admin) (push) Blocked by required conditions
CI Pipeline / Build Validation (desktop) (push) Blocked by required conditions
Deploy Landing Page / deploy (push) Blocked by required conditions
Deploy Landing Page / build (push) Waiting to run
Release & Packaging Pipeline / Build & Publish Admin Docker Image (push) Failing after 8s
Release & Code Signing CA Pipeline / build-and-sign-windows (push) Failing after 1m51s
Build macOS / Build & Package (macOS) (push) Failing after 4s
Build macOS / Build & Package (macOS)-1 (push) Failing after 5s
Release & Code Signing CA Pipeline / build-and-sign-macos (push) Failing after 3s
Release & Packaging Pipeline / Package macOS Desktop App (push) Failing after 4s
Release & Packaging Pipeline / Package Windows Desktop App (push) Failing after 2m28s
Release & Packaging Pipeline / Publish Official GitHub Release (push) Has been skipped
1.6 KiB
1.6 KiB
D3RO Voice — NAS Docker Deployment Guide
D3RO Voice의 클라우드 백엔드 및 관리자 백오피스를 Synology, QNAP, Linux NAS에 Docker로 배포하는 빠른 안내입니다.
🚀 빠른 시작 (3단계)
1단계: 배포 패키지 생성 (개발 PC)
# Windows
.\scripts\deploy-nas.ps1
# Linux / Mac
./scripts/deploy-nas.sh
out/nas-package/ 폴더에 d3ro-voice-api.tar, docker-compose.yml, .env, nas-control.sh가 생성됩니다.
2단계: NAS에 배포 및 실행
out/nas-package/의 모든 파일을 NAS의 작업 폴더(예: /volume1/docker/d3ro)에 복사한 후 실행합니다:
cd /volume1/docker/d3ro
docker load < d3ro-voice-api.tar
docker compose up -d
3단계: 접속 및 설정
- 🌐 메인 포털:
http://<NAS_IP>:5000/ - ⚙️ 관리자 백오피스:
http://<NAS_IP>:5000/admin(첫 가입자에게 최고 관리자 권한 자동 부여) - 📖 API 문서:
http://<NAS_IP>:5000/swagger - 🩺 헬스체크:
http://<NAS_IP>:5000/health
🛠️ NAS 제어 스크립트 (nas-control.sh)
./nas-control.sh start— 서비스 시작./nas-control.sh stop— 서비스 중지./nas-control.sh status— 상태 및 헬스체크 확인./nas-control.sh logs— 실시간 로그 조회./nas-control.sh backup— SQLite DB 및 설정 백업 (tar.gz)./nas-control.sh update <새파일.tar>— 컨테이너 업데이트 및 재시작
자세한 시놀로지/큐냅 GUI 설정 가이드는 docs/deployment/nas-deployment-guide.md를 참고하세요.