"title":"Adicionar GPU ao LXC | Documentação ProxMenux",
"description":"Partilhe GPU Intel, AMD ou NVIDIA com LXC. O ProxMenux configura dispositivos, grupos e bibliotecas conforme a distribuição; a aplicação tem de suportar e configurar a aceleração."
},
"header":{
"title":"Adicionar GPU ao LXC",
"description":"Partilha acesso GPU com LXC através dos dispositivos do anfitrião. O controlador permanece no anfitrião; as aplicações exigem bibliotecas compatíveis e configuração própria.",
"body":"Adiciona entradas <code>dev<N></code> a <code>/etc/pve/lxc/<ctid>.conf</code> para os nós <code>/dev/dri/*</code>, <code>/dev/kfd</code> ou <code>/dev/nvidia*</code> aplicáveis. Inicia o contentor, instala pacotes userspace da sua distribuição e, para Intel/AMD, alinha os grupos <code>video</code> e <code>render</code>. A aceleração das aplicações continua a exigir hardware, bibliotecas e configuração da aplicação compatíveis."
"heading":"Partilha LXC ou atribuição direta a uma VM",
"intro":"O LXC partilha o kernel e pode <em>partilhar</em> a GPU entre anfitrião e contentores. Com <vmLink>atribuição completa a uma VM</vmLink>, o dispositivo fica dedicado à VM e indisponível para o controlador do anfitrião.",
"headerFeature":"Característica",
"headerLxc":"LXC (esta página)",
"headerVm":"VM",
"rows":[
{
"feature":"O host continua usando o GPU?",
"lxc":"Sim",
"vm":"Não — exclusiva do VM"
},
{
"feature":"Vários contentores a partilhar um GPU?",
"lxc":"Sim",
"vm":"Não"
},
{
"feature":"Requer IOMMU / VFIO no host?",
"lxc":"Não",
"vm":"Sim"
},
{
"feature":"É necessário reiniciar?",
"lxc":"Normalmente não (apenas reinicie o CT)",
"vm":"Se mudar o controlador ou IOMMU do anfitrião; não a cada atribuição"
},
{
"feature":"Sistemas operativos convidados",
"lxc":"Apenas Linux (LXC é somente Linux)",
"vm":"SO convidado suportado com controlador GPU compatível"
}
]
},
"prereqs":{
"title":"Antes de começar",
"gpu":"<strong>GPU no anfitrião</strong> Intel, AMD ou NVIDIA, detetada via <code>lspci</code>.",
"gpuCheck":"lspci | grep -iE 'VGA|3D|Display'",
"vfio":"<strong>A GPU não deve estar associada a vfio-pci.</strong> Precisa do controlador nativo do anfitrião. Se atribuída a uma VM, o script propõe <switchLink>Alterar modo da GPU</switchLink>.",
"nvidia":"<strong>Para NVIDIA:</strong> instale primeiro o controlador no anfitrião. As bibliotecas do contentor têm de corresponder à versão. Use <nvidiaLink>Instalar controladores NVIDIA no anfitrião</nvidiaLink>.",
"nvidiaCheck":"nvidia-smi",
"container":"<strong>Um LXC existente.</strong> O script não o cria. Suporta ambos os modos; um contentor <strong>privilegiado</strong> não é sempre necessário. Dispositivos e permissões numéricas da aplicação têm de corresponder."
},
"unpriv":{
"title":"Suporta contentores privilegiados e sem privilégios",
"body":"O script escreve entradas <code>dev<N></code> para a configuração LXC e, em recipientes não privilegiados, alinha os GIDs <code>video</code> e <code>render</code> entre o host e o recipiente para que os nós do dispositivo GPU sejam alcançáveis de dentro sem que você tenha que editar manualmente <code>lxc.idmap</code>."
},
"running":{
"heading":"Executar o instalador",
"body":"Abra o ProxMenux e escolha <strong>Hardware: GPU e Coral-TPU → Adicionar GPU ao LXC</strong>.",
"imageAlt":"Opção do menu para adicionar GPU ao LXC"
},
"howRuns":{
"heading":"Como funciona o script",
"body":"Escolha contentor e famílias GPU e passe as verificações. Depois para e altera o contentor sem confirmação final adicional. A limpeza VFIO opcional tem confirmação separada e pode alterar antes o anfitrião."
},
"walkthrough":{
"heading":"Procedimento passo a passo",
"detect":{
"title":"Detectar GPUs da máquina",
"body":"Procura controladores GPU com <code>lspci</code>. Para NVIDIA verifica o módulo <code>nvidia</code> e <code>nvidia-smi</code>; a versão detetada determina o instalador <code>.run</code> do contentor.",
"tipTitle":"O NVIDIA não está pronto?",
"tipBody":"Se faltar o módulo ou NVIDIA não funcionar no anfitrião, use primeiro <nvidiaLink>Instalar controladores NVIDIA no anfitrião</nvidiaLink> e verifique o controlador."
"body":"Lista os contentores LXC elegíveis por ID e nome; os contentores OCI são excluídos e utilizam OCI manager Apps para os dispositivos. O contentor é parado se estiver em execução, iniciado para a instalação dos controladores e normalmente reposto no estado original (em execução/parado).",
"imageAlt":"Seleção de um contentor LXC existente"
},
"selectGpu":{
"title":"Selecione as famílias GPU",
"body":"A lista seleciona famílias por fabricante, não um dispositivo PCI isolado. Intel/AMD adicionam os nós DRI previstos; NVIDIA os dispositivos disponíveis, eventualmente de várias placas. Uma única família é selecionada automaticamente. Verifique a lista final, sobretudo com várias GPU.",
"imageAlt":"Lista de famílias GPU detetadas com nome e endereço PCI"
},
"preflight":{
"title":"Verificações prévias",
"imageAlt":"Proposta de alteração de modo de uma GPU associada a vfio-pci",
"intro":"Três verificações, qualquer uma das quais pode bloqueá-lo ou redirecioná-lo:",
"items":[
"<strong>Proteção SR-IOV.</strong> O assistente bloqueia VF ou PF com VF ativas. É uma limitação da seleção ampla de dispositivos, não uma proibição geral em LXC. Configure-os separadamente.",
"<strong>Associada a vfio-pci.</strong> O controlador nativo não pode criar <code>/dev/dri/*</code> ou <code>/dev/nvidia*</code>. Propõe <switchLink>Alterar modo da GPU</switchLink>; siga as indicações de reinício e volte depois.",
"<strong>Já configurada.</strong> Se todos os dispositivos estiverem presentes, termina sem reinstalar bibliotecas. Continua apenas com as famílias selecionadas em falta."
]
},
"applyConfig":{
"title":"Aplicar as alterações de configuração do LXC",
"body1":"Para o contentor, se estiver em execução, e altera <code>/etc/pve/lxc/<ctid>.conf</code>. As entradas numeradas <code>dev<N></code> incluem o GID do anfitrião de <code>video</code> ou <code>render</code>. As linhas bind <code>lxc.mount.entry</code> existentes para <code>/dev/dri</code> são substituídas por entradas <code>dev:</code>; verifique a configuração e as permissões resultantes.",
"body2":"Exemplo após Intel + NVIDIA no mesmo recipiente:"
},
"installDrivers":{
"title":"Iniciar o recipiente e instalar drivers dentro",
"body":"Inicia o contentor e espera até cerca de 30 segundos pela resposta de <code>pct exec</code>. Deteta a distribuição por <code>/etc/os-release</code> e instala os pacotes adequados.",
"debianNvidia":"Extrai <code>.run</code> no anfitrião → <code>pct push</code> → instala com <code>--no-kernel-modules --no-dkms</code>.",
"whyTitle":"Porque utiliza o instalador NVIDIA .run no Debian",
"whyBody":"Os pacotes podem não corresponder ao anfitrião. As bibliotecas <strong>têm de corresponder ao módulo carregado</strong> para NVML e <code>nvidia-smi</code>. Debian/glibc usa o <code>.run</code> dessa versão em cache, extrai e arquiva no anfitrião, transfere com <code>pct push</code> e instala com <code>--no-kernel-modules --no-dkms</code>. Alpine e Arch usam repositórios: verifique as versões."
"body1":"Para Intel/AMD, lê os GID do anfitrião de <code>video</code> e <code>render</code>, usando 44/104 apenas como alternativa, e depois altera <code>/etc/group</code> no contentor para corresponderem; as execuções apenas com NVIDIA saltam este passo. Entradas como <code>video:44</code> e <code>render:104</code> são exemplos, não ID universais. Verifique a pertença da aplicação aos grupos e as permissões efetivas dos dispositivos.",
"body2":"Ao concluir normalmente, volta a parar o contentor se estava parado; se estava ativo mantém-no ativo. Se falhar o arranque ou a instalação, verifique o estado final e o registo."
"intelBody":"A aceleração multimédia Intel, incluindo <em>Quick Sync</em>, depende da geração do GPU, dos codecs e da configuração da aplicação. O script partilha os que existirem de entre <code>/dev/dri/card0</code>, <code>card1</code>, <code>renderD128</code> e <code>renderD129</code>; outros números de nó não são adicionados. O anfitrião tem de os disponibilizar já através do seu controlador nativo, por exemplo <code>i915</code>.",
"amdBody":"AMD usa DRI para Mesa/VA-API. Se existir <code>/dev/kfd</code> no anfitrião, também o partilha. ROCm/OpenCL exige hardware e bibliotecas compatíveis; partilhar o dispositivo não instala toda a pilha ROCm.",
"nvidiaHeading":"NVIDIA",
"nvidiaBody":"Partilha os dispositivos <code>/dev/nvidia*</code>. <strong>As versões do controlador têm de corresponder</strong> para <code>nvidia-smi</code>. Debian/glibc usa o <code>.run</code> da versão do anfitrião; Alpine/Arch os repositórios. Abaixo de 2048 MiB de RAM configurada propõe um aumento temporário e depois restaura; exige também 1500 MiB livres em disco.",
"updateTitle":"Após atualizar NVIDIA no anfitrião, verifique as bibliotecas LXC",
"updateBody":"Bibliotecas antigas podem causar erros em <code>nvidia-smi</code>. O <nvidiaLink>instalador NVIDIA do anfitrião</nvidiaLink> propõe atualizar contentores. Repetir a adição pode terminar se já existirem dispositivos: não garante atualizar bibliotecas. Verifique versões e atualize os pacotes ou a instalação de utilizador adequada."
},
"verification":{
"heading":"Verificação",
"body":"No contentor verifique se a GPU está visível e utilizável."
},
"troubleshoot":{
"heading":"Resolução de problemas",
"mismatchTitle":"nvidia-smi: Failed to initialize NVML: Driver/library version mismatch",
"mismatchBody":"As bibliotecas não correspondem ao módulo carregado. Verifique versões e atualize o espaço de utilizador LXC. O <code>.run</code> em cache serve para Debian/glibc, mas a adição pode terminar se todos os dispositivos já existirem.",
"denyTitle":"Permissão negada em /dev/dri/renderD128 dentro do recipiente",
"denyBody":"Verifique dispositivo e permissões numéricas de <code>render</code>, depois se o utilizador pertence a <code>render</code>. Se disponível, adicione-o a <code>render</code> com <code>usermod -aG render <user></code>, substituindo o marcador pela conta real. Reinicie a sessão. Mudar privilégios não é uma solução geral.",
"vainfoTitle":"vainfo indica: VA-API version 1.xx; failed to initialize",
"vainfoBody":"Verifique acesso e controlador VA-API. Os nomes variam por distribuição: por exemplo <code>intel-media-driver</code> para Intel recentes suportadas, <code>i965-va-driver</code> para antigas compatíveis e <code>mesa-va-drivers</code> para AMD. A mensagem só por si não prova que falte um pacote.",
"logTitle":"Registo de instalação",
"logBody":"Cada execução escreve <code>/tmp/add_gpu_lxc.log</code> no anfitrião. Anexe o registo ao pedir ajuda."
},
"related":{
"heading":"Relacionados",
"items":[
{
"label":"Instalar Drivers NVIDIA (Host)",
"href":"/docs/hardware/nvidia-host",
"tail":" — instale o controlador do anfitrião antes de partilhar NVIDIA."
},
{
"label":"Adicionar GPU a VM (passthrough)",
"href":"/docs/hardware/gpu-vm-passthrough",
"tail":" — alternativa para dedicar uma GPU a uma VM."
},
{
"label":"Alterar modo da GPU (VM ↔ LXC)",
"href":"/docs/hardware/switch-gpu-mode",
"tail":" — alterna a GPU entre partilha LXC e atribuição VM."
},
{
"label":"Comandos de passagem GPU",
"href":"/docs/help-info/gpu-commands",
"tail":" — referência rápida para comandos de shell relacionados."
