286 lines
6.0 KiB
Markdown
286 lines
6.0 KiB
Markdown
# 🏠 시놀로지 NAS 설치 가이드
|
|
|
|
## 📋 사전 준비사항
|
|
|
|
### 1. 시놀로지 NAS 요구사항
|
|
- **DSM 7.0 이상**
|
|
- **Container Manager** 패키지 설치
|
|
- **Git Server** 패키지 설치 (선택사항)
|
|
- **최소 2GB RAM** 권장
|
|
|
|
### 2. 필요한 포트
|
|
- **4000**: 프론트엔드 (Nginx)
|
|
- **8000**: 백엔드 API (FastAPI)
|
|
- **5432**: PostgreSQL (내부 통신)
|
|
|
|
## 🚀 설치 방법
|
|
|
|
### 방법 1: SSH를 통한 설치 (권장)
|
|
|
|
#### 1단계: SSH 접속
|
|
```bash
|
|
ssh admin@[시놀로지_IP주소]
|
|
```
|
|
|
|
#### 2단계: 프로젝트 디렉토리 생성
|
|
```bash
|
|
sudo mkdir -p /volume1/docker/todo-project
|
|
cd /volume1/docker/todo-project
|
|
```
|
|
|
|
#### 3단계: Git 클론
|
|
```bash
|
|
sudo git clone https://git.hyungi.net/hyungi/Todo-Project.git .
|
|
```
|
|
|
|
#### 4단계: 환경 설정
|
|
```bash
|
|
# 환경 변수 파일 생성
|
|
sudo cp .env.example .env
|
|
|
|
# 환경 변수 편집 (필요시)
|
|
sudo nano .env
|
|
```
|
|
|
|
#### 5단계: Docker 컨테이너 실행
|
|
```bash
|
|
sudo docker-compose up -d
|
|
```
|
|
|
|
#### 6단계: 설치 확인
|
|
```bash
|
|
# 컨테이너 상태 확인
|
|
sudo docker-compose ps
|
|
|
|
# 로그 확인
|
|
sudo docker-compose logs -f
|
|
```
|
|
|
|
### 방법 2: Container Manager GUI 사용
|
|
|
|
#### 1단계: Container Manager 열기
|
|
- DSM → **Package Center** → **Container Manager** 설치/실행
|
|
|
|
#### 2단계: 프로젝트 생성
|
|
- **Project** → **Create**
|
|
- **Project name**: `todo-project`
|
|
- **Path**: `/docker/todo-project`
|
|
|
|
#### 3단계: 소스 설정
|
|
- **Source**: `Git Repository`
|
|
- **Repository URL**: `https://git.hyungi.net/hyungi/Todo-Project.git`
|
|
- **Branch**: `main`
|
|
|
|
#### 4단계: 컨테이너 실행
|
|
- **Build and run** 클릭
|
|
- 자동으로 `docker-compose.yml` 파일을 읽어서 실행
|
|
|
|
## 🔧 설정 및 최적화
|
|
|
|
### 1. 환경 변수 설정 (.env)
|
|
```bash
|
|
# 데이터베이스 설정
|
|
POSTGRES_DB=todo_project
|
|
POSTGRES_USER=todo_user
|
|
POSTGRES_PASSWORD=your_secure_password_here
|
|
|
|
# JWT 설정
|
|
SECRET_KEY=your_jwt_secret_key_here
|
|
ACCESS_TOKEN_EXPIRE_MINUTES=30
|
|
|
|
# 시놀로지 연동 설정
|
|
SYNOLOGY_DSM_HOST=localhost
|
|
SYNOLOGY_DSM_PORT=5000
|
|
SYNOLOGY_DSM_USERNAME=your_username
|
|
SYNOLOGY_DSM_PASSWORD=your_password
|
|
|
|
# 메일 설정 (MailPlus 연동용)
|
|
MAIL_SERVER=localhost
|
|
MAIL_PORT=587
|
|
MAIL_USERNAME=your_mail_username
|
|
MAIL_PASSWORD=your_mail_password
|
|
MAIL_FROM=noreply@yourdomain.com
|
|
```
|
|
|
|
### 2. 볼륨 매핑 확인
|
|
```yaml
|
|
volumes:
|
|
- /volume1/docker/todo-project/data:/data
|
|
- todo_uploads:/data/uploads
|
|
```
|
|
|
|
### 3. 포트 포워딩 설정
|
|
- **제어판** → **외부 액세스** → **라우터 구성**
|
|
- 포트 4000을 외부에서 접근 가능하도록 설정
|
|
|
|
## 🌐 접속 방법
|
|
|
|
### 내부 네트워크
|
|
```
|
|
http://[시놀로지_IP]:4000
|
|
```
|
|
|
|
### 외부 접속 (DDNS 설정 시)
|
|
```
|
|
http://[your-synology-ddns].synology.me:4000
|
|
```
|
|
|
|
## 🔒 보안 설정
|
|
|
|
### 1. HTTPS 설정 (Let's Encrypt)
|
|
```bash
|
|
# 인증서 디렉토리 생성
|
|
sudo mkdir -p /volume1/docker/todo-project/ssl
|
|
|
|
# docker-compose.yml에 SSL 볼륨 추가
|
|
volumes:
|
|
- /volume1/ssl:/etc/ssl/certs
|
|
```
|
|
|
|
### 2. 방화벽 설정
|
|
- **제어판** → **보안** → **방화벽**
|
|
- 필요한 포트만 열기: 4000, 8000
|
|
|
|
### 3. 사용자 권한 설정
|
|
```bash
|
|
# Docker 그룹에 사용자 추가
|
|
sudo usermod -aG docker $USER
|
|
```
|
|
|
|
## 📊 모니터링 및 유지보수
|
|
|
|
### 1. 로그 확인
|
|
```bash
|
|
# 전체 로그
|
|
sudo docker-compose logs
|
|
|
|
# 특정 서비스 로그
|
|
sudo docker-compose logs frontend
|
|
sudo docker-compose logs backend
|
|
sudo docker-compose logs db
|
|
```
|
|
|
|
### 2. 컨테이너 상태 확인
|
|
```bash
|
|
# 실행 중인 컨테이너
|
|
sudo docker-compose ps
|
|
|
|
# 리소스 사용량
|
|
sudo docker stats
|
|
```
|
|
|
|
### 3. 업데이트
|
|
```bash
|
|
# 최신 코드 가져오기
|
|
sudo git pull origin main
|
|
|
|
# 컨테이너 재빌드
|
|
sudo docker-compose down
|
|
sudo docker-compose up -d --build
|
|
```
|
|
|
|
### 4. 백업
|
|
```bash
|
|
# 데이터베이스 백업
|
|
sudo docker-compose exec db pg_dump -U todo_user todo_project > backup.sql
|
|
|
|
# 업로드 파일 백업
|
|
sudo tar -czf uploads_backup.tar.gz /volume1/docker/todo-project/data/uploads
|
|
```
|
|
|
|
## 🔧 문제 해결
|
|
|
|
### 1. 컨테이너가 시작되지 않는 경우
|
|
```bash
|
|
# 로그 확인
|
|
sudo docker-compose logs
|
|
|
|
# 포트 충돌 확인
|
|
sudo netstat -tulpn | grep :4000
|
|
```
|
|
|
|
### 2. 데이터베이스 연결 오류
|
|
```bash
|
|
# PostgreSQL 컨테이너 상태 확인
|
|
sudo docker-compose exec db psql -U todo_user -d todo_project -c "SELECT 1;"
|
|
```
|
|
|
|
### 3. 권한 문제
|
|
```bash
|
|
# 파일 권한 수정
|
|
sudo chown -R 1000:1000 /volume1/docker/todo-project/data
|
|
```
|
|
|
|
### 4. 메모리 부족
|
|
```bash
|
|
# 메모리 사용량 확인
|
|
free -h
|
|
|
|
# Docker 메모리 제한 설정 (docker-compose.yml)
|
|
services:
|
|
backend:
|
|
mem_limit: 512m
|
|
```
|
|
|
|
## 📱 PWA 설정
|
|
|
|
### 1. HTTPS 필수
|
|
- PWA 기능을 위해서는 HTTPS 연결이 필요합니다
|
|
- Let's Encrypt 인증서 설정 권장
|
|
|
|
### 2. 홈화면 추가
|
|
- 모바일에서 Safari/Chrome으로 접속
|
|
- "홈화면에 추가" 선택
|
|
- 네이티브 앱처럼 사용 가능
|
|
|
|
## 🎯 성능 최적화
|
|
|
|
### 1. Nginx 캐싱 설정
|
|
```nginx
|
|
location /static/ {
|
|
expires 1y;
|
|
add_header Cache-Control "public, immutable";
|
|
}
|
|
```
|
|
|
|
### 2. 데이터베이스 최적화
|
|
```sql
|
|
-- 인덱스 생성
|
|
CREATE INDEX idx_todos_created_at ON todos(created_at);
|
|
CREATE INDEX idx_todos_status ON todos(status);
|
|
```
|
|
|
|
### 3. 이미지 최적화
|
|
- 업로드된 이미지는 자동으로 압축됩니다
|
|
- 최대 1920x1920 해상도로 리사이즈
|
|
- JPEG 품질 85%로 최적화
|
|
|
|
## 📞 지원
|
|
|
|
문제가 발생하면 다음을 확인해주세요:
|
|
1. **로그 파일**: `sudo docker-compose logs`
|
|
2. **시스템 리소스**: `htop` 또는 DSM 리소스 모니터
|
|
3. **네트워크 연결**: 포트 접근 가능 여부
|
|
4. **권한 설정**: 파일 및 디렉토리 권한
|
|
|
|
---
|
|
|
|
## 🚀 빠른 시작 명령어
|
|
|
|
```bash
|
|
# 전체 설치 (한 번에 실행)
|
|
ssh admin@[시놀로지_IP]
|
|
sudo mkdir -p /volume1/docker/todo-project
|
|
cd /volume1/docker/todo-project
|
|
sudo git clone https://git.hyungi.net/hyungi/Todo-Project.git .
|
|
sudo cp .env.example .env
|
|
sudo docker-compose up -d
|
|
|
|
# 접속 확인
|
|
curl http://localhost:4000
|
|
```
|
|
|
|
설치 완료 후 `http://[시놀로지_IP]:4000`으로 접속하여 Todo Project를 사용하세요! 🎉
|
|
|
|
|