Команда wsl --install в PowerShell завершилась ошибкой «Виртуализация отключена в BIOS» — это самая частая причина, почему WSL 2 не запускается на Windows. Без включённой аппаратной виртуализации (Intel VT-x или AMD-V) подсистема Linux второго поколения физически не может стартовать, поскольку работает на базе лёгкой виртуальной машины Hyper-V.
Эта инструкция разбирает установку и настройку WSL 2 на Windows 10 и Windows 11: от проверки системных требований до решения типовых ошибок. Отдельно разберём отличия от первой версии WSL и ситуации, когда стоит остаться на ней.
Что такое WSL 2 и чем она отличается от первой версии
Windows Subsystem for Linux — это компонент Windows, позволяющий запускать дистрибутивы Linux (Ubuntu, Debian, Kali и другие) прямо внутри системы, без двойной загрузки и полноценной виртуальной машины. Первая версия WSL эмулировала системные вызовы ядра Linux, а WSL 2 использует настоящее ядро Linux, работающее внутри оптимизированной виртуальной машины.
За счёт этого вторая версия обеспечивает полную совместимость системных вызовов — в ней корректно работают Docker-контейнеры, systemd (в актуальных версиях) и инструменты, которые в WSL 1 попросту не запускались. Цена вопроса — обязательная поддержка виртуализации процессором и чуть более сложная сетевая модель.
- 🐧 WSL 1 — трансляция вызовов, быстрый доступ к файлам Windows, без Docker
- 🚀 WSL 2 — настоящее ядро Linux, полная совместимость, требует виртуализацию
- 📁 Файловая система Linux в WSL 2 работает быстрее при операциях внутри
ext4-диска - 🌐 Сеть WSL 2 изолирована: у Linux-среды свой IP-адрес, отличный от Windows
Системные требования и подготовка
Для работы WSL 2 вам нужна 64-разрядная Windows 10 версии 2004 (сборка 19041) или новее — либо любая актуальная Windows 11. Проверить сборку можно командой winver в диалоге «Выполнить» (Win + R). Редакция Windows Home тоже подходит: несмотря на отсутствие полноценного Hyper-V, необходимый компонент «Платформа виртуальной машины» в ней доступен.
Критичный момент — аппаратная виртуализация. Откройте «Диспетчер задач» (Ctrl + Shift + Esc), перейдите на вкладку «Производительность» → «ЦП» и посмотрите строку «Виртуализация». Если там указано «Включено» — переходите к установке. Если «Отключено», потребуется зайти в BIOS/UEFI и активировать Intel VT-x или AMD-V (название пункта зависит от производителя материнской платы — сверьтесь с её документацией).
⚠️ Внимание: изменение настроек BIOS/UEFI выполняйте аккуратно. Включение виртуализации само по себе безопасно, но не меняйте соседние параметры, назначения которых не знаете. При сомнениях ориентируйтесь на официальную инструкцию к вашей материнской плате или ноутбуку.
☑️ Готовность системы к WSL 2
Установка WSL 2: пошаговая инструкция
Самый простой способ — универсальная команда установки. Запустите PowerShell от имени администратора (правый клик по меню «Пуск» → «Терминал Windows (администратор)») и выполните:
wsl --installКоманда автоматически включает нужные компоненты Windows, скачивает ядро WSL 2 и устанавливает дистрибутив Ubuntu по умолчанию. После завершения обязательно перезагрузите компьютер — без перезагрузки виртуальная платформа не активируется, и дистрибутив не запустится.
Если нужен другой дистрибутив, сначала посмотрите доступные варианты, затем установите выбранный:
wsl --list --online
wsl --install -d Debian
При первом запуске дистрибутива появится окно терминала с предложением создать пользователя Linux и пароль. Учтите: при вводе пароля символы не отображаются — это нормальное поведение терминала Linux, а не зависание.
Настройка после установки
Убедитесь, что дистрибутив работает именно на второй версии. Команда wsl -l -v покажет список установленных дистрибутивов и их версии. Если в колонке VERSION стоит 1, конвертируйте дистрибутив:
wsl --set-version Ubuntu 2Конвертация может занять несколько минут в зависимости от объёма файлов внутри дистрибутива. Для всех будущих установок задайте вторую версию по умолчанию командой wsl --set-default-version 2.
Потребление памяти WSL 2 по умолчанию ограничено долей от общего объёма ОЗУ, но его можно настроить вручную. Для этого создайте в профиле пользователя Windows файл C:\Users\ИмяПользователя\.wslconfig и укажите лимиты:
[wsl2]
memory=4GB
processors=4
- 💾 memory — максимальный объём оперативной памяти для виртуальной машины WSL
- ⚙️ processors — число доступных виртуальных ядер процессора
- 🔄 После изменения файла выполните
wsl --shutdownи запустите дистрибутив заново - 📝 Параметр
swapпозволяет задать размер файла подкачки
Типичные ошибки WSL 2 и их решение
Ошибка 0x80370102 при запуске дистрибутива означает, что виртуализация недоступна: либо она отключена в BIOS/UEFI, либо не включён компонент «Платформа виртуальной машины». Проверка начинается с Диспетчера задач, затем — с компонентов Windows.
Сообщение об ошибке WslRegisterDistribution failed with error: 0x8007019e указывает, что не включён сам компонент «Подсистема Windows для Linux». Включите его через «Компоненты Windows» или командой в PowerShell от администратора:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartЕсли WSL 2 внезапно перестал запускаться после обновления Windows, возможная причина — повреждение сетевого стека или устаревшее ядро. Помогает команда wsl --update для обновления ядра, а в более сложных случаях — сброс сети через wsl --shutdown и перезапуск службы. Точную причину стоит искать в тексте ошибки: универсального решения для всех кодов не существует.
⚠️ Внимание: команда
wsl --unregister ИмяДистрибутива, которую часто советуют на форумах, полностью удаляет дистрибутив вместе со всеми файлами внутри него. Перед выполнением сохраните нужные данные — например, экспортировав дистрибутив черезwsl --export.
Сравнение WSL 2, WSL 1 и классической виртуальной машины
Выбор инструмента зависит от задачи. Ниже — сравнение по ключевым критериям; учтите, что реальная производительность зависит от конкретного оборудования и нагрузки.
| Критерий | WSL 1 | WSL 2 | Виртуальная машина |
|---|---|---|---|
| Ядро Linux | Эмуляция вызовов | Настоящее ядро | Настоящее ядро |
| Поддержка Docker | Нет | Да | Да |
| Требования к виртуализации | Не требуется | Обязательна | Обязательна |
| Скорость работы с файлами Windows | Высокая | Ниже | Низкая |
| Интеграция с Windows | Полная | Полная | Ограниченная |
Практический вывод: для разработки с Docker и современными инструментами выбирайте WSL 2. Если требуется максимально быстрый доступ к файлам на диске Windows и не нужна полная совместимость — допустим вариант с WSL 1. Полноценная виртуальная машина оправдана, когда нужен графический рабочий стол Linux или изоляция от хост-системы.
Как открыть файлы Linux из проводника Windows
Введите в адресной строке проводника путь \\wsl$ — откроется сетевая папка со всеми установленными дистрибутивами. Файлы можно копировать в обе стороны, но редактировать их лучше инструментами, понимающими окончания строк Linux (например, VS Code с расширением WSL).
Полезные команды для повседневной работы
Ниже — базовый набор команд управления WSL, которые выполняются в PowerShell или командной строке Windows. Их достаточно для ежедневной работы с подсистемой.
- ▶️
wsl— запустить дистрибутив по умолчанию - 📋
wsl -l -v— список дистрибутивов с версиями и состоянием - ⏹️
wsl --shutdown— завершить все запущенные экземпляры WSL - 🎯
wsl -d ИмяДистрибутива— запустить конкретный дистрибутив - 💿
wsl --export Ubuntu backup.tar— резервная копия дистрибутива - 🆙
wsl --update— обновление ядра WSL
Для интеграции с редактором кода удобнее всего Visual Studio Code с официальным расширением WSL: оно позволяет открывать проекты прямо из файловой системы Linux и запускать терминал внутри дистрибутива. Проекты при этом рекомендуется хранить именно в файловой системе Linux (/home/пользователь), а не на диске Windows — это заметно ускоряет сборку и работу инструментов.
⚠️ Внимание: не редактируйте файлы Linux через путь
\\wsl$программами, которые не умеют сохранять Linux-окончания строк (LF), — это может сломать скрипты и конфигурационные файлы. Для правок используйте редакторы с поддержкой LF.
Часто задаваемые вопросы
Работает ли WSL 2 на Windows 10 Home?
Да. Несмотря на отсутствие полноценного Hyper-V в домашней редакции, необходимый компонент «Платформа виртуальной машины» доступен. Требуется Windows 10 версии 2004 (сборка 19041) или новее и включённая виртуализация в BIOS/UEFI.
Сколько оперативной памяти потребляет WSL 2?
По умолчанию виртуальная машина WSL 2 может использовать ограниченную долю общего объёма ОЗУ, причём неиспользуемая память возвращается Windows. Точный лимит зависит от версии WSL. Управлять потреблением можно через файл .wslconfig с параметром memory.
Можно ли запускать графические Linux-приложения в WSL 2?
Да, в актуальных версиях Windows 10 и Windows 11 поддерживается WSLg — подсистема для запуска GUI-приложений Linux. Достаточно установить приложение внутри дистрибутива и запустить его из терминала — окно откроется в Windows. Для корректной работы желательно обновить WSL командой wsl --update.
Как перенести дистрибутив WSL на другой диск?
Используйте экспорт и импорт: wsl --export Ubuntu D:\backup\ubuntu.tar, затем wsl --unregister Ubuntu и wsl --import Ubuntu D:\WSL\Ubuntu D:\backup\ubuntu.tar. Учтите, что после импорта дистрибутив по умолчанию запускается от имени root — пользователя по умолчанию нужно настроить заново через файл /etc/wsl.conf.
Почему Docker Desktop требует WSL 2?
Docker на Windows работает поверх ядра Linux. WSL 2 предоставляет настоящее ядро с полной поддержкой системных вызовов, необходимых для контейнеров, поэтому Docker Desktop использует именно её как бэкенд по умолчанию. На WSL 1 контейнеры запустить невозможно из-за отсутствия реального ядра.