Naprawa rozdzielczości wyświetlania zablokowanej na 1024x768 na komputerze gościnnym Pardus KVM

Dlaczego gość Pardus KVM może utknąć na rozdzielczości 1024x768

Maszyna wirtualna Pardus, która nigdy nie oferuje rozdzielczości powyżej 1024x768, zazwyczaj nie ma problemu z prostymi ustawieniami pulpitu. Ważne pytanie brzmi, czy gość rzeczywiście otrzymuje większy tryb wyświetlania wirtualnego z KVM/QEMU i czy sesja pulpitu może reagować na zdarzenia zmiany rozmiaru.

Pożądany rezultat jest prosty: po zmianie rozmiaru okna przeglądarki lub wybraniu większego trybu, Pardus powinien udostępniać rozdzielczości takie jak 1366x768, 1600x900 lub 1920x1080 zamiast zgłaszać 1024x768 jako sztywno maksymalną rozdzielczość. Integracja ze schowkiem i płynne działanie wskaźnika to przydatne znaki pomocnicze w przypadku korzystania z SPICE, ale rozdzielczość jest głównym testem.

Niniejszy przewodnik dotyczy przede wszystkim gości pulpitu Pardus działających w środowisku KVM/QEMU z biblioteką libvirt i konsolą SPICE lub graficzną. Pardus 25.0 został wydany w listopadzie 2025 roku, a oficjalne repozytorium pobierania Pardus zawiera również obrazy Pardus 25.1 z marca 2026 roku. Dokładne menu pulpitu mogą się różnić w zależności od edycji XFCE i GNOME, dlatego poniższe testy wykorzystują polecenia i ustawienia wirtualizacji, które nie są w dużym stopniu zależne od jednej powłoki pulpitu. Aktualne obrazy instalacyjne można znaleźć w oficjalnym repozytorium pobierania Pardus 25 .

1. Sprawdź, czy 1024x768 to rzeczywiście maksymalny tryb gościa

Zacznij w Pardusie. Otwórz terminal i zidentyfikuj typ sesji oraz sprzęt wirtualnego wyświetlacza:

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

Jeżeli sesja to X11, uruchom także:

xrandr --current

Zwróć uwagę na dwie rzeczy. Po pierwsze, sprawdź, czy wirtualnym GPU jest QXL, Virtio GPU, generyczny adapter VGA, czy coś innego. Po drugie, sprawdź listę trybów. Jeśli 1920x1080 jest już wymienione, stos wirtualizacji prawdopodobnie obsługuje większą rozdzielczość, a problem jest najprawdopodobniej związany z konfiguracją pulpitu lub zmianą rozmiaru. Jeśli xrandrmaksymalna rozdzielczość to 1024x768, sama zmiana rozdzielczości pulpitu raczej nie pomoże.

W sesji Wayland xrandrnie jest to autorytatywne narzędzie konfiguracyjne dla kompozytora, dlatego należy go używać jedynie jako informacji uzupełniającej. Typ sesji ma znaczenie, ponieważ QXL historycznie był kojarzony z przepływami pracy X.Org/SPICE, podczas gdy Virtio GPU to nowocześniejsze, parawirtualizowane urządzenie graficzne w QEMU.

2. Sprawdź urządzenia wideo i wyświetlające maszyny wirtualnej na hoście KVM

Przed zmianą wirtualnego sprzętu wideo całkowicie wyłącz gościa. W Menedżerze maszyn wirtualnych otwórz szczegóły sprzętu maszyny wirtualnej i sprawdź zarówno urządzenie wyświetlające, jak i urządzenie wideo. Typowa konfiguracja SPICE wykorzystuje wyświetlacz SPICE wraz z wideo QXL lub Virtio.

Libvirt dokumentuje kilka obsługiwanych typów modeli wideo, w tym qxli virtio. QEMU opisuje Virtio GPU jako parawirtualizowany kontroler GPU/wyświetlacza dla gości Linuksa i zaleca urządzenia VirtIO, gdy nie ma potrzeby emulowania konkretnego sprzętu fizycznego. Można zapoznać się z dokumentacją urządzeń wideo libvirt oraz dokumentacją QEMU VirtIO GPU .

