Установка Open VM Tools на Debian 13, 12, 11: полное руководство

Open VM Tools — это набор драйверов и утилит для виртуальных машин, работающих под управлением VMware (Workstation, Fusion, Player, ESXi). Они обеспечивают:

  • Автоматическое изменение разрешения экрана при изменении размера окна
  • Копирование и вставку текста (clipboard sharing)
  • Перетаскивание файлов (drag-and-drop)
  • Общие папки (shared folders)
  • Синхронизацию времени с хостом
  • Graceful shutdown (выключение гостевой ОС через VMware)

⚠️ Важно: Open VM Tools предназначены только для VMware. Если вы используете VirtualBox, QEMU/KVM, Hyper-V — эта инструкция не для вас.

В этом руководстве я покажу, как установить Open VM Tools на Debian 13, 12 и 11, работающие под управлением VMware.

Оглавление

Предварительные требования

Перед установкой убедитесь, что:

  • Ваша виртуальная машина работает под VMware (Workstation, Fusion, Player, ESXi)
  • Вы имеете права sudo (администратора)

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo whoami

Что делает: sudo — выполняет команду от имени суперпользователя; whoami — показывает имя текущего пользователя.

✅ Ожидаемый вывод в терминале:

root

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.

Проверка платформы виртуализации

Убедитесь, что ваша ВМ действительно работает на VMware:

systemd-detect-virt

✅ Ожидаемый вывод для VMware: vmware

Если вывод другой (kvm, oracle, microsoft и т.д.) — эта инструкция не для вас. Устанавливайте соответствующие гостевые дополнения для вашей платформы.

Выбор пакета Open VM Tools

ПакетДля когоЧто даёт
open-vm-tools-desktopДесктопные гости
(GNOME, KDE, Xfce и т.д.)		Всё из базового пакета +
clipboard, drag-and-drop,
автоматическое изменение
разрешения
open-vm-toolsСерверные или headless-гости
(без графики)		Синхронизация времени,
общие папки, управление
питанием
open-vm-tools-devРазработкаЗаголовочные файлы
(обычно не нужны)

⚠️ Примечание: Пакет open-vm-tools-desktop автоматически устанавливает open-vm-tools как зависимость. Не нужно устанавливать оба.

Установка Open VM Tools

Шаг 1: Обновите систему

sudo apt update && sudo apt upgrade -y

Шаг 2: Установите соответствующий пакет

Для десктопной ВМ (с графикой):

sudo apt install -y open-vm-tools-desktop

Для серверной ВМ (без графики):

sudo apt install -y open-vm-tools

Шаг 3: Перезагрузите виртуальную машину

sudo reboot

Зачем: Некоторые функции (например, изменение разрешения экрана) работают только после полной перезагрузки.

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

Проверка версии пакета

apt-cache policy open-vm-tools

✅ Ожидаемый вывод: Installed: показывает версию (не (none)).

Проверка статуса сервиса

systemctl status open-vm-tools --no-pager

✅ Ожидаемый вывод: Active: active (running)

Проверка установки десктопного пакета (если устанавливали)

dpkg-query -W open-vm-tools-desktop

✅ Ожидаемый вывод: версия пакета.

Проверка общих папок (shared folders)

vmware-hgfsclient

Что делает: Показывает список общих папок, настроенных в VMware. Если нет вывода — проверьте настройки ВМ.

Решение типичных проблем

8.1 Сервис inactive (dead) или не запускается

Симптом: systemctl status open-vm-tools показывает inactive (dead) или failed.

Причина: Виртуальная машина работает не под VMware, или условие ConditionVirtualization=vmware не выполнено.

Пошаговое решение:

Шаг 1: Проверьте платформу виртуализации:

systemd-detect-virt

Если вывод не vmware — Open VM Tools не будут работать. Установите гостевые дополнения для вашей платформы (VirtualBox Guest Additions, QEMU Guest Agent и т.д.).

Шаг 2: Если вывод vmware, но сервис не запускается, переустановите пакет:

sudo apt install --reinstall open-vm-tools -y
sudo reboot

8.2 Не работает копирование/вставка, перетаскивание файлов или изменение разрешения

Симптом: Десктопные функции не работают, хотя ВМ под VMware.

Причина: Установлен только базовый пакет open-vm-tools, а не open-vm-tools-desktop.

Пошаговое решение:

Шаг 1: Проверьте, установлен ли десктопный пакет:

dpkg-query -W open-vm-tools-desktop

Шаг 2: Если пакет не установлен — установите его:

sudo apt install -y open-vm-tools-desktop
sudo reboot

Шаг 3: Проверьте настройки VMware:

  • Откройте настройки виртуальной машины
  • Убедитесь, что опции «Enable copy and paste», «Enable drag and drop» включены
  • Для общих папок: «Always enabled»

