Исправлена ​​ошибка, из-за которой разрешение экрана зависало на 1024x768 в гостевой системе KVM Pardus.

Почему гостевая система Pardus KVM может зависнуть на разрешении 1024x768

Виртуальная машина Pardus, которая никогда не предлагает разрешение выше 1024x768, обычно не страдает от простой проблемы с настройками рабочего стола. Важный вопрос заключается в том, получает ли гостевая система действительно более крупный виртуальный режим отображения от KVM/QEMU и может ли сессия рабочего стола реагировать на события изменения размера.

Желаемый результат прост: после изменения размера окна просмотра или выбора большего размера Pardus должен отображать разрешения, такие как 1366x768, 1600x900 или 1920x1080, вместо того, чтобы сообщать о максимальном разрешении 1024x768. Интеграция с буфером обмена и плавное поведение указателя являются полезными дополнительными признаками при использовании SPICE, но разрешение — это основной критерий оценки.

Данное руководство наиболее точно соответствует гостевым системам Pardus, работающим под управлением KVM/QEMU с libvirt и консолью SPICE или графической консолью. Pardus 25.0 был выпущен в ноябре 2025 года, а в официальном репозитории загрузок Pardus также указаны образы Pardus 25.1 от марта 2026 года. Точные меню рабочего стола могут отличаться в версиях XFCE и GNOME, поэтому в приведенных ниже проверках используются команды и параметры виртуализации, которые не сильно зависят от какой-либо конкретной оболочки рабочего стола. Актуальные образы установки можно найти в официальном репозитории загрузок Pardus 25 .

1. Убедитесь, что разрешение 1024x768 действительно является максимальным разрешением для гостевой системы.

Начните работу в Pardus. Откройте терминал и определите тип сессии и аппаратное обеспечение виртуального дисплея:

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

Если сессия X11, выполните также:

xrandr --current

Обратите внимание на две вещи. Во-первых, определите, является ли виртуальный графический процессор QXL, Virtio GPU, стандартным VGA-адаптером или чем-то другим. Во-вторых, проверьте список режимов. Если уже указано разрешение 1920x1080, то, вероятно, стек виртуализации способен работать с более высоким разрешением, и проблема, скорее всего, связана с конфигурацией рабочего стола или событием изменения размера. Если же xrandrуказано, что максимальное разрешение составляет 1024x768, то изменение разрешения в диалоговом окне вряд ли поможет.

В сессии Wayland xrandrэто не является авторитетным инструментом настройки композитора, поэтому используйте его только в качестве дополнительной информации. Тип сессии имеет значение, поскольку QXL исторически ассоциировался с рабочими процессами X.Org/SPICE, в то время как Virtio GPU — это более современное паравиртуализированное графическое устройство в QEMU.

2. Проверьте видео- и видеоустройства виртуальной машины на хосте KVM.

Перед изменением виртуального видеооборудования полностью выключите гостевую систему. В диспетчере виртуальных машин откройте сведения об оборудовании виртуальной машины и проверьте как устройство отображения, так и видеоустройство. В распространенной конфигурации SPICE используется дисплей SPICE вместе с видеокартой QXL или Virtio.

В документации Libvirt описаны несколько поддерживаемых типов видеомоделей, включая qxlи virtio. QEMU описывает Virtio GPU как паравиртуализированный контроллер GPU/дисплея для гостевых систем Linux и рекомендует устройства VirtIO в целом, когда нет необходимости эмулировать конкретное физическое оборудование. Вы можете ознакомиться с документацией по видеоустройствам libvirt и документацией QEMU по VirtIO GPU .

Если виртуальная машина уже использует QXL и SPICE, не меняйте всё сразу. Оставьте существующую конфигурацию и сначала установите гостевой агент SPICE. Это обеспечит вам чистый тест: если динамическое разрешение заработает, нет причин менять виртуальный графический процессор.

Если виртуальная машина использует старую универсальную видеокарту VGA или Cirrus, переход на QXL или Virtio обычно более целесообразен для современной Linux-системы. Если вы позже выберете Virtio, начните без принудительного включения 3D-ускорения. В документации QEMU отмечается, что режимы ускорения Virtio GPU имеют дополнительные требования к хосту, ядру, Mesa и рендереру. Поэтому базовая настройка 2D Virtio GPU является более безопасным вариантом для устранения неполадок.

3. Установите гостевой агент SPICE в Pardus.

Когда виртуальная машина использует SPICE-дисплей, наиболее полезным и безопасным решением является обеспечение spice-vdagentего установки в гостевой системе:

sudo apt update
sudo apt install spice-vdagent

Затем выйдите из системы и войдите снова или перезагрузите гостевую систему. В описании пакета Debian spice-vdagentуказано, что одной из его функций является автоматическая настройка разрешения X-сессии в соответствии с разрешением клиента. Pardus основан на Debian, поэтому этот пакет доступен в экосистеме пакетов, основанных на Debian, используемой текущими версиями Pardus. В стабильной версии Debian в настоящее время доступна версия spice-vdagent0.22.1-4.1. См. страницу пакета spice-vdagent в Debian .

После установки проверьте работу демона и процесса на стороне пользователя:

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