Jeśli maszyna wirtualna korzysta już z QXL i SPICE, nie zmieniaj wszystkiego naraz. Pozostaw tę konfigurację i najpierw zainstaluj agenta gościa SPICE. To zapewni czysty test: jeśli dynamiczna rozdzielczość zacznie działać, nie ma powodu, aby zmieniać wirtualny procesor graficzny.

Jeśli maszyna wirtualna korzysta ze starego, uniwersalnego modelu VGA lub Cirrus, przejście na QXL lub Virtio jest zazwyczaj bardziej odpowiednie dla nowoczesnego pulpitu Linux. Jeśli później wybierzesz Virtio, zacznij od wymuszenia akceleracji 3D. Dokumentacja QEMU wskazuje, że akcelerowane tryby GPU Virtio mają dodatkowe wymagania dotyczące hosta, jądra, Mesa i renderera. Podstawowa konfiguracja 2D GPU Virtio jest zatem bezpieczniejszą bazą do rozwiązywania problemów.

3. Zainstaluj agenta gościa SPICE w Pardusie

Gdy maszyna wirtualna korzysta z wyświetlacza SPICE, najskuteczniejszym rozwiązaniem o niskim ryzyku jest upewnienie się, że spice-vdagentjest on zainstalowany na komputerze gościa:

sudo apt update
sudo apt install spice-vdagent

Następnie wyloguj się i zaloguj ponownie lub zrestartuj gościa. Opis pakietu Debiana spice-vdagentzawiera automatyczne dostosowywanie rozdzielczości sesji X do rozdzielczości klienta jako jedną z funkcji. Pardus jest oparty na Debianie, więc ten pakiet jest dostępny w ekosystemie pakietów pochodnych Debiana, używanym w obecnych wydaniach Pardusa. Wersja stabilna Debiana zawiera obecnie wersje spice-vdagent0.22.1-4.1. Zobacz stronę pakietu Debian spice-vdagent .

Po instalacji sprawdź demona i proces po stronie użytkownika:

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

Działający demon systemowy jest przydatny, ale istotny jest również komponent sesji użytkownika. Dokumentacja pakietu Debiana wskazuje, że automatyczna obsługa rozwiązywania problemów zależy od aktywnej sesji graficznej, na której uruchomiony jest proces agenta.

Jeśli maszyna wirtualna używa QXL w środowisku X.Org i brakuje sterownika graficznego, sprawdź, czy zainstalowano pakiet sterowników QXL X.Org:

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

Należy to zrobić tylko wtedy, gdy gość faktycznie korzysta z QXL. Pakiet istnieje specjalnie dla urządzeń QXL w środowiskach KVM/QEMU zgodnych ze SPICE; nie jest potrzebny tylko dlatego, że maszyna wirtualna działa pod kontrolą KVM. Stabilne pakiety Debiana są obecnie w xserver-xorg-video-qxlwersji 0.1.6-1.1, udokumentowane na stronie sterownika Debian QXL .

4. Przed zmianą wirtualnego procesora GPU przetestuj ponownie dynamiczną zmianę rozmiaru

Po ponownym zalogowaniu otwórz konsolę graficzną i zmień rozmiar jej okna. Jeśli przeglądarka oferuje opcję skalowania do okna lub automatycznej zmiany rozmiaru, włącz opcję, która zmienia rozmiar gościa, a nie tylko rozciąga renderowany obraz.

W przypadku X11 uruchom xrandr --currentponownie. Pomyślny wynik powinien pokazać większy maksymalny i dodatkowy tryb, lub bieżący tryb powinien zmienić się automatycznie wraz ze zmianą rozmiaru okna przeglądarki. Możesz również otworzyć ustawienia wyświetlania Pardus i sprawdzić, czy można wybrać większe, natywne rozdzielczości.

Nie oceniaj sukcesu wyłącznie na podstawie tego, czy okno konsoli wydaje się większe. Użytkownik może skalować bufor ramki 1024x768, aby wypełnić nim duże okno, co daje większy obraz bez zwiększania rozdzielczości gościa. Wiarygodnymi wskaźnikami są tryb zgłaszany przez gościa oraz ilość faktycznie dostępnej przestrzeni roboczej na pulpicie.

