Как установить и настроить WSL2 в Windows 11: пошаговое руководство

Введение

Windows Subsystem for Linux 2 (WSL2) — это полноценное ядро Linux, работающее в легковесной виртуальной машине внутри Windows. Оно позволяет запускать Linux-дистрибутивы без двойной загрузки и сторонних гипервизоров, обеспечивая высокую производительность и совместимость с системными вызовами. WSL2 идеально подходит для разработки, тестирования и администрирования серверных приложений.

В этом руководстве мы разберём установку WSL2 в Windows 11, настройку дистрибутива, интеграцию с Windows и решение типичных ошибок.

Требования

• Windows 11 (версия 21H2 или новее, сборка 22000+).

• Процессор с поддержкой виртуализации (Intel VT-x или AMD-V), включённой в BIOS/UEFI.

• Минимум 4 ГБ ОЗУ (рекомендуется 8 ГБ и больше).

• Свободное место на диске (не менее 10 ГБ для дистрибутива и данных).

• Права администратора.

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

Шаг 1: Проверка поддержки виртуализации

1. Откройте диспетчер задач (Ctrl+Shift+Esc) и перейдите на вкладку «Производительность». 2. В разделе «ЦП» найдите строку «Виртуализация». Она должна быть «Включена». 3. Если виртуализация отключена, перезагрузите компьютер и войдите в BIOS/UEFI (обычно клавиши Del, F2 или F10). Найдите настройки Intel Virtualization Technology (VT-x) или AMD-V (SVM Mode) и включите их. Сохраните изменения и выйдите.

Шаг 2: Включение компонентов Windows

WSL2 требует включения двух компонентов: «Подсистема Windows для Linux» и «Платформа виртуальной машины».

1. Нажмите Win+R, введите optionalfeatures и нажмите Enter. 2. В списке найдите «Подсистема Windows для Linux» и установите флажок. 3. Найдите «Платформа виртуальной машины» и также установите флажок. 4. Нажмите «ОК» и дождитесь применения изменений. Перезагрузите компьютер.

Альтернативно можно использовать PowerShell (от имени администратора):

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

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

Шаг 3: Установка WSL2 через PowerShell

Самый простой способ — использовать одну команду, которая установит WSL и дистрибутив Ubuntu по умолчанию.

1. Откройте PowerShell от имени администратора. 2. Выполните:

   wsl --install

3. Дождитесь завершения установки. По умолчанию будет установлен дистрибутив Ubuntu. 4. Перезагрузите компьютер, если появится соответствующий запрос.

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

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

Если вы не хотите Ubuntu или установка не началась автоматически:

1. Просмотрите список доступных дистрибутивов:

   wsl --list --online

2. Установите нужный, например Debian:

   wsl --install -d Debian

3. После установки запустите дистрибутив из меню «Пуск» или командой wsl -d Debian.

Шаг 5: Первоначальная настройка дистрибутива

При первом запуске дистрибутива потребуется создать учётную запись Linux:

1. Введите имя пользователя (латиницей, без пробелов). 2. Придумайте и подтвердите пароль. Пароль не отображается при вводе — это нормально. 3. После создания пользователя вы попадёте в командную оболочку.

Обновите пакеты:

sudo apt update && sudo apt upgrade -y

Шаг 6: Проверка версии WSL

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

wsl --list --verbose

В столбце VERSION должна стоять цифра 2. Если указана 1, переключите:

wsl --set-version <имя_дистрибутива> 2

Также можно задать версию по умолчанию для новых установок:

wsl --set-default-version 2

Шаг 7: Настройка параметров WSL (файл .wslconfig)

Глобальные настройки WSL2 хранятся в файле %UserProfile%\.wslconfig. Создайте его, если он отсутствует, и добавьте параметры, например:

[wsl2]
memory=4GB
processors=2
swap=2GB
localhostForwarding=true

• memory — ограничение оперативной памяти для виртуальной машины WSL2.

• processors — количество ядер ЦП.

• swap — размер файла подкачки.

• localhostForwarding — проброс портов на localhost Windows.

После изменения файла выполните wsl --shutdown и запустите дистрибутив заново.

Шаг 8: Настройка дистрибутива (файл wsl.conf)

Для настроек внутри конкретного дистрибутива используется файл /etc/wsl.conf. Пример:

[automount]
enabled = true
root = /mnt/
options = "metadata,umask=22,fmask=11"

[network]
generateHosts = true
generateResolvConf = true

