- 메타데이터 오류를 방지하려면 영화와 TV 시리즈에 대해 별도의 경로를 설정하십시오.
- Linux 기반 Docker를 사용한 서버 구현 및 하드웨어 트랜스코딩 최적화.
- Infuse와 같은 외부 클라이언트와의 안전한 원격 액세스 관리 및 동기화 기능을 제공합니다.
Jellyfin에 라이브러리를 추가하면 영화, TV 프로그램, 음악, 사진 또는 개인 비디오가 담긴 폴더를 탐색 가능한 카탈로그로 만들 수 있습니다. 표지, 줄거리, 시즌 및 정리된 정보하지만 정확한 결과를 얻으려면 Jellyfin이 해당 폴더에 접근할 수 있어야 하고, 폴더에 어떤 유형의 콘텐츠가 들어 있는지 정확히 알아야 합니다.
파일이 어디에 저장되든 상관없습니다. 아직도 작동하는 오래된 PC외장 드라이브 또는 NAS를 사용할 수 있습니다. 기본 규칙은 Jellyfin이 실행되는 컴퓨터, 서비스 또는 컨테이너에서 경로가 보여야 한다는 것입니다. 개인 컴퓨터에서 열 수 있는 폴더가 서버에서 자동으로 사용 가능하지 않을 수 있습니다.
시작하기 전에 각 카테고리를 분리하는 것도 좋은 방법입니다. 영화, TV 시리즈, 음악은 서로 다른 메타데이터 구조와 제공업체를 사용합니다. 각 카테고리별로 별도의 라이브러리를 만들면 잘못된 식별을 줄이고 향후 유지 관리를 더 쉽게 할 수 있습니다.
젤리핀에서 도서관이란 무엇인가요?

도서관이란 하나 이상의 폴더로 구성된 가상 컬렉션파일은 원래 위치에 그대로 남아 있습니다. Jellyfin은 경로만 분석하고, 경로에 대한 정보를 데이터베이스에 저장한 다음, 애플리케이션을 통해 결과를 표시합니다.
하나의 라이브러리에 여러 위치의 파일을 포함할 수 있습니다. 예를 들어, '영화'라는 라이브러리를 만들고 내장 드라이브의 폴더와 NAS에 있는 폴더를 모두 포함할 수 있습니다. 파일이 서로 다른 장치에 저장되어 있더라도 인터페이스에는 두 폴더가 함께 표시됩니다.
그렇다고 해서 카테고리를 섞어도 된다는 뜻은 아닙니다. 영화 라이브러리 내에서 여러 영화 폴더를 합칠 수는 있지만, 같은 컬렉션에 TV 시리즈나 음악 폴더를 추가하는 것은 좋지 않습니다.
폴더를 추가하기 전에 어떻게 준비해야 할까요?
젤리핀 패널을 열기 전에 서버가 해당 폴더를 읽을 수 있는지 확인하십시오. 젤리핀이 스캔을 수행하거나 파일을 재생하려고 할 때마다 해당 경로에 계속 액세스할 수 있어야 합니다.
미디어가 로컬 디스크에 있는 경우 Jellyfin을 실행하는 사용자에게 권한을 부여하십시오. 폴더 및 파일에 대한 읽기 권한쓰기 권한은 Jellyfin이 콘텐츠와 함께 이미지, NFO 파일 또는 기타 데이터를 저장하도록 허용하거나 파일 삭제를 활성화한 경우에만 필요합니다.
SMB 또는 NFS 리소스를 사용할 때는 서버의 운영 체제에 해당 리소스를 마운트해야 합니다. Jellyfin은 파일 시스템에서 직접 읽도록 설계되었으며, 다른 컴퓨터에서 액세스하는 네트워크 폴더 자격 증명을 저장하지 않습니다.
많은 소장품을 어디에 보관할지 고민 중이시라면 다음 옵션들을 확인해 보세요. 가정용 NAS 저장 장치재부팅 후 및 Jellyfin 시작 전에 리소스가 자동으로 마운트되는지 확인하십시오.
Jellyfin에서 Docker를 사용할 때 미디어 폴더를 마운트하는 방법
컨테이너는 호스트 시스템의 모든 폴더를 자동으로 볼 수 없습니다. Jellyfin에서 접근 가능한 내부 경로에 실제 위치를 연결하는 볼륨을 추가해야 합니다.
예를 들어:
services:
jellyfin:
image: jellyfin/jellyfin
volumes:
- /mnt/multimedia/peliculas:/media/peliculas:ro
- /mnt/multimedia/series:/media/series:ro
이 예에서는 /mnt/multimedia/peliculas 호스트의 경로입니다. /media/peliculas 이것은 Jellyfin이 컨테이너 내에서 인식할 수 있는 라이브러리입니다. 따라서 라이브러리를 생성할 때 다음을 선택해야 합니다.
/media/peliculas
Jellyfin에 호스트 경로를 입력하지 마십시오. 컨테이너 내에 해당 위치가 존재하지 않습니다.접미사 :ro 미디어를 읽기 전용 모드로 마운트하세요. 스캔 및 재생에는 읽기 전용 모드면 충분합니다. Jellyfin이 해당 폴더를 수정해야 하는 경우에만 쓰기 권한을 사용하세요.
폴더가 마운트되었음에도 불구하고 비어 있는 것처럼 보인다면, 컨테이너가 실행되는 사용자 및 그룹 권한을 확인하십시오. 해당 사용자의 자격 증명에는 디렉터리를 탐색하고 파일을 읽을 수 있는 권한이 있어야 합니다.
Jellyfin에 라이브러리를 추가하는 방법 (단계별)

