Solução da comunidade

Restaurar a aprendizagem automática do Immich após mudar de NVIDIA para Intel Arc no ZimaOS

A June–August 2026 solved thread where Jellyfin used an Intel Arc A310 successfully but Immich facial recognition stopped because the machine-learning service still carried NVIDIA-style GPU reservations. The original poster confirmed machine learning worked again after editing the YAML.

Substituir uma GPU NVIDIA por uma placa Intel Arc pode deixar uma aplicação autoalojada a funcionar enquanto outra perde a aceleração. Foi exatamente isso que aconteceu neste tópico de origem, entre junho e agosto de 2026. Depois de trocar uma RTX 2070 por uma Intel Arc A310, a transcodificação de vídeo por hardware do Jellyfin continuou a funcionar e intel-gpu-top funcionava no anfitrião ZimaOS, mas o reconhecimento facial do Immich parou e o widget de GPU da página inicial do ZimaOS desapareceu.

O YAML do Immich apresentado revelou por que razão as aplicações se comportavam de forma diferente: o serviço de aprendizagem automática ainda tinha uma reserva de GPU Docker ao estilo NVIDIA. O caminho Intel do Immich utiliza OpenVINO e acesso direto a /dev/driO autor original acabou por editar o YAML na interface mais recente do ZimaOS e confirmou que a aprendizagem automática voltou a funcionar.

O Jellyfin funcionar não prova que o ML do Immich tenha acesso à GPU

O Jellyfin e a aprendizagem automática do Immich são contentores separados. Cada um recebe a sua própria imagem, dispositivos, ambiente e permissões de execução. Passar uma GPU Intel ao Jellyfin não dá automaticamente acesso à GPU ao ML do Immich /dev/dri aparecer automaticamente dentro de immich-machine-learning.

Esta foi a correção conceptual mais importante do tópico. A deteção da GPU ao nível do anfitrião, a transcodificação do Jellyfin, o ML do Immich e o widget de GPU do ZimaOS são quatro camadas distintas.

O serviço de aprendizagem automática continuava a parecer-se com a configuração NVIDIA antiga

O YAML de origem continha uma reserva de dispositivo Docker semelhante a:

deploy:
  resources:
    reservations:
      devices:
        - capabilities:
            - gpu
          device_ids:
            - "0"

Essa reserva genérica de GPU tinha sido transferida da configuração anterior com a RTX 2070. Não correspondia ao caminho normal do Intel OpenVINO utilizado pelo Immich.

Primeiro, verifique se a GPU Intel existe no anfitrião ZimaOS

O autor original já tinha confirmado dois factos importantes:

  • intel-gpu-top funcionou a partir do terminal do ZimaOS;
  • O Jellyfin conseguia utilizar a Arc A310 para transcodificação por hardware.

Esses resultados mostram que o kernel do anfitrião e, pelo menos, uma via multimédia do espaço do utilizador conseguiam utilizar a GPU. Tornam pouco plausível a explicação de que “a placa Arc não é detetada de todo” para a falha do Immich.

Em seguida, verifique /dev/dri dentro do contentor ML do Immich

O membro da comunidade sugeriu verificar o anfitrião e o contentor separadamente. O diagnóstico mais útil é saber se o contentor de aprendizagem automática consegue ver /dev/dri.

Se o anfitrião tiver o dispositivo de renderização Intel, mas o contentor não, a correção deve ser feita na definição do contentor e não na BIOS da placa-mãe ou na configuração PCIe.

O ML Intel atual do Immich utiliza OpenVINO

O suporte atual do Immich para machine learning acelerado por hardware Intel utiliza OpenVINO. O contentor de machine learning precisa da imagem ou variante de imagem OpenVINO adequada, além de acesso aos dispositivos de renderização.

Antes de editar uma stack atual, consulte os requisitos atuais de machine learning do Immich com aceleração de hardware Intel OpenVINO, porque as etiquetas das imagens e as opções de aceleradores compatíveis podem mudar entre versões do Immich.

