Solución de la comunidad

Extras de ZVM para ZimaOS: inicio automático, instantáneas, asignación directa de USB/PCIe y copias de seguridad de máquinas virtuales

A May-August 2026 community project that adds operational controls beside ZimaOS's built-in ZVM: autostart, snapshots, USB and PCIe passthrough, VM backup/export, remote storage, metrics, NIC switching, power controls, and a VNC console. IceWhale staff praised the work but it remains a community add-on.

ZVM Extras es una extensión comunitaria creada para cubrir las carencias operativas del administrador ZVM integrado en ZimaOS sin reemplazarlo. El ZVM oficial sigue siendo responsable de crear y editar máquinas virtuales; ZVM Extras funciona junto a él como un módulo independiente systemd-sysext módulo y se comunica con el mismo backend de libvirt.

El proyecto comenzó en mayo de 2026 en ZimaOS 1.6.1 con inicio automático, instantáneas, USB passthrough, almacenamiento remoto, copias de seguridad, watchdogs y métricas. Después evolucionó rápidamente gracias a las pruebas de la comunidad. El repositorio público actual documenta la versión v0.7.0, verificada en ZimaOS 1.7.0-beta1, y varios errores de la versión v0.6.3 ya están corregidos.

Amplía ZVM en lugar de reemplazarlo

El autor del código evitó deliberadamente crear un segundo administrador de máquinas virtuales. ZVM Extras lee el mismo inventario de máquinas virtuales y funciona mediante libvirt/virsh, mientras que la interfaz normal de ZVM sigue siendo la autoridad para crear máquinas virtuales y realizar ediciones habituales.

Este diseño reduce los conflictos con la capa de virtualización integrada, pero no elimina el riesgo de compatibilidad. Una actualización de ZimaOS o ZVM aún puede cambiar el comportamiento de libvirt, el XML de las máquinas virtuales, la red o la gestión de dispositivos subyacentes a la extensión.

El inicio automático añade un orden y un retraso específicos para cada máquina virtual

La extensión puede marcar determinadas máquinas virtuales para que se inicien automáticamente después de que arranque el host ZimaOS. A diferencia de un simple interruptor de «iniciar todo automáticamente», admite establecer un orden y retrasos entre las máquinas virtuales para que los servicios de infraestructura se inicien en secuencia.

Un watchdog también puede reiniciar las máquinas virtuales seleccionadas si se detienen inesperadamente. En la versión v0.7.0, esta misma sección incorporó controles para iniciar, detener, reiniciar y apagar forzosamente, además de advertencias cuando el watchdog fuera a reiniciar inmediatamente una máquina virtual que el usuario está intentando detener.

Las instantáneas gestionan de forma diferente las máquinas virtuales en ejecución y detenidas

Pestaña Snapshots de ZVM Extras que muestra una máquina virtual Linux en ejecución, con controles para crear instantáneas, seleccionar el destino de almacenamiento, revertirlas y eliminarlas
La extensión proporciona una interfaz gráfica para crear, revertir y eliminar instantáneas, en lugar de exigir a los usuarios que las gestionen manualmente con virsh.

El diseño original utilizaba instantáneas internas de libvirt para las máquinas virtuales detenidas e instantáneas externas con el estado de la memoria para las máquinas virtuales en ejecución. Esta distinción es importante porque una instantánea activa y reversible es más compleja y puede consumir una cantidad considerable de almacenamiento.

El almacenamiento NFS o SMB remoto también puede utilizarse como destino de instantáneas, reduciendo la carga sobre el dispositivo NVMe local.

USB Passthrough se convirtió en un flujo de trabajo con interfaz gráfica

Pestaña USB passthrough de ZVM Extras que muestra los dispositivos USB del host, con controles persistentes para conectarlos y desconectarlos
El proyecto de origen muestra los dispositivos USB del host y permite conectarlos de forma persistente a una VM seleccionada sin editar manualmente el XML de libvirt.

La extensión también reconcilia las conexiones USB persistentes si la interfaz normal de ZVM reescribe posteriormente la configuración del invitado y elimina la entrada del dispositivo del host.

El passthrough de PCIe utiliza VFIO y grupos IOMMU

En la v0.4.0, ZVM Extras añadió el passthrough de PCIe. La interfaz muestra la agrupación IOMMU y el controlador del host, bloquea los dispositivos puente evidentemente inadecuados y utiliza VFIO para la asignación.

Esta función sigue siendo más arriesgada que conectar directamente un dispositivo USB común. El hardware elegido debe aislarse de forma segura, el host no debe depender de él y una asignación incorrecta puede afectar a la estabilidad o la red del host.

El almacenamiento remoto puede contener instantáneas y copias de seguridad

Pestaña de almacenamiento remoto de ZVM Extras para añadir recursos compartidos NFS o SMB como destinos de instantáneas y copias de seguridad
Los montajes NFS y SMB se pueden configurar como destinos remotos para las instantáneas de VM y las exportaciones de copias de seguridad.

