사용자, 시청 기록 또는 설정을 잃지 않고 Jellyfin 데이터를 옮기는 방법
사용자나 시청 기록을 잃지 않고 Jellyfin을 이전하려면, 영구 데이터를 복사하기 전에 소스 인스턴스를 중지하고 새 인스턴스가 검증을 통과할 때까지 기존 인스턴스를 그대로 유지하세요.
모든 미디어 파일이 있어도 홈 서버 마이그레이션은 실패할 수 있습니다. Jellyfin의 상태 정보가 데이터, 구성, 메타데이터, 데이터베이스 경로에 저장되기 때문입니다. 이러한 마운트를 확인하고, 쓰기 작업을 중지한 상태에서 복사한 다음, 동일한 경로와 소유권을 재현하세요. 기존 소스를 폐기하기 전에 로그인, 시청 기록, 라이브러리 액세스, 재생을 테스트하세요.
소스를 중지하고 영구 경로를 확인하세요
소스 인스턴스가 아직 사용자에게 서비스를 제공하고 있습니다. 가장 영향이 적은 확인부터 시작하세요. Jellyfin 데이터/구성/캐시 경로, 컨테이너 마운트, UID/GID, 버전, 미디어 위치를 기록한 뒤 상태 정보를 복사하기 전에 컨테이너를 중지하세요.
확인 결과는 구체적으로 기록해야 합니다. 모든 상태 경로가 마운트되어 있는지, 데이터베이스 경로가 볼륨 내부에 숨겨져 있는지, 미디어만 매핑되어 있는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 마이그레이션 전에 백업
추측하지 말고 상황에 따라 진행하세요. 모든 영구 경로를 알고 있다면 계속 진행하고, 숨겨진 경로가 있다면 먼저 확인하세요. 미디어만 매핑되어 있다면 복사하기 전에 상태 백업을 생성하세요.
소유권을 유지한 채 데이터, 구성, 데이터베이스를 복사하세요
소스가 중지되었고 경로 목록을 확인했습니다. 가장 영향이 적은 확인부터 시작하세요. 먼저 상태 디렉터리를 복사하고, 파일 수와 크기를 비교한 다음, 대상 UID/GID를 적용하고 Jellyfin이 데이터베이스를 읽고 쓸 수 있는지 확인하세요.
확인 결과는 구체적으로 기록해야 합니다. 데이터베이스가 정상적으로 열리는지, 권한 거부 오류가 나타나는지, 경로는 존재하지만 라이브러리가 비어 있는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 로컬 데이터베이스 경로
추측하지 말고 상황에 따라 진행하세요. 데이터베이스가 열리고 경로가 일치한다면 계속 진행하세요. 권한 문제가 발생하면 파일을 삭제하지 말고 소유권을 수정하세요. 라이브러리가 비어 있다면 다시 검색하기 전에 마운트 경로를 수정하세요.
결과를 테스트하기 전에 런타임을 재현하세요
영구 데이터가 복사되었고 소유권이 수정되었습니다. 가장 영향이 적은 확인부터 시작하세요. 대상 마운트를 사용해 컨테이너를 다시 생성하고 이미지 버전을 기록한 다음, 라이브러리나 사용자를 변경하기 전에 관리자 대시보드를 여세요.
확인 결과는 구체적으로 기록해야 합니다. 사용자와 라이브러리가 표시되는지, 시작 시 마이그레이션이 실행되는지, 기본 설정 마법사가 나타나는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요.
추측하지 말고 상황에 따라 진행하세요. 상태 정보가 표시된다면 아직 다시 검색하지 마세요. 마이그레이션이 실행되면 완료될 때까지 기다리고 소스를 유지하세요. 설정 마법사가 나타나면 데이터 마운트가 잘못된 것이므로 중지하세요.
정리하기 전에 사용자, 시청 기록, 라이브러리, 재생을 확인하세요
새 인스턴스가 복사된 상태 정보로 시작됩니다. 가장 영향이 적은 확인부터 시작하세요. 기존 사용자로 로그인하고 시청 기록과 라이브러리 권한을 확인한 다음, Direct Play 한 번과 트랜스코딩 한 번을 재생하고 한 번 재시작한 후 다시 확인하세요.
확인 결과는 구체적으로 기록해야 합니다. 모든 상태 정보와 재생이 정상인지, 특정 라이브러리가 비어 있는지, 사용자나 시청 기록이 누락되었는지 확인하세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 마이그레이션 검증 경로
추측하지 말고 상황에 따라 진행하세요. 모든 확인을 두 번 통과했다면 최종 백업을 보관하고 나중에 소스를 폐기하세요. 상태 확인 중 하나라도 실패하면 클라이언트를 소스로 되돌리세요. 재생이 실패하면 정리하기 전에 경로나 하드웨어 가속기를 수정하세요.
추천 제품
지원 및 팁
더 읽어보기
Jellyfin이 다른 컨테이너와 GPU 또는 가속기를 안전하게 공유할 수 있나요?
GPU 공유는 조건부로 지원됩니다. 먼저 장치가 표시되는지와 드라이버가 지원되는지 확인한 다음, 두 워크로드를 모두 실행하고 소프트웨어 폴백이 발생하는지 지켜보세요.
Jellyfin 오류가 클라이언트에서 발생했는지 서버에서 발생했는지 확인하는 방법
Jellyfin 오류는 한 기기에서만 발생하면 클라이언트 문제이고, 동일한 경로에서 여러 클라이언트가 실패하며 로그 내용도 일치하면 서버 문제입니다.
Jellyfin 캐시 및 임시 저장소 구성 방법
지속적인 상태 데이터, 재구축 가능한 캐시, 임시 트랜스코딩 저장 공간을 분리한 다음 실제 재생 테스트로 용량과 권한을 확인하세요.