[interop]
enabled = true
appendWindowsPath = true

• automount — автоматическое монтирование дисков Windows в /mnt/c и т.д.

• metadata — поддержка прав доступа Linux на смонтированных дисках.

• interop — возможность запускать Windows-приложения из Linux.

После редактирования перезапустите WSL командой wsl --shutdown.

Шаг 9: Интеграция с Windows: доступ к файлам и буфер обмена

WSL2 автоматически монтирует диски Windows в каталог /mnt/. Например, диск C доступен как /mnt/c/. Вы можете открывать файлы Linux из Проводника Windows по пути \\wsl$\<имя_дистрибутива>\.

Для копирования текста между Windows и Linux используйте стандартные сочетания Ctrl+C и Ctrl+V в терминале Windows Terminal. В старом консольном окне может потребоваться включить «Быстрое редактирование» в свойствах окна.

Шаг 10: Установка Windows Terminal (рекомендуется)

Windows Terminal — современный терминал с поддержкой вкладок и профилей. Установите его из Microsoft Store или через winget:

winget install Microsoft.WindowsTerminal

После установки запустите Windows Terminal, нажмите стрелку вниз в строке вкладок и выберите свой дистрибутив WSL. Теперь у вас будет удобный доступ к Linux.

Шаг 11: Настройка графических приложений (WSLg)

В Windows 11 WSL2 поддерживает графические приложения Linux из коробки через WSLg. Проверьте работу, установив простой редактор:

sudo apt install x11-apps -y
xeyes

Должно открыться окно с глазами. Если приложение не запускается, убедитесь, что в файле .wslconfig не отключён параметр guiApplications (по умолчанию включён).

Шаг 12: Работа с Docker через WSL2

Docker Desktop для Windows использует WSL2 как бэкенд. Установите Docker Desktop с официального сайта, при установке выберите «Use WSL 2 instead of Hyper-V». После установки в настройках Docker Desktop включите интеграцию с вашим дистрибутивом WSL2. Теперь команды docker будут доступны внутри Linux.

Типичные ошибки

• Ошибка «WSL 2 requires an update to its kernel component» — установите пакет обновления ядра WSL2 вручную с сайта Microsoft (ссылка в разделе «Дополнительные ресурсы»).

• Виртуализация отключена — включите VT-x/AMD-V в BIOS/UEFI.

• Конфликт с Hyper-V или VirtualBox — WSL2 использует платформу виртуальной машины, которая может конфликтовать со старыми версиями VirtualBox. Обновите VirtualBox до последней версии или используйте Hyper-V вместо VirtualBox.

• Медленная работа с файлами на диске Windows — работайте с файлами внутри файловой системы Linux (например, в /home/user/project), а не в /mnt/c/. Это значительно повышает производительность.

• Ошибка «The Windows Subsystem for Linux optional component is not enabled» — включите компонент «Подсистема Windows для Linux» через optionalfeatures или DISM.

• Проблемы с сетью — проверьте настройки брандмауэра Windows, особенно если используете VPN. Иногда требуется сбросить сеть WSL командой wsl --shutdown.

FAQ

Вопрос: Можно ли использовать WSL2 без включения виртуализации? Нет, WSL2 требует аппаратной виртуализации. Если она недоступна, можно использовать WSL1, но он менее совместим.

Вопрос: Как удалить дистрибутив WSL? Выполните wsl --unregister <имя_дистрибутива>. Это удалит все данные дистрибутива.

Вопрос: Где хранятся файлы WSL2? В виртуальном диске ext4.vhdx, который обычно находится в %LocalAppData%\Packages\<имя_пакета>\LocalState\. Не редактируйте его напрямую.

Вопрос: Как изменить дистрибутив по умолчанию? Используйте wsl --set-default <имя_дистрибутива>.

Вопрос: Поддерживается ли systemd? Да, в последних версиях WSL2 можно включить systemd, добавив в /etc/wsl.conf секцию [boot] с параметром systemd=true.

Вопрос: Как обновить ядро WSL2? Выполните wsl --update в PowerShell от имени администратора.

Итог

WSL2 — мощный инструмент для разработчиков и администраторов, позволяющий использовать Linux в Windows 11 с минимальными накладными расходами. Следуя этому руководству, вы сможете установить WSL2, настроить дистрибутив, интегрировать его с Windows и избежать типичных ошибок. Экспериментируйте с настройками .wslconfig и wsl.conf, чтобы адаптировать среду под свои задачи.