Установка VirtualBox Guest Additions в Linux

Талисман Linux Tux сидит на логотипе VirtualBox

Зачем нужны Guest Additions

VirtualBox Guest Additions — это набор драйверов и вспомогательных утилит для гостевой ОС. Они обеспечивают:

адаптивное масштабирование экрана (динамическое изменение разрешения при изменении окна VirtualBox),
общий буфер обмена между хостом и гостем (clipboard),
перетаскивание файлов (drag-and-drop) в обе стороны,
общие папки (shared folders) с гибкими правами доступа,
синхронизацию времени и оптимизацию производительности графики.

Краткое определение: Guest Additions — расширение для гостевой ОС, повышающее удобство и интеграцию с хостом.

Требования перед установкой

Установленная виртуальная машина (не live-сессия). Установите ОС в VM прежде, чем устанавливать Guest Additions.
Привилегии root или возможность sudo в гостевой ОС.
Наличие заголовков ядра и инструментов сборки (для сборки модулей) если используется бинарная версия из ISO.
Для дистрибутивов с Secure Boot: возможно потребуется подписание модулей или отключение Secure Boot.

Важно: всегда сделайте снимок (snapshot) виртуальной машины перед крупными изменениями.

Быстрая последовательность действий (универсальная)

Установите пакеты сборки и заголовки ядра (если потребуется).
В меню VirtualBox выберите Devices → Insert Guest Additions CD image.
В гостевой ОС монтируйте носитель и запустите autorun.sh или установите пакет из репозитория.
Перезагрузите VM и проверьте работу функций (масштабирование, общий буфер обмена, папки).

Установка на Ubuntu и Debian

Подходит для Ubuntu, Debian и производных (Linux Mint, Kali и т. п.).

Запустите виртуальную машину и дождитесь загрузки рабочего стола.
Обновите пакеты и установите необходимые инструменты:

sudo apt update && sudo apt upgrade -y
sudo apt install build-essential dkms linux-headers-$(uname -r) -y

Пояснение: build-essential — набор компилятора и утилит, dkms — поддержка динамической пересборки модулей при обновлении ядра, linux-headers — заголовки текущего ядра.

В меню VirtualBox выберите Devices → Insert Guest Additions CD image.
В файловом менеджере откройте смонтированный диск и запустите autorun.sh через контекстное меню («Запустить как программу») или через терминал:

cd /media/$USER/VBox_GAs_*  # замените $USER своим именем пользователя при необходимости
sudo ./autorun.sh

Если скрипт запускает сборку модулей, дождитесь окончания и введите пароль при необходимости.

После завершения нажмите Enter, когда появится сообщение “Press Return to close this window”, и перезагрузите VM:

sudo reboot

Установка VirtualBox Guest Additions на Ubuntu

Совет: если система не монтировала диск в /media/$USER, используйте команду lsblk или dmesg | tail для поиска точки монтирования.

Установка на Arch и Manjaro

Arch и производные часто поставляют пакеты в репозитории — установка проще:

sudo pacman -Syu
sudo pacman -S virtualbox-guest-utils

После установки перезагрузите VM. На некоторых системах (Manjaro) может потребоваться пакет virtualbox-host-modules-arch или virtualbox-host-dkms в зависимости от ядра, которое вы используете.

Примечание: если вы используете ядро, отличное от стандартного, выберите соответствующие host-модули (например, virtualbox-host-modules-arch для stock-ядра или virtualbox-host-dkms для DKMS).

Установка на Fedora, CentOS и RHEL

Начиная с Fedora, VirtualBox Guest Additions иногда предустановлены. Если нет — используйте образ CD:

Devices → Insert Guest Additions CD image.
Нажмите Run в появившемся диалоговом окне или откройте диск в файловом менеджере и выберите Run Software.

В терминале установка обычно выглядит так:

sudo dnf install gcc make perl kernel-devel kernel-headers -y  # при необходимости
cd /run/media/$USER/VBox_GAs_*  # найдите точную папку, можно использовать Tab
sudo ./VBoxLinuxAdditions.run
sudo reboot

Если вы устанавливаете на RHEL/CentOS, убедитесь, что включены репозитории с пакетами для разработки ядра.

Установка Guest Additions на Fedora

Удаление Guest Additions

Если нужно удалить Guest Additions — используйте встроенный деинсталлятор или пакетный менеджер.

Ubuntu и Debian

cd /opt/VBoxGuestAdditions-*
sudo ./uninstall.sh
sudo reboot

Arch и Manjaro

sudo pacman -Rns virtualbox-guest-utils
sudo reboot

Fedora и RPM-based дистрибутивы

Если установлено через пакетный менеджер:

sudo dnf remove VirtualBox-guest-additions* -y
sudo reboot

Если устанавливали вручную через /opt:

cd /opt/VBoxGuestAdditions-*
sudo ./uninstall.sh
sudo reboot

Удаление Guest Additions на Ubuntu

Проверка успешной установки

Критерии приёмки:

Окно виртуальной машины автоматически изменяет разрешение при изменении размера окна VirtualBox.
Общий буфер обмена работает (Clipboard → Bidirectional в настройках VirtualBox).
Перетаскивание работает, если включено в настройках виртуальной машины.
Общие папки доступны: проверьте группу vboxsf и корректные права доступа.

Команды для диагностики:

systemctl status vboxservice  # для systemd-систем
lsmod | grep vbox             # должны быть модули vboxguest, vboxsf, vboxvideo
journalctl -b | grep -i vbox  # логи модуля

Распространённые проблемы и решения

