업데이트

VDtN (Video Download to NAS) 1.1.2 업데이트 (ft. 확장, 봇)

빨간물약

17 11월 2025 — 5 min read

1.1.2 버전이 업데이트 됐습니다

API 토큰이 추가 됐는데요

SSO 생성 계정 같은 경우 비번이 따로 없어서

확장 프로그램이나 텔레그램 봇을 사용하려면 비번을 생성해야 했죠

사용하는데 문제는 없지만 불편하고 보안에도 좋지 않아서 토큰 생성 방식을 추가 했습니다

새 토큰 생성 버튼을 누르고 이름을 정한 후 토큰 생성 버튼을 누르시면

Config URL과 토큰이 생성 됩니다

생성한 토큰은 다시 확인이 안되니 처음 생성 됐을 때 잘 기록을 해두세요

Config URL은 서버 주소와 아이디 토큰이 전부 통합 돼있어서

확장 프로그램이나 텔레그램 봇에서 하나만 입력하면 됩니다

기존 아이디 + 비번 방식도 그대로 사용 가능하고

아이디 + 토큰 방식도 사용 가능 합니다

# ============================================================================
# 필수 설정 항목 (반드시 변경해야 하는 항목)
# ============================================================================

# JWT 시크릿 키 (프로덕션 환경에서 반드시 변경!)
# - 영문, 숫자, 하이픈(-), 언더스코어(_)만 사용 (특수문자 %@# 등은 피하세요)
# - 권장 길이: 32-64자
# - 예시: my-super-secret-jwt-key-for-production-2024
JWT_SECRET=change-this-secret-key-in-production

# SSO 암호화 키 (SSO 사용 시 필수)
# - OAuth2 클라이언트 시크릿을 데이터베이스에 암호화하여 저장할 때 사용
# - SSO를 사용하지 않으면 설정하지 않아도 됩니다
# 
# 권장 생성 방법 (가장 쉬움):
#   1) 애플리케이션을 먼저 실행하세요 (docker-compose up -d)
#   2) super_admin으로 로그인하세요
#   3) 설정 > SSO 탭에서 "암호화 키 생성" 버튼을 클릭하세요
#   4) 생성된 키를 복사하여 이 파일에 붙여넣으세요
#   5) docker-compose down && docker-compose up -d 로 재시작하세요
# 
# 대체 생성 방법:
#   - Python: python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
#   - Docker: docker exec -it video-download-to-nas-backend-1 python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
# 
# - 생성된 키 예시: gAAAAABk1234567890abcdefghijklmnopqrstuvwxyz==
# - ⚠️ 주의: 키를 변경하면 기존에 저장된 SSO 설정을 복호화할 수 없습니다!
SSO_ENCRYPTION_KEY=

# CORS 허용 출처 (쉼표로 구분된 목록)
# - 개발 환경: * (모든 출처 허용)
# - 프로덕션: 실제 도메인만 지정 (예: http://nas.example.com:3000,https://nas.example.com)
# - 시놀로지 예시: http://192.168.1.100:3000 또는 http://your-nas-domain:3000
ALLOWED_ORIGINS=*

# 백엔드 URL (OAuth2 리다이렉트 URI에 사용)
# - 시놀로지 예시: http://192.168.1.100:8000 또는 http://your-nas-domain:8000
# - 외부 접속 시: https://your-domain.com
BACKEND_URL=http://localhost:8000

# 프론트엔드 URL (인증 후 리다이렉트에 사용)
# - 시놀로지 예시: http://192.168.1.100:3000 또는 http://your-nas-domain:3000
# - 외부 접속 시: https://your-domain.com
FRONTEND_URL=http://localhost:3000

# 서버 URL (API 토큰 원클릭 설정에 사용)
# - 프론트엔드 URL과 동일하게 설정하세요
# - 텔레그램 봇/브라우저 확장에서 토큰 설정 시 사용됩니다
# - 시놀로지 예시: http://192.168.1.100:3000 또는 http://your-nas-domain:3000
SERVER_URL=http://localhost:3000

# HTTPS 강제 사용 (OAuth2 리다이렉트에 적용)
# - 개발 환경: false
# - 프로덕션 (HTTPS 사용 시): true
FORCE_HTTPS=false


# ============================================================================
# 고급 설정 (일반적으로 변경하지 않아도 되는 항목)
# ============================================================================

# 데이터베이스 경로
# - Docker 환경에서는 변경하지 마세요
# - 데이터는 /app/data 볼륨에 저장됩니다
DATABASE_URL=sqlite:////app/data/vdtn.db


# ============================================================================
# 참고 사항
# ============================================================================
# 
# 기타 설정 (Rate Limiting, 사용자 등록, 할당량 등)은
# super_admin으로 로그인 후 설정 페이지에서 변경할 수 있습니다.
#
# SSO 제공자 설정 (Google, Microsoft, GitHub 등)도
# 설정 페이지의 SSO 탭에서 구성할 수 있습니다.
#

복사

.env 파일입니다

# 서버 URL (API 토큰 원클릭 설정에 사용)
# - 프론트엔드 URL과 동일하게 설정하세요
# - 텔레그램 봇/브라우저 확장에서 토큰 설정 시 사용됩니다
# - 시놀로지 예시: http://192.168.1.100:3000 또는 http://your-nas-domain:3000
SERVER_URL=http://localhost:3000

복사

.env 파일에 서버 URL을 추가 하시면 됩니다

토큰 방식을 사용하기 위해서는 텔레그램 봇과 확장 프로그램을 업데이트 해야 합니다