A memória do Jellyfin pode manter-se elevada após uma análise, uma tarefa de metadados ou uma sessão de reprodução porque a «memória utilizada» inclui vários elementos com ciclos de vida diferentes: heap da aplicação, alocações nativas, bibliotecas partilhadas, tmpfs de transcodificação, cache de páginas do sistema de ficheiros e memória do kernel contabilizada para um contentor.
Não diagnostique uma fuga de memória com base num único valor elevado. Primeiro, determine se a memória pertence ao processo do Jellyfin, ao respetivo cgroup ou à cache do anfitrião; depois, repita a mesma carga de trabalho e veja se a parte não recuperável estabiliza num patamar ou continua a aumentar em degraus.
Comece pela memória disponível, não pelo valor de memória livre do anfitrião
O Linux usa deliberadamente a RAM inativa para colocar em cache os ficheiros lidos recentemente. Por isso, a coluna «livre» pode apresentar um valor baixo depois de o Jellyfin analisar uma biblioteca ou ler grandes árvores de metadados, mesmo que as aplicações continuem a dispor de muita memória.
A clássica explicação da cache de páginas do Linux recomenda observar a memória disponível e o comportamento da swap, em vez de considerar a pouca RAM livre uma falha por si só. A cache recuperável é útil até que outra carga de trabalho precise dessas páginas.
Preocupe-se mais cedo quando a memória disponível se aproxima de zero, a atividade de swap aumenta persistentemente, a latência sobe durante a recuperação de memória ou o kernel regista encerramentos por falta de memória (OOM). Estes sinais indicam pressão; uma grande quantidade de memória em cache sem pressão pode simplesmente refletir um servidor em atividade.
Separe a memória anónima da cache de ficheiros dentro do contentor
Numa instância do Jellyfin em contentor, consulte a discriminação da memória do cgroup em vez de se basear apenas numa percentagem do Docker. A memória anónima representa a heap, a pilha e os mapeamentos anónimos; a memória apoiada por ficheiros representa a cache de páginas e, em geral, pode ser recuperada mais facilmente.
Um guia atual sobre a contabilização da memória dos contentores separa anon, file e slab, para que um contentor com muita memória em cache não seja confundido com um processo cuja memória privada cresce sem limites.
Registe ambos os valores antes de uma carga de trabalho, no pico, cinco ou dez minutos após a conclusão e depois de uma segunda execução idêntica. Uma cache de ficheiros elevada mas estável sugere dados em cache; uma memória anónima que aumenta em quantidade semelhante após cada ciclo idêntico merece uma investigação mais aprofundada dos processos ou dos plugins.
Lembre-se de que o armazenamento temporário também pode ocupar memória
Se o diretório de transcodificação ou outro caminho de trabalho usar tmpfs, os respetivos ficheiros ocupam RAM e podem ser contabilizados na memória do contentor ou do anfitrião. Uma sessão de reprodução interrompida deverá libertar, mais tarde, os segmentos temporários elegíveis, mas uma tarefa interrompida ou uma falha na limpeza pode deixar uma pegada grande em tmpfs.
Meça diretamente o sistema de ficheiros temporário em vez de presumir que cada gigabyte extra corresponde à memória heap gerida. Verifique também se outro processo, como o FFmpeg, continua ativo depois de a tarefa visível do Jellyfin terminar. Um processo filho que mantenha ficheiros ou mapeamentos pode manter memória alocada, mesmo que o painel indique que a tarefa do utilizador foi concluída.
Mantenha o tmpfs limitado. As transcodificações em RAM só são úteis quando o pico do conjunto de trabalho, juntamente com o Jellyfin, o sistema operativo e os outros contentores, ainda deixa uma margem de segurança face à pressão. Se o limite de memória for atingido durante uma transcodificação normal, mude o caminho para um SSD ou aumente o limite, mas apenas depois de dimensionar o anfitrião na sua totalidade.
Use um teste de estabilização repetível para distinguir a retenção de uma fuga de memória
Escolha uma carga de trabalho controlada, como consultar uma biblioteca, atualizar os metadados de um pequeno conjunto de teste ou realizar uma transcodificação representativa. Registe o RSS do processo, os valores anon e file do cgroup, a RAM disponível no anfitrião, o swap e a duração da tarefa. Execute-a três vezes, com períodos de arrefecimento iguais.
Um fluxo de trabalho com contentores que consomem muita memória distingue o crescimento contínuo da memória anónima e a pressão de OOM de uma utilização de memória estável e centrada na cache. Esta distinção é mais útil do que perguntar se o valor regressou ao nível inicial de inatividade.
Os alocadores do runtime podem reter memória para a reutilizar, em vez de devolver imediatamente todas as páginas ao sistema operativo. O que importa é perceber se a execução repetida de tarefas equivalentes continua a aumentar a memória comprometida e se o anfitrião sofre pressão, não se o RSS regressa à linha de base anterior à tarefa em poucos segundos.
Investigue extensões, tarefas repetidas e limites quando a utilização de memória não estabilizar
Se a memória anónima aumentar em degraus ao longo de cargas de trabalho idênticas repetidas, desative uma extensão ou funcionalidade em segundo plano não essencial de cada vez e repita o mesmo teste. Compare com um processo Jellyfin inativo, sem nenhum processo filho FFmpeg ativo nem uma análise em curso.
Verifique também o limite de memória do contentor e as outras cargas de trabalho do anfitrião. Um limite demasiado baixo pode fazer com que o comportamento normal da cache e do runtime pareça patológico, enquanto a ausência de limites num anfitrião sobrecarregado pode permitir que um serviço consuma memória suficiente para provocar pressão de recuperação em todo o sistema.
A discussão da ZimaSpace sobre o primeiro recurso cuja margem sustentável se esgota aponta para o critério certo para parar: ajuste a memória apenas quando a pressão precede sistematicamente uma falha do Jellyfin, e não porque um painel mostra que está a ser usada a maior parte da RAM que, de outro modo, estaria inativa.
Perguntas frequentes
Um RSS elevado do Jellyfin significa automaticamente que há uma fuga de memória?
Não. O RSS pode incluir memória que o runtime mantém para reutilizar e páginas que permanecem residentes após a conclusão de tarefas úteis. Um sinal mais forte de fuga de memória é o aumento da memória anónima ou não recuperável ao longo de cargas de trabalho equivalentes repetidas, sem estabilização, sobretudo quando a RAM disponível diminui ou surgem eventos de swap e OOM.
Devo reiniciar o Jellyfin todas as noites para libertar memória?
Não como solução de rotina. Um reinício pode servir de comparação para diagnóstico, mas reinícios programados ocultam o padrão de crescimento e podem dissimular a verdadeira origem. Classifique primeiro a memória dos processos, dos cgroups, da cache e do tmpfs; corrija uma fuga de memória, uma falha de limpeza, um plug-in ou um limite insuficiente apenas quando as evidências o indicarem.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



