Jellyfin 라이브러리 스캔 오류 해결방법/파일 인식 오류

 

오픈소스 미디어 서버인 Jellyfin 사용 중 라이브러리 스캔 오류가 발생하면 영화나 드라마 파일이 표시되지 않거나 메타데이터가 정상적으로 불러와지지 않을 수 있습니다. 특히 폴더 권한 문제나 경로 설정 오류 때문에 스캔 실패가 자주 발생합니다.

핵심 요약
- 라이브러리 경로 설정 확인 필요
- 폴더 권한 오류가 가장 흔한 원인
- 메타데이터 서버 연결 상태 확인 중요
- Docker 및 NAS 환경 설정 점검 필요

Jellyfin 라이브러리 스캔 오류가 발생하는 이유

라이브러리 스캔 오류는 아래 원인으로 자주 발생합니다.

• 잘못된 라이브러리 경로 설정
• 폴더 읽기 권한 부족
• 메타데이터 서버 연결 실패
• Docker 볼륨 연결 오류
• NAS 네트워크 연결 문제

주의사항
라이브러리 폴더를 이동하거나 이름을 변경한 경우 기존 경로가 유지되어 스캔 오류가 발생할 수 있습니다.

Jellyfin 라이브러리 스캔 오류 해결방법

1단계 : 라이브러리 경로 확인

Jellyfin 관리자 대시보드에서 라이브러리 경로가 실제 저장 폴더와 일치하는지 확인합니다.

• 대시보드 접속
• 라이브러리 메뉴 선택
• 폴더 경로 확인
• 잘못된 경로 수정

2단계 : 폴더 권한 설정 확인

Jellyfin 서버 계정에 미디어 폴더 읽기 권한이 없으면 스캔이 실패할 수 있습니다.

운영환경	확인 항목
Windows	폴더 공유 및 읽기 권한
Linux	chmod / chown 권한 설정
Docker	볼륨 마운트 경로 확인
NAS	네트워크 공유 권한 확인

설정 팁
Docker 환경에서는 컨테이너 내부 경로와 실제 저장 경로가 정확히 연결되어 있어야 정상 스캔이 가능합니다.

 

3단계 : 라이브러리 새로고침 실행

경로 수정 후 반드시 라이브러리 새로고침 또는 전체 스캔을 실행해야 변경 사항이 반영됩니다.

메타데이터 인식 오류 해결방법

파일은 표시되지만 포스터나 정보가 표시되지 않는다면 메타데이터 서버 연결 문제일 가능성이 있습니다.

• 인터넷 연결 상태 확인
• 메타데이터 제공자 활성화 확인
• 파일명 규칙 수정
• 영문 제목 사용 권장

파일명 팁
영화 파일명은 ‘MovieName (2025)’ 형식으로 저장하면 메타데이터 인식률이 높아질 수 있습니다.

Docker 환경에서 스캔 오류 해결방법

Docker 기반 Jellyfin에서는 볼륨 마운트 오류가 가장 흔한 원인입니다.

확인 사항

• docker-compose 경로 확인
• 읽기 권한 설정
• 컨테이너 재시작
• 캐시 초기화

NAS 환경에서 라이브러리 오류 해결방법

Synology 또는 QNAP NAS 사용 시 SMB 또는 NFS 연결 문제로 라이브러리 스캔 실패가 발생할 수 있습니다.

• NAS 공유 폴더 권한 재설정
• 네트워크 연결 상태 확인
• 절전모드 해제
• 고정 IP 설정 권장

팁
라이브러리 파일 수가 많을 경우 초기 스캔에 시간이 오래 걸릴 수 있으므로 서버를 바로 종료하지 않는 것이 좋습니다.

마무리 정리

Jellyfin 라이브러리 스캔 오류는 대부분 경로 설정, 권한 문제, Docker 볼륨 연결 오류 때문에 발생합니다. 폴더 권한과 라이브러리 경로만 정확히 설정해도 대부분 해결 가능하며, 메타데이터 설정도 함께 확인하는 것이 중요합니다.