Em dezembro de 2025, um tutorial da comunidade IceWhale publicou uma extensão autónoma de kernel aberto da NVIDIA para GPUs RTX 50XX num kernel específico do ZimaOS. Mais tarde, um utilizador confirmou que uma RTX 5060 Ti de 16 GB disponibilizava os controlos da GPU aos contentores. Outros utilizadores relataram que o mesmo procedimento falhava no ZimaOS 1.6.1 ou não permitia utilizar uma RTX 5090.
Isto torna a publicação um procedimento histórico específico de uma versão, não um comando intemporal de “controlador NVIDIA mais recente”.
O Procedimento Histórico Exato
A publicação original instruía os utilizadores a iniciar uma sessão SSH, mudar para root e executar:
cd /var/lib/extensions/
wget https://github.com/jerrykuku/staff/releases/download/v0.1.3/nvidia-open-kernel-580.105.08-linux-6.12.25.raw -O nvidia-open-kernel-580.105.08-linux-6.12.25.raw
systemd-sysext refresh
install-nvidia-kernel-openNão execute este bloco apenas porque a GPU é um modelo RTX 50XX. O nome do ficheiro especifica explicitamente o kernel Linux 6.12.25, e o comando auxiliar tem de existir na versão instalada do ZimaOS. Faça uma cópia de segurança dos dados das aplicações e confirme uma forma de recuperação através da consola local antes de alterar as extensões do kernel.
Associe a Compilação do ZimaOS Antes de Instalar
- Registe a versão exata e o kernel do ZimaOS.
- Confirme que a GPU aparece em
lspci. - Verifique se
install-nvidia-kernel-openexiste. - Confirme que o número do kernel da extensão corresponde ao kernel em execução.
- Leia as respostas mais recentes na discussão original para verificar regressões.
Um utilizador do ZimaOS 1.6.1 relatou Package not installed para uma extensão do sistema e install-nvidia-kernel-open: command not found. Isto é um sinal para parar, não um motivo para improvisar outro instalador com privilégios de root.
Os Controladores Não Corrigem um Dispositivo PCIe em Falta
Se lspci não mostrar o dispositivo NVIDIA, resolva primeiro problemas relacionados com Oculink, integridade do adaptador, alimentação da dock, encaixe do cabo e negociação da ligação PCIe. A discussão relacionada sobre a deteção de Oculink demonstra por que razão ventoinhas e LEDs não provam que o dispositivo foi enumerado.
O Que o Sucesso com a RTX 5060 Ti Confirmou
O sucesso provou que uma combinação específica de modelo e software funcionava. Não provou que a configuração do Stable Diffusion, todas as placas RTX 50XX, todas as docks ou todas as versões posteriores do ZimaOS funcionariam.
Verifique as Três Camadas Após Reiniciar
-
Anfitrião:
lspcideteta a GPU envidia-smiapresenta informações sobre ela. - Contentor: as definições da aplicação no ZimaOS concedem acesso à GPU NVIDIA.
-
Aplicação: a carga de trabalho seleciona CUDA, NVENC ou o back-end de GPU relevante e mostra um processo em
nvidia-smi.
Não Utilize a Extensão RTX 50XX em Placas NVIDIA Mais Antigas
Um utilizador de uma GTX 1050 Ti instalou esta extensão e perdeu o acesso ao NVML até que um membro da equipa IceWhale lhe recomendou executar uninstall-nvidia-kernel-open e reiniciar. Utilize a extensão apenas com o hardware e a versão do sistema para os quais foi criada.
Utilize a Discussão Original como Referência para Atualizações
Como a IceWhale não publicou um comando independente da versão para RTX 50XX no guia geral de instalação atual, consulte o tutorial original sobre RTX 50XX antes de cada tentativa. Inclua num pedido de suporte a versão do ZimaOS, o kernel, o modelo da GPU, o método de ligação, lspci, nvidia-smi e o texto completo do erro.
Perguntas Frequentes sobre RTX 50XX no ZimaOS
A extensão 6.12.25 é válida para todas as versões do ZimaOS?
Não. O nome do ficheiro e os relatos posteriores de falhas mostram que é específica de uma versão.
Ver “NVIDIA Corporation Device” garante que o controlador funciona?
Não. A enumeração no anfitrião foi bem-sucedida, mas o nvidia-smi também tem de comunicar com o controlador.
Devo instalar o controlador antes de a GPU aparecer em lspci?
Não. Resolva primeiro a enumeração do hardware.
