Подробный гайд: Установка и настройка гостевых дополнений VirtualBox в ALT Linux

Важно:

• Версия гостевых дополнений должна соответствовать версии установленного VirtualBox на хост-системе.

---

Подготовка гостевой системы (внутри виртуальной машины с ALT Linux)

Шаг 1: Обновление системы и ядра

# Обновление списков пакетов
sudo apt-get update

# Полное обновление системы
sudo apt-get dist-upgrade

# Обновление ядра (автоматический выбор)
sudo update-kernel -f

Шаг 2: Определение версии и типа ядра

# Проверка версии и flavour ядра
uname -r
# Пример вывода: 6.12.41-6.12-alt1

Примечание:

• В примере выше 6.12 — это flavour ядра, который понадобится для установки соответствующих модулей.

Шаг 3: Установка необходимых пакетов

# Установка модулей ядра для гостевых дополнений
# Замените 6.12 на ваш flavour ядра (std-def, un-def, 6.6, 6.12 и т.д.)
sudo apt-get install kernel-modules-virtualbox-addition-6.12

# Установка утилит гостевых дополнений
sudo apt-get install virtualbox-guest-additions virtualbox-guest-common virtualbox-guest-utils

Важно:

• Не для всех flavour существуют модули kernel-modules-virtualbox-addition-*. Предварительно проверьте доступность пакета в репозитории.

Шаг 4: Активация службы и настройка прав

# Включение и запуск службы гостевых дополнений
sudo systemctl enable --now vboxadd-service.service

# Добавление пользователя в группу для доступа к общим папкам
sudo gpasswd -a $USER vboxsf

Шаг 5: Перезагрузка

# Перезагрузка виртуальной машины
sudo reboot

---

Настройка функций гостевых дополнений

Общие папки (Shared Folders)

На хост-системе (VirtualBox Manager):

1. Выделите виртуальную машину -> Настройки -> Общие папки
2. Нажмите «Добавить папку» (иконка с плюсом)
3. Укажите путь к папке на хосте
4. Задайте имя папки (например, shared)

5. Отметьте опции:

• Авто-подключение
• Создать постоянную папку

В гостевой системе (ALT Linux):

# Общая папка автоматически монтируется в /media/sf_<имя_папки>
# Например: /media/sf_shared

# Проверка монтирования
ls -la /media/

# Если папка не доступна, проверьте членство в группе:
groups $USER
# Должна быть указана группа: vboxsf

Адаптация экрана (автомасштабирование)

После установки дополнений:

• Разрешение экрана гостевой ОС будет автоматически подстраиваться под размер окна VirtualBox
• Работает режим «Полноэкранный режим» и «Масштабируемый режим»

Если не работает:

# Перезапустите службу
sudo systemctl restart vboxadd-service

# Проверьте загрузку модулей ядра
lsmod | grep vbox

Общий буфер обмена и Drag-n-Drop

Настройка в интерфейсе VirtualBox:

1. Запустите виртуальную машину
2. В меню окна ВМ: Устройства -> Общий буфер обмена -> Двунаправленный
3. В меню: Устройства -> Функция Drag-n-Drop -> Двунаправленный

Альтернативно через VBoxManage на хосте:

VBoxManage modifyvm "Имя_ВМ" --clipboard-mode bidirectional
VBoxManage modifyvm "Имя_ВМ" --drag-and-drop bidirectional

---

Диагностика и устранение проблем

Модули не загружаются

# Проверка загруженных модулей
lsmod | grep vbox

# Если модулей нет — переустановите их после обновления ядра
sudo apt-get install --reinstall kernel-modules-virtualbox-addition-6.12

Ошибка: «This system is currently not set up to build kernel modules»

# Установка заголовков ядра и инструментов сборки
sudo apt-get install kernel-headers-modules-6.12 build-essential

Общие папки не монтируются

# Проверка службы
sudo systemctl status vboxadd-service

# Ручное монтирование (если авто-подключение не сработало)
sudo mkdir -p /mnt/shared
sudo mount -t vboxsf shared /mnt/shared

Не работает адаптация экрана

# Проверка установки пакетов
rpm -qa | grep virtualbox-guest

# Переустановка дополнений
sudo apt-get install --reinstall virtualbox-guest-additions

---

Обновление гостевых дополнений

При обновлении VirtualBox на хост-системе:

1. На хосте: обновите VirtualBox и Extension Pack

2. В гостевой ОС:

# Обновление пакетов
sudo apt-get update
sudo apt-get dist-upgrade

# Обновление модулей ядра (если обновилось ядро)
sudo update-kernel -f
sudo apt-get install kernel-modules-virtualbox-addition-6.12

# Перезагрузка
sudo reboot

Важно:

• После обновления VirtualBox необходимо обновить как Extension Pack, так и Guest Additions.

---

Альтернативный способ: установка из ISO-образа

Если установка из репозитория не работает:

1. В меню VirtualBox: Устройства -> Подключить образ диска Дополнений гостевой ОС

2. В гостевой системе:

# Создание точки монтирования
sudo mkdir -p /mnt/vbox-additions
sudo mount /dev/cdrom /mnt/vbox-additions

# Переход в директорию и запуск установки
cd /mnt/vbox-additions
sudo ./VBoxLinuxAdditions.run

Этот метод требует наличия установленных build-essential и заголовков ядра. Предпочтительнее использовать пакеты из репозитория ALT Linux.

---

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

# 1. Проверка службы
systemctl is-active vboxadd-service
# Должно вернуть: active

# 2. Проверка групп пользователя
groups $USER
# Должна быть: vboxsf

# 3. Проверка общих папок
ls /media/
# Должна отображаться папка: sf_<имя>

# 4. Проверка буфера обмена
# Попробуйте скопировать текст между хостом и гостевой ОС

# 5. Проверка адаптации экрана
# Измените размер окна VirtualBox — разрешение гостевой ОС должно измениться автоматически

Совет:

• Для стабильной работы всегда используйте пакеты из официальных репозиториев ALT Linux, соответствующие вашей версии платформы (p10, p11, Sisyphus).

Если возникли проблемы — проверьте логи:

journalctl -u vboxadd-service -n 50
cat /var/log/vboxadd-install.log

Удачной виртуализации!