AM
Разработка 6 мин чтения

Docker Desktop не запускается в Windows: исправление ошибок WSL

Пошаговое руководство по исправлению ошибок Docker Desktop в Windows: проблемы с WSL2, виртуализацией, дистрибутивами, движком и настройками системы.

DockerWSLWindowsвиртуализацияконтейнеры

Симптомы

  • Docker Desktop показывает ошибку при запуске
  • Ошибка «deploying WSL2 distributions» или «The network name cannot be found»
  • Docker зависает на «Starting the Docker Engine...»
  • Ошибка «WSL2 is not supported with your current machine configuration»
  • Контейнеры не запускаются, Docker не реагирует

Возможные причины

  • Виртуализация отключена в BIOS
  • Hyper-V или WSL2 не установлены или повреждены
  • Конфликт версий Docker Desktop и WSL
  • Повреждённый дистрибутив docker-desktop
  • Антивирус блокирует компоненты Docker
  • Недостаточно прав для запуска

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

1

Проверьте виртуализацию в BIOS

Docker Desktop требует включённую виртуализацию (Intel VT-x или AMD-V). Перезагрузите компьютер и войдите в BIOS (обычно Del, F2 или F10 при загрузке). Найдите раздел CPU или Advanced и убедитесь, что виртуализация включена. Если вы не видите эту опцию, возможно, она уже включена. Проверить в Windows: откройте Диспетчер задач (Ctrl+Shift+Esc) → вкладка «Производительность» → CPU → «Виртуализация» должна быть «Включена». Также убедитесь, что Virtualization-based Security включена в реестре: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\DeviceGuard → EnableVirtualizationBasedSecurity = 1.

2

Установите WSL2 и Hyper-V

Откройте PowerShell от администратора и выполните: wsl --install. Это установит WSL2 и Ubuntu по умолчанию. Если WSL уже установлен, обновите его: wsl --update. Для включения Hyper-V выполните: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All -All -NoRestart. После установки перезагрузите компьютер. Если WSL2 требует компонент «Virtual Machine Platform», установите его: dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart.

Команда 
wsl --install
wsl --update
3

Удалите и пересоздайте дистрибутив docker-desktop

Остановите Docker Desktop полностью (правой кнопкой по иконке в трее → Quit Docker Desktop). Откройте командную строку от администратора и выполните: wsl --unregister docker-desktop. Это удалит дистрибутив Docker (данные контейнеров не удалятся). Запустите Docker Desktop снова — он автоматически создаст новый дистрибутив. Если ошибка сохраняется, также выполните: wsl --shutdown для полной остановки WSL перед перезапуском Docker.

Команда 
wsl --unregister docker-desktop
wsl --shutdown
4

Обновите или откатите Docker Desktop

Некоторые версии Docker Desktop содержат ошибки совместимости с WSL. Проверьте последнюю стабильную версию на сайте Docker. Если у вас последняя версия и она не работает, попробуйте откатить на предыдущую стабильную: удалите текущую версию и установите более раннюю (например, 4.32.0 вместо 4.33.1). Также обновите WSL: wsl --update --pre-release для получения последней предварительной версии с исправлениями.

5

Проверьте права доступа

Docker Desktop требует права администратора для работы с WSL и Hyper-V. Запускайте Docker от имени администратора: правой кнопкой по ярлыку Docker Desktop → «Запуск от имени администратора». Если Docker должен запускаться автоматически при входе, настройте через Планировщик заданий: создайте задачу с триггером «При входе в систему» и действием «Запустить программу» с параметром «Запуск от имени администратора». Также проверьте, что антивирус не блокирует компоненты Docker — добавьте исключения для Docker Desktop и WSL.

6

Сбросьте сетевые настройки Docker

Откройте PowerShell от администратора и выполните: netsh winsock reset. Затем перезагрузите компьютер. Если Docker использует VPN или прокси, временно отключите их. Проверьте настройки DNS: переключитесь на DNS Google (8.8.8.8) в настройках сети. Если Docker не может подключиться к реестру образов, попробуйте использовать зеркало (mirror) в настройках Docker Engine: добавьте "registry-mirrors": ["https://mirror.gcr.io"] в файл конфигурации.

7

