정상적인 복원으로 필요한 사용자, 경로, 재생, 권한 및 재시작 동작이 재현되는지 확인하기 전에는 기존 Jellyfin 서버를 폐기하지 마세요.
새 인스턴스가 단순히 대시보드만 여는 상태인가요, 아니면 기존 호스트와 동일한 클라이언트 및 스토리지 작업 부하를 견뎌냈나요? 테스트하는 동안 기존 서버는 중지하고 복구 가능한 상태로 유지하세요. 성공적인 로그인은 첫 번째 신호일 뿐입니다. 복원 과정에서는 실제 가정 환경에서 사용하는 상태와 데이터 경로가 제대로 유지되는지 입증해야 합니다.
재생 전에 영구 상태 확인
복원된 구성과 데이터베이스에 예상한 사용자, 라이브러리, 시청 상태, 플러그인 및 권한이 포함되어 있는지 확인하세요. Jellyfin 서비스 컨텍스트에서 각 라이브러리 경로를 점검하고, 모든 스토리지 위치에서 샘플 파일을 하나씩 읽어 보세요. 마운트 누락이나 잘못된 소유권은 스캔 또는 재생 요청이 발생할 때까지 드러나지 않을 수 있습니다.
캐시나 다운로드한 아트워크처럼 의도적으로 다시 생성한 항목을 기록해 두세요. 그래야 차이를 복원 실패로 오인하지 않습니다. 다음 단계가 완료될 때까지 백업과 기존 애플리케이션 데이터 사본은 변경하지 말고 그대로 유지하세요.
복원된 항목 수와 알려진 시청 상태 기록 하나를 기존 서버의 마지막 목록과 비교하세요. 데이터베이스가 정상적으로 시작되었다고 해서 모든 미디어 경로나 사용자 권한이 유지되었다는 뜻은 아닙니다.
기존 클라이언트 작업 부하 실행
로컬 Direct Play 1회, 강제 트랜스코딩 1회, 자막, 사용 중인 경우 원격 액세스, 제한된 사용자 계정을 테스트하세요. 기존 서버에서 확인된 동작과 재생 모드, 오디오, 자막 렌더링, 라이브러리 표시 여부 및 시작 시간을 비교하세요.
클라이언트 하나만 실패한다면 전체 복원을 변경하기 전에 해당 클라이언트의 기능이나 경로 문제를 분리해 확인하세요. 마이그레이션 경로는 체크리스트로 유용하지만, 승인 여부는 사용자의 실제 가정 환경 작업 부하를 기준으로 결정해야 합니다.
서비스가 정상적인 시작 작업을 완료할 만큼 충분히 실행된 후 세션을 한 번 더 반복하세요. 이렇게 하면 빠른 로그인으로는 발견하기 어려운 지연된 마운트, 플러그인 또는 메타데이터 오류를 포착할 수 있습니다.
콜드 재시작 및 복구 단계 통과
Jellyfin을 중지하고 호스트를 재부팅한 다음, 스토리지 마운트와 네트워크 서비스가 준비될 때까지 기다린 후 동일한 클라이언트 테스트를 반복하세요. 복원된 애플리케이션 상태의 최신 백업을 생성하거나 찾아 두세요. 그런 다음 두 번째 복원 테스트를 수행하거나, 최소한 해당 백업에 복구에 필요한 정확한 데이터 디렉터리와 권한이 포함되어 있는지 확인하세요.
복원된 호스트가 상태, 경로, 사용자, 재생, 콜드 재시작 및 백업 위치 확인을 두 번 모두 통과했을 때만 기존 서버를 폐기하세요. 데이터베이스를 열 수 없거나, 기존 클라이언트 작업 부하가 실패하거나, 복구 사본을 독립적으로 읽을 수 없다면 중지하고 롤백하세요.
통과한 정확한 복원 지점, 파일 소유권 및 경로 매핑을 기록하세요. 새 호스트가 폐기 유예 기간 중에 실패할 경우 이 세부 정보가 복구 절차가 됩니다.
폐기 유예 기간을 안전하게 종료
복원된 호스트가 두 번째 콜드 시작 테스트를 통과하고 최신 백업을 독립적으로 찾을 수 있을 때까지 기존 서버는 중지하되 복구 가능한 상태로 유지하세요.
로컬 재생, 필요한 경우 원격 재생, 사용자 액세스, 라이브러리 스캔 및 복원 문서가 모두 통과한 후에만 기존 호스트를 폐기하세요. 보존 기간이 끝날 때까지 기존 애플리케이션 데이터도 유지하세요.
필수 클라이언트가 하나라도 실패하거나, 복원된 데이터베이스가 예기치 않게 변경되거나, 백업으로 테스트한 상태를 재현할 수 없다면 중지하고 롤백하세요.
지원 및 팁
더 읽어보기

동시에 실행되는 컨테이너에 맞게 Jellyfin 데이터베이스 연결을 최적화하는 방법
데이터베이스 소유자는 한 명으로 시작하고 SQLite의 잠금 동작을 측정하세요. 동시성과 복구 요구 사항이 복잡성을 감수할 만한 경우에만 다른 백엔드를 추가하세요.

Jellyfin에서 중복 작업 또는 가져오기를 방지하는 방법
중복 작업은 대개 스케줄러가 겹치거나 작성자가 둘 이상일 때 발생합니다. 담당자 한 명, 경로 하나, 완료 확인 하나를 지정하세요.

데이터베이스 볼륨이 가득 찬 후 Jellyfin을 복구하는 방법
쓰기 작업을 중지하고, 데이터베이스와 WAL 파일을 보존하며, 상태를 무작정 삭제하지 않고 공간을 확보한 다음 무결성과 원래 워크로드를 확인하세요.

