Corrigir problema de resolução de tela travada em 1024x768 em uma máquina virtual Pardus KVM

Por que uma máquina virtual Pardus KVM pode ficar travada em 1024x768?

Uma máquina virtual Pardus que nunca oferece nada acima de 1024x768 geralmente não sofre de um problema simples de configuração da área de trabalho. A questão importante é se o sistema convidado realmente recebe um modo de exibição virtual maior do KVM/QEMU e se a sessão da área de trabalho consegue reagir a eventos de redimensionamento.

O resultado desejado é simples: após redimensionar a janela do visualizador ou selecionar um modo maior, o Pardus deve exibir resoluções como 1366x768, 1600x900 ou 1920x1080, em vez de reportar 1024x768 como seu limite máximo. A integração da área de transferência e o comportamento suave do ponteiro são indicadores secundários úteis quando o SPICE está envolvido, mas a resolução é o teste principal.

Este guia aplica-se mais diretamente a máquinas virtuais Pardus executadas em KVM/QEMU com libvirt e um console SPICE ou gráfico. O Pardus 25.0 foi lançado em novembro de 2025, e o repositório oficial de downloads do Pardus também lista imagens do Pardus 25.1 de março de 2026. Os menus da área de trabalho podem variar entre as edições XFCE e GNOME, portanto, as verificações abaixo utilizam comandos e configurações de virtualização que não dependem fortemente de um único ambiente gráfico. Consulte o repositório oficial de downloads do Pardus 25 para obter as imagens de instalação atuais.

1. Confirme se 1024x768 é realmente a resolução máxima do sistema convidado.

Comece dentro do Pardus. Abra um terminal e identifique o tipo de sessão e o hardware de exibição virtual:

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

Se a sessão for X11, execute também:

xrandr --current

Preste atenção a dois detalhes. Primeiro, observe se a GPU virtual é QXL, Virtio GPU, um adaptador VGA genérico ou algo diferente. Segundo, verifique a lista de modos. Se 1920x1080 já estiver listado, a pilha de virtualização provavelmente é compatível com a resolução maior e o problema provavelmente está relacionado à configuração da área de trabalho ou a um evento de redimensionamento. Se xrandro modo de resolução máximo indicado for 1024x768, alterar a resolução da área de trabalho por si só provavelmente não resolverá o problema.

Em uma sessão Wayland, xrandrnão é uma ferramenta de configuração definitiva para o compositor, portanto, use-a apenas como informação complementar. O tipo de sessão é importante porque o QXL tem sido historicamente associado a fluxos de trabalho X.Org/SPICE, enquanto a GPU Virtio é o dispositivo gráfico paravirtualizado mais moderno no QEMU.

2. Verifique os dispositivos de vídeo e exibição da máquina virtual no host KVM.

Desligue completamente a máquina virtual antes de alterar seu hardware de vídeo virtual. No Gerenciador de Máquinas Virtuais, abra os detalhes de hardware da máquina virtual e verifique o dispositivo de exibição e o dispositivo de vídeo. Uma configuração SPICE comum utiliza um monitor SPICE juntamente com vídeo QXL ou Virtio.

A documentação do Libvirt suporta diversos tipos de modelos de vídeo, incluindo `v1` qxle `v2` virtio. O QEMU descreve a GPU VirtIO como um controlador de GPU/exibição paravirtualizado para sistemas operacionais Linux convidados e recomenda dispositivos VirtIO em geral quando não há necessidade de emular hardware físico específico. Você pode consultar a documentação de dispositivos de vídeo do Libvirt e a documentação da GPU VirtIO do QEMU .

Se a máquina virtual já utiliza QXL e SPICE, não altere tudo de uma vez. Mantenha essa configuração e instale primeiro o agente convidado do SPICE. Isso permite um teste limpo: se a resolução dinâmica começar a funcionar, não há necessidade de alterar a GPU virtual.

Se a máquina virtual estiver usando um modelo VGA genérico antigo ou Cirrus, migrar para QXL ou Virtio geralmente é mais apropriado para um desktop Linux moderno. Se você optar por Virtio posteriormente, comece sem forçar a aceleração 3D. A documentação do QEMU observa que os modos de GPU Virtio acelerados têm requisitos adicionais de host, kernel, Mesa e renderizador. Portanto, uma configuração básica de GPU Virtio 2D é a base de solução de problemas mais segura.

3. Instale o agente convidado SPICE no Pardus.

Quando a máquina virtual usa um monitor SPICE, a solução de baixo risco mais útil é garantir que o SPICE spice-vdagentesteja instalado no sistema convidado:

sudo apt update
sudo apt install spice-vdagent

Em seguida, faça logout e login novamente ou reinicie o sistema convidado. A descrição do pacote Debian spice-vdagentlista especificamente o ajuste automático da resolução da sessão X para a resolução do cliente como uma de suas funções. O Pardus é baseado em Debian, portanto, este pacote está disponível no ecossistema de pacotes derivados do Debian usado pelas versões atuais do Pardus. O Debian estável atualmente inclui a versão spice-vdagent0.22.1-4.1. Consulte a página do pacote spice-vdagent no Debian .

Após a instalação, verifique o daemon e o processo do lado do usuário:

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

