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

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

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

데스크톱을 서비스 역할로 분류하세요

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

모든 역할에 담당자, 대상 위치, 액세스 경로, 복구 작업이 정해져 있으면 마이그레이션 범위가 명확해집니다. 역할을 독립적으로 복원할 수 없다면 스택 설계를 수정할 때까지 데스크톱에 그대로 두세요.

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

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

이동 중 경로와 권한 유지

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

Jellyfin이 의도한 모든 라이브러리를 읽고 데이터베이스에 쓸 수 있으며 경로 매핑을 변경하지 않고 재시작할 수 있으면 판정은 PASS입니다. 권한 설정에 미디어 트리 전체에 대한 광범위한 쓰기 권한이 필요하다면 진행하기 전에 데이터 역할과 애플리케이션 역할을 분리하세요.

Featured

ZimaCube 2 개인용 클라우드 홈 NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

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

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

이러한 점검을 마친 뒤에만 원격 액세스나 추가 서비스를 더하세요. ZimaCube 2 AI NAS와 같은 소형 호스트는 지속형 저장소, 컨테이너 여유 용량, 별도의 백업 경로라는 기본 요건이 이미 스택에 부합할 때 고려할 수 있습니다.

확장 범위와 중단 기준 정하기

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