라이브러리 탐색, 스캔 또는 트랜스코딩에서 지연이 발생한다면 Jellyfin의 데이터베이스와 변경이 잦은 캐시는 SSD에 배치하고, 읽기 경로가 안정적이라면 대용량 미디어는 HDD에 유지하세요.
탐색이 느리거나 첫 화면이 늦게 표시되나요? 또는 대용량 파일 재생에서만 문제가 발생하나요? 무엇이든 이동하기 전에 애플리케이션 상태, 캐시, 미디어, 백업 역할을 분리하세요. 목표는 모든 바이트를 빠르게 만드는 것이 아니라, 각 역할에 필요한 지연 시간과 내구성을 제공하는 것입니다.
관찰된 동작에 따라 데이터베이스와 캐시 배치하기
Jellyfin 구성, 데이터베이스, 메타데이터 인덱스, 로그는 작은 읽기와 쓰기를 많이 수행합니다. 트랜스코딩 임시 파일과 이미지 생성 작업도 변경이 잦습니다. 디스크 대기열이나 지연 시간이 증상과 연관되어 있다면 이러한 역할을 로컬 SSD로 이동하세요. 전체 스캔과 동시에 실행되는 가장 큰 트랜스코딩 작업 세트를 수용할 수 있도록 충분한 여유 공간을 확보하세요.
역할을 이동한 후에는 구성된 경로, 소유권, 여유 공간 및 재시작 여부를 확인하세요. Jellyfin 캐시와 메타데이터를 NFS로 이동한 커뮤니티 사례는 네트워크 기반 경로를 로컬 스토리지와 같다고 가정하지 말고 지연 시간과 지속성을 테스트해야 하는 이유를 보여 줍니다(캐시 배치 사례).
컨테이너를 다시 만들고 재부팅한 후 데이터베이스 경로를 확인한 다음, 서비스가 작은 상태 변경 내용을 기록할 수 있는지 확인하세요. 경로가 원래대로 돌아간다면 마운트 또는 환경 매핑이 지속적으로 유지되지 않는 것입니다.
읽기 테스트를 통과하면 대용량 미디어는 용량 계층에 유지하기
영화와 드라마는 대부분 대용량 순차 읽기이므로 Direct Play와 일반적인 트랜스코딩에는 HDD로 충분할 수 있습니다. 원격 파일이나 고비트레이트 파일을 포함해 마운트된 각 라이브러리에서 파일 하나씩 테스트하세요. HDD의 회전 시작이나 공유 네트워크 마운트 때문에 재생이 지연된다면 더 빠른 데이터베이스 디스크를 구매하기 전에 마운트 시점을 조정하거나 스토리지 경로를 분리하세요.
이동 전후의 첫 화면 표시 지연 시간과 라이브러리 탐색 속도를 비교하세요. 측정된 지연 시간이 개선되고 백업 경로가 약화되지 않는 경우에만 SSD 배치를 유지하세요.
캐시가 네트워크 마운트에 있다면 콜드 스타트와 일시적인 NAS 중단을 테스트하세요. 부팅 시 공유 경로를 사용할 수 있을 때만 작동하는 구성은 신뢰할 수 있는 애플리케이션 경로가 아닙니다.
기존 경로를 삭제하기 전에 복구 확인하기
미디어 볼륨과 별도로 애플리케이션 상태를 백업하세요. 깨끗한 경로에 데이터베이스와 구성을 복원하고 Jellyfin을 시작한 다음 사용자, 라이브러리 및 대표적인 재생 세션을 확인하세요. 원래 SSD가 계속 마운트되어 있어야만 복원이 작동한다면 마이그레이션이 완료되지 않은 것입니다.
파일 시스템에서 오류를 보고하거나, 데이터베이스 무결성 검사에 실패하거나, 경로를 이동한 후 메타데이터가 예상과 다르게 변경되면 문제를 상위 단계로 전달하세요. 재시작 후 원래 작업 부하가 정상적으로 통과할 때까지 이전 복사본을 유지하세요.
컨테이너를 다시 만들고 재부팅한 후 데이터베이스 경로를 확인한 다음, 서비스가 작은 상태 변경 내용을 기록할 수 있는지 확인하세요. 경로가 원래대로 돌아간다면 마운트 또는 환경 매핑이 지속적으로 유지되지 않는 것입니다.
최종 SSD 및 HDD 경계 검증하기
최종 마운트가 활성화된 상태에서 Jellyfin을 재시작하고 라이브러리 스캔을 실행한 다음, 각 스토리지 역할에서 파일 하나씩 재생하세요. 재부팅 후에도 데이터베이스, 캐시, 미디어 및 백업 경로가 서로 분리되어 있는지 확인하세요.
관찰된 한계가 작은 파일의 지연 시간이라면 메타데이터를 SSD에 유지하고, 작업에 문제가 없으며 복구 경로를 단순하게 유지하는 편이 더 중요하다면 HDD에 두세요. 벤치마크에서 SSD가 더 빠르다는 이유만으로 역할을 이동하지 마세요.
배치 변경 후 파일 시스템 오류, 데이터베이스 장애 또는 누락된 마운트가 다시 발생하면 문제를 상위 단계로 전달하세요. 다른 스토리지 마이그레이션을 시도하기 전에 이전 경로를 복원하세요.
지원 및 팁
더 읽어보기

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

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

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

