원치 않는 덮어쓰기를 허용하지 않고 로컬 메타데이터 파일 설정하기

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

로컬 NFO 파일과 아트워크를 사용하면 미디어 라이브러리를 쉽게 이동할 수 있지만, 이를 읽는 서버에 제목, 이미지 또는 식별자를 바꿀 권한이 있을 수도 있습니다. 미디어를 읽기 전용으로 마운트하면 실수로 파일에 기록하는 일을 막을 수 있지만, 서버가 다운로드한 사이드카 파일을 저장하는 위치는 달라집니다.

권한을 변경하기 전에 각 메타데이터 필드의 기준 소스를 하나씩 정하세요. 직접 관리하는 사이드카 파일은 버전 관리하거나 백업하고, 서버 데이터베이스 상태는 쓰기 가능하게 유지해야 합니다. 새로 고침 테스트를 통해 서버가 원본 파일을 수정하지 않고 읽는지 확인하세요. 업그레이드 후와 라이브러리 전체 메타데이터 새로 고침 후에도 이 테스트를 반복하세요.

어떤 메타데이터 소스를 기준으로 삼을지 결정하세요

직접 관리하는 필드 목록을 작성하세요. 제목, 정렬 제목, 에디션, 날짜, 인물, 제공자 ID, 포스터, 배경 아트 등이 포함됩니다. 로컬 파일을 기준 정보로 삼는다면 새로 고침 중 해당 필드를 덮어쓸 수 있는 제공자 업데이트를 비활성화하거나 제한하세요.

파일 이름 지정 규칙을 정하기 전에 설치된 서버 제품군에 대한 Jellyfin NFO 필드 동작을 확인하세요. 라이브러리 유형에 따라 지원 범위가 다르며, 언뜻 명확해 보이는 파일 이름이 실제로 스캐너가 읽는 파일이 아닐 수도 있습니다.

프로덕션 라이브러리 외부에 작은 테스트 디렉터리를 마련하세요. 영화 또는 에피소드 하나와 해당 NFO, 선택한 아트워크를 넣어 두면 정성껏 관리한 수천 개의 파일을 위험에 빠뜨리지 않고 스캔 및 새로 고침 동작을 테스트할 수 있습니다.

읽기 전용 미디어와 쓰기 가능한 서버 상태 분리

컨테이너 내부에서 미디어 트리는 읽기 전용으로 마운트하고, 구성, 캐시, 데이터베이스 경로는 쓰기 가능하게 유지하세요. 읽기 전용 바인드 마운트 같은 컨테이너 플래그를 사용하면 릴리스마다 의미가 달라질 수 있는 애플리케이션 체크박스에 의존하는 것보다 확실하게 보호할 수 있습니다.

서버가 미디어 옆에 새 아트워크를 다운로드해야 한다면, 완전히 읽기 전용인 라이브러리는 해당 워크플로와 호환되지 않습니다. 다운로드한 메타데이터는 애플리케이션 상태에 저장하거나, 서버 프로세스 외부에서 사이드카 파일을 기록하는 제어된 스테이징 작업을 사용하세요.

마운트 맵을 배포 기록의 일부로 관리하세요. Jellyfin 컨테이너 업그레이드 체크리스트는 컨테이너를 다시 만들 때 미디어, 메타데이터, 애플리케이션 상태를 구분하는 데 도움이 됩니다.

큐레이션과 충돌하는 쓰기 경로 비활성화

미디어 폴더를 외부에서 큐레이션하는 경우, 아트워크나 NFO 메타데이터를 해당 폴더에 저장하는 옵션을 끄세요. 라이브러리별 메타데이터 저장 설정도 확인하세요. 쓰기를 활성화하는 설정이 전역 설정에만 있는 것은 아닐 수 있습니다.

필요한 모든 쓰기 가능 경로를 명시적으로 제공하는 경우가 아니라면, 올바른 마운트 설정을 대신해 컨테이너 파일 시스템 전체를 읽기 전용으로 설정하지 마세요. 데이터베이스, 로그, 플러그인, 임시 파일에는 여전히 제어된 쓰기 가능 위치가 필요합니다.

샘플 NFO 파일과 이미지의 파일 해시 또는 수정 시간을 기록하고, 라이브러리를 스캔한 다음 UI에서 제목을 수정하고 메타데이터 새로고침을 실행하세요. 애플리케이션이 허용된 로컬 상태를 데이터베이스에 기록하는 동안 파일은 변경되지 않아야 합니다.

복원 및 업그레이드 동작 확인

큐레이션한 사이드카 파일은 미디어 서버 데이터베이스와 별도로 내보내거나 백업하세요. 사이드카 파일은 표시 메타데이터를 복원하지만, 데이터베이스에는 시청 상태, 사용자, 컬렉션 등 로컬 파일에 포함되지 않는 정보가 남아 있을 수 있습니다.

테스트 기간에 컨테이너를 다시 만들고, 배포 과정에서도 읽기 전용 마운트 플래그가 유지되는지 확인하세요. 그런 다음 샘플 디렉터리를 스캔하고 해시를 다시 비교하세요. 업그레이드로 새 메타데이터 저장 기능이 추가되거나 기본값이 바뀔 수 있기 때문입니다.

최종 중단 규칙은 간단합니다. 원하는 결과를 보존하기 위해 새로고침에 쓰기 권한이 필요하다면, 원본 데이터의 기준 설계가 아직 정해지지 않은 것입니다. 샘플을 복원하고 프로덕션은 읽기 전용으로 유지한 뒤, 해당 필드를 서버와 외부 큐레이터 중 누가 관리할지 결정하세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.