Переустановите Docker Desktop

Если ничего не помогло, выполните полную переустановку. Удалите Docker Desktop через Параметры → Приложения. Удалите остаточные папки: %LOCALAPPDATA%\Docker, %APPDATA%\Docker, %ProgramData%\DockerDesktop. Перезагрузите компьютер. Скачайте последнюю версию Docker Desktop с официального сайта и установите. При установке убедитесь, что включена опция «Use WSL 2 based engine». После установки запустите Docker и дождитесь инициализации.

Docker Desktop в Windows зависит от WSL2 (Windows Subsystem for Linux 2) и виртуализации. Если один из компонентов не работает, Docker не запустится. Чаще всего проблема решается пересозданием дистрибутива WSL или обновлением компонентов.

Основные ошибки Docker Desktop

Самые распространённые ошибки: «deploying WSL2 distributions — The network name cannot be found», «WSL2 is not supported», «Docker Engine stopped». Они связаны с тем, что WSL2 не может создать или запустить виртуальную машину Docker. Причины: отключённая виртуализация, конфликт версий, повреждённый дистрибутив или недостаток прав.

Проверка виртуализации

Docker Desktop требует аппаратную виртуализацию (Intel VT-x или AMD-V). Проверьте через Диспетчер задач: вкладка «Производительность» → CPU → «Виртуализация» должна быть «Включена». Если отключена — включите в BIOS. Также убедитесь, что Virtualization-based Security активен в реестре Windows. Некоторые эмуляторы Android отключают эту опцию для стабильности — после их использования её нужно включать обратно.

Пересоздание дистрибутива WSL

Самый эффективный способ — удалить дистрибутив docker-desktop и позволить Docker создать его заново. Остановите Docker Desktop, выполните wsl —unregister docker-desktop от администратора, затем запустите Docker снова. Это не удаляет данные контейнеров (они хранятся отдельно). Если не помогло, выполните wsl —shutdown для полной остановки WSL.

Конфликты версий

Некоторые версии Docker Desktop (особенно 4.33.x) содержат ошибки совместимости с WSL. Попробуйте обновить до последней версии или откатить на предыдущую стабильную. Также обновите WSL командой wsl —update или wsl —update —pre-release. Docker активно исправляет эти ошибки, и обновления thường решают проблему.

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

При проблемах с загрузкойLinuxсначала检查 system logs. Выполните journalctl -xb для просмотра логов последней загрузки. Обратите внимание на строки с [FAILED] или [ERROR]. Проверьте, какие службы не запустились: systemctl —failed. Это покажет точную причину незагрузки.

Восстановление через Live USB

Если система не загружается вообще, загрузитесь с Live USB. Смонтируйте корневой раздел: sudo mount /dev/sdaX /mnt. Проверьте файловую систему: sudo fsck /dev/sdaX. Переустановите загрузчик: sudo grub-install —root-directory=/mnt /dev/sda. Это восстановит GRUB после неудачного обновления.

Проверка конфигурации

Проверьте конфигурационные файлы: /etc/fstab (монтирование разделов), /etc/default/grub (параметры ядра), /etc/systemd/system.conf (systemd). Убедитесь, что UUID разделов в fstab совпадают с реальными: sudo blkid. Неправильный UUID — частая причина незагрузки после обновления или замены диска.

Исправление через chroot

Если нужен доступ к системе для исправления: sudo mount /dev/sdaX /mnt, sudo mount —bind /dev /mnt/dev, sudo mount —bind /proc /mnt/proc, sudo chroot /mnt. Теперь вы внутри системы и можете исправлять конфигурацию, переустанавливать пакеты или обновлятьinitramfs: update-initramfs -u.

Откат обновления

Если проблема возникла после обновления ядра или пакетов, загрузитесь с предыдущего ядра в меню GRUB. Затем выполните: sudo apt install —reinstall linux-image-$(uname -r) или sudo dnf downgrade kernel. Для автоматического отката: sudo apt-mark hold имя-пакета — запретит обновление этого пакета.

Источники

  1. github.com — проверено 02.06.2026
  2. github.com — проверено 02.06.2026
  3. github.com — проверено 02.06.2026
  4. github.com — проверено 02.06.2026