Native ZVM still does not have a clearly documented first-party PCIe passthrough workflow, so do not plan an LSI HBA VM around an assumed checkbox that may not exist. IceWhale originally said PCIe passthrough was long-term roadmap work; in 2026, a community ZVM-Extra module added VFIO-based PCIe passthrough, but it remains a community extension rather than core ZVM.
Se a passagem direta da HBA for essencial para a sua missão, o Proxmox continua a ser a escolha mais convencional para anfitrião. Se quiser continuar a usar o ZimaOS, valide os grupos IOMMU e a extensão comunitária numa VM de teste antes de colocar armazenamento importante atrás dela.
O que a IceWhale disse no tópico original
Em novembro de 2025, a IceWhale afirmou que a passagem direta PCIe não estava prevista a curto prazo, mas constava do roteiro de longo prazo.
O que mudou em 2026
O tópico do módulo ZVM-Extra da comunidade introduziu a passagem direta PCIe através de VFIO e a verificação de grupos IOMMU. Mais tarde, a IceWhale reconheceu que o módulo respondia a lacunas atuais do ZVM.
O apoio da comunidade não é apoio nativo
O ZVM-Extra funciona em paralelo com o ZVM oficial e utiliza o mesmo backend libvirt. Isto não significa que o ZVM nativo tenha adquirido uma interface de passagem direta documentada oficialmente nem que todas as futuras atualizações do ZimaOS preservem o comportamento das extensões de terceiros.
Verifique o IOMMU antes de qualquer outra coisa
dmesg | grep -Ei 'DMAR|IOMMU'
find /sys/kernel/iommu_groups/ -type lA sua HBA tem de estar num grupo IOMMU seguro, que possa ser isolado sem retirar hardware essencial ao anfitrião.
Uma HBA LSI é um dispositivo de grande impacto para passar diretamente à VM
Depois de ser associada ao VFIO e atribuída à VM, a controladora já não deverá ser usada pelo anfitrião para aceder aos discos. Não coloque o disco de sistema do ZimaOS nem armazenamento essencial para o anfitrião atrás da mesma HBA.
Use o Proxmox quando a passagem direta for o requisito principal
Para o TrueNAS, o Unraid ou outra VM de armazenamento que precise de acesso direto a uma HBA, o Proxmox dispõe de um processo de passagem PCIe maduro e torna a arquitetura mais fácil de compreender.
Mantenha o ZimaOS como convidado, se necessário
Pode executar o ZimaOS como VM no Proxmox para usar as respetivas aplicações e interface, deixando outra VM controlar o HBA. O guia atual para executar o ZimaOS no Proxmox documenta a instalação atualmente suportada do ZimaOS como sistema convidado.
Teste se as alterações persistem após o reinício
Uma configuração de passthrough que funciona uma vez pode falhar após um reinício, se os controladores do anfitrião voltarem a assumir o dispositivo ou se os metadados da extensão não forem reaplicados. Teste o arranque a frio, o arranque e a paragem da VM e a visibilidade do armazenamento antes de confiar dados de produção a esta configuração.
O guia de hardware para virtualização aborda as limitações de hardware.
Faça uma cópia de segurança da definição da VM antes de alterar o VFIO
Guarde o XML/a configuração da VM e os metadados de armazenamento antes de associar um HBA ao VFIO. Erros na associação de dispositivos podem impedir o arranque de uma VM ou retirar o controlador do acesso do anfitrião até à etapa de recuperação seguinte.
Verifique todo o grupo IOMMU
Não passe um dispositivo apenas porque o respetivo endereço PCI aparece em lspci. Inspecione todas as funções no mesmo grupo IOMMU e confirme que o isolamento do grupo não vai retirar ao anfitrião uma placa de rede, um controlador SATA ou outro dispositivo essencial.
As VMs de armazenamento precisam de um plano de recuperação
Se o TrueNAS ou outro sistema convidado controlar o HBA, documente como recuperar esse sistema, o disco da VM e a configuração de passthrough, independentemente dos discos ligados ao HBA. Caso contrário, uma falha do anfitrião pode tornar o conjunto de armazenamento inacessível, mesmo que os discos de dados estejam em boas condições.
Perguntas frequentes
O ZVM nativo suporta oficialmente passthrough PCIe neste momento?
Não foi encontrado nenhum procedimento claro de passthrough oficial nas documentação oficial atual; a solução funcional discutida publicamente em 2026 é uma extensão da comunidade.
O ZVM-Extra permite fazer passthrough de dispositivos PCIe?
A documentação da comunidade diz que sim, através de VFIO e da verificação dos grupos IOMMU.
Devo passar um HBA LSI a uma VM de armazenamento?
Só se for possível isolar corretamente o HBA e o anfitrião não depender de nenhum disco ligado a ele.
O Proxmox facilita este processo?
Sim, quando o passthrough PCIe é um requisito essencial do projeto, e não uma experiência opcional.