Модули не собираются: проверьте, установлены ли linux-headers/kernel-devel и совпадает ли версия заголовков с текущим ядром.
Secure Boot мешает загрузке модулей: либо подпишите модули (mokutil), либо временно отключите Secure Boot в BIOS/UEFI.
Неверная версия VirtualBox на хосте vs Guest Additions в госте: обновите VirtualBox на хосте и заново вставьте CD с Guest Additions.
Проблемы с правами на общую папку: добавьте пользователя в группу vboxsf и перезайдите в сессию:

sudo usermod -aG vboxsf $USER
newgrp vboxsf  # или выйдите и войдите снова

Если графика не захватывает курсор или разрешение, убедитесь, что в настройках VM включен видеодрайвер VMSVGA/Graphics Controller, и у гостя установлены соответствующие модули.

Ментальные модели и решение «когда делать что»

Если дистрибутив предоставляет пакет в репозитории — используйте пакет менеджер (pacman/apt/dnf). Это надежнее и проще.
Если дистрибутив не имеет пакета — используйте вставку Guest Additions CD и autorun (ручная сборка модулей).
Если планируется частая смена версий ядра — предпочитайте DKMS-пакеты: они автоматически пересобирают модули.

Альтернативы и когда они лучше

VMware Tools для гостевых систем под VMware: лучше интеграция на VMware-хостах.
Hyper-V Integration Services для Windows/Linux при запуске под Hyper-V.
Если важна высочайшая производительность графики или GPU passthrough — рассмотрите KVM + virt-manager.

Чек-листы по ролям

Администратор:

Создать snapshot перед установкой.
Установить заголовки и инструменты сборки.
Обновить VirtualBox на хосте.
Установить Guest Additions и перезагрузить.
Проверить логи systemd/journalctl.

Разработчик:

Убедиться, что общий буфер обмена и drag-and-drop включены.
Настроить общие папки для доступа к исходникам.
Проверить права и синхронизацию времени.

Тестировщик/QA:

Протестировать масштабирование экрана и перетаскивание файлов.
Тестировать поведение при обновлении ядра и перезапуске сервисов.

Руководство действий при ошибке (runbook)

Проверить версию ядра: uname -r
Проверить наличие заголовков: ls /usr/src | grep $(uname -r)
Проверить логи установки: tail -n 200 /var/log/vboxadd-install.log (если есть) или journalctl -xe
Попробовать пересобрать модуль вручную:

cd /usr/src/vboxguest-* || cd /opt/VBoxGuestAdditions-*
sudo ./sbin/rcvboxadd setup

Если проблема — откат к snapshot и повторение установки с другими опциями.

Командная шпаргалка (cheat sheet)

Обновление и установка заголовков (Debian/Ubuntu):

sudo apt update && sudo apt upgrade -y
sudo apt install build-essential dkms linux-headers-$(uname -r) -y

Запуск установщика с CD:

sudo mount /dev/cdrom /mnt
cd /mnt
sudo ./VBoxLinuxAdditions.run

Добавление пользователя в группу vboxsf:

sudo usermod -aG vboxsf $USER

Проверка модулей:

lsmod | grep vbox
systemctl status vboxservice

Совместимость и миграция

При миграции виртуальной машины между разными версиями VirtualBox всегда сначала обновите VirtualBox на хосте, затем обновляйте Guest Additions в госте.
Для гостя настраивайте DKMS-пакеты, если ожидаете частых апдейтов ядра.
При переносе VM между хостами с разными гипервизорами (VirtualBox → VMware) удалите Guest Additions перед миграцией и установите соответствующие VMware Tools после.

Тест-кейсы и критерии приёмки

Измените размер окна VirtualBox — экран гостя автоматически подстроился.
Скопируйте текст на хосте и вставьте в гостя (и наоборот).
Перетащите небольшой файл с хоста в гостя — файл появился в целевой папке.
Создайте общую папку, добавьте гостя в vboxsf — проверьте чтение и запись.

Если все пункты проходят — установка успешна.

Когда Guest Additions не помогут

Глубокая поддержка 3D-ускорения может быть ограничена: для интенсивной графики лучше GPU passthrough.
Если хост использует другие гипервизоры (например, KVM/Hyper-V) — нужны их интеграционные пакеты.

Decision tree (выбор метода установки)

flowchart TD
  A[Нужны Guest Additions?] --> B{Дистрибутив предоставляет пакет?}
  B -- Да --> C[Установить через пакетный менеджер]
  B -- Нет --> D[Вставить Guest Additions CD и запустить autorun]
  C --> E{Используется DKMS?}
  E -- Да --> F[Установить DKMS-пакет]
  E -- Нет --> G[Установить host-modules или native пакет]
  D --> H{Сборка модулей завершилась успешно?}
  H -- Да --> I[Перезагрузить и проверить]
  H -- Нет --> J[Проверить заголовки ядра и Secure Boot]
  J --> K[Исправить заголовки или отключить Secure Boot]
  K --> D

Безопасность и Secure Boot

Если включён Secure Boot, unsigned модули (vboxguest, vboxsf) могут блокироваться. Возможные подходы:

Подписать модули с помощью mokutil и загрузить ключ в MOK (Machine Owner Key).
Отключить Secure Boot в UEFI/BIOS для тестовой машины.

Важно: выбор зависит от политики безопасности вашей организации.

Резюме

Guest Additions — обязательный компонент для полноценной работы десктоп-VM в VirtualBox.
Всегда проверяйте соответствие версий ядра и заголовков, используйте DKMS при частых апдейтах ядра.
Перед изменениями делайте snapshot; при проблемах используйте чек-листы и runbook, описанные выше.

Варианты: если VirtualBox не подходит под ваши требования, рассмотрите VMware, Hyper-V или KVM в зависимости от задач и требований к производительности.

Важно: перед массовым развёртыванием проверьте установку на тестовой VM и документируйте шаги для вашей инфраструктуры.