검사, 메타데이터 작업 또는 재생 세션이 끝난 뒤에도 Jellyfin 메모리 사용량이 높은 상태로 남을 수 있습니다. “사용 중인 메모리”에는 수명 주기가 서로 다른 여러 항목, 즉 애플리케이션 힙, 네이티브 할당, 공유 라이브러리, 트랜스코딩용 tmpfs, 파일 시스템 페이지 캐시, 컨테이너에 부과되는 커널 메모리가 포함되기 때문입니다.
높은 수치 하나만 보고 메모리 누수라고 진단하지 마세요. 먼저 메모리가 Jellyfin 프로세스, cgroup, 호스트 캐시 중 어디에 속하는지 확인하세요. 그런 다음 같은 작업을 반복해 회수할 수 없는 부분이 안정적인 수준에 도달하는지, 계속 증가하는지 살펴보세요.
호스트의 여유 메모리 수치가 아니라 사용 가능한 메모리부터 확인하세요
Linux는 유휴 RAM을 사용해 최근 읽은 파일을 캐시에 저장합니다. 따라서 Jellyfin이 라이브러리를 검색하거나 대용량 메타데이터 트리를 읽은 뒤에도 애플리케이션에 충분한 메모리가 남아 있는데 “free” 열의 값은 작게 표시될 수 있습니다.
널리 알려진 Linux 페이지 캐시 설명에서는 사용 가능한 메모리와 스왑 동작을 살펴보라고 권합니다. 여유 RAM이 적다는 사실만으로 문제가 있다고 판단해서는 안 됩니다. 회수 가능한 캐시는 다른 작업에서 페이지가 필요해지기 전까지 유용합니다.
사용 가능한 메모리가 0에 가까워지거나, 스왑 활동이 지속적으로 늘거나, 회수 중 지연 시간이 증가하거나, 커널에 OOM 종료 기록이 남는다면 더 서둘러 대응하세요. 이런 신호는 메모리 압박을 나타냅니다. 메모리 압박이 없다면 캐시 사용량이 많은 것은 단지 서버가 데이터를 캐시에 올려 둔 결과일 수 있습니다.
컨테이너에서 익명 메모리와 파일 캐시 구분하기
컨테이너에서 실행되는 Jellyfin 인스턴스라면 Docker의 단일 비율만 믿지 말고 cgroup 메모리 내역을 확인하세요. 익명 메모리는 힙, 스택, 익명 매핑을 나타내며, 파일 기반 메모리는 페이지 캐시를 나타내므로 일반적으로 회수할 수 있습니다.
최신 컨테이너 메모리 회계 가이드에서는 anon, file, slab을 구분하므로, 캐시 사용량이 많은 컨테이너를 개인 메모리가 무한정 증가하는 프로세스로 오해하지 않을 수 있습니다.
작업 전, 사용량이 가장 높을 때, 완료 후 5분 또는 10분 뒤, 그리고 동일한 작업을 두 번째로 실행한 뒤에 두 값을 모두 기록하세요. 파일 캐시가 높지만 안정적이라면 데이터가 캐시에 따뜻하게 올라온 것입니다. 동일한 주기를 반복할 때마다 익명 메모리가 비슷한 양만큼 증가한다면 프로세스나 플러그인을 더 자세히 조사해야 합니다.
임시 저장소도 메모리일 수 있다는 점을 기억하세요
트랜스코딩 디렉터리나 다른 작업 경로에서 tmpfs를 사용하면, 해당 파일이 RAM을 소비하며 컨테이너 또는 호스트 메모리 회계에 반영될 수 있습니다. 재생 세션이 중지되면 사용 가능한 임시 세그먼트는 결국 해제되어야 하지만, 작업이 중단되거나 정리 과정이 실패하면 tmpfs 사용량이 큰 상태로 남을 수 있습니다.
추가 기가바이트를 모두 관리 힙으로 간주하지 말고 임시 파일 시스템을 직접 측정하세요. 또한 눈에 보이는 Jellyfin 작업이 끝난 뒤에도 FFmpeg 같은 다른 프로세스가 여전히 실행 중인지 확인하세요. 파일이나 매핑을 점유한 자식 프로세스가 있으면 대시보드에는 사용자 작업이 완료된 것으로 표시되더라도 메모리가 할당된 상태로 남을 수 있습니다.
tmpfs 용량을 제한하세요. RAM 기반 트랜스코딩은 최대 작업 메모리에 Jellyfin, 운영 체제 및 다른 컨테이너의 사용량을 더한 뒤에도 안전한 여유가 남을 때만 유용합니다. 일반적인 트랜스코딩 중 메모리 제한에 도달한다면, 전체 호스트의 메모리 용량을 산정한 뒤에만 경로를 SSD로 옮기거나 제한을 높이세요.
반복 가능한 정점 테스트로 메모리 유지와 누수 구분하기
라이브러리 탐색, 소규모 테스트 세트의 메타데이터 새로 고침, 일반적인 트랜스코딩처럼 통제 가능한 작업 하나를 선택하세요. 프로세스 RSS, cgroup의 anon 및 file, 호스트에서 사용 가능한 RAM, 스왑, 작업 소요 시간을 기록하세요. 동일한 냉각 시간을 두고 세 번 실행하세요.
메모리 사용량이 많은 컨테이너의 작업 흐름에서는 익명 메모리가 계속 증가하고 OOM 압박이 발생하는 경우와 캐시 비중이 높지만 사용량이 안정적인 경우를 구분합니다. 이 구분이 메모리 수치가 원래 유휴 상태의 값으로 돌아왔는지 묻는 것보다 더 유용합니다.
런타임 할당자는 모든 페이지를 즉시 운영 체제에 반환하는 대신 재사용을 위해 메모리를 유지할 수 있습니다. 실질적인 판단 기준은 반복되는 동일한 작업으로 커밋된 메모리 사용량이 계속 증가하는지, 그리고 호스트에서 메모리 압박이 발생하는지입니다. RSS가 몇 초 안에 작업 전 유휴 상태의 기준치로 내려오는지가 아닙니다.
메모리 사용량이 안정되지 않으면 플러그인, 반복 작업, 제한을 확인하세요
동일한 작업을 반복할 때마다 익명 메모리가 계단식으로 증가한다면, 필수적이지 않은 플러그인이나 백그라운드 기능을 한 번에 하나씩 비활성화하고 같은 테스트를 반복하세요. 활성 FFmpeg 자식 프로세스가 없고 스캔이 진행 중이지 않은 유휴 Jellyfin 프로세스와 비교하세요.
컨테이너의 메모리 제한과 호스트에서 실행 중인 다른 작업도 확인하세요. 제한이 너무 낮으면 정상적인 캐시 및 런타임 동작도 비정상적으로 보일 수 있습니다. 반대로 부하가 많은 호스트에서 제한이 없으면 한 서비스가 메모리를 지나치게 많이 사용해 시스템 전체에 메모리 회수 압박을 일으킬 수 있습니다.
ZimaSpace에서 논의한 지속적으로 여유가 가장 먼저 사라지는 리소스를 중단 기준으로 삼는 것이 적절합니다. 대시보드에서 유휴 RAM의 대부분을 사용한다고 표시되는 것만으로 메모리 용량을 조정하지 말고, 메모리 압박이 Jellyfin 오류보다 지속적으로 먼저 발생할 때만 조정하세요.
자주 묻는 질문
Jellyfin RSS가 높으면 자동으로 메모리 누수인가요?
아니요. RSS에는 런타임이 재사용을 위해 유지하는 메모리와 유용한 작업이 끝난 뒤에도 상주하는 페이지가 포함될 수 있습니다. 더 확실한 누수 신호는 동일한 작업을 반복해도 안정적인 정점에 도달하지 않고 회수 불가능한 메모리나 익명 메모리가 계속 증가하는 경우입니다. 특히 사용 가능한 RAM이 줄거나 스왑 및 OOM 이벤트가 나타난다면 더욱 그렇습니다.
메모리를 비우려고 매일 밤 Jellyfin을 재시작해야 하나요?
일상적인 해결책으로는 권장하지 않습니다. 재시작은 진단을 위한 비교 수단이 될 수 있지만, 예약 재시작은 증가 양상을 감추고 실제 원인을 가릴 수 있습니다. 먼저 프로세스, cgroup, 캐시, tmpfs 메모리를 구분하세요. 증거로 원인이 확인된 경우에만 메모리 누수, 정리 실패, 플러그인 문제 또는 너무 낮은 제한을 해결하세요.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



