Jellyfin é uma solução de mídia livre e de código aberto, projetada para servidores domésticos ou pessoais. Ele oferece gerenciamento centralizado de vídeos, áudio e imagens, além de streaming sob demanda com ênfase em privacidade e controle total sobre os dados. Seu repositório oficial está disponível em: https://github.com/jellyfin/jellyfin. Ao reproduzir conteúdos em 4K no Jellyfin, você já percebeu travamentos frequentes, deisncronização áudio-vídeo ou até mesmo lentidão crítica do servidor? Esses sintomas normalmente indicam que a transcodificação baseada exclusivamente na CPU está saturendo os recursos do sistema. Este guia apresenta uma abordagem estruturada — diagnóstico, fundamentação técnica, configuração prática e ajustes avançados — para migrar para aceleração por GPU, elevando o desempenho de transcodificação em até 5× e suportando múltiplos fluxos simultâneos em resolução 4K. ### 1. Diagnóstico de gargalos: identificando a necessidade de aceleração

Execute o comando abaixo para verificar se processos de transcodificação estão consumindo excessivamente a CPU: ``` ps aux --sort=-%cpu | grep -i ffmpeg | head -n 5

Se um ou mais processos `ffmpeg` ocuparem consistentemente mais de 60% da CPU durante reprodução, isso indica forte dependência de transcodificação por software. Além disso, examine os arquivos de log localizados em `/var/log/jellyfin/`, especialmente os que seguem o padrão `FFmpeg.Transcode-*.log`. Uma linha como esta confirma uso de codificação por CPU: ```
Stream #0:0: Video: h264 (Main), yuv420p, 3840x2160 [SAR 1:1 DAR 16:9], 23.98 fps

A ausência de referências a nvenc, vaapi ou qsv no log também é um indício claro. ### 2. Fundamentos técnicos: como a GPU acelera a transcodificação

Em vez de delegar todo o pipeline (decodificação → filtragem → codificação) à CPU, a aceleração por GPU transfere operações intensivas para unidades especializadas: - NVIDIA NVENC/NVDEC: circuitos dedicados integrados em GPUs da série GTX 10xx ou superior, com suporte nativo a H.264, HEVC e AV1 (RTX 40xx+).

• Intel Quick Sync Video (QSV): bloco de hardware presente em CPUs Intel desde a geração 6ª (Skylake), ideal para ambientes de baixo consumo.
• VA-API + drivers open-source: interface padronizada usada por GPUs AMD (com drivers mesa-va-drivers) e Intel (com intel-media-va-driver).

Essas unidades operam com latência reduzida e eficiência energética significativamente superior — tipicamente 3–4× mais rápido que uma CPU equivalente para tarefas de compressão de vídeo. ### 3. Implementação passo a passo

Verificação prévia do ambiente

Para NVIDIA: ``` nvidia-smi --query-gpu=name,driver_version --format=csv

Para Intel/AMD: ```
vainfo 2>/dev/null | grep "VAEntrypointVLD"

Se nenhum resultado for exibido, instale os drivers adequados: ```

Para NVIDIA (Ubuntu/Debian)

sudo apt install nvidia-driver-535 ffmpeg

Para Intel

sudo apt install intel-media-va-driver-non-free vainfo ffmpeg

Para AMD

sudo apt install mesa-va-drivers libva2 vainfo ffmpeg

#### Configuração no painel web

Acesse **Administração → Servidor → Reprodução** e ajuste: - **Tipo de aceleração de hardware**: selecione `NVENC`, `QSV` ou `VA-API`, conforme seu hardware.
- **Limite de taxa de bits**: defina entre 20–35 Mbps para saída 4K.
- **Modo de codificação**: use `balanceado` como ponto inicial.
- Habilite **Decodificação por hardware** e **Codificação por hardware**.

Salve e reinicie o serviço: ```
sudo systemctl restart jellyfin

Validação da ativação

Após iniciar uma transcodificação, verifique novamente os logs. Trechos como os abaixo confirmam sucesso: - NVIDIA: [hevc_nvenc @ 0x...] Initialized encoder with 4 threads

• Entel: [hevc_qsv @ 0x...] Using Intel QSV runtime version 1.37
• AMD: [hevc_vaapi @ 0x...] Using VAAPI profile VAProfileHEVCMain

Monitore o uso da CPU com htop: uma queda de 65–75% no consumo comparado ao modo sem aceleração é esperada. ### 4. Ajustes avançados para qualidade e escalabilidade

Otimizações de parâmetros

Edite o arquivo de configuração personalizada do Jellyfin (ex.: /etc/jellyfin/encoding.xml) com: ``` <EncodingOptions> <HardwareAccelerationType>Vaapi</HardwareAccelerationType> <EncoderPreset>medium</EncoderPreset> <MaxBFrames>3</MaxBFrames> <EnableBFrame>true</EnableBFrame> <HardwareDecoding>true</HardwareDecoding> </EncodingOptions>

O uso de `medium` melhora a eficiência de compressão sem impacto crítico no tempo de processamento. #### Permissões e concorrência

Adicione o usuário `jellyfin` ao grupo `video` para acesso aos dispositivos de aceleração: ```
sudo usermod -aG video jellyfin

Para ambientes com múltiplos usuários, limite tarefas simultâneas em Administração → Servidor → Transcodificação. Um valor seguro é min(4, número_de_núcleos_GPU / 2). Ative também Ajuste dinâmico de taxa de bits para adaptar a saída à largura de banda do cliente.