Solucionar el problema de resolución de pantalla atascada en 1024x768 en una máquina virtual Pardus KVM

¿Por qué una máquina virtual Pardus KVM puede quedarse atascada en 1024x768?

Una máquina virtual Pardus que nunca ofrece una resolución superior a 1024x768 generalmente no sufre un problema simple de configuración del escritorio. La cuestión importante es si el sistema invitado recibe realmente un modo de visualización virtual mayor de KVM/QEMU y si la sesión de escritorio puede reaccionar a los eventos de redimensionamiento.

El resultado deseado es sencillo: tras redimensionar la ventana del visor o seleccionar un modo de mayor tamaño, Pardus debería mostrar resoluciones como 1366x768, 1600x900 o 1920x1080, en lugar de indicar 1024x768 como su resolución máxima. La integración del portapapeles y el comportamiento fluido del puntero son indicadores secundarios útiles cuando se utiliza SPICE, pero la resolución es la prueba principal.

Esta guía se aplica principalmente a las máquinas virtuales Pardus que se ejecutan bajo KVM/QEMU con libvirt y una consola SPICE o gráfica. Pardus 25.0 se lanzó en noviembre de 2025, y el repositorio oficial de descargas de Pardus también incluye imágenes de Pardus 25.1 de marzo de 2026. Los menús del escritorio pueden variar entre las ediciones XFCE y GNOME, por lo que las comprobaciones que se describen a continuación utilizan comandos y configuraciones de virtualización que no dependen en gran medida de un entorno de escritorio específico. Consulte el repositorio oficial de descargas de Pardus 25 para obtener las imágenes de instalación más recientes.

1. Confirma que 1024x768 es realmente el modo máximo del invitado.

Comience dentro de Pardus. Abra una terminal e identifique el tipo de sesión y el hardware de visualización virtual:

echo "$XDG_SESSION_TYPE"
lspci -nnk | grep -A3 -E 'VGA|Display'

Si la sesión es X11, ejecute también:

xrandr --current

Presta atención a dos cosas. Primero, anota si la GPU virtual es QXL, Virtio GPU, un adaptador VGA genérico u otra cosa. Segundo, revisa la lista de modos. Si 1920x1080 ya aparece en la lista, es probable que la pila de virtualización sea compatible con la resolución mayor y que el problema se deba a la configuración del escritorio o a un evento de redimensionamiento. Si xrandrindica que la resolución máxima es 1024x768, cambiar el cuadro de diálogo de resolución del escritorio por sí solo probablemente no solucionará el problema.

En una sesión Wayland, xrandrno es una herramienta de configuración autorizada para el compositor, así que úsela solo como información complementaria. El tipo de sesión importa porque QXL se ha asociado históricamente con flujos de trabajo X.Org/SPICE, mientras que Virtio GPU es el dispositivo gráfico paravirtualizado más moderno en QEMU.

2. Compruebe los dispositivos de vídeo y pantalla de la máquina virtual en el host KVM.

Apague completamente la máquina virtual antes de modificar su hardware de vídeo virtual. En el Administrador de máquinas virtuales, abra los detalles del hardware de la máquina virtual e inspeccione tanto el dispositivo de visualización como el dispositivo de vídeo. Una configuración SPICE común utiliza una pantalla SPICE junto con vídeo QXL o Virtio.

Libvirt documenta varios tipos de modelos de vídeo compatibles, incluidos qxly virtio. QEMU describe Virtio GPU como un controlador de GPU/pantalla paravirtualizado para invitados Linux y recomienda los dispositivos VirtIO en general cuando no hay necesidad de emular hardware físico específico. Puede consultar la documentación del dispositivo de vídeo de libvirt y la documentación de QEMU VirtIO GPU .

Si la máquina virtual ya utiliza QXL y SPICE, no cambie todo a la vez. Mantenga esa configuración e instale primero el agente invitado de SPICE. Esto le permitirá realizar una prueba limpia: si la resolución dinámica comienza a funcionar, no hay motivo para cambiar la GPU virtual.

Si la máquina virtual utiliza una tarjeta gráfica VGA o Cirrus antigua, generalmente es más apropiado migrar a QXL o Virtio para un escritorio Linux moderno. Si posteriormente elige Virtio, comience sin forzar la aceleración 3D. La documentación de QEMU indica que los modos de GPU Virtio acelerados tienen requisitos adicionales de host, kernel, Mesa y renderizador. Por lo tanto, una configuración básica de GPU Virtio 2D es la opción más segura para la resolución de problemas.

3. Instale el agente invitado SPICE en Pardus.

Cuando la máquina virtual utiliza una pantalla SPICE, la solución más útil y de bajo riesgo es asegurarse de spice-vdagentque esté instalado en el sistema invitado:

sudo apt update
sudo apt install spice-vdagent

Luego, cierre sesión y vuelva a iniciarla, o reinicie la máquina virtual. La descripción del paquete Debian spice-vdagentmenciona específicamente el ajuste automático de la resolución de la sesión X a la resolución del cliente como una de sus funciones. Pardus se basa en Debian, por lo que este paquete está disponible en el ecosistema de paquetes derivados de Debian utilizado por las versiones actuales de Pardus. Debian stable actualmente incluye la spice-vdagentversión 0.22.1-4.1. Consulte la página del paquete spice-vdagent de Debian .

Tras la instalación, compruebe el proceso del demonio y del lado del usuario:

systemctl status spice-vdagentd.service --no-pager
pgrep -a spice-vdagent

Un demonio del sistema en ejecución es útil, pero el componente de sesión de usuario también es importante. La documentación del paquete de Debian señala que el manejo automático de la resolución depende de una sesión gráfica activa que ejecute el proceso del agente.

