썸네일 생성으로 미디어 서버의 앱 저장 공간이 가득 차는 이유는 무엇인가요?

에바 왕

IceWhale author

에바 왕 는 기술 작가 그리고 이자 ZimaSpace의 상주 장인입니다. 평생을 기술에 열정을 가진 사람으로서 홈랩과 오픈소스 소프트웨어에 열정을 가지고 있으며,복잡한 기술 개념을 쉽게 이해할 수 있는 실습 가이드로 번역하는 데 전문성을 가지고 있습니다.에바는 셀프 호스팅이 어렵지 않고 재미있어야 한다고 믿습니다. 그녀의 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 신비를 풀도록돕고 있습니다. 첫 NAS 구축부터 Docker 컨테이너 마스터링까지.

Why Does Thumbnail Generation Fill a Media Server’s App Storage? - Zima Store Online

서버가 많은 파생 이미지를 생성하여 쓰기 가능한 메타데이터 또는 캐시 경로에 저장하기 때문에 썸네일 생성으로 앱 저장 공간이 가득 찰 수 있습니다.

미디어 라이브러리는 멀티테라바이트 동영상을 HDD 풀에 보관하면서 컨테이너의 구성, 메타데이터, 캐시는 훨씬 작은 SSD 또는 부팅 볼륨에 매핑할 수 있습니다. 챕터 이미지, 트릭플레이 미리 보기, 포스터, 배경 이미지, 임시 추출 파일은 원본 파일 크기만이 아니라 라이브러리 사용 기간과 생성 설정에 따라 계속 증가합니다. 안전한 해결 방법은 데이터베이스가 여전히 필요로 하는 항목을 삭제하기 전에 정확한 파생 이미지 유형과 경로를 확인하는 것에서 시작합니다.

실제로 증가하는 디렉터리 찾기

미디어 애플리케이션의 구성, 캐시, 메타데이터, 트랜스코딩, 임시 디렉터리를 각각 측정하세요. 썸네일 작업이 실행되는 동안 하위 디렉터리를 할당된 용량과 최근 수정 시간순으로 정렬하세요.

Jellyfin의 인터페이스 문자열에는 챕터 이미지 추출이 느리고 리소스를 많이 사용하며 수 기가바이트의 공간이 필요할 수 있다고 명시되어 있습니다.

공간 증가가 호스트 바인드 마운트, 이름이 지정된 볼륨, 컨테이너의 쓰기 가능 레이어 중 어디에서 발생하는지 확인하세요. 컨테이너 레이어가 증가한다면 정리하기 전에 영속성을 바로잡으세요. 그렇지 않으면 앱 화면에서는 공간이 사라진 것처럼 보여도 Docker의 시스템 저장 공간은 계속 사용될 수 있습니다.

파일을 생성한 이미지 기능 확인

일반 포스터와 배경 이미지를 챕터 이미지, 트릭플레이 미리 보기, 동영상 미리 보기 썸네일, 인트로 마커, 플러그인이 생성한 아트워크와 구분하세요. 각 기능에는 서로 다른 실행 조건과 보존 규칙이 있습니다.

트릭플레이는 동영상 타임라인 전체에서 반복적인 시각 샘플을 생성하여 클라이언트가 탐색 중 미리 보기를 표시할 수 있도록 합니다. 이렇게 생성되는 이미지 그리드의 크기는 원본이 1080p인지 4K인지보다 전체 재생 시간, 샘플링 간격, 해상도, 품질, 타일 레이아웃에 주로 영향을 받습니다.

예약된 작업 하나를 수동으로 실행하면서 대상 디렉터리를 확인하세요. 새 파일 이름과 데이터베이스 항목을 생성 기능과 일치시키세요. 특정 미리 보기 작업 하나가 원인일 때 모든 메타데이터 제공자를 비활성화하지 마세요.

간격, 해상도, 품질, 라이브러리 범위 확인

썸네일 너비, 샘플링 간격, JPEG 또는 WebP 품질, 타일 크기, 스레드 수, 생성 대상 라이브러리를 기록하세요. 간격을 짧게 설정하고 이미지를 크게 만들수록 동영상 1시간당 저장되는 픽셀이 늘어납니다.

설정 변경이나 업그레이드 후 생성이 다시 시작될 수도 있습니다. Jellyfin 이슈에는 기능을 비활성화해도 기존 출력이 정리되지 않아 이전에 생성된 트릭플레이 데이터가 다시 나타나는 문제를 겪은 사용자들이 설명되어 있습니다.

작은 테스트 라이브러리에서 설정 하나만 변경하고 미디어 1시간당 생성되는 바이트 수를 비교하세요. 측정한 비율로 전체 라이브러리의 용량을 추정한 후 또 다른 전체 추출 작업을 실행하세요.

설정 변경	예상 저장 공간 영향	절충점
샘플링 간격 늘리기	이미지 수 감소	탐색 미리 보기의 정밀도 저하
썸네일 너비 줄이기	파일 크기 감소	TV 미리 보기 이미지가 흐릿해짐
이미지 품질 낮추기	파일 크기 감소	압축 아티팩트 증가
라이브러리 범위 좁히기	총 저장 공간 감소	제외된 라이브러리에는 미리 보기 없음

