안전한 접근 방식은 데이터베이스 무결성과 경로를 확인하고, 일치하는 메타데이터 자산을 복원하며, 검증된 누락 항목만 새로 고치는 단계적 복구를 단일 명령이 아닌 관찰 가능한 게이트의 연속으로 다루는 것입니다.
Jellyfin 또는 유사한 홈 미디어 서버를 격리된 앱 데이터 경로로 복원할 때 실제 위험은 복원된 미디어 데이터베이스는 시작되지만 포스터, 매칭 결과, 컬렉션, 시청 상태 또는 라이브러리 연결이 불완전한 경우입니다. 현재 식별 정보와 복구 지점을 기록하고, 가장 변경이 적은 판별 절차부터 시작하며, 다른 변수를 변경하기 전에 성공 및 실패 결과를 해석하고, 스토리지가 불안정해지거나 복구 가능한 유일한 사본이 노출될 상황에서는 중단합니다. 아래 워크플로는 원래 작업이 성공하거나 증거가 에스컬레이션 경계에 도달한 경우에만 종료됩니다.
복원된 인스턴스를 동결하고 누락 항목을 분류하세요
복구된 서버를 프로덕션 환경과 격리된 상태로 유지하고 예약된 스캔, 정리, 메타데이터 교체 및 자동 라이브러리 모니터링을 비활성화합니다. 애플리케이션 버전, 데이터베이스 파일, 메타데이터 및 이미지 디렉터리, 캐시, 라이브러리 경로, 사용자 수, 시청 상태, 플러그인, 그리고 각 구성 요소의 정확한 복구 시점을 기록합니다.
ZimaSpace의 Jellyfin 복구 단위 검증 절차를 사용하여 백업이 단순한 데이터베이스 파일이 아니라 완전한 복구 단위인지 확인합니다. 한 시점의 데이터베이스와 다른 시점의 메타데이터 디렉터리를 조합하면 정상적으로 시작되더라도 항목 참조와 아트워크 자산이 서로 일치하지 않을 수 있습니다.
증상을 별도로 분류합니다. 포스터 누락, 잘못된 제목 매칭, 비어 있는 컬렉션, 유실된 시청 상태, 사용할 수 없는 미디어 또는 권한 오류가 이에 해당합니다. 미디어 마운트나 복원된 데이터베이스의 무결성이 확실하지 않다면 새로 고치기 전에 중단하세요. 새로 고침으로는 누락된 복구 구성 요소를 안전하게 복구할 수 없습니다.
버전, 데이터베이스 무결성 및 미디어 경로를 확인하세요
복원된 데이터의 복사본을 대상으로 일치하는 애플리케이션 버전을 시작하고 데이터베이스 마이그레이션 및 무결성 메시지를 확인합니다. 최신 버전이 데이터베이스를 마이그레이션하도록 허용하기 전에 복원된 사용자, 라이브러리 정의, 항목 수 및 시청 기록이 존재하는지 확인합니다.
복원된 데이터베이스가 예상하는 동일한 컨테이너 경로에 미디어를 읽기 전용으로 마운트합니다. 경로가 변경되었다면 복사본에서 지원되는 마이그레이션 또는 경로 업데이트 방법이 제대로 작동하는지 입증합니다. 먼저 라이브러리를 삭제하고 다시 만들지 마세요. 그러면 새 식별자가 생성되어 기존 상태와의 연결이 끊어질 수 있습니다.
Jellyfin 경로 및 데이터베이스 마이그레이션 사례에 관한 Jellyfin 마이그레이션 논의에서는 데이터베이스 참조와 구성 경로를 구분합니다. 이를 범위가 제한된 마이그레이션 단서로 활용하되, 프로덕션 데이터베이스 테이블을 무작정 편집하지 말고 복원된 버전과 하나의 파일럿 라이브러리를 기준으로 검증합니다.
일치하는 자산을 복원하고 검증된 누락 항목만 새로 고치세요
가능한 경우 동일한 복구 지점에 속하는 메타데이터, 아트워크, 플러그인 및 구성을 복원합니다. 권한과 소유권을 비교한 다음, 사용자 지정 포스터, 수동으로 식별한 제목, 컬렉션, 자막 및 인물 이미지를 대표하는 여러 알려진 항목을 불러옵니다.
파일은 없지만 데이터베이스 참조가 올바른 경우 소규모 파일럿 세트에서 누락된 메타데이터 또는 누락된 이미지 작업을 실행합니다. 올바른 폴더 이름은 원격 매칭을 개선합니다. 매칭을 위한 미디어 폴더 이름 지정에서는 체계적인 Jellyfin 경로가 전체 교체 새로 고침을 수행하지 않고도 제공업체가 제목을 식별하는 데 어떻게 도움이 되는지 설명합니다.
전체 메타데이터 교체는 저장된 상태를 의도적으로 폐기해도 되는 항목에만 사용합니다. NFO 파일과 잠긴 필드를 보존하고 변경 전 상태를 기록하며, 파일럿 실행으로 사용자 지정 제목, 아트워크, 정렬 이름 또는 컬렉션 소속이 덮어써지지 않는지 확인합니다.
복구를 검증하고 서비스를 점진적으로 복귀시키세요
대표 항목을 재생하고, 포스터와 배경 이미지를 확인하며, 컬렉션을 열고, 검색을 테스트하고, 원래 사용자 계정에서 시청 진행 상태를 확인한 다음, 임시 메타데이터 편집을 하나 수행합니다. 격리된 인스턴스를 다시 시작하고 복구된 모든 상태가 유지되는지 확인합니다.
먼저 파일럿 라이브러리의 스캔을 다시 활성화한 다음, 라이브러리를 한 번에 하나씩 활성화합니다. 사용할 수 없는 경로, 이미지 쓰기 실패, 제공업체 제한, 데이터베이스 잠금 및 예기치 않은 항목 삭제가 로그에 나타나는지 확인합니다. 전체 주기가 완료될 때까지 원본 복원 사본은 변경하지 않은 상태로 유지합니다.
데이터베이스, 경로, 아트워크, 사용자 지정 필드, 사용자, 재생, 재시작 및 백업이 모두 통과한 경우에만 트래픽을 반환합니다. 식별자나 시청 상태가 변경되면 보호된 복원 사본으로 롤백하고, 유일한 사본에 새로 고침을 계속 적용하는 대신 손상 또는 누락된 복구 구성 요소를 에스컬레이션합니다.
지원 및 팁
더 읽어보기

라이브 TV 녹화 저장 공간, 보존 기간 및 정리 가이드
실제 녹화 데이터를 측정하고, 헤드룸을 확보하며, 보관 기간과 용량 제한을 함께 적용하고, 저장 공간이 가득 차기 전에 가장 오래된 조건 충족 프로그램이 삭제되는지 확인하세요.

오디오, 비디오 및 자막용 Jellyfin 클라이언트 호환성 체크리스트
대표 파일을 한 번에 하나의 변수만 테스트하고, 모든 클라이언트에 대해 Direct Play, 리먹스, 오디오 변환, 비디오 트랜스코딩 또는 실패를 기록하세요.

스캔, 메타데이터 및 HDD 스핀다운을 위한 미디어 라이브러리 유지 관리 가이드
디스크에 액세스하는 작업을 유용한 활성 시간대에 묶고, 메타데이터 변경 범위를 제한하며, 새 미디어 검색과 실제 유휴 기간을 모두 확인하세요.

