Risolvere il problema della risoluzione dello schermo bloccata a 1024x768 su una macchina virtuale KVM Pardus.

Perché una macchina virtuale Pardus KVM può rimanere bloccata alla risoluzione 1024x768

Una macchina virtuale Pardus che non offre mai una risoluzione superiore a 1024x768 di solito non soffre di un semplice problema di impostazioni del desktop. La questione importante è se la macchina virtuale guest riceve effettivamente una modalità di visualizzazione virtuale più ampia da KVM/QEMU e se la sessione desktop è in grado di reagire agli eventi di ridimensionamento.

Il risultato desiderato è semplice: dopo aver ridimensionato la finestra del visualizzatore o aver selezionato una modalità più grande, Pardus dovrebbe mostrare risoluzioni come 1366x768, 1600x900 o 1920x1080 invece di indicare 1024x768 come risoluzione massima. L'integrazione con gli appunti e la fluidità del puntatore sono utili indicatori secondari quando si utilizza SPICE, ma la risoluzione è il test principale.

Questa guida si applica principalmente alle macchine virtuali desktop Pardus in esecuzione su KVM/QEMU con libvirt e una console SPICE o grafica. Pardus 25.0 è stato rilasciato a novembre 2025 e il repository di download ufficiale di Pardus elenca anche le immagini di Pardus 25.1 di marzo 2026. I menu del desktop possono differire tra le edizioni XFCE e GNOME, quindi i controlli seguenti utilizzano comandi e impostazioni di virtualizzazione che non dipendono fortemente da una singola shell del desktop. Consultare il repository di download ufficiale di Pardus 25 per le immagini di installazione più recenti.

1. Conferma che 1024x768 sia effettivamente la risoluzione massima supportata dalla macchina virtuale.

Iniziate da Pardus. Aprite un terminale e identificate il tipo di sessione e l'hardware del display virtuale:

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

Se la sessione è X11, eseguire anche:

xrandr --current

Presta attenzione a due cose. Innanzitutto, verifica se la GPU virtuale è QXL, Virtio GPU, un adattatore VGA generico o qualcos'altro. In secondo luogo, controlla l'elenco delle modalità. Se 1920x1080 è già presente nell'elenco, è probabile che lo stack di virtualizzazione supporti una risoluzione maggiore e che il problema sia dovuto a una configurazione del desktop o a un evento di ridimensionamento. Se invece xrandrla risoluzione massima indicata è 1024x768, è improbabile che la semplice modifica della risoluzione del desktop risolva il problema.

In una sessione Wayland, xrandrnon è uno strumento di configurazione autorevole per il compositore, quindi usalo solo come informazione supplementare. Il tipo di sessione è importante perché QXL è stato storicamente associato ai flussi di lavoro X.Org/SPICE, mentre Virtio GPU è il dispositivo grafico paravirtualizzato più moderno in QEMU.

2. Verificare i dispositivi video e di visualizzazione della macchina virtuale sull'host KVM.

Arrestare completamente la macchina virtuale prima di modificarne l'hardware video. In Virtual Machine Manager, aprire i dettagli hardware della VM e controllare sia il dispositivo di visualizzazione che il dispositivo video. Una configurazione SPICE comune utilizza un display SPICE insieme a un dispositivo video QXL o Virtio.

Libvirt documenta diversi tipi di modelli video supportati, tra cui qxle virtio. QEMU descrive VirtIO GPU come un controller GPU/display paravirtualizzato per guest Linux e raccomanda i dispositivi VirtIO in generale quando non è necessario emulare un hardware fisico specifico. È possibile consultare la documentazione del dispositivo video di libvirt e la documentazione di QEMU su VirtIO GPU .

Se la macchina virtuale utilizza già QXL e SPICE, non modificare tutto in una volta. Lascia la configurazione attuale e installa prima l'agente guest SPICE. In questo modo potrai effettuare un test pulito: se la risoluzione dinamica inizia a funzionare, non c'è motivo di cambiare la GPU virtuale.

Se la macchina virtuale utilizza una vecchia scheda video generica VGA o Cirrus, il passaggio a QXL o Virtio è generalmente più appropriato per un desktop Linux moderno. Se in seguito si sceglie Virtio, è consigliabile iniziare senza forzare l'accelerazione 3D. La documentazione di QEMU indica che le modalità GPU Virtio accelerate hanno requisiti aggiuntivi a livello di host, kernel, Mesa e renderer. Pertanto, una configurazione GPU Virtio 2D di base rappresenta la soluzione più sicura per la risoluzione dei problemi.

3. Installa l'agente guest SPICE in Pardus

Quando la VM utilizza un display SPICE, la soluzione più utile e a basso rischio è assicurarsi spice-vdagentche sia installato nel sistema guest:

sudo apt update
sudo apt install spice-vdagent

Quindi disconnettiti e accedi di nuovo, oppure riavvia la macchina virtuale. La descrizione del pacchetto Debian spice-vdagentelenca specificamente la regolazione automatica della risoluzione della sessione X alla risoluzione del client come una delle sue funzioni. Pardus è basato su Debian, quindi questo pacchetto è disponibile nell'ecosistema di pacchetti derivati ​​da Debian utilizzato dalle versioni correnti di Pardus. Debian stable attualmente include la spice-vdagentversione 0.22.1-4.1. Consulta la pagina del pacchetto spice-vdagent di Debian .

Dopo l'installazione, verificare il demone e il processo lato utente:

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

Un demone di sistema in esecuzione è utile, ma anche il componente della sessione utente è importante. La documentazione dei pacchetti Debian indica che la gestione della risoluzione automatica dipende da una sessione grafica attiva che esegue il processo dell'agente.