폴더에 접근할 수 있게 되면 관리자 계정으로 다음 단계를 완료하세요.
- Jellyfin 웹 인터페이스를 엽니다.
- 메인 메뉴를 여세요.
- 입력하다 관리 > 제어판.
- 선택하다 서버 > 라이브러리.
- 누르다 미디어 라이브러리 추가.
- 콘텐츠 유형을 선택하세요.
- 인터페이스에 표시될 이름을 입력하세요.
- 기호를 누르세요 + 폴더를 추가하려면.
- 경로를 선택하거나 직접 입력하세요.
- 메타데이터의 언어 및 국가를 구성합니다.
- 추가 옵션을 검토하고 라이브러리를 저장하세요.
Jellyfin은 파일 분석을 시작하고 진행률 표시줄을 표시합니다. 소규모 라이브러리는 거의 즉시 나타날 수 있지만, 대규모 컬렉션의 경우 콘텐츠를 식별하고 이미지를 다운로드하는 데 더 많은 시간이 필요합니다.
표지 이미지, 시즌 및 줄거리는 프로세스가 완료될 때까지 순차적으로 표시되지만, 프로세스 진행 중에도 인터페이스를 계속 사용할 수 있습니다. 도서관의 첫 번째 스캔.
어떤 유형의 콘텐츠를 선택해야 할까요?
파일 형식은 Jellyfin이 폴더 구조를 해석하는 방식과 사용할 제공업체를 결정합니다. 잘못된 형식을 선택하면 영화가 에피소드로 표시되거나 전체 시리즈가 여러 개의 개별 비디오로 표시될 수 있습니다.
| 도서관의 종류 | 추천 콘텐츠 |
|---|---|
| 영화 산업 | 장편 영화들을 제목과 연도별로 정리했습니다. |
| 시리즈 | 프로그램은 시리즈, 시즌, 에피소드 폴더로 분류되어 있습니다. |
| 음악 | 내부 태그가 올바르게 작성된 앨범 및 노래 목록입니다. |
| 뮤직 비디오들 | 영화나 시리즈에 포함되지 않은 뮤직 비디오 및 공연. |
| 사진들 | 개인 이미지는 폴더를 사용하여 정리했습니다. |
| 서적 | 해당 추가 기능을 통해 책, 만화, 오디오북을 이용할 수 있습니다. |
| 홈 비디오 및 사진 | 자동 필름 식별 기능이 없는 개인 녹화물. |
해당 유형을 사용하지 마십시오. 혼합 영화 및 시리즈현재 문서에서는 이 방법을 구식으로 간주하고 신뢰할 수 없는 결과를 초래하므로 사용을 권장하지 않습니다. 폴더에 두 범주가 모두 포함된 경우 라이브러리를 생성하기 전에 분리하십시오.
영화, TV 프로그램, 음악을 정리하는 방법

