День 0 · установка · troubleshooting.md

Если установка не пошла

Собрано по частоте: сверху то, что случается чаще всего.

Прежде чем читать — скопируйте точный текст ошибки. Не пересказывайте: половина проблем узнаётся по одной строке, а по пересказу не узнаётся никогда.

Машина не запускается

VT-x is not available (VERR_VMX_NO_VMX)

Не включена аппаратная виртуализация.

• Windows: включите в BIOS — «Шаг 1» в windows.md.
• Если в BIOS уже включена, а ошибка осталась — не отключён Hyper-V, «Шаг 2» там же.

VT-x is being used by another hypervisor

Тот же Hyper-V, другое сообщение. Отключите его и перезагрузитесь.

Пункта Hyper-V нет в списке компонентов, а ошибка есть? Виновата «Безопасность на основе виртуализации»:

1. Win → напечатать Изоляция ядра → открыть.
2. Выключить «Целостность памяти».
3. Перезагрузиться.

Kernel driver not installed (rc=1908)

Windows не дала VirtualBox поставить драйверы. Обычно из-за антивируса или из-за того, что установщик запускали не от администратора.

Переустановите VirtualBox: правой кнопкой по установщику → «Запуск от имени администратора». На время установки отключите антивирус.

Kernel driver not installed на Linux

Модули ядра не собрались. Проверьте:

lsmod | grep vbox

Пусто — пересоберите:

sudo apt install -y build-essential dkms linux-headers-$(uname -r)
sudo /sbin/vboxconfig

На системах с Secure Boot модули могут не загружаться, потому что не подписаны. Проще всего отключить Secure Boot в BIOS. Проверить, включён ли он:

mokutil --sb-state

Машина стартует, но всё дико тормозит

Почти всегда — Hyper-V: VirtualBox работает, но в медленном режиме. Проверьте, что он отключён.

Реже — машине выдано слишком много памяти, и не хватает основной системе. Рабочему столу нужно 4096 МБ; если на ноутбуке всего 8 ГБ, больше не давайте.

Ещё вариант: видеопамяти выделено мало. «Настроить» → «Дисплей» → поставить на максимум, 128 МБ. Графический рабочий стол на 16 МБ работать не будет.

Чёрный экран, ничего не происходит больше двух минут

Выключите машину (Машина → Выключить) и запустите заново. Повторяется — проверьте, что образ распакован полностью и не побился при скачивании.

Дополнения гостевой ОС: окно, буфер, разрешение

Самая частая группа жалоб после первого запуска. Почти всё лечится одним: установить Дополнения гостевой ОС (шаг 7 в windows.md).

Окно крошечное, не тянется, разрешение не меняется

Не установлены Дополнения. Пока их нет, система не знает размер окна.

Плюс проверьте: «Настроить» → «Дисплей» → видеопамять должна быть на максимуме (128 МБ). При 16 МБ рабочий стол будет тормозить и обрезаться.

Не копируется текст между основной системой и виртуалкой

Два условия, оба обязательны:

1. Установлены Дополнения гостевой ОС.
2. Меню окна → «Устройства» → «Общий буфер обмена» → «Двунаправленный».

Внутри самой виртуалки копирование работает всегда, Дополнения для этого не нужны. Но помните: в терминале Linux свои сочетания.

Обычный Ctrl+C в терминале прерывает команду, а не копирует.

Установка Дополнений падает с ошибкой про заголовки ядра

Не хватает пакетов для сборки:

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

После этого запустите установку Дополнений заново.

Диск с Дополнениями не находится

ls /media/$USER/

Каталог называется примерно VBox_GAs_7.0.14. Если пусто — подключите образ заново: меню окна → «Устройства» → «Подключить образ диска Дополнений гостевой ОС».

Мышь «залипла» в окне виртуалки

Нажмите правый Ctrl — это host-клавиша, она освобождает курсор. На Mac обычно левый Cmd. Текущая написана в правом нижнем углу окна.

После установки Дополнений мышь перестаёт залипать вовсе.

Клавиатура печатает не те символы

Раскладка внутри Linux настраивается отдельно от основной системы: «Параметры» → «Клавиатура» → добавить раскладку. Переключение обычно Super + Пробел.

Не отдаёт память после закрытия

VirtualBox держит память, пока машина запущена, даже если окно свёрнуто. Закончили — «Машина» → «Выключить», а не просто закрыть окно. Вариант «Сохранить состояние машины» тоже освобождает память и позволяет продолжить с того же места.

Не получается войти

Пароль не печатается, ничего не видно

Это не поломка. В Linux пароль при вводе не отображается вообще никак — ни точками, ни звёздочками. Печатайте вслепую и жмите Enter.

Login incorrect на готовом образе

• Проверьте логин и пароль на странице, откуда скачали образ — они там написаны. Обычно osboxes / osboxes.org или ubuntu / ubuntu.
• Раскладка: пароль набирается латиницей.
• Caps Lock.
• Логин вводится маленькими буквами.
• Символ . в пароле osboxes.org при сбитой раскладке может вводиться не тем клавишей — см. пункт про клавиатуру выше.

user is not in the sudoers file

Ваш пользователь не имеет прав администратора. Разбирается в after-install.md, пункт 2.

Забыл пароль, который сам придумал

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

Это, кстати, хороший аргумент за снапшоты.

macOS

Установщик VirtualBox заблокирован

Системные настройки → «Конфиденциальность и безопасность» → пролистать вниз → сообщение про Oracle → «Разрешить» → запустить установщик заново. Может потребоваться перезагрузка.

VirtualBox не ставится на Mac с чипом M

И не поставится. На Apple Silicon другая архитектура процессора. Используйте UTM — см. macos.md.

UTM: машина не стартует

Проверьте, что скачали образ для ARM64, а не для x86. Образ для обычных компьютеров на M-чипе запустится только в режиме эмуляции — крайне медленно либо никак.

Тренажёр не запускается

Архив не скачивается или не находится

Смотрите, что вообще попало в загрузки:

ls -lh ~/Downloads

Файл мог сохраниться под другим именем — подставьте его в команду распаковки.

course: command not found

Не установлен или установлен не туда:

ls -l /usr/local/bin/course

Пусто — вернитесь к пункту 7.3 в after-install.md и проверьте, что все пять строк выполнились без ошибок.

Permission denied при запуске course

Не выставлен бит выполнения:

sudo chmod 755 /usr/local/bin/course
sudo find /opt/course -name '*.sh' -exec chmod 755 {} +

День 01 не найден

Материалы распаковались не туда:

ls /opt/course

Ожидается blocks и lib. Если вместо них ещё один вложенный каталог — распакуйте заново с --strip-components=1.

course doctor говорит, что журнал команд не включён

course setup-shell
source ~/.bashrc

Затем закройте и откройте терминал, проверьте снова.

Ничего из этого не помогло

Опишите проблему по такой форме — так вам ответят в разы быстрее:

Половина ответа на вопрос содержится в том, как он сформулирован: пока вы заполняете эти строки, проблема нередко решается сама.