Запущенный системный демон полезен, но компонент пользовательской сессии также имеет значение. В документации к пакетам Debian отмечается, что автоматическая обработка разрешения зависит от активной графической сессии, в которой запущен процесс агента.

Если виртуальная машина использует QXL в среде X.Org, и графический драйвер отсутствует, проверьте, установлен ли пакет драйверов QXL X.Org:

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

Это нужно делать только тогда, когда гостевая система действительно использует QXL. Пакет существует специально для устройств QXL в средах KVM/QEMU, совместимых со SPICE; он не нужен просто потому, что виртуальная машина работает под KVM. В стабильной версии Debian сейчас доступны пакеты xserver-xorg-video-qxl0.1.6-1.1, информация о которых приведена на странице драйвера QXL в Debian .

4. Перед изменением виртуального графического процессора повторно протестируйте динамическое изменение размера.

После повторного входа в систему откройте графическую консоль и измените размер ее окна. Если ваш просмотрщик предоставляет возможность масштабирования по размеру окна или автоматического изменения размера, включите параметр, который изменяет размер гостевой системы, а не просто растягивает отображаемое изображение.

Для X11 запустите программу xrandr --currentеще раз. В случае успешного результата должно отобразиться большее максимальное значение и дополнительные режимы, или текущий режим должен автоматически меняться при изменении размера окна просмотра. Вы также можете открыть настройки дисплея Pardus и убедиться, что доступны более высокие разрешения, имитирующие исходный внешний вид.

Не стоит судить об успехе исключительно по тому, насколько больше выглядит окно консоли. Пользователь может масштабировать буфер кадров 1024x768, чтобы он заполнял большое окно, что приводит к увеличению изображения без повышения разрешения гостевой системы. Надежными показателями являются режим, сообщаемый гостевой системой, и фактически доступное рабочее пространство рабочего стола.

Если разрешение QXL по-прежнему зависает на 1024x768, переключитесь на видео Virtio.

Если агент SPICE установлен и активен, но гостевая система по-прежнему отображает только разрешение 1024x768, изменяйте параметры по одному. Выключите виртуальную машину, откройте настройки видеооборудования и переключите модель видеокарты с QXL или устаревшего VGA на Virtio. Оставьте SPICE-дисплей, если у вас нет особых причин для изменения протокола удаленного отображения.

Загрузите Pardus и повторите проверку оборудования и режима работы:

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

В сессии X11 также выполните команду xrandr --current. QEMU указывает, что для работы Virtio GPU требуется поддержка ядра гостевой системы Linux CONFIG_DRM_VIRTIO_GPU; ядра основных дистрибутивов обычно предоставляют эту поддержку, но пользовательские ядра могут её не предоставлять. Если после внесения изменений гостевая система загружается с чёрным экраном, выключите её от хоста и вернитесь к исходной модели видеокарты, вместо того чтобы продолжать вносить изменения в гостевую систему вслепую.

Когда xrandr может помочь — и когда это неправильное решение

Если xrandrнужное вам разрешение уже указано в списке, его выбор может быть полезным диагностическим шагом:

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

Замените Virtual-1на фактическое имя выходного файла, указанное командой ` xrandr.`. Эта команда применяется только к X11 и только в том случае, если этот режим уже доступен для вывода.

Если нужный режим отсутствует, а максимальный размер буфера кадров по-прежнему составляет 1024x768, ручное добавление строки модели обычно устраняет симптом, а не причину. В гостевой системе KVM виртуальный графический процессор и интеграция дисплея должны обычно объявлять доступные режимы. Сначала исправьте этот путь. Документация X.Org RandR является основным справочником по динамической настройке дисплея X11.

Как определить, завершено ли устранение неполадок?

Полезные команды для устранения неполадок

Если результат по-прежнему противоречив, соберите следующие команды, прежде чем вносить дальнейшие изменения:

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

В X11 добавьте:

xrandr --current

Эти проверки позволяют разделить ошибки на четыре класса: хост предоставляет неправильное виртуальное видеоустройство, Pardus не имеет соответствующей интеграции с гостевой системой, агент установлен, но не запущен в графической сессии, или сессия рабочего стола использует стек отображения, который не реагирует на ожидаемый механизм изменения размера.

Ограничения этого исправления

Единого оптимального варианта QXL или Virtio для каждой установки KVM не существует. На результат влияют версии QEMU/libvirt на хосте, консольный клиент, сессия рабочего стола, ядро ​​и включено ли 3D-ускорение. Описанные выше шаги намеренно начинаются с наименее радикальных изменений, а в качестве критерия успеха используется разрешение, сообщаемое гостевой системой.

Если доступ к виртуальной машине осуществляется через другой путь отображения — например, через обычный VNC, сквозную передачу GPU, RDP-подключение к гостевой системе или облачную консоль — шаги, специфичные для SPICE, могут не применяться. Аналогично, для пользовательского ядра без соответствующего драйвера DRM может потребоваться конфигурация ядра, а не пакет для рабочего стола.

Практическая точка остановки — это когда Pardus отображает необходимые режимы более высокого разрешения, пользователь может изменять размер без простого масштабирования буфера кадров 1024x768, и результат сохраняется после перезагрузки. Если эти условия выполнены, дополнительные строки моделирования, файлы конфигурации X.Org или изменения 3D-ускорения не требуются.