데스크톱에서 오픈 소스 미디어 스택으로 Jellyfin을 마이그레이션하는 방법

에바 왕

IceWhale author

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

How to Migrate Jellyfin From a Desktop to an Open-Source Media Stack - Zima Store Online

컨테이너나 NAS를 선택하기 전에 애플리케이션 상태, 미디어, 캐시, 백업, 네트워크 액세스에 명확한 역할을 할당하여 Jellyfin을 마이그레이션하세요.

일반적인 데스크톱은 모든 역할을 하나의 파일 시스템과 하나의 전원 경로에 통합합니다. 오픈 소스 미디어 스택은 이러한 역할을 분리하므로, 첫 번째 컨테이너를 시작하기 전에 각 경로, UID/GID, 서비스 종속성, 복원 작업을 모두 매핑해야 마이그레이션이 성공합니다. 정상적인 재시작과 실제 클라이언트 테스트를 통과할 때까지 데스크톱을 롤백 소스로 유지하세요.

데스크톱을 서비스 역할로 매핑하기

Jellyfin 구성 및 데이터베이스, 미디어 라이브러리, 메타데이터와 이미지 캐시, 플러그인, 자막 캐시, 사용자, 리버스 프록시 또는 DNS 종속성을 목록으로 정리하세요. 각 항목을 영구 애플리케이션 상태, 대체할 수 없는 미디어, 재구축 가능한 캐시, 백업 사본 또는 복구 미디어로 분류하세요. 캐시를 데이터베이스처럼 복사하지 말고, 미러링된 미디어 볼륨을 두 번째 백업으로 간주하지도 마세요.

모든 역할에 담당 주체, 대상, 액세스 경로, 복원 작업이 지정되면 마이그레이션 경계가 명확해집니다. 어떤 역할을 독립적으로 복원할 수 없다면 스택 설계를 수정할 때까지 해당 역할을 데스크톱에 유지하세요.

이미지를 선택하기 전에 대상 토폴로지 결정하기

Jellyfin에는 하나의 서비스 역할을 사용하고, 구성 및 데이터베이스에는 하나의 영구 데이터 볼륨을, 미디어에는 안정적인 경로를 가진 미디어 볼륨을, 백업에는 별도의 대상을 사용하세요. 장애 연쇄가 중요하다면 리버스 프록시, 모니터링, 실험적 서비스는 각각 별도의 경로나 네트워크에 배치하세요. 타사 마이그레이션 도구는 무작정 폴더를 복사하는 대신 경로 변환과 데이터베이스 처리를 명시적으로 계획해야 하는 이유를 보여줍니다(경로를 인식하는 Jellyfin 마이그레이션 참고 자료).

이동 중 경로와 권한 유지하기

데스크톱 서비스를 중지하고 영구 데이터의 사본을 만든 다음, 변환하기 전에 사본을 검증하세요. 대상에서는 가능한 경우 컨테이너 내부의 미디어 경로를 데이터베이스에 기록된 경로와 동일하게 유지하세요. 컨테이너 UID/GID는 미디어를 읽고 필요한 애플리케이션 디렉터리에만 쓸 수 있는 주체로 설정하세요. 플러그인을 가져오거나 자동화를 추가하기 전에 라이브러리 하나를 스캔하고 사용자 한 명이 로그인하는 테스트를 진행하세요.

Jellyfin이 의도한 모든 라이브러리를 읽고, 데이터베이스에 쓰며, 경로 매핑을 변경하지 않고 재시작할 수 있으면 의사 결정 종료 조건은 PASS입니다. 권한 때문에 미디어 트리 전체에 광범위한 쓰기 액세스가 필요하다면 진행하기 전에 데이터와 애플리케이션 역할을 분리하세요.

-15% OFF

ZimaBoard 2 - 당신의 큰 아이디어를 위한 미니 홈 서버

Single board computer zimaboard2

재생, 사용자, 복구를 단계별로 검증하기

로컬 직접 재생, 대표적인 트랜스코딩, 자막, 두 번째 사용자 계정을 테스트하세요. 그런 다음 대화형 셸이 아니라 compose 또는 배포 정의에서 스택을 중지하고 다시 생성하세요. 애플리케이션 데이터 백업을 깨끗한 테스트 위치에 복원하고 시청 상태, 사용자, 라이브러리 경로가 보존되었는지 또는 의도적으로 재구축되었는지 확인하세요.

이러한 검사를 완료한 후에만 원격 액세스나 추가 서비스를 설정하세요. ZimaCube 2 AI NAS와 같은 소형 호스트는 영구 스토리지, 컨테이너를 위한 여유 리소스, 별도의 백업 경로라는 중립적인 요구 사항이 이미 스택과 일치할 때 고려할 수 있습니다.

확장 및 중단 경계 설정하기

스토리지 계층, 트랜스코딩이 가능한 컴퓨팅 노드 또는 별도의 네트워크 역할을 추가하여 확장하세요. 새 워크로드가 생길 때마다 하나의 공유 볼륨을 확장하는 방식으로 모든 문제를 해결하려고 하지 마세요. 플러그인, 경로 변환 또는 사용자 마이그레이션이 검증되지 않았다면 데스크톱 롤백 사본을 유지하세요. 원래 데스크톱을 실행하지 않아도 문서화된 재구축을 통해 동일한 라이브러리 액세스와 재생 결과를 얻을 수 있으면 스택을 사용할 준비가 된 것입니다.