Se la macchina virtuale utilizza QXL su X.Org e il driver grafico risulta mancante, verificare se il pacchetto driver QXL per X.Org è installato:

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

Eseguire questa operazione solo quando la macchina virtuale utilizza effettivamente QXL. Il pacchetto esiste specificamente per i dispositivi QXL in ambienti KVM/QEMU compatibili con SPICE; non è necessario solo perché la macchina virtuale viene eseguita in ambiente KVM. La versione stabile di Debian attualmente include le versioni xserver-xorg-video-qxl0.1.6-1.1, documentate nella pagina del driver QXL di Debian .

4. Eseguire nuovamente il test del ridimensionamento dinamico prima di modificare la GPU virtuale.

Dopo aver effettuato nuovamente l'accesso, apri la console grafica e ridimensiona la finestra. Se il tuo visualizzatore offre un'opzione di ridimensionamento automatico o di adattamento alla finestra, abilita l'opzione che ridimensiona la finestra del sistema anziché limitarsi ad allungare l'immagine renderizzata.

Per X11, esegui xrandr --currentnuovamente il comando. Un risultato positivo dovrebbe mostrare un valore massimo maggiore e modalità aggiuntive, oppure la modalità corrente dovrebbe cambiare automaticamente quando la finestra del visualizzatore cambia dimensione. Puoi anche aprire le impostazioni di Pardus Display e verificare che siano selezionabili risoluzioni più grandi con aspetto nativo.

Non giudicate il successo basandovi solo sull'aspetto della finestra della console. Un visualizzatore può scalare un framebuffer di 1024x768 per riempire una finestra di grandi dimensioni, ottenendo un'immagine più grande senza aumentare la risoluzione del sistema guest. Gli indicatori affidabili sono la modalità segnalata dal sistema guest e la quantità di spazio di lavoro desktop effettivamente disponibile.

Se QXL si blocca ancora a 1024x768, passa al video Virtio.

Se l'agente SPICE è installato e attivo, ma la macchina virtuale espone ancora solo una risoluzione di 1024x768, procedi con un livello alla volta. Spegni la macchina virtuale, apri le impostazioni dell'hardware video e cambia il modello video da QXL o VGA legacy a Virtio. Mantieni la visualizzazione SPICE a meno che tu non abbia un motivo specifico per cambiare anche il protocollo di visualizzazione remota.

Avvia Pardus e ripeti i controlli hardware e di modalità:

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

In una sessione X11, eseguire anche xrandr --current. QEMU afferma che Virtio GPU richiede il supporto del kernel guest Linux per CONFIG_DRM_VIRTIO_GPU; i kernel delle distribuzioni principali normalmente lo forniscono, ma i kernel personalizzati potrebbero non fornirlo. Se il guest si avvia con una schermata nera dopo la modifica, spegnerlo dall'host e ripristinare il modello video anziché continuare a modificare il guest alla cieca.

Quando xrandr può essere d'aiuto e quando invece non è la soluzione giusta.

Se xrandrla risoluzione desiderata è già presente nell'elenco, selezionarla può essere un utile passaggio diagnostico:

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

Sostituire Virtual-1con il nome di output effettivo mostrato da xrandr. Questo comando si applica solo a X11 e solo quando tale modalità è già disponibile per l'output.

Se la modalità desiderata non è presente e la dimensione massima del framebuffer è ancora 1024x768, l'iniezione manuale di una modeline di solito risolve il sintomo anziché la causa. In una macchina virtuale KVM, l'integrazione tra GPU virtuale e display dovrebbe normalmente pubblicizzare le modalità utilizzabili. Correggi prima quel percorso. La documentazione X.Org RandR è il riferimento principale per la configurazione dinamica del display X11.

Come stabilire se la riparazione è completa

Comandi utili per la risoluzione dei problemi

Se il risultato è ancora incoerente, raccogli questi comandi prima di apportare un'altra modifica:

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

Su X11, aggiungere:

xrandr --current

Questi controlli distinguono quattro diverse classi di errore: l'host espone il dispositivo video virtuale errato, Pardus non dispone dell'integrazione guest necessaria, l'agente è installato ma non in esecuzione nella sessione grafica oppure la sessione desktop utilizza uno stack di visualizzazione che non risponde al meccanismo di ridimensionamento previsto.

Limiti di questa correzione

Non esiste una singola scelta tra QXL e Virtio che sia la migliore per ogni installazione KVM. Le versioni di QEMU/libvirt sull'host, il client della console, la sessione desktop, il kernel e l'eventuale attivazione dell'accelerazione 3D influiscono sul risultato. I passaggi sopra descritti iniziano intenzionalmente con la modifica meno invasiva e utilizzano la risoluzione riportata dalla macchina virtuale come criterio di successo.

Se si accede alla macchina virtuale tramite un percorso di visualizzazione diverso, come VNC standard, passthrough GPU, RDP verso la macchina virtuale o una console cloud, i passaggi specifici di SPICE potrebbero non essere applicabili. Allo stesso modo, un kernel personalizzato senza il driver DRM pertinente potrebbe richiedere la configurazione del kernel anziché un pacchetto desktop.

Il punto di arresto pratico si verifica quando Pardus espone le modalità superiori desiderate, il visualizzatore può ridimensionare l'immagine senza dover semplicemente scalare un framebuffer 1024x768 e il risultato persiste dopo un riavvio. Se queste condizioni sono soddisfatte, non sono necessari ulteriori modelli, file di configurazione X.Org o modifiche all'accelerazione 3D.