Jeśli QXL nadal zatrzymuje się na 1024x768, przełącz się na wideo Virtio

Jeśli agent SPICE jest zainstalowany i aktywny, ale gość nadal wyświetla tylko 1024x768, zmieniaj warstwy pojedynczo. Wyłącz maszynę wirtualną, otwórz ustawienia sprzętu wideo i zmień model wideo z QXL lub starszej wersji VGA na Virtio. Zachowaj wyświetlacz SPICE, chyba że masz konkretny powód, aby zmienić również protokół zdalnego wyświetlania.

Uruchom Pardusa i powtórz sprawdzanie sprzętu i trybu:

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

W sesji X11 uruchom również xrandr --current. QEMU stwierdza, że ​​Virtio GPU wymaga obsługi jądra gościa Linuksa CONFIG_DRM_VIRTIO_GPU; jądra głównych dystrybucji zazwyczaj ją zapewniają, ale jądra niestandardowe mogą nie. Jeśli po zmianie komputer gościa uruchomi się do czarnego ekranu, wyłącz go z hosta i przywróć model wideo, zamiast kontynuować bezmyślną modyfikację komputera gościa.

Kiedy xrandr może pomóc — a kiedy jest to złe rozwiązanie

Jeśli xrandrna liście znajduje się już interesująca Cię rozdzielczość, jej wybranie może okazać się przydatnym krokiem diagnostycznym:

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

Zastąp Virtual-1rzeczywistą nazwą wyjściową wyświetlaną przez xrandr. To polecenie działa tylko w systemie X11 i tylko wtedy, gdy ten tryb jest już dostępny dla wyjścia.

Jeśli żądany tryb jest nieobecny, a maksymalny rozmiar bufora ramki nadal wynosi 1024x768, ręczne wstrzyknięcie modelu zazwyczaj leczy objaw, a nie przyczynę. W gościu KVM integracja wirtualnego procesora graficznego i wyświetlacza powinna zazwyczaj ogłaszać użyteczne tryby. Najpierw należy naprawić tę ścieżkę. Dokumentacja X.Org RandR stanowi podstawowe źródło informacji na temat konfiguracji dynamicznego wyświetlacza X11.

Jak stwierdzić, czy naprawa została zakończona

Przydatne polecenia dotyczące rozwiązywania problemów

Jeśli wynik nadal jest niespójny, przed wprowadzeniem kolejnej zmiany zbierz poniższe polecenia:

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

Na X11 dodaj:

xrandr --current

Te kontrole rozróżniają cztery różne klasy błędów: host ujawnia niewłaściwe wirtualne urządzenie wideo, Pardus nie ma odpowiedniej integracji z gościem, agent jest zainstalowany, ale nie jest uruchomiony w sesji graficznej lub sesja pulpitu używa stosu wyświetlania, który nie reaguje na oczekiwany mechanizm zmiany rozmiaru.

Ograniczenia tej poprawki

Nie ma jednego rozwiązania, które byłoby najlepsze dla każdej instalacji KVM – QXL czy Virtio. Na wynik wpływają wersje QEMU/libvirt hosta, klient konsoli, sesja pulpitu, jądro oraz włączona akceleracja 3D. Powyższe kroki celowo rozpoczynają się od najmniej uciążliwej zmiany i wykorzystują rozdzielczość zgłaszaną przez gościa jako kryterium sukcesu.

Jeśli dostęp do maszyny wirtualnej odbywa się za pośrednictwem innej ścieżki wyświetlania – takiej jak zwykły VNC, passthrough GPU, RDP do gościa lub konsola w chmurze – kroki specyficzne dla SPICE mogą nie mieć zastosowania. Podobnie, niestandardowe jądro bez odpowiedniego sterownika DRM może wymagać konfiguracji jądra, a nie pakietu pulpitu.

Praktycznym punktem zatrzymania jest moment, gdy Pardus udostępni pożądane wyższe tryby, a widz może zmienić rozmiar bez konieczności skalowania bufora ramki 1024x768, a wynik przetrwa ponowne uruchomienie. Jeśli te warunki są spełnione, dodatkowe modele, pliki konfiguracyjne X.Org ani zmiany akceleracji 3D są zbędne.