Esto resulta especialmente útil para discos virtuales QCOW2 grandes. Mantener todas las instantáneas en el mismo dispositivo físico que la VM activa ofrece poca protección frente a un fallo de la unidad local y puede consumir espacio rápidamente.

Las copias de seguridad de VM exportan XML e imágenes de disco

El proyecto puede exportar la configuración de la VM y las imágenes de disco como un artefacto de copia de seguridad independiente. Las versiones posteriores recuerdan el destino de copia de seguridad seleccionado, lo que facilita las operaciones repetidas.

Una instantánea de una VM y una copia de seguridad de una VM no son equivalentes. Una instantánea sirve principalmente como mecanismo de reversión. Una copia de seguridad independiente almacenada en otro dispositivo protege frente a la pérdida del almacenamiento del propio host.

Las métricas en tiempo real convierten ZVM en un panel más operativo

ZVM Extras lee las métricas de CPU, memoria, disco y red desde libvirt. Usuarios de la comunidad confirmaron que esas mediciones funcionaban en VM de prueba. En la v0.6.3, un usuario informó de que todas las VM mostraban un 100 % de memoria; el autor rastreó el problema de cálculo y lo solucionó en la v0.7.0, que también añadió minigráficos de historial breve.

El cambio de NIC está limitado intencionadamente a las redes existentes

La extensión puede cambiar la red y el modelo libvirt de la NIC de un invitado. El autor se negó intencionadamente a automatizar la creación de un nuevo puente del host asociando la interfaz Ethernet activa de ZimaOS, porque una migración fallida al puente podría dejar el NAS sin conexión.

Este límite cauteloso es importante. Seleccionar una red existente es mucho más seguro que reescribir la pila de red principal del host desde un complemento de gestión de VM.

La comunicación entre la VM y el host aún puede verse limitada por macvtap

Un usuario de la comunidad podía acceder a una máquina virtual de Home Assistant desde la LAN, pero no desde un contenedor de proxy inverso en el host de ZimaOS cuando ambos utilizaban la misma NIC física. El autor de la fuente sospechó del comportamiento clásico de aislamiento del host de macvtap y sugirió revisar el XML del invitado.

Etiquetó claramente esa explicación como una hipótesis porque no pudo reproducir la configuración exacta. No la conviertas en una causa raíz confirmada de ZimaOS sin inspeccionar el tipo de interfaz real.

El proyecto añadió una suite de pruebas real, pero no cubre todas las rutas de hardware

Para la versión v0.4.0, el autor informó de que se superaron 63 casos de prueba, incluidos análisis estático, pruebas de condiciones de carrera, controles de CSRF/origen, protecciones contra inyección de argumentos y rutas, instantáneas, exportación de copias de seguridad, cambios de NIC y métricas. Los casos reales de apagado y encendido y de conexión de PCIe en caliente quedaron intencionadamente fuera del alcance de esas pruebas automatizadas.

Otro usuario de la comunidad instaló de forma independiente la versión v0.4.0, confirmó que la sysext se cargaba, detectó una máquina virtual Debian, mostró métricas y creó correctamente una instantánea de una máquina virtual detenida.

IceWhale elogió el proyecto, pero sigue siendo software comunitario

Zima-Jerry respondió más tarde que el proyecto parecía abordar las deficiencias actuales de ZVM. Es una valoración oficial positiva, no un anuncio de que ZVM Extras haya pasado a formar parte de ZimaOS ni de que tenga el mismo soporte que un módulo integrado.

Antes de instalarla, revisa el repositorio actual de ZVM Extras y el estado de la versión. Actualmente, el repositorio identifica la versión v0.7.0 como verificada en ZimaOS 1.7.0-beta1.

Haz una copia de seguridad de los datos de la máquina virtual antes de probar extensiones comunitarias de virtualización

Las instantáneas, el paso de dispositivos y la reconciliación de XML funcionan cerca del almacenamiento de la máquina virtual y de la configuración de los dispositivos. Pruébalo primero con un invitado desechable, conserva una copia de los discos QCOW2 importantes y asegúrate de poder restaurarlos sin la extensión instalada.

Preguntas frecuentes sobre ZVM Extras

¿ZVM Extras reemplaza a la aplicación oficial de ZVM?

No. Está diseñado como una extensión complementaria y utiliza el mismo backend de libvirt.

¿Puede pasar dispositivos USB y PCIe desde la interfaz gráfica?

Sí. El paso de dispositivos USB y el paso de dispositivos PCIe basado en VFIO son funciones principales del proyecto.

¿Puede hacer una copia de seguridad de una máquina virtual en otro NAS?

Puede montar almacenamiento NFS o SMB y usar rutas remotas para instantáneas o exportaciones de copias de seguridad.

¿ZVM Extras tiene soporte oficial de IceWhale?

No. El personal de IceWhale lo elogió, pero el código fuente y el repositorio actual lo describen como un complemento comunitario.