Behebung des Problems, dass die Bildschirmauflösung auf 1024x768 auf einem Pardus KVM-Gastsystem fixiert ist.

Warum ein Pardus-KVM-Gast bei 1024x768 hängen bleiben kann

Eine Pardus-VM, die nie eine höhere Auflösung als 1024x768 bietet, leidet in der Regel nicht an einem einfachen Problem mit den Desktop-Einstellungen. Entscheidend ist, ob der Gast von KVM/QEMU tatsächlich einen höheren virtuellen Anzeigemodus erhält und ob die Desktop-Sitzung auf Größenänderungen reagieren kann.

Das gewünschte Ergebnis ist klar: Nach dem Ändern der Größe des Anzeigefensters oder der Auswahl eines größeren Modus sollte Pardus Auflösungen wie 1366x768, 1600x900 oder 1920x1080 anzeigen, anstatt 1024x768 als maximale Auflösung anzugeben. Die Integration der Zwischenablage und ein flüssiges Mauszeigerverhalten sind bei SPICE nützliche sekundäre Indikatoren, die Auflösung ist jedoch der primäre Test.

Diese Anleitung gilt insbesondere für Pardus-Desktop-Gastsysteme, die unter KVM/QEMU mit libvirt und einer SPICE- oder grafischen Konsole laufen. Pardus 25.0 wurde im November 2025 veröffentlicht, und im offiziellen Pardus-Download-Repository sind auch Pardus-25.1-Images ab März 2026 verfügbar. Da sich die Desktop-Menüs zwischen den XFCE- und GNOME-Editionen unterscheiden können, verwenden die folgenden Prüfungen Befehle und Virtualisierungseinstellungen, die nicht stark von einer bestimmten Desktop-Shell abhängen. Aktuelle Installations-Images finden Sie im offiziellen Pardus-25-Download-Repository .

1. Bestätigen Sie, dass 1024x768 tatsächlich die maximale Bildschirmauflösung des Gastes ist.

Beginnen Sie in Pardus. Öffnen Sie ein Terminal und ermitteln Sie den Sitzungstyp und die virtuelle Anzeigehardware:

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

Wenn es sich um eine X11-Sitzung handelt, führen Sie außerdem Folgendes aus:

xrandr --current

Beachten Sie zwei Dinge. Erstens: Prüfen Sie, ob die virtuelle GPU eine QXL, eine Virtio-GPU, ein generischer VGA-Adapter oder etwas anderes ist. Zweitens: Überprüfen Sie die Modusliste. Ist 1920x1080 bereits aufgeführt, unterstützt der Virtualisierungsstack wahrscheinlich die höhere Auflösung, und das Problem liegt eher an der Desktop-Konfiguration oder einer Größenänderung. Wird hingegen xrandr1024x768 als maximale Auflösung angegeben, hilft eine Änderung der Desktop-Auflösung im Dialogfeld wahrscheinlich nicht.

In einer Wayland-Sitzung xrandrist dies kein maßgebliches Konfigurationstool für den Compositor; verwenden Sie es daher nur als ergänzende Information. Der Sitzungstyp ist relevant, da QXL traditionell mit X.Org/SPICE-Workflows assoziiert wird, während Virtio GPU das modernere paravirtualisierte Grafikgerät in QEMU ist.

2. Überprüfen Sie die Video- und Anzeigegeräte der VM auf dem KVM-Host.

Fahren Sie den Gast vollständig herunter, bevor Sie die virtuelle Videohardware ändern. Öffnen Sie im Virtual Machine Manager die Hardwaredetails der VM und überprüfen Sie sowohl das Anzeigegerät als auch das Videogerät. Eine gängige SPICE-Konfiguration verwendet ein SPICE-Display zusammen mit QXL- oder Virtio-Video.

Libvirt dokumentiert verschiedene unterstützte Videomodelltypen, darunter VirtIO qxlund virtioQEMU. QEMU beschreibt VirtIO GPU als paravirtualisierten GPU-/Display-Controller für Linux-Gastsysteme und empfiehlt VirtIO-Geräte generell, wenn keine bestimmte physische Hardware emuliert werden muss. Sie können die Libvirt-Videogerätedokumentation und die QEMU-VirtIO-GPU-Dokumentation einsehen .

