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
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# D3RO Voice — NAS Docker Deployment Guide
|
|
|
|
D3RO Voice의 클라우드 백엔드 및 관리자 백오피스를 Synology, QNAP, Linux NAS에 Docker로 배포하는 빠른 안내입니다.
|
|
|
|
## 🚀 빠른 시작 (3단계)
|
|
|
|
### 1단계: 배포 패키지 생성 (개발 PC)
|
|
```powershell
|
|
# 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`)에 복사한 후 실행합니다:
|
|
```bash
|
|
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](docs/deployment/nas-deployment-guide.md)를 참고하세요.
|