ZVM Extras는 ZVM 자체를 대체하지 않고 ZimaOS에 기본 제공되는 ZVM 관리자의 운영상 공백을 메우기 위해 구축된 커뮤니티 확장 기능입니다. 공식 ZVM은 가상 머신 생성 및 편집을 담당하며, ZVM Extras는 별도의 모듈로서 그 옆에서 작동합니다. systemd-sysext 모듈이며 동일한 libvirt 백엔드와 통신합니다.
이 프로젝트는 2026년 5월 ZimaOS 1.6.1에서 자동 시작, 스냅샷, USB 패스스루, 원격 스토리지, 백업, 워치독 및 메트릭 기능을 갖추고 시작되었습니다. 이후 커뮤니티 테스트를 통해 빠르게 발전했습니다. 현재 공개 저장소에는 ZimaOS 1.7.0-beta1에서 검증된 v0.7.0이 문서화되어 있으며, v0.6.3의 여러 버그가 이미 수정되었습니다.
ZVM을 대체하지 않고 확장합니다
소스 작성자는 두 번째 VM 관리자를 만드는 방식을 의도적으로 피했습니다. ZVM Extras는 동일한 VM 목록을 읽고 libvirt/virsh를 통해 작동하며, 일반적인 ZVM 인터페이스는 VM 생성 및 일반적인 편집 작업에서 계속 권한을 가집니다.
이 설계는 기본 제공 가상화 계층과의 충돌을 줄이지만 호환성 위험을 없애지는 않습니다. ZimaOS 또는 ZVM 업데이트로 인해 확장 기능의 하위에서 libvirt 동작, VM XML, 네트워킹 또는 장치 처리가 변경될 수 있습니다.
자동 시작에 VM별 순서 및 지연 시간 추가
이 확장 기능은 ZimaOS 호스트가 부팅된 후 선택한 VM이 자동으로 시작되도록 설정할 수 있습니다. 단순히 “모두 자동 시작”하는 스위치와 달리, VM 간 순서와 지연 시간을 지원하므로 인프라 서비스가 순차적으로 시작될 수 있습니다.
워치독은 선택한 VM이 예기치 않게 중지되면 다시 시작할 수도 있습니다. v0.7.0에서는 같은 영역에 시작, 중지, 재부팅 및 강제 종료 제어 기능이 추가되었으며, 사용자가 VM을 중지하려 할 때 워치독이 즉시 VM을 다시 시작할 수 있음을 경고합니다.
스냅샷은 실행 중인 VM과 중지된 VM을 서로 다르게 처리합니다
기존 설계는 중지된 VM에 내부 libvirt 스냅샷을 사용하고, 실행 중인 VM에는 메모리 상태를 포함한 외부 스냅샷을 사용했습니다. 실행 중 생성하고 되돌릴 수 있는 스냅샷은 더 복잡하며 상당한 스토리지를 사용할 수 있기 때문에 이러한 구분은 중요합니다.
원격 NFS 또는 SMB 스토리지도 스냅샷 대상으로 사용할 수 있어 로컬 NVMe 장치의 부담을 줄일 수 있습니다.
USB 패스스루가 GUI 워크플로가 되다
또한 일반 ZVM UI가 나중에 게스트 구성을 다시 작성해 호스트 장치 항목을 삭제하는 경우에도, 이 확장 기능은 영구 USB 연결을 다시 조정합니다.
PCIe 패스스루는 VFIO와 IOMMU 그룹을 사용함
v0.4.0부터 ZVM Extras는 PCIe 패스스루를 지원했습니다. 인터페이스에는 IOMMU 그룹과 호스트 드라이버가 표시되고, 명백히 부적합한 브리지 장치는 차단되며, 할당에는 VFIO가 사용됩니다.
이는 일반 USB 장치를 패스스루하는 것보다 위험도가 높은 기능입니다. 선택한 하드웨어를 안전하게 격리해야 하고, 호스트가 해당 하드웨어에 의존해서는 안 되며, 잘못된 할당은 호스트 안정성이나 네트워킹에 영향을 줄 수 있습니다.
원격 스토리지에 스냅샷과 백업을 저장할 수 있음
이는 대용량 QCOW2 가상 디스크에 특히 유용합니다. 활성 VM과 동일한 물리 장치에 모든 스냅샷을 보관하면 로컬 드라이브 장애에 대한 보호 효과가 거의 없고, 공간이 빠르게 소진될 수 있습니다.
VM 백업은 XML과 디스크 이미지를 내보냄
이 프로젝트는 VM 구성과 디스크 이미지를 독립적인 백업 아티팩트로 내보낼 수 있습니다. 이후 버전에서는 선택한 백업 대상을 기억하므로 반복 작업이 더 쉬워졌습니다.
VM 스냅샷과 VM 백업은 동일하지 않습니다. 스냅샷은 주로 롤백을 위한 기능입니다. 다른 장치에 저장된 별도의 백업은 호스트 스토리지 자체의 손실에 대비해 보호 기능을 제공합니다.
실시간 지표로 ZVM이 더욱 운영 중심적인 대시보드로 변함
ZVM Extras는 libvirt에서 CPU, 메모리, 디스크, 네트워크 지표를 읽습니다. 커뮤니티 사용자들은 테스트 VM에서 이러한 측정값이 정상적으로 작동한다고 확인했습니다. v0.6.3에서는 한 사용자가 모든 VM의 메모리 사용률이 100%로 표시된다고 보고했으며, 작성자는 계산 문제를 추적해 v0.7.0에서 수정했습니다. v0.7.0에는 짧은 기간의 기록 스파크라인도 추가되었습니다.
NIC 전환은 기존 네트워크로 의도적으로 제한됨
이 확장 기능은 게스트 NIC의 libvirt 네트워크와 모델을 변경할 수 있습니다. 작성자는 실행 중인 ZimaOS 이더넷 인터페이스를 브리지에 종속시켜 새 호스트 브리지를 자동으로 생성하는 기능을 의도적으로 거부했습니다. 브리지 마이그레이션에 실패하면 NAS가 오프라인 상태가 될 수 있기 때문입니다.
이 신중한 경계는 중요합니다. 기존 네트워크를 선택하는 방식이 VM 관리 애드온에서 호스트의 기본 네트워크 스택을 다시 작성하는 것보다 훨씬 안전합니다.
VM ↔ 호스트 통신도 여전히 macvtap의 한계에 부딪힐 수 있음
한 커뮤니티 사용자는 LAN에서는 Home Assistant VM에 연결할 수 있었지만, 두 환경이 동일한 물리 NIC를 사용할 때 ZimaOS 호스트의 리버스 프록시 컨테이너에서는 연결할 수 없었습니다. 원문 작성자는 전형적인 macvtap 호스트 격리 동작을 의심했으며 게스트 XML을 확인해 보라고 제안했습니다.
그는 해당 설명을 가설이라고 명확히 밝혔습니다. 정확히 동일한 설정을 재현할 수 없었기 때문입니다. 실제 인터페이스 유형을 확인하지 않고 이를 ZimaOS의 확정된 근본 원인으로 단정하지 마세요.
프로젝트에 실제 테스트 스위트가 추가되었지만, 모든 하드웨어 경로가 포함된 것은 아닙니다
v0.4.0의 경우 작성자는 정적 분석, 경쟁 상태 테스트, CSRF/출처 제어, 인수/경로 주입 방어, 스냅샷, 백업 내보내기, NIC 변경 및 메트릭을 포함한 63개의 테스트 케이스가 통과했다고 보고했습니다. 실제 전원 주기와 실행 중 PCIe 연결 사례는 해당 자동화 테스트 범위에서 의도적으로 제외되었습니다.
또 다른 커뮤니티 사용자는 독립적으로 v0.4.0을 설치하여 sysext가 로드되고, Debian VM이 감지되며, 메트릭이 표시되고, 중지된 VM의 스냅샷이 성공적으로 생성되는 것을 확인했습니다.
IceWhale이 프로젝트를 칭찬했지만, 여전히 커뮤니티 소프트웨어입니다
이후 Zima-Jerry는 이 프로젝트가 현재 ZVM의 부족한 점을 해결하는 것으로 보인다고 답변했습니다. 이는 긍정적인 공식 피드백이지만, ZVM Extras가 ZimaOS의 일부가 되었거나 기본 제공 모듈처럼 지원된다는 발표는 아닙니다.
설치하기 전에 현재 ZVM Extras 저장소와 릴리스 상태를 검토하세요. 현재 저장소에서는 v0.7.0이 ZimaOS 1.7.0-beta1에서 검증되었다고 명시합니다.
커뮤니티 가상화 확장 기능을 테스트하기 전에 VM 데이터 백업하기
스냅샷, 패스스루, XML 조정 기능은 모두 VM 스토리지 및 장치 구성에 밀접하게 영향을 줍니다. 먼저 폐기 가능한 게스트로 테스트하고, 중요한 QCOW2 디스크의 사본을 보관하며, 확장 기능을 설치하지 않은 상태에서도 복원할 수 있는지 확인하세요.
ZVM Extras FAQ
ZVM Extras가 공식 ZVM 앱을 대체하나요?
아니요. 이 확장 기능은 보조 확장 프로그램으로 설계되었으며 동일한 libvirt 백엔드를 사용합니다.
GUI에서 USB 및 PCIe 장치를 패스스루할 수 있나요?
예. USB 패스스루와 VFIO 기반 PCIe 패스스루는 이 프로젝트의 핵심 기능입니다.
VM을 다른 NAS에 백업할 수 있나요?
NFS 또는 SMB 스토리지를 마운트하고, 스냅샷이나 백업 내보내기에 원격 경로를 사용할 수 있습니다.
ZVM Extras는 IceWhale의 공식 지원을 받나요?
아니요. IceWhale 직원이 이 프로젝트를 칭찬했지만, 소스와 현재 저장소에서는 커뮤니티 애드온으로 설명하고 있습니다.