Si la máquina virtual utiliza QXL bajo X.Org y el controlador de gráficos parece faltar, compruebe si el paquete de controladores QXL X.Org está instalado:

dpkg -l xserver-xorg-video-qxl
sudo apt install xserver-xorg-video-qxl

Esto solo debe hacerse cuando el sistema invitado utilice QXL. El paquete existe específicamente para dispositivos QXL en entornos KVM/QEMU compatibles con SPICE; no es necesario simplemente porque la máquina virtual se ejecute bajo KVM. Debian stable actualmente incluye los paquetes xserver-xorg-video-qxl0.1.6-1.1, documentados en la página del controlador QXL de Debian .

4. Vuelva a probar el redimensionamiento dinámico antes de cambiar la GPU virtual.

Tras volver a iniciar sesión, abre la consola gráfica y cambia el tamaño de su ventana. Si tu visor ofrece la opción de ajustar el tamaño a la ventana o de redimensionamiento automático, activa la opción que redimensiona al invitado en lugar de simplemente estirar la imagen renderizada.

Para X11, vuelva a ejecutar el programa xrandr --current. Si el resultado es correcto, debería mostrar un máximo mayor y modos adicionales, o bien, el modo actual debería cambiar automáticamente al modificar el tamaño de la ventana del visor. También puede abrir la configuración de Pardus Display y comprobar que se pueden seleccionar resoluciones con apariencia nativa mayores.

No juzgue el éxito únicamente por si la ventana de la consola se ve más grande. Un visor puede escalar un framebuffer de 1024x768 para que llene una ventana grande, lo que produce una imagen más grande sin aumentar la resolución del sistema invitado. Los indicadores fiables son el modo que informa el sistema invitado y la cantidad de espacio de trabajo del escritorio realmente disponible.

Si QXL sigue deteniéndose en 1024x768, cambie a vídeo Virtio.

Si el agente SPICE está instalado y activo, pero la máquina virtual solo muestra una resolución de 1024x768, modifique una capa a la vez. Apague la máquina virtual, abra la configuración de hardware de vídeo y cambie el modelo de vídeo de QXL o VGA antiguo a Virtio. Mantenga la configuración de SPICE a menos que tenga un motivo específico para cambiar también el protocolo de visualización remota.

Inicie Pardus y repita las comprobaciones de hardware y modo:

lspci -nnk | grep -A3 -E 'VGA|Display'
lsmod | grep virtio_gpu

En una sesión X11, ejecute también xrandr --current. QEMU indica que la GPU Virtio requiere compatibilidad del kernel de Linux invitado para CONFIG_DRM_VIRTIO_GPU; los kernels de las distribuciones principales normalmente lo proporcionan, pero los kernels personalizados podrían no hacerlo. Si el invitado arranca con una pantalla negra después del cambio, apáguelo desde el host y revierta el modelo de vídeo en lugar de seguir modificando el invitado a ciegas.

Cuándo puede ayudar xrandr y cuándo no es la solución adecuada.

Si xrandrya aparece la resolución que desea, seleccionarla puede ser un paso de diagnóstico útil:

xrandr --output Virtual-1 --mode 1920x1080

Reemplazar Virtual-1con el nombre de salida real que muestra xrandr. Este comando se aplica solo a X11 y solo cuando ese modo ya está disponible para la salida.

Si el modo deseado no está disponible y el tamaño máximo del búfer de fotogramas sigue siendo 1024x768, inyectar manualmente una línea de modelo suele ser un tratamiento para el síntoma, no para la causa. En una máquina virtual KVM, la GPU virtual y la integración de la pantalla deberían anunciar los modos utilizables. Solucione primero ese problema. La documentación de X.Org RandR es la referencia principal para la configuración dinámica de pantallas en X11.

Cómo decidir si la reparación está completa

Comandos útiles para la resolución de problemas

Si el resultado sigue siendo inconsistente, recopile estos comandos antes de realizar otro cambio:

echo "$XDG_SESSION_TYPE"
lspci -nnk | grep -A3 -E 'VGA|Display'
systemctl status spice-vdagentd.service --no-pager
pgrep -a spice-vdagent
journalctl -b -u spice-vdagentd.service --no-pager

En X11, agregue:

xrandr --current

Estas comprobaciones distinguen cuatro clases de fallos diferentes: el host expone el dispositivo de vídeo virtual incorrecto, Pardus carece de la integración de invitado pertinente, el agente está instalado pero no se ejecuta en la sesión gráfica, o la sesión de escritorio utiliza una pila de visualización que no responde al mecanismo de redimensionamiento esperado.

Limitaciones de esta solución

No existe una única opción de QXL o Virtio que sea la mejor para todas las instalaciones de KVM. Las versiones de QEMU/libvirt del host, el cliente de consola, la sesión de escritorio, el kernel y la activación o desactivación de la aceleración 3D influyen en el resultado. Los pasos anteriores comienzan intencionadamente con el cambio menos disruptivo y utilizan la resolución reportada por el usuario como criterio de éxito.

Si se accede a la máquina virtual mediante una ruta de visualización diferente (como VNC estándar, transferencia de GPU, RDP al sistema invitado o una consola en la nube), es posible que no se apliquen los pasos específicos de SPICE. Del mismo modo, un kernel personalizado sin el controlador DRM correspondiente puede requerir la configuración del kernel en lugar de un paquete de escritorio.

El punto de parada práctico se da cuando Pardus expone los modos superiores deseados, el visor puede cambiar el tamaño sin simplemente escalar un framebuffer de 1024x768 y el resultado se mantiene tras un reinicio. Si se cumplen estas condiciones, no son necesarios modelines adicionales, archivos de configuración de X.Org ni cambios en la aceleración 3D.