이 가이드는 서버에 경로를 추가하는 방법에 중점을 둡니다. 전체 명명 구조는 관련 문서에서 설명합니다. Jellyfin에서 영화와 TV 프로그램을 추가하고 정리하세요.하지만 이것들은 핵심적인 규칙들입니다.
영화 산업
각 영화마다 별도의 폴더를 만들고, 가능하면 제목과 제작 연도를 포함시켜야 합니다.
Peliculas/
└── Nombre de la película (2025)/
└── Nombre de la película (2025).mkv
연도를 추가하면 리메이크작과 이름이 같은 작품들을 구분하는 데 도움이 됩니다. 또한, 제작사 식별자를 추가하면 더욱 정확한 검색 결과를 얻을 수 있습니다.
Nombre de la película (2025) [tmdbid-ID]
시리즈
시리즈는 시즌별로 나누고 알아보기 쉬운 에피소드 번호를 사용해야 합니다.
Series/
└── Nombre de la serie (2025)/
├── Season 01/
│ ├── Nombre de la serie S01E01.mkv
│ └── Nombre de la serie S01E02.mkv
└── Season 02/
└── Nombre de la serie S02E01.mkv
시즌 00 이는 일반적으로 스페셜 에피소드에 사용됩니다. 하나의 파일에는 다음과 같은 패턴을 사용하여 여러 개의 연속된 에피소드가 포함될 수 있습니다. S01E01-E02.
음악
음악의 경우, 파일에 포함된 메타데이터가 파일 이름보다 더 중요합니다. 각 폴더에는 하나의 앨범만 있어야 합니다.
Musica/
└── Artista/
└── Álbum/
├── Canción 01.flac
└── Canción 02.flac
첫 스캔을 수행하기 전에 아티스트, 앨범 아티스트, 앨범 이름, 트랙 번호 및 디스크 번호 필드를 확인하십시오.
라이브러리 메타데이터를 구성하는 방법
Jellyfin은 TMDb, OMDb 및 로컬 NFO 파일과 같은 제공업체로부터 정보를 가져옵니다. 라이브러리 생성 중에 다음 옵션을 선택할 수 있습니다. 선호하는 언어 및 국가 제목, 줄거리, 평점을 다운로드하는 데 사용됩니다.
각 라이브러리별로 언어를 설정할 수 있으므로 애니메이션, 스페인 영화 또는 원어 버전 영화 모음은 나머지 라이브러리와 다른 설정을 사용할 수 있습니다.
로컬 NFO 파일이 원격 제공자보다 우선순위가 높습니다. 폴더 이름을 변경한 후에도 Jellyfin에 오래된 정보가 계속 표시되는 경우, 해당 파일이 존재하는지 확인하십시오. .nfo 그것은 해당 데이터를 강요하는 것입니다.
제목이 잘못된 작품과 연결된 경우, 항목 식별 도구를 사용하거나 폴더 이름에 식별자를 추가하세요(예: ...). [tmdbid-ID], [imdbid-ID] o [tvdbid-ID]그런 다음 메타데이터를 다시 업데이트합니다.
더 복잡한 경우에는 다음을 참조하세요. Jellyfin에서 앨범 아트 및 메타데이터 문제 해결.
하나의 라이브러리에 여러 폴더를 추가하는 방법
디스크마다 별도의 라이브러리를 만들 필요가 없습니다. Jellyfin을 사용하면 라이브러리를 추가할 수 있습니다. 같은 유형의 여러 경로 그리고 그것들을 하나의 컬렉션으로 표시합니다.
예를 들어, 영화 라이브러리에는 다음과 같은 것들이 포함될 수 있습니다.
/media/disco-interno/peliculas
/media/nas/peliculas
/media/disco-usb/peliculas
선택한 이름 아래에 세 위치 모두 함께 표시됩니다. 이 설정은 컬렉션 규모가 커져서 여러 드라이브에 분산해야 할 때 유용합니다.
상위 폴더와 하위 폴더를 동시에 추가하지 마십시오. /media/peliculas 그리고 또한 /media/peliculas/animacionJellyfin은 동일한 콘텐츠를 두 번 분석하여 복제본을 생성할 수 있습니다.
새 라이브러리를 사용자가 볼 수 있도록 허용하는 방법
모든 라이브러리에 접근 권한이 있는 사용자는 새 컬렉션을 자동으로 받게 됩니다. 하지만 특정 라이브러리만 볼 수 있도록 설정된 프로필은 새 컬렉션을 받지 못합니다. 그들은 자동으로 접근 권한을 얻지 못합니다..
이를 승인하려면:
- 열기 제어판.
- 입력하다 사용자.
- 해당 프로필을 선택하세요.
- 열려 있는 도서관 이용.
- 새 도서관을 표시해 두세요.
- 변경 사항을 저장하세요.
이 단계는 특히 다음과 같은 경우에 중요합니다. Jellyfin에서 하위 프로필을 구성하세요새로운 라이브러리는 검토를 거쳐 명시적으로 승인될 때까지 숨겨진 상태로 남아 있을 수 있기 때문입니다.
라이브러리를 업데이트하거나 재분석하는 방법
Jellyfin은 예약된 작업을 실행하여 변경 사항을 감지하지만, 수동으로 스캔을 시작할 수도 있습니다. 라이브러리 메뉴를 열고 해당 옵션을 선택하세요. 분석하거나 업데이트하세요..
실시간 모니터링을 사용하면 다음 스캔을 기다리지 않고도 새 파일이나 수정된 파일을 감지할 수 있습니다. 하지만 모든 파일 시스템에서 작동하는 것은 아닙니다. NFS나 rclone과 같은 리소스는 필요한 이벤트를 생성하지 않을 수 있으므로, 이러한 경우에는 예약된 작업이나 수동 스캔을 사용해야 합니다.
제목의 ID만 수정했다면 전체 컬렉션을 다시 분석할 필요가 없습니다. 불필요한 호출과 처리를 방지하려면 해당 항목의 메타데이터만 업데이트하세요.
라이브러리를 수정하거나 제거하는 방법
에서 제어판 > 라이브러리 컬렉션 옵션을 열면 이름을 변경하거나, 폴더를 추가 또는 제거하거나, 메타데이터 제공자를 검토할 수 있습니다.
경로를 삭제하기 전에 해당 경로가 특정 파일의 유일한 위치가 아닌지 확인하십시오. NAS 또는 USB 드라이브를 사용하는 경우 연결 상태도 확인해야 합니다. 일시적으로 사용할 수 없는 드라이브는 더 이상 존재하지 않는 경로로 표시될 수 있습니다.
네트워크 스토리지 연결이 끊어진 상태에서는 유지 관리 작업이나 전체 검사를 수행하지 마십시오. Jellyfin은 카탈로그에서 찾을 수 없는 항목을 제거할 수 있습니다. 파일은 NAS에서 삭제되지 않지만, 연결을 복원하고 라이브러리를 다시 검사해야 합니다.
Jellyfin에 라이브러리를 추가할 때 흔히 발생하는 실수

