VDtN (Video Download to NAS) 1.1.3 업데이트 (ft. 봇 내장, 권한 관리, 가입 승인)

스크린샷 2025-11-19 02.00.38.png

1.1.3 업데이트가 또 됐습니다

업데이트를 천천히 하려고 했는데 자주 되네요…

 

이번 업데이트는 텔레그램 봇을 그냥 내장 했습니다

 

우선 텔레그램 봇 기능을 사용하려면 또 .env 를 수정 해야 합니다

 

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

# 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
# - ⚠️ 브라우저 확장 프로그램 사용 시: 반드시 * 로 설정해야 합니다!
#   (확장 프로그램은 chrome-extension:// origin에서 요청을 보내므로)
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

# 텔레그램 봇 설정
# - 텔레그램 봇 기능 활성화 여부 (기본값: false)
TELEGRAM_BOT_ENABLED=false

# - 시스템 시작 시 활성 봇 자동 시작 여부 (기본값: false)
TELEGRAM_BOT_AUTO_START=false


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

 

# 텔레그램 봇 설정
# - 텔레그램 봇 기능 활성화 여부 (기본값: false)
TELEGRAM_BOT_ENABLED=false

# - 시스템 시작 시 활성 봇 자동 시작 여부 (기본값: false)
TELEGRAM_BOT_AUTO_START=false

텔레그램 봇 설정과 자동 시작을 추가해주시면 됩니다

사용하시려면 true로 변경 해줘야합니다

 

텔레그램봇 역시 권한 설정이 가능하고요

 

스크린샷 2025-11-18 23.57.23.png

권한이 있다면 계정 설정에 텔레그램 봇 탭이 추가 됩니다

버튼 모드, 베스트 모드, mp3 모드가 있고요

예전 봇 사용해보신 분들은 아시겠지만

버튼 모드는 확장 프로그램 처럼 해상도나 m4a mp3 선택이 가능한 모드고요

베스트 모드는 그냥 선택지 없이 베스트 해상도로 다운, mp3는 mp3로 다운 됩니다

 

스크린샷 2025-11-19 02.00.38.png

봇 모드는 설정 후에도 변경 가능하고요

다운로드 알림이나 진행 상황 알림을 활성화 하면 텔레그램으로 알림이 옵니다

그런데 용량 작은 것들은 금방 끝나서 진행상황 알림이 오지 않을 수 있습니다

 

스크린샷 2025-11-19 01.35.33.png

설정 후에 시작을 하면 이런 화면이 보입니다

 

 

스크린샷 2025-11-19 01.36.19.png

유튜브 주소를 넣으면 저는 버튼 모드라 이렇게 표시가 됩니다

 

스크린샷 2025-11-19 01.36.46.png

옵션을 선택하시면 다운로드가 시작 됩니다

 

스크린샷 2025-11-19 01.37.29.png

다운로드가 진행되면 실시간 진행율이 표시 됩니다

 

스크린샷 2025-11-19 01.38.56.png

 

스크린샷 2025-11-19 01.39.10.png

이런 식으로 1초마다 갱신 됩니다

 

스크린샷 2025-11-19 01.39.32.png

 

스크린샷 2025-11-19 01.40.00.png

다운로드가 완료되면 완료 메세지로 변경 됩니다

 

 

스크린샷 2025-11-19 00.08.04.png

설정 탭에 슈퍼 애드민이 접근 가능한 봇 관리와 권한 관리 메뉴가 생겼습니다

 

스크린샷 2025-11-19 00.08.50.png

텔레그램 봇 관리는 서버에서 실행 되고 있는 전체 텔레그램 봇을 확인하고 제어할 수 있습니다

 

 

image.png

역할 권한 관리 메뉴에는 기본 역할별 권한 설정이 가능 합니다

 

 

스크린샷 2025-11-19 00.14.12.png

그래서 개별 사용자 권한 관리도 좀 바꼈습니다

기본값, 허용, 거부 이렇게 3가지 상태로 제어 가능 합니다

좌측에는  역할 기본 권한이 표시되고요

우측 관리자 설정 권한이 우선 적용 됩니다

 

대충 넣을만한 기능은 다 넣은 거 같은데

이제 좀 실사용을 해보면서 수정을 하게 될 거 같습니다

 

한가지 생각하고 있는 기능은 수요가 있다면 자체 vpn 기능이나

warp 기능 또는 차단 우회 기능을 넣어볼까 생각 중입니다

 

VDtN 서버 이미지는 지금 업데이트 가능 합니다

 

-추가- 

스크린샷 2025-11-19 10.26.05.png

이제 가입시 관리자 승인 모드를 선택 할 수 있습니다

 

스크린샷 2025-11-19 09.15.54.png

승인 대기 중인 계정이 있으면 슈퍼 애드민 계정 프로필에 알림 마크가 표시 됩니다

설정 옆의 알림 아이콘을 클릭 하면 사용자 관리 메뉴로 이동 합니다

 

스크린샷 2025-11-19 09.28.30.png

설정 – 사용자 관리 탭에 승인대기 메뉴가 생겼습니다

승인시 로그인이 가능하고 거부시 계정이 삭제 됩니다

 

스크린샷 2025-11-19 10.18.07.png

 

스크린샷 2025-11-19 09.15.01.png

SSO 계정 생성과 로컬 계정 가입 둘 다 적용 됩니다

 

이미지는 지금 배포중이니 업데이트 하시면 됩니다

 

댓글 남기기

이메일 주소는 공개되지 않습니다. 필수 항목은 *(으)로 표시합니다