A comunidade sugeriu remover a reserva NVIDIA e adicionar acesso ao dispositivo Intel

O autor da resposta propôs remover o antigo deploy.resources.reservations.devices secção do serviço de ML e garantir que os dispositivos de renderização Intel eram passados para o contentor, conceptualmente utilizando:

devices:
  - /dev/dri:/dev/dri

A resposta também sugeria uma imagem de machine learning específica para OpenVINO para a versão que o utilizador tinha publicado.

Essas etiquetas de versão exatas pertencem ao período da fonte. Utilize etiquetas atuais do Immich em vez de fixar o número de versão de 2026.

Utilize os registos de machine learning para confirmar o fornecedor do acelerador

Uma solução funcional /dev/dri mount é necessário, mas não suficiente. Depois de alterar o YAML, reinicie o Immich e consulte os registos de machine learning para verificar a inicialização do acelerador, o carregamento do modelo ou erros do fornecedor.

Isto é preferível a avaliar o sucesso através do widget da GPU do ZimaOS, porque o registo da aplicação indica se o serviço de ML específico está realmente a utilizar o backend pretendido.

A edição de YAML mais recente do ZimaOS facilitou a resolução

Quando o autor original voltou, a 24 de agosto, observou especificamente que a versão mais recente do ZimaOS expunha a edição de YAML de forma mais direta a partir da página inicial do servidor. Isso eliminou a dificuldade anterior de encontrar o YAML subjacente da aplicação.

Este é um limite de versão importante: os conselhos mais antigos sobre localizar manualmente ficheiros Compose gerados são menos relevantes depois de o ZimaOS App Store 2.0 ter adicionado a edição nativa de YAML.

O Autor Original Confirmou a Recuperação do Machine Learning

A resposta final da fonte afirma que, após remover o bloco de reserva da GPU antiga e ajustar a configuração dos dispositivos, o machine learning do Immich voltou a funcionar.

Isto torna este um caso de origem resolvido. Não prova que todos os modelos Intel Arc ou todas as versões do Immich utilizem exatamente o mesmo YAML, mas valida fortemente o diagnóstico: o contentor de ML continuava configurado para o modelo de GPU anterior.

O Widget da GPU em Falta no ZimaOS Era um Problema Separado

O widget da GPU da página inicial desapareceu após a mudança para a Arc A310, mas o Jellyfin já estava a utilizar a GPU. Isso significa que o widget do painel não podia ser tratado como o indicador oficial do suporte da GPU.

Para a resolução de problemas das aplicações, dê prioridade à deteção de dispositivos pelo anfitrião, à visibilidade dos dispositivos no contentor e aos registos da aplicação, em vez de um widget decorativo de utilização.

Uma Lista de Verificação Melhor para a Migração da GPU

  1. Confirme a nova GPU e o controlador ao nível do anfitrião ZimaOS.
  2. Verifique cada aplicação acelerada separadamente.
  3. Remova as reservas de dispositivos específicas do fabricante antigo.
  4. Utilize o back-end de aceleração exigido pelo novo fabricante.
  5. Passe os dispositivos de renderização necessários para cada contentor relevante.
  6. Reinicie apenas a stack afetada e consulte os registos.
  7. Inicie uma nova tarefa de machine learning do Immich e confirme que os resultados aparecem.

FAQ da Intel Arc para o Immich

Porque é que o Jellyfin continuou a funcionar enquanto o reconhecimento facial do Immich deixou de funcionar?

As duas aplicações são executadas em contentores diferentes e requerem uma configuração de GPU separada.

Que back-end utiliza atualmente o Immich para o machine learning com GPU Intel?

OpenVINO.

O problema original da Arc A310 foi resolvido?

Sim. O utilizador confirmou que a edição do YAML restaurou o machine learning.

O widget da GPU do ZimaOS determina se o Immich pode utilizar a GPU?

Não. O caso de origem tinha um widget em falta, embora a aceleração da GPU do Jellyfin continuasse a funcionar.