서버가 파생 이미지를 다수 생성해 쓰기 가능한 메타데이터 또는 캐시 경로에 저장하기 때문에 썸네일 생성으로 앱 저장 공간이 가득 찹니다.
미디어 라이브러리는 수 테라바이트 규모의 동영상을 HDD 풀에 보관하면서 컨테이너의 구성, 메타데이터 및 캐시는 훨씬 작은 SSD나 부팅 볼륨에 저장할 수 있습니다. 그러면 챕터 이미지, Trickplay 미리 보기, 포스터, 배경 이미지 및 임시 추출 파일이 소스 파일 크기만이 아니라 라이브러리의 재생 시간과 생성 설정에 따라 증가합니다. 안전하게 해결하려면 데이터베이스에서 여전히 필요로 하는 파일을 삭제하기 전에 정확한 파생 파일 유형과 경로를 먼저 파악해야 합니다.
실제로 용량이 증가하는 디렉터리 찾기
미디어 애플리케이션의 구성, 캐시, 메타데이터, 트랜스코딩 및 임시 디렉터리를 각각 측정하세요. 썸네일 작업이 실행되는 동안 하위 디렉터리를 할당된 크기와 최근 수정 시간순으로 정렬하세요.
Jellyfin 인터페이스 문구에는 챕터 이미지 추출이 느리고 리소스를 많이 사용하며 몇 기가바이트의 공간이 필요할 수 있다고 명시되어 있습니다.
데이터 증가가 호스트 바인드 마운트, 명명된 볼륨 또는 컨테이너 쓰기 가능 계층 중 어디에서 발생하는지 확인하세요. 컨테이너 계층이 증가한다면 정리하기 전에 영구 저장 설정을 수정하세요. 그렇지 않으면 앱 화면에서 공간이 사라진 것처럼 보여도 Docker 시스템 저장 공간은 계속 사용될 수 있습니다.
어떤 이미지 기능이 파일을 생성했는지 확인
일반 포스터와 배경 이미지를 챕터 이미지, Trickplay 미리 보기, 동영상 미리 보기 썸네일, 인트로 마커 및 플러그인 생성 아트워크와 구분하세요. 기능마다 실행 조건과 보존 규칙이 다릅니다.
Trickplay는 동영상 타임라인 전체에서 반복적으로 이미지를 생성하므로, 클라이언트가 탐색 중 미리 보기를 표시할 수 있습니다. 생성된 이미지 그리드의 크기는 소스가 1080p인지 4K인지보다 전체 재생 시간, 샘플링 간격, 해상도, 품질 및 타일 레이아웃에 더 큰 영향을 받습니다.
대상 디렉터리를 살펴보면서 예약된 작업 하나를 수동으로 실행하세요. 새 파일 이름과 데이터베이스 항목을 해당 파일을 생성한 기능과 대조하세요. 미리 보기 작업 하나만 원인이라면 모든 메타데이터 제공자를 사용 중지하지 마세요.
확인 간격, 해상도, 품질 및 라이브러리 범위
썸네일 너비, 샘플링 간격, JPEG 또는 WebP 품질, 타일 크기, 스레드 수, 생성 대상 라이브러리를 기록하세요. 간격이 짧고 이미지가 클수록 동영상 1시간당 저장되는 픽셀 수가 늘어납니다.
설정을 변경하거나 업그레이드한 뒤 생성이 다시 시작될 수도 있습니다. Jellyfin 이슈에는 기능을 비활성화해도 기존 출력물이 정리되지 않아 이미 생성된 트릭플레이 데이터가 다시 나타나는 현상을 막지 못한 사용자들이 언급되어 있습니다.
소규모 테스트 라이브러리에서 설정을 하나 변경하고 미디어 1시간당 생성되는 바이트 수를 비교하세요. 측정한 비율을 사용해 전체 라이브러리의 용량을 추정한 뒤 다시 전체 추출 작업을 시작하세요.
| 설정 변경 | 예상 저장 공간 영향 | 장단점 |
|---|---|---|
| 샘플링 간격 증가 | 이미지 수 감소 | 탐색 미리보기의 정확도 저하 |
| 썸네일 너비 감소 | 파일 크기 감소 | TV 미리보기 이미지가 흐릿해짐 |
| 이미지 품질 저하 | 파일 크기 감소 | 압축 아티팩트 증가 |
| 라이브러리 범위 축소 | 전체 저장 공간 감소 | 제외된 라이브러리에는 미리보기 없음 |
모든 콘텐츠에 최고 품질의 파생 파일을 생성하기보다 실제 클라이언트 화면과 탐색 동작에 맞는 설정을 선택하세요.
오래되었거나 고아가 된 썸네일 세트 찾기
파일을 교체, 이름 변경, 이동 또는 삭제한 뒤 실제 미디어 항목과 생성된 디렉터리를 비교하세요. 새 파일에 다른 항목 ID나 출력 이름이 지정되면 이전 미리보기 세트가 남을 수 있습니다.
Jellyfin 보고서에 따르면 미디어 옆에 저장된 오래된 트릭플레이 이미지는 대체 미리보기가 생성된 후에도 삭제되지 않아 현재 이미지 세트 옆에 오래된 트릭플레이 데이터가 남았습니다.
먼저 애플리케이션에서 지원하는 정리 작업을 실행하고 메타데이터 데이터베이스를 백업했는지 확인하세요. 직접 삭제해야 한다면, 참조 여부를 알 수 없는 대용량 디렉터리 트리를 삭제하기 전에 고아 항목 하나를 시험 삼아 제거한 다음 새로고침해 보세요.
이미지를 앱 저장소에 둘지 미디어 옆에 둘지 확인
일부 미디어 서버는 라이브러리 옆에 아트워크나 트릭플레이 데이터를 저장할 수 있지만, 다른 서버는 앱 메타데이터 안에 데이터베이스와 연결된 파생 파일을 보관합니다. 저장 위치를 변경하면 백업, 권한, 마이그레이션, 읽기 전용 미디어의 동작 방식이 달라집니다.
미리보기를 미디어 옆에 저장하면 마이그레이션의 이식성을 높일 수 있지만, 대용량 HDD 공유 폴더에 작은 파일이 크게 늘어나고 라이브러리에 쓰기 권한이 필요할 수도 있습니다. 한 Jellyfin 마이그레이션 문제 사례에서는 로컬에 저장한 트릭플레이 파일이 인스턴스 간에 제대로 이전되지 않을 수 있음을 보여줍니다.
애플리케이션이 로컬 이미지의 이동을 완전히 지원하지 않는 한, 데이터베이스에 연결된 파생 파일과 변경이 잦은 파생 파일은 용량을 충분히 확보한 앱 볼륨에 두세요. 선택한 구성에 쓰기 권한이 필요하지 않다면 미디어 공유 폴더를 읽기 전용으로 유지하세요.
데이터베이스 상태를 분리하지 않고 앱 볼륨 이동하기
설정이 적절하지만 앱 볼륨이 부족하다면 미디어 서버를 중지하고 컨테이너의 영구 마운트 설계에 따라 전체 구성, 메타데이터, 캐시를 옮기세요. 소유권, ACL, 데이터베이스 파일, 심볼릭 링크를 그대로 유지하세요.
메타데이터와 썸네일용 SSD 앱 볼륨에 관한 ZimaSpace 문서에서는 대용량 원본 미디어는 HDD에 보관하면서 이러한 소규모 파일 작업에는 빠른 저장 장치가 유리한 이유를 설명합니다.
애플리케이션이 해당 분할 방식을 지원하지 않는 한, 데이터베이스 경로는 남겨 둔 채 이미지 폴더 중 가장 큰 것만 옮기지 마세요. 마이그레이션한 인스턴스를 분리된 상태로 시작하고, 새 파일을 생성하기 전에 기존 썸네일이 정상적으로 표시되는지 확인하세요.
안전하게 정리하고 증가량 기준선 설정하기
썸네일 작업을 일시 중지하고, 애플리케이션 데이터베이스를 백업한 다음, 유형별 파생 파일의 현재 개수와 용량을 기록하세요. 오래된 파일임이 확인된 결과물만 삭제하거나, 애플리케이션에서 지원하는 삭제 및 재생성 기능을 사용하세요.
SSD가 가득 차면 썸네일 외의 문제도 생길 수 있습니다. 한 Jellyfin 문제 사례에서는 SSD 용량이 소진된 상태에서 데이터베이스 손상 의심 및 불완전한 라이브러리 보기가 함께 나타났습니다. 이는 여유 공간 부족이 앱 상태를 위협할 수 있는 이유를 보여줍니다.
정리한 후 한 라이브러리에서 생성을 실행하고, 일일 증가량을 측정하고, 앱 볼륨이 예약 공간 한도에 도달하기 전에 알림을 설정하세요. 예상한 미리보기가 표시되고, 오래된 데이터가 더 이상 다시 나타나지 않으며, 저장 공간 증가량이 선택한 간격, 해상도, 품질, 라이브러리 범위와 일치하면 복구가 완료된 것입니다.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