Wenn die VM bereits QXL und SPICE verwendet, sollten Sie nicht alles auf einmal ändern. Belassen Sie die bestehende Konfiguration und installieren Sie zuerst den SPICE-Gastagenten. So erhalten Sie einen sauberen Test: Funktioniert die dynamische Auflösung anschließend, besteht kein Grund, die virtuelle GPU zu ändern.

Wenn die VM eine ältere, generische VGA- oder Cirrus-Grafikkarte verwendet, ist der Wechsel zu QXL oder Virtio für einen modernen Linux-Desktop in der Regel sinnvoller. Sollten Sie sich später für Virtio entscheiden, beginnen Sie ohne erzwungene 3D-Beschleunigung. Die QEMU-Dokumentation weist darauf hin, dass beschleunigte Virtio-GPU-Modi zusätzliche Anforderungen an Host, Kernel, Mesa und Renderer stellen. Eine einfache 2D-Virtio-GPU-Konfiguration ist daher die sicherere Ausgangsbasis für die Fehlersuche.

3. Installieren Sie den SPICE-Gastagenten in Pardus

Wenn die VM eine SPICE-Anzeige verwendet, besteht die sinnvollste und risikoärmste Lösung darin, sicherzustellen, spice-vdagentdass SPICE im Gastsystem installiert ist:

sudo apt update
sudo apt install spice-vdagent

Melden Sie sich anschließend ab und wieder an oder starten Sie den Gast neu. Die Debian-Paketbeschreibung spice-vdagentführt die automatische Anpassung der X-Sitzungsauflösung an die Clientauflösung als eine der Funktionen auf. Da Pardus auf Debian basiert, ist dieses Paket im Debian-basierten Paketökosystem verfügbar, das von aktuellen Pardus-Versionen verwendet wird. Debian Stable enthält derzeit Version spice-vdagent0.22.1-4.1. Weitere Informationen finden Sie auf der Debian-Paketseite für spice-vdagent .

Überprüfen Sie nach der Installation den Daemon und den benutzerseitigen Prozess:

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

Ein laufender Systemdienst ist zwar nützlich, aber auch die Benutzersitzung spielt eine Rolle. Die Paketdokumentation von Debian weist darauf hin, dass die automatische Auflösung von einer aktiven grafischen Sitzung abhängt, in der der Agentenprozess ausgeführt wird.

Wenn die VM QXL unter X.Org verwendet und der Grafiktreiber zu fehlen scheint, überprüfen Sie, ob das QXL X.Org-Treiberpaket installiert ist:

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

Führen Sie diese Schritte nur aus, wenn der Gast tatsächlich QXL verwendet. Das Paket ist speziell für QXL-Geräte in SPICE-kompatiblen KVM/QEMU-Umgebungen vorgesehen; es wird nicht benötigt, nur weil die VM zufällig unter KVM läuft. Debian Stable enthält derzeit die Versionen xserver-xorg-video-qxl0.1.6 bis 1.1, die auf der Debian-QXL-Treiberseite dokumentiert sind .

4. Testen Sie die dynamische Größenänderung erneut, bevor Sie die virtuelle GPU ändern.

Nach dem erneuten Anmelden öffnen Sie die grafische Konsole und passen deren Fenstergröße an. Falls Ihr Viewer eine Option zum Skalieren auf Fenstergröße oder zur automatischen Größenanpassung bietet, aktivieren Sie die Option, die die Größe des Gastsystems ändert, anstatt das gerenderte Bild lediglich zu strecken.

Führen Sie den Vorgang für X11 xrandr --currenterneut aus. Im Erfolgsfall sollten ein höherer Maximalwert und zusätzliche Modi angezeigt werden, oder der aktuelle Modus sollte sich automatisch ändern, wenn sich die Größe des Anzeigefensters ändert. Sie können auch die Pardus-Anzeigeeinstellungen öffnen und überprüfen, ob höhere, nativ wirkende Auflösungen auswählbar sind.

Beurteilen Sie den Erfolg nicht allein anhand der Größe des Konsolenfensters. Ein Viewer kann einen 1024x768-Framebuffer skalieren, um ein größeres Fenster auszufüllen, wodurch ein größeres Bild entsteht, ohne die Auflösung des Gastsystems zu erhöhen. Zuverlässige Indikatoren sind der vom Gastsystem gemeldete Modus und die tatsächlich verfügbare Desktop-Arbeitsfläche.

Falls QXL weiterhin bei 1024x768 stoppt, wechseln Sie zu Virtio Video.