Um daemon do sistema em execução é útil, mas o componente de sessão do usuário também é importante. A documentação do pacote Debian observa que o tratamento de resolução automática depende de uma sessão gráfica ativa executando o processo do agente.

Se a máquina virtual usa QXL sob X.Org e o driver gráfico parece estar faltando, verifique se o pacote de drivers X.Org para QXL está instalado:

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

Faça isso somente quando o sistema convidado realmente usar QXL. O pacote existe especificamente para dispositivos QXL em ambientes KVM/QEMU compatíveis com SPICE; ele não é necessário apenas porque a máquina virtual está sendo executada em KVM. O Debian estável atualmente inclui os pacotes xserver-xorg-video-qxl0.1.6 a 1.1, documentados na página do driver QXL do Debian .

4. Teste novamente o redimensionamento dinâmico antes de alterar a GPU virtual.

Após fazer login novamente, abra o console gráfico e redimensione a janela. Se o seu visualizador oferecer uma opção de redimensionamento automático ou de ajuste à janela, habilite a opção que redimensiona a janela do sistema operacional convidado em vez de simplesmente esticar a imagem renderizada.

Para o X11, execute xrandr --currentnovamente. Um resultado bem-sucedido deve mostrar um valor máximo maior e modos adicionais, ou o modo atual deve mudar automaticamente quando a janela do visualizador mudar de tamanho. Você também pode abrir as configurações de exibição do Pardus e verificar se resoluções maiores com aparência nativa estão disponíveis para seleção.

Não julgue o sucesso apenas pelo tamanho da janela do console. Um visualizador pode redimensionar um framebuffer de 1024x768 para preencher uma janela grande, o que produz uma imagem maior sem aumentar a resolução do sistema convidado. Os indicadores confiáveis ​​são o modo relatado pelo sistema convidado e a quantidade de espaço de trabalho da área de trabalho realmente disponível.

Se o QXL ainda parar em 1024x768, mude para vídeo Virtio.

Se o agente SPICE estiver instalado e ativo, mas a máquina virtual ainda exibir apenas 1024x768, altere uma camada por vez. Desligue a máquina virtual, abra as configurações de hardware de vídeo e altere o modelo de vídeo de QXL ou VGA legado para Virtio. Mantenha a tela SPICE, a menos que você tenha um motivo específico para alterar também o protocolo de exibição remota.

Inicialize o Pardus e repita as verificações de hardware e modo:

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

Em uma sessão X11, execute também o comando xrandr --current. O QEMU afirma que a GPU Virtio requer suporte do kernel Linux para o modelo de vídeo CONFIG_DRM_VIRTIO_GPU; kernels de distribuições convencionais geralmente fornecem esse suporte, mas kernels personalizados podem não fornecer. Se o sistema convidado inicializar com uma tela preta após a alteração, desligue-o do host e reverta o modelo de vídeo em vez de continuar modificando o sistema convidado sem antes verificar as configurações.

Quando o xrandr pode ajudar — e quando é a solução errada.

Se xrandra resolução desejada já estiver listada, selecioná-la pode ser uma etapa diagnóstica útil:

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

Substitua Virtual-1pelo nome de saída real exibido por xrandr. Este comando se aplica somente ao X11 e somente quando esse modo já estiver disponível para a saída.

Se o modo desejado estiver ausente e o tamanho máximo do framebuffer ainda for 1024x768, injetar manualmente uma modeline geralmente trata o sintoma em vez da causa. Em um sistema operacional convidado KVM, a GPU virtual e a integração com o monitor normalmente devem anunciar modos utilizáveis. Corrija esse caminho primeiro. A documentação do X.Org RandR é a principal referência para configuração dinâmica de monitores X11.

Como determinar se o reparo está completo

Comandos úteis para resolução de problemas

Se o resultado ainda for inconsistente, colete esses comandos antes de fazer outra alteração:

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

No X11, adicione:

xrandr --current

Essas verificações separam quatro classes de falhas diferentes: o host expõe o dispositivo de vídeo virtual errado, o Pardus não possui a integração relevante com o sistema operacional convidado, o agente está instalado, mas não está em execução na sessão gráfica, ou a sessão da área de trabalho está usando uma pilha de exibição que não responde ao mecanismo de redimensionamento esperado.

Limitações desta correção

Não existe uma única opção entre QXL e Virtio que seja a melhor para todas as instalações KVM. As versões do QEMU/libvirt do host, o cliente de console, a sessão de desktop, o kernel e se a aceleração 3D está habilitada, tudo isso afeta o resultado. Os passos acima começam intencionalmente com a alteração menos disruptiva e usam a resolução relatada pelo sistema convidado como critério de sucesso.

Se a máquina virtual for acessada por meio de um caminho de exibição diferente — como VNC simples, passagem direta de GPU, RDP para o sistema convidado ou um console na nuvem — as etapas específicas do SPICE podem não se aplicar. Da mesma forma, um kernel personalizado sem o driver DRM relevante pode exigir configuração do kernel em vez de um pacote de desktop.

O ponto de parada prático ocorre quando o Pardus expõe os modos superiores desejados, o visualizador pode redimensionar a tela sem simplesmente redimensionar um framebuffer de 1024x768 e o resultado se mantém após uma reinicialização. Se essas condições forem atendidas, modelines adicionais, arquivos de configuração do X.Org ou alterações na aceleração 3D tornam-se desnecessários.