Installation, operations, and mobile sharing guides for youtube-dl-nas
로그인된 대시보드에서 NAS로 영상, 오디오, 자막을 개별 다운로드하고 저장된 파일을 관리할 수 있습니다.
로그인 전 또는 대시보드 상단의 언어 선택기에서 English, 한국어, 简体中文, Polski를 선택할 수 있습니다. 처음 접속할 때 지원하는 브라우저 언어를 자동 감지하고, 지원하지 않는 언어는 영어로 표시하며, 직접 선택한 언어는 저장됩니다.
호환성을 우선해야 하는 기기에서는 Compatible MP4 (H.264/AAC)를 선택하세요. 원본에 해당 코덱 조합이 없으면 다른 코덱으로 조용히 바꾸거나 트랜스코딩하지 않고 명확히 실패하며, 기존 Best의 의미는 바뀌지 않습니다.
요청이 정상적으로 큐에 들어가면 현재 기기에 선택한 프로필을 기억합니다. 새 기기이거나 저장값이 올바르지 않으면 Best로 돌아가며 URL을 자동 제출하지는 않습니다.
Options를 열면 미디어 옆에 JPG 썸네일을 저장하거나 이 기기의 PWA 모바일 공유 기본 프로필을 정하고, 제한된 소스에 사용할 Netscape 쿠키 파일을 관리할 수 있습니다. 항상 물어보기는 공유 URL을 바로 큐에 넣지 않고 입력창에 채워 출력 프로필을 확인하게 합니다.
쿠키는 계정 접근 권한을 포함할 수 있는 민감한 정보입니다. 접근 권한이 있는 사이트에서 내보낸 파일만 사용하세요. 앱 관리 파일은 1 MiB 제한과 형식 검사를 거쳐 메타데이터 볼륨에 소유자 전용 권한으로 저장되며 여기서 교체하거나 삭제할 수 있습니다. YTDLP_COOKIES_FILE로 외부 파일을 마운트한 경우에는 준비 상태만 표시하고 변경하지 않습니다.
재생목록이나 채널 URL을 입력하면 Playlist Guard가 범위 선택기를 표시합니다. 재생목록 파라미터가 붙은 개별 영상 URL은 현재 영상만이 기본값입니다. 순수 재생목록과 채널 URL은 처음 10개 또는 전체 항목을 명시적으로 골라야 큐에 넣을 수 있습니다. 완료된 각 항목은 파일과 기록에 별도 행으로 저장됩니다.
Current Activity에는 현재 제목, 채널, 썸네일, 진행률, 전송 속도와 남은 시간이 표시됩니다. Up next에서는 대기 중인 요청의 처리 순서, 요청 출처와 선택 화질을 확인할 수 있습니다. 시작 전인 요청은 제거 아이콘으로 대기열에서 취소할 수 있습니다.
큐는 데이터베이스 없이 영구 메타데이터 볼륨에 저장됩니다. 컨테이너가 재시작되면 중단된 활성 요청이 먼저 복원되고 나머지 요청이 기존 순서대로 이어집니다. 복원된 요청에는 Restored after restart가 표시됩니다. 호환되는 임시 파일은 yt-dlp가 이어받지만 정확한 바이트 구간 재개 지원은 원본 서비스에 따라 달라집니다.
같은 URL, 다운로드 프로필과 옵션은 공유 추적 파라미터를 제외하고 비교해 중복 등록을 막습니다. 메타데이터 추출 뒤에는 미디어 ID로 NAS의 기존 파일을 한 번 더 확인합니다. 같은 파일의 완료 신호가 반복되면 기존 기록과 최초 다운로드 날짜를 유지합니다. 완료 파일이 없는 실패 항목은 기존처럼 Retry할 수 있습니다.
데스크톱의 상세 영역은 라이브러리 개요로 시작합니다. 작은 화면과 모바일에서는 파일과 기록의 통계 버튼으로 같은 레이어를 열 수 있습니다. 현재 기록을 기준으로 저장 파일 수와 용량, 최근 7일 완료 수, 14일 활동 차트, 미디어 종류별 분포와 기록된 실패를 요약합니다. 마운트 파일은 저장 라이브러리 합계에는 포함하지만 다운로드 활동에서는 제외합니다. 미디어 종류나 실패 그룹을 선택하면 기존 기록 필터가 적용됩니다.
저장된 영상과 오디오는 다시 내려받지 않고 Preview로 재생할 수 있습니다. 저장한 썸네일 sidecar는 Grid 보기와 상세 정보에 사용됩니다. 실패 작업 재시도, 브라우저 다운로드, 기록만 삭제, 실제 파일과 연결된 썸네일 삭제 작업도 제공됩니다.
모바일 브라우저가 백그라운드에서 돌아오면 선택한 보기, 필터, 페이지와 상세 항목을 유지한 채 파일과 기록 및 현재 작업을 자동으로 갱신합니다.
SRT, VTT, ASS, SSA 자막 파일의 작업 메뉴에서 Subtitle QA를 선택합니다. 검증된 기준 원문을 붙여 넣고 필요하면 쉼표 또는 줄바꿈으로 키워드를 입력한 다음 Analyze를 누릅니다.
문자 정답률(CRR), 문자 오류율(CER), 단어 오류율(WER), 문자 대체·삭제·삽입 횟수와 키워드 보존 결과를 확인할 수 있습니다. 자막 파일과 입력한 기준 원문은 NAS 컨테이너 안에서만 처리됩니다. 새 컨테이너가 시작될 때 nlptutti를 설치하거나 최신 버전으로 갱신합니다.
/downfolder에 기존 파일이 있으면 자동으로 탐색합니다. 저장된 다운로드 기록이 없는 파일은 Mounted, No metadata로 표시됩니다. 미리보기, 브라우저 다운로드와 삭제는 가능하지만 원본 URL이나 화질 정보는 복원할 수 없습니다.
기록만 모두 지워도 실제 파일은 삭제되지 않습니다. 남겨진 파일은 다시 마운트 파일로 표시됩니다.
docker compose pull
docker compose up -d
latest와 26.0822 이미지는 linux/amd64, linux/arm64를 지원합니다.
휴대폰 공유 설정은 모바일 공유 설정을 참고하세요.