5.6 KiB
5.6 KiB
시놀로지 NAS에서 Jaryo File Manager 서비스 실행 가이드
1. 사전 준비사항
1.1 DSM 패키지 설치
- DSM 제어판 → 패키지 센터 접속
- 다음 패키지들을 설치:
- Node.js (최신 LTS 버전 권장)
- Git Server (선택사항, 소스코드 관리용)
- Web Station (선택사항, 웹 서버 프록시용)
1.2 SSH 활성화
- DSM 제어판 → 터미널 및 SNMP → SSH 서비스 활성화
- 포트 번호 확인 (기본: 22)
2. 프로젝트 배포
2.1 방법 1: 직접 파일 업로드 (간단한 방법)
- File Station에서
/volume1/web/폴더 생성 - 프로젝트 파일들을
jaryo폴더에 업로드 - SSH로 접속하여 설정
2.2 방법 2: Git을 통한 배포 (권장)
# NAS에 SSH 접속
ssh admin@your-nas-ip
# 프로젝트 디렉토리 생성
mkdir -p /volume1/web/jaryo
cd /volume1/web/jaryo
# Git 저장소 클론 (로컬에서 push한 경우)
git clone [your-repository-url] .
# 또는 로컬에서 직접 파일 복사
# scp -r ./jaryo/* admin@your-nas-ip:/volume1/web/jaryo/
3. 서비스 설정 및 실행
3.1 스크립트 권한 설정
# SSH로 NAS 접속
ssh admin@your-nas-ip
# 프로젝트 디렉토리로 이동
cd /volume1/web/jaryo
# 스크립트 실행 권한 부여
chmod +x start-service.sh
chmod +x stop-service.sh
3.2 서비스 시작
# 서비스 시작
./start-service.sh
# 로그 확인
tail -f logs/app.log
# 프로세스 상태 확인
ps aux | grep "node server.js"
3.3 서비스 중지
# 서비스 중지
./stop-service.sh
4. 자동 시작 설정 (선택사항)
4.1 Task Scheduler 사용
- DSM 제어판 → 작업 스케줄러
- 작업 생성 → 사용자 정의 스크립트
- 설정:
- 작업 이름: Jaryo Service Start
- 사용자: root
- 스케줄: 시스템 부팅 시
- 작업 설정:
/volume1/web/jaryo/start-service.sh
4.2 rc.local 사용 (고급 사용자)
# /etc/rc.local 파일 편집
sudo vi /etc/rc.local
# 다음 라인 추가
/volume1/web/jaryo/start-service.sh &
# 파일 저장 후 권한 설정
chmod +x /etc/rc.local
5. 방화벽 및 포트 설정
5.1 DSM 방화벽 설정
- DSM 제어판 → 보안 → 방화벽
- 방화벽 규칙 편집 → 규칙 생성
- 설정:
- 포트: 3005 (애플리케이션 포트)
- 프로토콜: TCP
- 소스: 허용할 IP 범위
5.2 라우터 포트 포워딩 (외부 접속용)
라우터에서 포트 3005를 NAS의 IP로 포워딩 설정
6. 웹 서버 프록시 설정 (Web Station 사용)
6.1 Web Station 설정
- Web Station → 가상 호스트 → 생성
- 설정:
- 도메인 이름: your-domain.com (또는 IP)
- 포트: 80 (또는 443 for HTTPS)
- 문서 루트:
/volume1/web/jaryo - HTTP 백엔드 서버:
http://localhost:3005
6.2 Apache 설정 (고급)
# /volume1/web/apache/conf/vhost/VirtualHost.conf
<VirtualHost *:80>
ServerName your-domain.com
DocumentRoot /volume1/web/jaryo
ProxyPreserveHost On
ProxyPass / http://localhost:3005/
ProxyPassReverse / http://localhost:3005/
<Directory /volume1/web/jaryo>
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
7. 모니터링 및 유지보수
7.1 로그 모니터링
# 실시간 로그 확인
tail -f /volume1/web/jaryo/logs/app.log
# 로그 파일 크기 확인
du -h /volume1/web/jaryo/logs/app.log
# 로그 로테이션 설정 (logrotate 사용)
7.2 서비스 상태 확인
# 프로세스 확인
ps aux | grep "node server.js"
# 포트 사용 확인
netstat -tlnp | grep :3005
# 메모리 사용량 확인
top -p $(cat /volume1/web/jaryo/app.pid)
7.3 백업 설정
- Hyper Backup 패키지 설치
/volume1/web/jaryo폴더 백업 스케줄 설정- 데이터베이스 파일 (
jaryo.db) 별도 백업 권장
8. 문제 해결
8.1 일반적인 문제들
서비스가 시작되지 않는 경우:
# Node.js 설치 확인
which node
node --version
# 의존성 재설치
cd /volume1/web/jaryo
rm -rf node_modules package-lock.json
npm install
# 권한 문제 확인
ls -la /volume1/web/jaryo/
chown -R admin:users /volume1/web/jaryo/
포트 충돌 문제:
# 포트 사용 확인
netstat -tlnp | grep :3005
# 다른 포트로 변경 (server.js 수정)
# const PORT = process.env.PORT || 3006;
메모리 부족 문제:
# 메모리 사용량 확인
free -h
# Node.js 메모리 제한 설정
# node --max-old-space-size=512 server.js
8.2 로그 분석
# 에러 로그만 확인
grep -i error /volume1/web/jaryo/logs/app.log
# 최근 100줄 확인
tail -100 /volume1/web/jaryo/logs/app.log
# 특정 시간대 로그 확인
grep "2024-01-15" /volume1/web/jaryo/logs/app.log
9. 보안 고려사항
- HTTPS 설정: Let's Encrypt 인증서 사용
- 방화벽 강화: 필요한 포트만 개방
- 정기 업데이트: Node.js 및 패키지 업데이트
- 백업: 정기적인 데이터 백업
- 모니터링: 로그 모니터링 및 알림 설정
10. 성능 최적화
- PM2 사용: 프로세스 관리자로 PM2 사용 고려
- 캐싱: 정적 파일 캐싱 설정
- 압축: gzip 압축 활성화
- CDN: 정적 파일 CDN 사용 고려
참고: 이 가이드는 시놀로지 DSM 7.x 기준으로 작성되었습니다. 버전에 따라 일부 설정이 다를 수 있습니다.