====== Windows Subsystem for Linux ======

----

{{infobox>
name = Windows Subsystem for Linux
image = :windows:windows_subsystem_for_linux_logo.png
Разработчик: = Microsoft
Лицензия: = GNU GPL v2 и проприетарная
Написан на: = C++
Операционная система = Windows 10 и Windows 11
Язык интерфейса: = Многоязычный в числе и Русский
Дата выпуска: = 2 Августа 2016 года
Последняя версия: = 3.0.3
Дата последнего релиза: = 9 Октября 2026 года
Репозиторий на GitHub: = https://github.com/microsoft/WSL \\ https://github.com/microsoft/WSLg \\ https://github.com/microsoft/WSL2-Linux-Kernel
Веб-сайт: = https://learn.microsoft.com/windows/wsl
<infobox}}

===== О Windows Subsystem for Linux =====

Windows Subsystem for Linux (WSL) - Это слой совместимости, разработанный корпорацией Microsoft, который позволяет запускать среду Linux и нативные Linux-приложения непосредственно в операционных системах Windows 10/11. WSL была впервые представлена в 2016 году и активно развивается по сей день.

WSL существует в двух версиях. WSL 1 - Реализована как тонкий слой совместимости в ядре Windows. Она переводит системные вызовы Linux (syscalls) в вызовы ядра Windows. Это обеспечивает высокую интеграцию с файловой системой Windows, но имеет ограничения в поддержке специфичных системных вызовов. WSL 2 - Использует легковесную виртуальную машину с полноценным, скомпилированным ядром Linux. Это обеспечивает полную совместимость с Linux (включая запуск Docker) и значительно ускоряет операции с файловой системой, особенно при работе с проектами внутри Linux-окружения.

===== Установка Windows Subsystem for Linux =====

==== Включение виртуализации в BIOS  ====

Чтобы компоненты WSL могли работать на компьютере, необходимо убедиться в том, что в настройках BIOS включена поддержка аппаратной виртуализации.

Во время загрузки компьютера с помощью клавиши, определенной производителем (обычно одна из следующих: "Esc", "Del", "F2", "F9", "F10"), заходим в настройки BIOS.

Данный пункт настроек может иметь следующее наименование и располагаться в разделе:

**System Configuration -> Virtualization Technology -> Enabled**

Или, например:

**Advanced -> Virtualization Technology -> Enabled**


==== Включение компонентов ====

После того, как поддержка аппаратной виртуализации активирована, запускам ОС Windows. Поставим "галочки" в соответствующем разделе Панели управления Windows, чтобы активировать WSL.

**Панель управления -> Программы -> Включение или отключение компонентов Windows -> Подсистема Windows для Linux**

**Панель управления -> Программы -> Включение или отключение компонентов Windows -> Платформа виртуальной машины**

После этого Windows загрузит необходимые компоненты и попросит перезагрузить компьютер. Перезагружаем компьютер.

Важно!
При установке WSL на виртуальную машину, нужно выставить флаги виртуализации ЦП для виртуальной машины. Например, если вы устанавливаете WSL на виртуализированную Windows, запущенную в Hyper-V с именем MyWSL, эту команду нужно выполнить на узле виртуализации, а не на виртуальной машине. Для ее выполнения нужна командная строка PowerShell с повышенными привилегиями. Замените MyWSL на имя вашей виртуальной машины в Hyper-V:
<code powershell>
Set-VMProcessor -VMName MyWSL -ExposeVirtualizationExtensions $true
</code>

Включение компонента WSL:
<code powershell>
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
</code>

Включение платформы виртуальных машин в Windows. Эта команда разрешит использовать второе поколение WSL, что даст возможность Windows установить Linux с помощью Hyper-V.
<code powershell>
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
</code>

Перезагрузите ПК.

==== Установка WSL ====

  * [[https://learn.microsoft.com/ru-ru/windows/wsl/install-manual|Инструкции по установке вручную для более старых версий WSL]]

Скачайте пакет обновления ядра WSL2.

  * [[https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi|Пакет обновления ядра Linux WSL2 для компьютеров x64]]
  * [[https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_arm64.msi|Пакет обновления ядра Linux WSL2 для компьютеров ARM64]]

Установка WSL:
<code powershell>
wsl --install
</code>

Проверка статуса WSL:
<code powershell>
wsl --status
</code>

==== Обновление WSL ====

Обновить WSL:
<code powershell>
wsl --update
</code>

Вернутся к предыдущей версии (ядру) WSL:
<code powershell>
wsl --update rollback
</code>

==== Использование WSL ====

Если у вас не работает 2-я WSL по той или иной причине, включите 1-ю версию.

Включение WSL 1 по умолчанию:
<code powershell>
wsl --set-default-version 1
</code>

Включение WSL 2 по умолчанию:
<code powershell>
wsl --set-default-version 2
</code>

Переключить дистрибутив на WSL 1:
<code powershell>
wsl --set-version <Дистрибутив> 1
</code>

Переключить дистрибутив на WSL 2:
<code powershell>
wsl --set-version <Дистрибутив> 2
</code>

Просмотр списка доступных дистрибутивов Linux для скачивания через магазин Microsoft Store:
<code powershell>
wsl --list --online
</code>

Просмотр списка установленных дистрибутивов в подсистеме WSL:
<code powershell>
wsl -l -v
</code>

Установка дистрибутива:
<code powershell>
wsl --install -d Имя_дистрибутива
</code>

Изменить дистрибутив по-умолчанию:
<code powershell>
wsl --setdefault Имя_дистрибутива
</code>

Удаление отдельного дистрибутива:
<code powershell>
wsl --unregister Имя_дистрибутива 
</code>

Откройте Проводник и адресную строку вставьте **\\wsl$**.

Вход в сетевой каталог WSL:
<code>
\\wsl$
</code>

Завершить среду WSL со всеми запущенными дистрибутивами:
<code powershell>
wsl --shutdown
</code>

Завершить работу конкретного дистрибутива:
<code powershell>
wsl --terminate Имя_дистрибутива
</code>

Зайти в WSL Ubuntu под root и сбросить пароль:
<code powershell>
ubuntu config --default-user root
</code>

<code powershell>
Passwd
</code>

Вернуть пользователя по умолчанию:
<code powershell>
ubuntu config --default-user Имя_пользователя
</code>