Wenn der SPICE-Agent installiert und aktiv ist, die virtuelle Maschine aber weiterhin nur eine Auflösung von 1024x768 anzeigt, gehen Sie schrittweise vor. Schalten Sie die virtuelle Maschine aus, öffnen Sie die Grafikeinstellungen und stellen Sie das Grafikmodell von QXL oder dem älteren VGA-Standard auf Virtio um. Behalten Sie die SPICE-Anzeige bei, es sei denn, Sie haben einen triftigen Grund, auch das Remote-Anzeigeprotokoll zu ändern.

Starten Sie Pardus neu und wiederholen Sie die Hardware- und Modusprüfungen:

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

Führen Sie in einer X11-Sitzung außerdem den Befehl aus xrandr --current. QEMU gibt an, dass die Virtio-GPU Unterstützung für den Linux-Gastkernel benötigt CONFIG_DRM_VIRTIO_GPU; gängige Distributionskernel bieten dies normalerweise, benutzerdefinierte Kernel jedoch möglicherweise nicht. Falls der Gast nach der Änderung einen schwarzen Bildschirm anzeigt, schalten Sie ihn vom Host aus und setzen Sie das Videomodell zurück, anstatt den Gast ohne weitere Änderungen zu konfigurieren.

Wann xrandr helfen kann – und wann es die falsche Lösung ist.

Wenn xrandrdie gewünschte Auflösung bereits aufgeführt ist, kann deren Auswahl ein hilfreicher Diagnoseschritt sein:

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

Ersetzen Sie dies Virtual-1durch den tatsächlichen Ausgabenamen, der durch angezeigt wird xrandr. Dieser Befehl gilt nur für X11 und nur dann, wenn dieser Modus bereits für die Ausgabe verfügbar ist.

Wenn der gewünschte Modus fehlt und die maximale Framebuffer-Größe weiterhin 1024x768 beträgt, behebt das manuelle Einfügen einer Modeline meist nur das Symptom, nicht die Ursache. In einem KVM-Gastsystem sollten die virtuelle GPU und die Display-Integration normalerweise nutzbare Modi bereitstellen. Korrigieren Sie diesen Fehler zuerst. Die X.Org RandR-Dokumentation ist die wichtigste Referenz für die dynamische Display-Konfiguration unter X11.

Wie man feststellt, ob die Reparatur abgeschlossen ist

Nützliche Befehle zur Fehlerbehebung

Sollte das Ergebnis weiterhin inkonsistent sein, sammeln Sie diese Befehle, bevor Sie eine weitere Änderung vornehmen:

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

Auf X11 hinzufügen:

xrandr --current

Diese Prüfungen unterscheiden vier verschiedene Fehlerklassen: Der Host stellt das falsche virtuelle Videogerät bereit, Pardus verfügt nicht über die erforderliche Gastintegration, der Agent ist zwar installiert, läuft aber nicht in der grafischen Sitzung, oder die Desktop-Sitzung verwendet einen Anzeigestapel, der nicht auf den erwarteten Größenänderungsmechanismus reagiert.

Grenzen dieser Lösung

Es gibt keine allgemeingültige QXL- oder Virtio-Lösung, die für jede KVM-Installation optimal ist. Die QEMU-/libvirt-Versionen des Hostsystems, der Konsolenclient, die Desktop-Sitzung, der Kernel und die Aktivierung der 3D-Beschleunigung beeinflussen das Ergebnis. Die oben beschriebenen Schritte beginnen bewusst mit der am wenigsten einschneidenden Änderung und verwenden die vom Gastsystem gemeldete Auflösung als Erfolgskriterium.

Wird auf die VM über einen anderen Anzeigepfad zugegriffen – beispielsweise über VNC, GPU-Passthrough, RDP-Zugriff auf das Gastsystem oder eine Cloud-Konsole –, sind die SPICE-spezifischen Schritte möglicherweise nicht anwendbar. Ebenso kann ein benutzerdefinierter Kernel ohne den entsprechenden DRM-Treiber eine Kernelkonfiguration anstelle eines Desktop-Pakets erfordern.

Der praktische Endpunkt ist erreicht, wenn Pardus die gewünschten höheren Modi bereitstellt, der Viewer die Größe ändern kann, ohne lediglich einen 1024x768-Framebuffer zu skalieren, und das Ergebnis einen Neustart übersteht. Sind diese Bedingungen erfüllt, sind zusätzliche Modelines, X.Org-Konfigurationsdateien oder Änderungen an der 3D-Beschleunigung nicht erforderlich.