Jellyfin 저장소를 구성할 때는 지속적으로 유지해야 하는 상태 데이터와 다시 생성할 수 있는 캐시, 그리고 일시적으로 급증하는 트랜스코딩 임시 파일을 분리하세요. 데이터베이스와 구성 파일은 가장 안정적인 로컬 경로에 두어야 합니다.
홈 서버에서는 빠른 SSD에 구성 파일, 데이터베이스, 캐시, 트랜스코딩 작업 공간을 두고 대용량 미디어는 더 큰 저장 장치에 보관할 수 있습니다. 각 디렉터리를 명시적으로 매핑하고, 컨테이너 사용자와 최소 여유 공간을 확인한 다음 Jellyfin을 재시작하세요. 레이아웃을 완료했다고 판단하기 전에 일반적인 트랜스코딩 사례를 실행해야 합니다.
지속형, 재생성 가능, 임시 경로 매핑
Jellyfin 경로가 기본값을 사용하거나 문서화되지 않은 마운트에 연결되어 있습니다. 가장 영향이 적은 확인부터 시작하세요. 실제 데이터, 구성, 캐시, 로그, 웹, 트랜스코딩 경로를 출력한 다음 각각을 지속형, 재생성 가능, 임시 경로로 분류합니다.
확인해야 할 구체적인 사항은 다음과 같습니다. 지속형 경로는 로컬 SSD에 있고, 임시 경로는 루트 파티션에 있으며, 캐시는 네트워크 공유에 있을 수 있습니다. 다른 변수를 변경하기 전에 결과를 기록하세요. 실제 Jellyfin 경로
추측하지 말고 조건에 따라 판단하세요. 지속형 경로가 로컬에 있고 안정적이면 그대로 유지하고, 임시 공간이 부족하면 임시 경로만 옮기세요. 데이터베이스나 구성 파일이 원격 위치에 있다면 재생을 조정하기 전에 먼저 로컬로 이전해야 합니다.
경로 및 컨테이너 권한 구성
저장소 역할이 정해졌습니다. 가장 영향이 적은 확인부터 시작하세요. 한 번에 하나의 경로만 변경하고, 마운트 테이블을 확인한 다음 Jellyfin 사용자로 테스트 파일 또는 작업 파일을 생성합니다.
확인해야 할 구체적인 결과는 다음과 같습니다. 쓰기 테스트가 통과하는지, 권한이 거부되는지, 경로가 비어 있는 디렉터리로 확인되는지 살펴보세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 로컬 마운트 파일 시스템
추측하지 말고 조건에 따라 판단하세요. 쓰기가 통과하면 계속 진행하고, 권한 오류가 발생하면 데이터를 삭제하지 말고 소유권을 수정하세요. 경로가 비어 있다면 다시 검색하기 전에 마운트 대상을 수정해야 합니다.
캐시 및 트랜스코딩을 위한 최소 여유 공간 설정
경로가 구성되고 쓰기 가능한 상태입니다. 가장 영향이 적은 확인부터 시작하세요. 일반적인 사용 환경에서 가장 부하가 큰 재생 조합을 실행하고, 임시 파일 증가량과 쓰기 지연 시간을 기록한 다음 오류가 발생하기 전에 알림을 설정합니다.
확인해야 할 구체적인 결과는 다음과 같습니다. 임시 파일이 일정 수준을 유지하는지, 일시적인 부하 중 볼륨이 가득 차는지, 캐시가 삭제되지 않고 계속 증가하는지 살펴보세요. 다른 변수를 변경하기 전에 결과를 기록하세요. 트랜스코딩 최소 여유 공간
추측하지 말고 조건에 따라 판단하세요. 여유 공간이 일정하게 유지되면 현재 기준을 유지하고 모니터링합니다. 공간이 가득 차면 스트림을 추가하기 전에 임시 경로를 옮기거나 확장하세요. 캐시가 전혀 삭제되지 않으면 캐시 경로와 유지 관리 작업을 확인합니다.
재시작 후 대표적인 트랜스코딩 재생
저장소 경로와 최소 여유 공간이 구성되었습니다. 가장 영향이 적은 확인부터 시작하세요. Jellyfin을 한 번 재시작하고 실제 경로를 확인한 다음, 자막 또는 크기 조정을 포함한 Direct Play 한 건과 트랜스코딩 한 건을 재생하고 임시 파일이 정리되는지 확인합니다.
확인해야 할 구체적인 결과는 다음과 같습니다. 경로 설정이 유지되고 재생이 정상적으로 되는지, 트랜스코딩이 CPU로 대체되는지, 임시 파일 쓰기가 실패하는지 살펴보세요. 다른 변수를 변경하기 전에 결과를 기록하세요.
추측하지 말고 조건에 따라 판단하세요. 경로와 재생이 모두 정상이라면 중단합니다. 하드웨어 가속기 대체가 발생하면 매핑 문제를 별도로 진단하세요. 임시 파일 쓰기가 실패하면 마지막으로 작동한 경로를 복원하고 소유권을 수정합니다.
지원 및 팁
더 읽어보기

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

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

Jellyfin 백업에서 일관되지 않은 상태가 캡처되지 않도록 하는 방법
완전한 파일 복사만으로는 자동으로 일관성이 보장되지 않습니다. 쓰기를 중지하거나 원자적으로 스냅샷을 생성하고, 모든 상태 경로를 캡처한 다음 복원을 검증하세요.

