Настроить WSL2 на Windows 11 за 5 минут – пошаговое руководство

Введение / Зачем это нужно

WSL2 (Windows Subsystem for Linux 2) позволяет запускать полноценные дистрибутивы Linux прямо в Windows без необходимости двойной загрузки или виртуальной машины. Это удобно для разработчиков, DevOps-инженеров и всех, кто хочет использовать инструменты Linux, такие как git, docker, python и другие, не покидая среду Windows.

После выполнения этого руководства у вас будет полностью настроенная среда WSL2 с дистрибутивом Ubuntu, готовая к повседневной работе с Linux-командами.

Требования / Подготовка

• Windows 10 (версия 2004 или выше) или Windows 11 с включённым режимом разработчика.
• Права администратора для включения необходимых компонентов Windows.
• Интернет-соединение для загрузки ядра и дистрибутива.

Пошаговая инструкция

Шаг 1: Включение Hyper‑V и Virtual Machine Platform

Откройте PowerShell от имени администратора и выполните:

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -All

Перезагрузите систему для применения изменений.

Шаг 2: Обновление ядра WSL2

Убедитесь, что используется последнее ядро:

wsl --update
wsl --install

Команда wsl --update скачает и установит последнюю версию ядра, а wsl --install подготовит систему к первому дистрибутиву.

Шаг 3: Установка дистрибутива Ubuntu

Запустите установщик дистрибутива:

wsl --install -d Ubuntu

Создайте пароль для пользователя root при первом запуске. После завершения установки запустите Ubuntu из меню «Пуск» или через команду ubuntu.

Шаг 4: Создание первого пользователя и настройка домашней директории

В терминале Ubuntu выполните:

sudo adduser alice
sudo usermod -aG sudo alice

Затем войдите под новым пользователем (su - alice) и установите необходимые инструменты, например:

sudo apt update && sudo apt install -y git vim

Шаг 5: Проверка работоспособности и запуск команд

Проверьте версию ядра и список дистрибутивов:

wsl --list --verbose
wsl -d Ubuntu uname -r

Теперь вы можете запускать любые Linux-команды напрямую из PowerShell или Windows Terminal.

Проверка результата

• Команда wsl --list --verbose должна показать статус Running для Ubuntu.
• wsl -d Ubuntu uname -r отобразит версию ядра (например, 5.15.90.1-microsoft-standard-WSL2).
• Запустите ubuntu из меню «Пуск» — вы увидите приглашение bash с вашей домашней директорией (/home/alice).

Если всё вышеперечисленное отображается корректно, настройка WSL2 завершена успешно.

Возможные проблемы

• Hyper‑V или Virtualization Platform отключены – выполните команды из Шага 1 с параметром -All и перезагрузите систему.
• WSL2 выдаёт ошибку «0x80070103» при обновлении – удалите старое ядро вручную: wsl --shutdown и повторите wsl --update.
• Команда wsl не найдена – убедитесь, что каталог C:\Program Files\WindowsSubSystemLinux добавлен в системный PATH (добавляется автоматически после установки).
• Ubuntu не запускается – переустановите дистрибутив: wsl --uninstall Ubuntu и выполните wsl --install -d Ubuntu повторно.

💡 Совет: Храните все команды WSL2 в отдельном скрипте (wsl-setup.ps1), чтобы быстро повторить настройку на новом ПК.

⚠️ Важно: Для использования Docker внутри WSL2 дополнительно требуется установка Docker Desktop для Windows с включённым背部 engine WSL2. Это выходит за рамки данного гайда, но может быть полезно для дальнейшей работы.