커뮤니티 솔루션

ZimaOS에서 현재 지원되는 ZVM PCIe 패스스루 HBA 옵션

IceWhale said PCIe passthrough was long-term roadmap work; a 2026 community ZVM-Extra module later added VFIO-based PCIe passthrough outside core ZVM.

네이티브 ZVM에는 아직 명확하게 문서화된 공식 PCIe 패스스루 워크플로가 없으므로, 존재하지 않을 수도 있는 체크박스를 전제로 LSI HBA VM을 계획하지 마세요. IceWhale은 처음에 PCIe 패스스루를 장기 로드맵 작업이라고 밝혔습니다. 2026년에는 커뮤니티 ZVM-Extra 모듈에 VFIO 기반 PCIe 패스스루가 추가되었지만, 여전히 핵심 ZVM이 아닌 커뮤니티 확장 기능입니다.

HBA 패스스루가 업무상 중요하다면 Proxmox가 더 일반적인 호스트 선택입니다. ZimaOS를 계속 사용하려면 중요한 스토리지를 연결하기 전에 테스트 VM에서 IOMMU 그룹과 커뮤니티 확장 기능을 검증하세요.

원래 스레드에서 IceWhale이 밝힌 내용

2025년 11월, IceWhale은 PCIe 패스스루를 단기적으로는 계획하지 않았지만 장기 로드맵에는 포함되어 있다고 밝혔습니다.

2026년에 달라진 점

커뮤니티 ZVM-Extra 모듈 스레드에서는 VFIO와 IOMMU 그룹 확인을 통한 PCIe 패스스루가 소개되었습니다. 이후 IceWhale은 이 모듈이 현재 ZVM의 공백을 보완한다고 인정했습니다.

커뮤니티 지원은 네이티브 지원이 아닙니다

ZVM-Extra는 공식 ZVM과 함께 작동하며 동일한 libvirt 백엔드를 사용합니다. 하지만 이것이 네이티브 ZVM에 공식적으로 문서화된 패스스루 UI가 추가되었다는 뜻은 아니며, 향후 모든 ZimaOS 업데이트가 서드파티 확장 기능의 동작을 보장한다는 의미도 아닙니다.

무엇보다 먼저 IOMMU를 확인하세요

dmesg | grep -Ei 'DMAR|IOMMU'
find /sys/kernel/iommu_groups/ -type l

HBA는 중요한 호스트 하드웨어를 빼앗지 않고 격리할 수 있는 안전한 IOMMU 그룹에 속해야 합니다.

LSI HBA는 패스스루하기에 영향이 큰 장치입니다

VFIO에 바인딩되어 VM에 할당되면 호스트는 더 이상 해당 컨트롤러의 디스크를 사용해서는 안 됩니다. ZimaOS 시스템 디스크나 호스트에 중요한 스토리지를 동일한 HBA에 연결하지 마세요.

패스스루가 핵심 요구 사항이라면 Proxmox를 사용하세요

HBA를 직접 소유해야 하는 TrueNAS, Unraid 또는 다른 스토리지 VM을 운영하려면 Proxmox가 성숙한 PCIe 패스스루 워크플로를 제공하므로 아키텍처를 더 쉽게 설계하고 이해할 수 있습니다.

필요하다면 ZimaOS를 게스트로 유지하세요

앱과 UI에는 ZimaOS를 Proxmox VM으로 실행하고, 다른 VM이 HBA를 소유하도록 구성할 수 있습니다. 현재 Proxmox에서 ZimaOS 실행 가이드에는 현재 지원되는 ZimaOS 게스트 설치 방법이 설명되어 있습니다.

재부팅 후에도 유지되는지 테스트하세요

한 번 작동한 패스스루 구성도 호스트 드라이버가 장치를 다시 가져가거나 확장 기능 메타데이터가 재적용되지 않으면 재부팅 후 실패할 수 있습니다. 운영 데이터를 맡기기 전에 콜드 부팅, VM 시작 및 중지, 스토리지 인식을 테스트하세요.

가상화 하드웨어 가이드에서 하드웨어 제약 조건을 확인할 수 있습니다.

VFIO 변경 전에 VM 정의를 백업하세요

HBA를 VFIO에 바인딩하기 전에 VM XML/구성과 스토리지 메타데이터를 저장하세요. 장치 바인딩을 잘못하면 VM이 시작되지 않거나 다음 복구 단계까지 호스트에서 컨트롤러에 접근할 수 없게 될 수 있습니다.

전체 IOMMU 그룹을 확인하세요

PCI 주소가 lspci에 표시된다는 이유만으로 장치를 패스스루하지 마세요. 동일한 IOMMU 그룹에 속한 모든 기능을 검사하고, 해당 그룹을 격리해도 호스트 NIC, SATA 컨트롤러 또는 다른 중요한 장치가 함께 분리되지 않는지 확인하세요.

스토리지 VM에는 복구 계획이 필요합니다

TrueNAS 또는 다른 게스트가 HBA를 소유한다면, HBA에 연결된 디스크와는 독립적으로 해당 게스트, VM 디스크, 패스스루 구성을 복구하는 방법을 문서화하세요. 그렇지 않으면 데이터 디스크가 정상이어도 호스트 장애로 스토리지 풀에 접근할 수 없게 될 수 있습니다.

자주 묻는 질문

이제 네이티브 ZVM이 PCIe 패스스루를 공식 지원하나요?

현재 공식 문서에서는 명확한 공식 패스스루 워크플로를 찾을 수 없었으며, 2026년에 공개적으로 논의된 작동 방식은 커뮤니티 확장 기능입니다.

ZVM-Extra로 PCIe 장치를 패스스루할 수 있나요?

커뮤니티 문서에 따르면 IOMMU 그룹 확인과 함께 VFIO를 사용하여 가능합니다.

LSI HBA를 스토리지 VM에 패스스루해야 하나요?

HBA를 깔끔하게 격리할 수 있고 호스트가 해당 HBA에 연결된 디스크에 의존하지 않는 경우에만 패스스루하세요.

이 작업에는 Proxmox가 더 쉬운가요?

PCIe 패스스루가 선택적인 실험이 아니라 핵심 설계 요구 사항이라면 그렇습니다.