Включение и настройка WSL2

Перед использованием WSL Dashboard ваша система Windows должна правильно включить и настроить среду WSL 2. Этот раздел проведет вас через необходимые базовые настройки.

1. Проверка системных требований

WSL 2 имеет минимальные требования к версии Windows. Нажмите Win + R, введите winver для проверки вашей версии:

• Windows 10: версия 1903 или выше, и версия сборки (Build) должна быть 18362 или выше.
• Windows 11: все версии поддерживаются.

IMPORTANT

Если ваша версия слишком старая, сначала обновите систему через "Windows Update".

2. Включение аппаратной виртуализации

WSL 2 работает на основе технологии виртуализации, поэтому необходимо включить Virtualization Technology в BIOS/UEFI материнской платы.

• Способ проверки: Откройте "Диспетчер задач" -> вкладка "Производительность" -> "CPU".
• Проверка состояния: Убедитесь, что состояние "Виртуализация" в правом нижнем углу отображается как "Включено".
• Способ включения: Если не включено, вам нужно перезагрузить компьютер и войти в настройки BIOS/UEFI, найти опцию, подобную Intel VT-x или AMD-V, и установить ее в положение Enabled.

3. Включение связанных функций Windows

Необходимо включить функции Windows "Windows Subsystem for Linux" и "Virtual Machine Platform".

Метод A: Через графический интерфейс (рекомендуется)

1. Нажмите Win + S, найдите и откройте "Включение или отключение функций Windows".
2. Установите флажки в следующих двух пунктах:
   • Windows Subsystem for Linux (Подсистема Windows для Linux)
   • Virtual Machine Platform (Платформа виртуальных машин)
3. Нажмите "ОК" и перезагрузите компьютер при появлении запроса.

Метод B: Через командную строку (с правами администратора)

Запустите PowerShell от имени администратора и выполните следующие команды:

# Включить WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Включить платформу виртуальных машин
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

После выполнения вручную перезагрузите компьютер.

4. Установка/обновление ядра WSL

Современные версии Windows могут получать обновления WSL через Microsoft Store.

• Адрес загрузки: Microsoft Store - Windows Subsystem for Linux
• Ручная загрузка: Если не удается использовать магазин, вы можете загрузить последний пакет установки .msixbundle или .msi с WSL GitHub Releases для оффлайн установки.

5. Установка WSL 2 как версии по умолчанию

Чтобы убедиться, что новые установленные дистрибутивы по умолчанию используют WSL 2, выполните в терминале:

wsl --set-default-version 2

Общие проблемы

• Ошибка 0x80370102: Обычно возникает из-за того, что виртуализация не включена в BIOS или есть конфликты с Hyper-V.
• Переключение между WSL 1 и WSL 2: Вы можете использовать wsl --set-version <имя дистрибутива> 2 для обновления существующего экземпляра WSL 1 до WSL 2.