8.3 Общие папки (shared folders) не отображаются

Симптом: vmware-hgfsclient не показывает папки, или папки не видны в /mnt/hgfs/.

Причина: Общие папки не включены в настройках VMware или не смонтированы.

Пошаговое решение:

Шаг 1: Убедитесь, что общие папки включены в VMware (VM → Settings → Options → Shared Folders → Always enabled).

Шаг 2: Проверьте, какие папки видны из гостевой системы:

vmware-hgfsclient

Шаг 3: Если папки видны, но не смонтированы — смонтируйте вручную:

sudo mkdir -p /mnt/hgfs
sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other

Шаг 4: Для автоматического монтирования при загрузке добавьте в /etc/fstab:

.host:/ /mnt/hgfs fuse.vmhgfs-fuse allow_other,defaults 0 0

8.4 Синхронизация времени не работает

Симптом: Время в гостевой системе расходится с временем хоста.

Причина: Служба синхронизации времени не активна.

Пошаговое решение:

Шаг 1: Проверьте, что служба синхронизации запущена:

systemctl status open-vm-tools --no-pager

Шаг 2: Если сервис активен, но время всё равно расходится — включите синхронизацию времени вручную:

sudo vmware-toolbox-cmd timesync enable

Шаг 3: Проверьте статус:

sudo vmware-toolbox-cmd timesync status

✅ Ожидаемый вывод: Enabled

8.5 После обновления ядра перестали работать функции

Симптом: После apt upgrade и перезагрузки перестали работать общие папки или другие функции.

Причина: Open VM Tools не требует пересборки модулей DKMS, но иногда требуется перезагрузка.

Пошаговое решение:

Шаг 1: Перезагрузитесь (ещё раз):

sudo reboot

Шаг 2: Если не помогло — переустановите пакеты:

sudo apt install --reinstall open-vm-tools -y

Если вы на десктопе:

sudo apt install --reinstall open-vm-tools-desktop -y

Шаг 3: Перезагрузитесь снова.

Обновление Open VM Tools

Open VM Tools обновляются через стандартный APT:

sudo apt update
sudo apt install --only-upgrade open-vm-tools -y

Для десктопной ВМ (обновить оба пакета):

sudo apt install --only-upgrade open-vm-tools open-vm-tools-desktop -y

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

sudo reboot

Удаление Open VM Tools

⚠️ Внимание: Удаление отключит интеграцию с VMware (копирование/вставку, общие папки, синхронизацию времени). Выполняйте, только если ВМ больше не работает под VMware.

Шаг 1: Удалите пакеты

sudo apt remove --purge open-vm-tools open-vm-tools-desktop open-vm-tools-dev

Шаг 2: Удалите неиспользуемые зависимости

sudo apt autoremove --purge

Шаг 3: Перезагрузитесь

sudo reboot

Чек-лист: что проверить после установки

  • [ ] Платформа виртуализации: systemd-detect-virt → vmware
  • [ ] Пакет установлен: apt-cache policy open-vm-tools → Installed: с версией
  • [ ] Сервис запущен: systemctl status open-vm-tools → active (running)
  • [ ] Десктопный пакет (если нужен): dpkg-query -W open-vm-tools-desktop → версия
  • [ ] Общие папки видны: vmware-hgfsclient показывает список
  • [ ] Копирование/вставка работает: попробуйте скопировать текст с хоста в гостевую систему
  • [ ] Изменение разрешения работает: растяните окно ВМ — разрешение должно измениться автоматически

Часто задаваемые вопросы (FAQ)

Вопрос: Open VM Tools и «VMware Tools» (через установщик ISO) — это одно и то же?
Ответ: Рекомендуемый способ для Debian — Open VM Tools из репозиториев. Старый ISO-установщик устарел и не рекомендуется.

Вопрос: Нужно ли устанавливать open-vm-tools-desktop на сервер?
Ответ: Нет, на сервере без графики достаточно open-vm-tools. Десктопный пакет добавляет только графические функции (clipboard, drag-and-drop, автоматическое изменение разрешения).

Вопрос: Совместимы ли Open VM Tools с VMware ESXi?
Ответ: Да, полностью совместимы.

Вопрос: Почему не работают общие папки, хотя vmware-hgfsclient показывает их?
Ответ: Папки нужно смонтировать. Выполните:

sudo mkdir -p /mnt/hgfs
sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other

Вопрос: Как проверить, что синхронизация времени работает?
Ответ: sudo vmware-toolbox-cmd timesync status → Enabled

Заключение

Теперь Open VM Tools установлены на вашем Debian. Ваша виртуальная машина под VMware будет работать более плавно: корректно менять разрешение экрана, поддерживать копирование/вставку между хостом и гостем и синхронизировать время.

Что дальше?

Связанные записи