해당 폴더가 선택기 목록에 나타나지 않습니다.
Jellyfin 프로세스가 해당 위치를 찾을 수 없습니다. 드라이브가 마운트되었는지, 그리고 서비스 사용자에게 폴더를 탐색하고 파일을 읽을 수 있는 권한이 있는지 확인하십시오.
Docker 경로가 비어 있는 것 같습니다.
호스트 경로를 제대로 입력하셨을 겁니다. 구성된 볼륨을 확인하고 Jellyfin에서 해당 볼륨을 선택하세요. 컨테이너의 내부 경로.
라이브러리는 생성되었지만 파일이 표시되지 않습니다.
권한, 콘텐츠 유형 및 폴더 구조를 확인하십시오. 공식 문서에 따르면 가장 일반적인 두 가지 이유는 다음과 같습니다. 잘못된 권한 및 호환되지 않는 조직 스캐너를 이용해.
해당 영화들은 시리즈 안에 포함되어 있습니다.
혼합 폴더를 사용했거나 잘못된 유형을 선택했습니다. 카테고리를 분리하여 영화와 TV 프로그램용 개별 라이브러리를 만드세요.
같은 제목이 중복해서 나타납니다.
상위 폴더와 하위 폴더처럼 경로가 겹치는 부분이 있는지 확인하세요. 또한 동일한 리소스가 두 개의 서로 다른 경로를 사용하여 마운트되지 않았는지 확인하세요.
Jellyfin이 잘못된 표지 또는 줄거리를 다운로드했습니다.
이름과 연도를 수정하거나 공급업체 ID를 추가하세요. 그런 다음 해당 품목의 메타데이터를 업데이트하십시오.
새 파일은 자동으로 나타나지 않습니다.
수동 검사를 시작하고 예약된 작업을 확인하십시오. 폴더가 NFS, rclone 또는 이벤트 기반 모니터링을 지원하지 않는 시스템을 사용하는 경우 실시간 모니터링이 작동하지 않을 수 있습니다.
NAS 연결이 끊어지면 콘텐츠가 사라집니다.
Jellyfin은 접근할 수 없는 경로에서 스캔을 진행했습니다. 마운트를 복원하고 파일이 다시 보이는지 확인한 후 라이브러리를 다시 스캔하십시오.
일부 사용자는 새 라이브러리를 볼 수 없습니다.
접근이 제한된 프로필은 수동으로 승인해야 합니다. 사용자 계정을 열고, 라이브러리 접근으로 이동하여 컬렉션을 선택하고 변경 사항을 저장하세요.
음악이 잘못된 방식으로 그룹화되어 있는 것 같습니다.
파일의 내부 태그를 확인하세요. Jellyfin은 주로 내장된 메타데이터를 사용하여 아티스트, 앨범, 디스크 및 트랙을 식별합니다.
Jellyfin에 라이브러리를 제대로 추가하려면 올바른 유형을 선택하고, 서버에서 접근 가능한 경로를 지정하고, 각 콘텐츠 클래스에 대해 예상되는 구조를 준수해야 합니다. 대부분의 문제는 플레이어 자체의 문제가 아니라... 보이지 않는 경로, 불충분한 권한 또는 호환되지 않는 이름.
대규모 컬렉션을 가져오기 전에 두세 개의 타이틀이 들어 있는 폴더를 먼저 가져와 보세요. Jellyfin이 해당 파일들을 올바르게 인식하면 경로를 확장하거나 나머지 파일을 이동하세요. 이 과정을 통해 초기 스캔 후 수백 개의 항목을 수정해야 하는 번거로움을 방지할 수 있습니다.
색인
- 1 젤리핀에서 도서관이란 무엇인가요?
- 2 폴더를 추가하기 전에 어떻게 준비해야 할까요?
- 3 Jellyfin에서 Docker를 사용할 때 미디어 폴더를 마운트하는 방법
- 4 Jellyfin에 라이브러리를 추가하는 방법 (단계별)
- 5 어떤 유형의 콘텐츠를 선택해야 할까요?
- 6 영화, TV 프로그램, 음악을 정리하는 방법
- 7 라이브러리 메타데이터를 구성하는 방법
- 8 하나의 라이브러리에 여러 폴더를 추가하는 방법
- 9 새 라이브러리를 사용자가 볼 수 있도록 허용하는 방법
- 10 라이브러리를 업데이트하거나 재분석하는 방법
- 11 라이브러리를 수정하거나 제거하는 방법
- 12 Jellyfin에 라이브러리를 추가할 때 흔히 발생하는 실수
- 12.1 해당 폴더가 선택기 목록에 나타나지 않습니다.
- 12.2 Docker 경로가 비어 있는 것 같습니다.
- 12.3 라이브러리는 생성되었지만 파일이 표시되지 않습니다.
- 12.4 해당 영화들은 시리즈 안에 포함되어 있습니다.
- 12.5 같은 제목이 중복해서 나타납니다.
- 12.6 Jellyfin이 잘못된 표지 또는 줄거리를 다운로드했습니다.
- 12.7 새 파일은 자동으로 나타나지 않습니다.
- 12.8 NAS 연결이 끊어지면 콘텐츠가 사라집니다.
- 12.9 일부 사용자는 새 라이브러리를 볼 수 없습니다.
- 12.10 음악이 잘못된 방식으로 그룹화되어 있는 것 같습니다.