A transcodificação por hardware costuma deixar de funcionar após uma atualização porque o contentor recriado já não deteta o mesmo dispositivo, grupo de permissões ou capacidade do runtime, ou porque já não tem uma pilha de espaço de utilizador compatível.
A GPU do anfitrião pode continuar a funcionar enquanto o Plex, o Jellyfin, o Emby ou uma aplicação de câmaras passa silenciosamente a recorrer à CPU depois de substituir a imagem. A primeira tarefa é confirmar se o dispositivo existe dentro do novo contentor e se o utilizador do serviço consegue aceder-lhe. Em seguida, distinga os problemas de mapeamento do runtime e de permissões de uma regressão de codecs ou controladores específica da imagem.
Confirmar que a carga de trabalho recorreu mesmo à transcodificação por software
Force a transcodificação de um ficheiro e registe o painel de controlo do servidor multimédia, o registo do FFmpeg ou do transcodificador, a utilização da CPU no anfitrião e a atividade do motor da GPU. A reprodução direta não testa o percurso de hardware.
Um caso da comunidade LinuxServer recomenda verificar um indicador explícito de hardware e a telemetria da GPU, pois a atividade da CPU, por si só, pode induzir em erro. O indicador mais útil é a utilização ativa do motor da GPU durante uma transcodificação controlada.
Se os registos mostrarem que o codificador por hardware é aberto com sucesso, investigue filtros não suportados, legendas, mapeamento de tons ou aceleração parcial. Se não for possível abrir o dispositivo, continue a verificar a deteção no anfitrião e o acesso pelo contentor.
Comparar os dispositivos GPU no anfitrião e dentro do contentor
Liste os nós de dispositivo esperados no anfitrião e dentro do contentor atualizado. Para VA-API da Intel ou AMD, compare /dev/dri/card* e /dev/dri/renderD*; para NVIDIA, compare a visibilidade no runtime e os dispositivos indicados pela respetiva ferramenta de gestão.
Um caso de Quick Sync no Unraid mostra que o anfitrião pode precisar do módulo de kernel correto antes de existir /dev/dri, e que o dispositivo também tem de ser disponibilizado ao contentor. Muitas vezes, o que falta é o mapeamento do dispositivo /dev/dri, e não a biblioteca multimédia ou a base de dados da aplicação.
Se o dispositivo não existir no anfitrião, comece por corrigir o controlador, a BIOS, o kernel ou o estado do hardware do anfitrião. Se existir no anfitrião, mas não dentro do contentor, compare a configuração de dispositivos antiga e a nova, no compose ou gerada pela interface.
Verificar o acesso aos grupos Render e Video
Registe os IDs numéricos do proprietário e do grupo dos nós de dispositivo da GPU no anfitrião e, em seguida, verifique os grupos atribuídos ao utilizador do serviço dentro do contentor. Nomes como render podem corresponder a IDs numéricos diferentes consoante a imagem.
Um caso de resolução de problemas do Jellyfin no Docker mostra uma configuração funcional que corresponde explicitamente ao ID do grupo de renderização do anfitrião e verifica as permissões de renderD128. Esse mapeamento numérico do grupo de renderização pode mudar quando uma imagem altera os utilizadores ou grupos internos.
Adicione o grupo suplementar necessário à definição do contentor, em vez de tornar o dispositivo acessível a todos os utilizadores. Recrie o contentor e teste o acesso como o utilizador efetivo do serviço multimédia.
Verifique as opções de execução e as capacidades específicas da imagem
Compare as definições da imagem anterior e da atual quanto a devices, group_add, às definições de execução da GPU, às variáveis de capacidades, ao modo privilegiado e a quaisquer alterações nos modelos do gestor de contentores.
Um relato sobre o Emby descreve a interrupção da aceleração por hardware no Docker enquanto a aplicação continuava disponível, ilustrando o recurso a software após a perda da GPU, que torna este problema fácil de não detetar.
Não resolva um problema específico de acesso a dispositivos concedendo acesso privilegiado abrangente. Restabeleça apenas as permissões mínimas de dispositivo e grupo necessárias para o percurso do codificador.
Distinga uma regressão da imagem do contentor de uma falha do anfitrião
Execute um teste simples de GPU ou FFmpeg no contentor atualizado e, em seguida, compare-o com a imagem anteriormente fixada, usando as mesmas montagens, mapeamentos de dispositivos, ficheiro multimédia e configuração da aplicação.
Se a imagem antiga funcionar imediatamente e a nova falhar com o mesmo estado de execução, guarde os registos e considere que se trata de uma regressão na camada de utilizador, nos codecs, no FFmpeg ou na aplicação. Não reescreva as permissões repetidamente quando a comparação controlada entre imagens já permite identificar a versão.
Limpe apenas as caches de codecs regeneráveis documentadas quando os registos apontarem para esse problema e não altere a base de dados da aplicação nem os metadados dos ficheiros multimédia. Fixe a imagem comprovadamente funcional até à regressão ser compreendida ou corrigida.
Valide todo o pipeline após a reparação
Teste a descodificação por hardware, a codificação, o mapeamento de tons, a inserção de legendas na imagem e, pelo menos, um cliente que force a transcodificação. Confirme que o dispositivo GPU esperado aparece nos registos e que o anfitrião apresenta atividade contínua do motor.
O procedimento da ZimaSpace para verificar a transcodificação real por hardware proporciona um teste de conclusão mais rigoroso do que uma opção numa página de definições.
O problema só fica resolvido quando o contentor atualizado ou fixado mantém o acesso ao dispositivo após ser recriado e após o reinício, utiliza a GPU para o percurso de codec previsto e deixa de recorrer silenciosamente a uma alternativa. Guarde o digest da imagem anterior e a definição de execução como limite para reverter a próxima atualização.
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...