모든 제목에 최고 품질의 파생 이미지를 생성하기보다 실제 클라이언트 화면과 탐색 동작에 맞는 설정을 선택하세요.

Featured

ZimaCube 2 개인용 클라우드 홈 NAS

ZimaCube2

오래되었거나 고아 상태인 썸네일 세트 확인

파일을 교체하거나 이름을 변경하거나 이동하거나 삭제한 후, 활성 미디어 항목과 생성된 디렉터리를 비교하세요. 새 파일에 다른 항목 ID 또는 출력 이름이 부여되면 이전 미리 보기 세트가 남아 있을 수 있습니다.

Jellyfin 보고서에 따르면 새 트릭플레이 미리 보기가 생성된 후에도 미디어 옆에 저장된 이전 트릭플레이 이미지가 삭제되지 않아 오래된 트릭플레이 데이터가 현재 세트 옆에 남는 문제가 있었습니다.

먼저 애플리케이션에서 지원하는 정리 작업을 사용하고 메타데이터 데이터베이스의 백업을 확인하세요. 수동 삭제가 필요하다면 고아 상태인 항목 하나를 테스트하고 새로 고친 후, 참조 관계를 알 수 없는 대규모 디렉터리 트리를 삭제하세요.

이미지를 앱 저장 공간에 둘지 미디어 옆에 둘지 확인

일부 미디어 서버는 아트워크나 트릭플레이 데이터를 라이브러리 옆에 저장할 수 있지만, 다른 서버는 데이터베이스에 연결된 파생 이미지를 앱 메타데이터 내부에 보관합니다. 저장 위치를 변경하면 백업, 권한, 마이그레이션, 읽기 전용 미디어 동작에 영향을 줍니다.

미리 보기를 미디어 옆에 저장하면 마이그레이션의 이식성이 향상될 수 있지만, 대규모 HDD 공유 폴더에 작은 파일이 많이 생기고 라이브러리에 쓰기 권한이 필요할 수 있습니다. 한 Jellyfin 마이그레이션 이슈에서는 로컬에 저장된 트릭플레이 파일이 인스턴스 간에 제대로 이전되지 않을 수 있음을 보여 줍니다.

애플리케이션이 이식 가능한 로컬 이미지를 완전히 지원하지 않는 한, 데이터베이스에 연결된 파생 이미지와 변경이 잦은 파생 이미지는 용량을 충분히 확보한 앱 볼륨에 보관하세요. 선택한 구조에서 쓰기 권한이 필요하지 않다면 미디어 공유 폴더는 읽기 전용으로 유지하세요.

데이터베이스 상태를 분리하지 않고 앱 볼륨 이동

설정에는 문제가 없지만 앱 볼륨의 용량이 부족하다면 미디어 서버를 중지하고 컨테이너의 영속 마운트 설계에 따라 전체 구성, 메타데이터, 캐시를 이동하세요. 소유권, ACL, 데이터베이스 파일, 심볼릭 링크를 유지하세요.

메타데이터와 썸네일용 SSD 앱 볼륨에 관한 ZimaSpace 문서에서는 이러한 작은 파일 작업에는 빠른 저장 장치가 유리하고 대용량 원본 미디어는 HDD에 계속 보관할 수 있는 이유를 설명합니다.

애플리케이션이 이러한 분할을 지원하지 않는 한 가장 큰 이미지 폴더만 옮기고 데이터베이스 경로는 그대로 두지 마세요. 마이그레이션한 인스턴스를 격리된 상태로 시작하고 새 이미지를 생성하기 전에 이전 썸네일이 정상적으로 표시되는지 확인하세요.

안전하게 정리하고 증가 기준 설정

썸네일 작업을 일시 중지하고 애플리케이션 데이터베이스를 백업한 후, 파생 이미지 유형별 현재 파일 수와 바이트 수를 기록하세요. 확실히 오래된 출력만 삭제하거나 애플리케이션에서 지원하는 삭제 및 재생성 제어 기능을 사용하세요.

SSD가 가득 차면 썸네일 외에도 문제가 발생할 수 있습니다. 한 Jellyfin 이슈에서는 SSD 고갈이 데이터베이스 손상 의심 및 불완전한 라이브러리 표시와 관련되어 있어 여유 공간 고갈이 앱 상태를 위협할 수 있음을 보여 줍니다.

정리한 후 한 라이브러리에서 생성을 실행하고 일일 증가량을 측정한 다음, 앱 볼륨이 예약된 여유 공간 임계값에 도달하기 전에 알림을 설정하세요. 예상한 미리 보기가 정상적으로 작동하고, 오래된 데이터가 다시 나타나지 않으며, 저장 공간 증가량이 선택한 간격, 해상도, 품질, 라이브러리 범위와 일치하면 문제가 해결된 것입니다.