Jellyfin 백업은 모든 파일을 포함하고 있어도 캡처 중 데이터베이스, 구성, 메타데이터가 변경되면 일관성이 깨질 수 있으므로, 백업 도구를 선택하기 전에 쓰기 경계를 정의해야 합니다.
홈 서버에서는 Jellyfin을 일시 중지하거나 상태를 저장하는 모든 경로를 포함하는 파일 시스템 스냅샷을 사용하는 것이 가장 안전합니다. 캡처가 완료된 후에만 원본 서비스를 다시 실행하고, 복사본을 복원 테스트하세요. 테스트에서 누락된 사용자나 시청 기록이 발견되면 마지막으로 정상임이 확인된 백업을 유지하고 해당 백업으로 교체하지 마세요.
작업을 실행하기 전에 일관성 경계를 정의하세요
백업은 쓰기 시점을 알 수 없는 일정에 따라 실행됩니다. 가장 영향이 적은 확인부터 시작하세요. 실행 중인 Jellyfin 작업을 나열하고, 백업 중 서비스 중지, 쓰기 일시 중지 또는 모든 상태 경로의 원자적 스냅샷 생성 중 어떤 방식을 사용할지 결정하세요. 복원 경계
확인해야 할 내용은 구체적이어야 합니다. 서비스를 잠시 중지할 수 있는지, 파일 시스템이 스냅샷을 지원하는지, 두 경계를 모두 사용할 수 없는지를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요.
추측하지 말고 해당 분기에 따라 처리하세요. 서비스 중지나 조정된 스냅샷 생성이 가능하면 이를 예약하고, 불가능하면 애플리케이션 백업을 사용해 범위를 문서화하세요. 두 방법 모두 불가능하다면 실행 중인 파일 복사본을 검증된 백업이라고 부르지 마세요.
해당 경계 아래의 모든 상태 저장 경로를 캡처하세요
캡처 경계를 선택했습니다. 가장 영향이 적은 확인부터 시작하세요. 백업 매니페스트를 Jellyfin의 data/config/cache 경로 및 컨테이너 또는 호스트의 마운트 정의와 비교하세요.
확인해야 할 내용은 구체적이어야 합니다. 필요한 모든 경로가 포함되었는지, 캐시만 누락되었는지, 구성이나 데이터베이스가 없는지를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 상태 경로 목록
추측하지 말고 해당 분기에 따라 처리하세요. 데이터와 구성이 포함되어 있으면 계속 진행하고, 캐시만 누락되었다면 재생성 가능한 항목으로 문서화하세요. 데이터베이스나 구성이 누락되었다면 백업을 거부하고 매니페스트를 수정하세요.
보존된 백업을 신뢰하기 전에 복사본을 복원 테스트하세요
선택한 경계에 따라 백업을 캡처했습니다. 가장 영향이 적은 확인부터 시작하세요. 별도의 데이터 경로에 복원하고, 동일한 Jellyfin 버전을 실행한 다음 로그인하여 시청 기록과 라이브러리를 확인하고 항목 하나를 재생하세요.
확인해야 할 내용은 구체적이어야 합니다. 상태가 일관적인지, 설정 마법사가 표시되는지, 라이브러리나 사용자 하나가 누락되었는지를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요.
추측하지 말고 해당 분기에 따라 처리하세요. 상태와 재생이 정상이라면 백업을 승인하고, 설정 마법사가 표시되면 마운트가 잘못된 것이며, 상태가 누락되었다면 백업을 거부하고 이전 복사본을 유지하세요.
의심스러운 백업은 가장 작은 복구 단계로 처리하세요
복원 테스트에서 상태가 누락되었거나 일관되지 않은 것으로 나타났습니다. 가장 영향이 적은 확인부터 시작하세요. 의심스러운 백업을 읽기 전용으로 유지하고, 마지막으로 승인된 복사본과 비교하며, 다시 캡처하기 전에 원본 로그를 확인하세요.
확인해야 할 내용은 구체적이어야 합니다. 원본이 정상인지, 원본 자체가 이미 손상되었는지, 경로 하나만 다른지를 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 복원 테스트를 거친 보존
추측하지 말고 해당 분기에 따라 처리하세요. 원본이 정상이라면 경계나 매니페스트를 수정하고 다시 캡처하세요. 원본이 손상되었다면 먼저 마지막으로 정상인 복사본을 복원하세요. 경로 하나만 다르다면 해당 마운트를 수정하고 테스트를 반복하세요.
지원 및 팁
더 읽어보기

Jellyfin이 다른 컨테이너와 GPU 또는 가속기를 안전하게 공유할 수 있나요?
GPU 공유는 조건부로 지원됩니다. 먼저 장치가 표시되는지와 드라이버가 지원되는지 확인한 다음, 두 워크로드를 모두 실행하고 소프트웨어 폴백이 발생하는지 지켜보세요.

Jellyfin 오류가 클라이언트에서 발생했는지 서버에서 발생했는지 확인하는 방법
Jellyfin 오류는 한 기기에서만 발생하면 클라이언트 문제이고, 동일한 경로에서 여러 클라이언트가 실패하며 로그 내용도 일치하면 서버 문제입니다.

Jellyfin 캐시 및 임시 저장소 구성 방법
지속적인 상태 데이터, 재구축 가능한 캐시, 임시 트랜스코딩 저장 공간을 분리한 다음 실제 재생 테스트로 용량과 권한을 확인하세요.

