Как настроить WSL: полное руководство по установке и настройке

Команда wsl --install в PowerShell, запущенном от имени администратора, — самый быстрый способ развернуть подсистему Windows для Linux: она включает нужные компоненты, устанавливает ядро WSL и дистрибутив Ubuntu по умолчанию. Если после перезагрузки терминал Linux не открывается или выдаёт ошибку, причина обычно кроется в отключённой виртуализации в BIOS/UEFI или в неактивных компонентах Windows.

WSL (Windows Subsystem for Linux) позволяет запускать Linux-окружение прямо внутри Windows без виртуальных машин и двойной загрузки. Это удобно разработчикам, тестировщикам и всем, кому нужны инструменты командной строки Linux — от bash и ssh до git, docker и пакетных менеджеров. Ниже разберём установку с нуля, выбор версии WSL 1 или WSL 2, базовую настройку дистрибутива и разбор типовых ошибок.

Проверка системных требований перед установкой

Перед установкой убедитесь, что система соответствует минимальным условиям. Для WSL 2 требуется Windows 10 версии 2004 (сборка 19041) и выше либо любая актуальная Windows 11, а также процессор с поддержкой аппаратной виртуализации. Проверить версию системы можно командой winver в диалоге «Выполнить» (Win + R).

Важный момент — виртуализация должна быть включена на уровне BIOS/UEFI. Откройте Диспетчер задач (Ctrl + Shift + Esc), перейдите на вкладку «Производительность» → «ЦП» и посмотрите строку «Виртуализация». Если там указано «Отключено», потребуется зайти в BIOS/UEFI и активировать Intel VT-x или AMD-V — название пункта зависит от производителя материнской платы, поэтому точный путь сверяйте с документацией к вашей плате или ноутбуку.

  • 🖥️ Windows 10 (сборка 19041+) или Windows 11 — обязательное условие для WSL 2
  • ⚙️ Включённая виртуализация (VT-x / AMD-V) в BIOS/UEFI
  • 💾 Несколько гигабайт свободного места на системном диске под дистрибутив
  • 👤 Права администратора для включения компонентов Windows

Быстрая установка WSL одной командой

На актуальных версиях Windows весь процесс сведён к одной команде. Откройте PowerShell или Терминал Windows от имени администратора и выполните:

wsl --install

Эта команда автоматически включает компоненты «Подсистема Windows для Linux» и «Платформа виртуальной машины», скачивает ядро WSL, устанавливает WSL 2 версией по умолчанию и ставит дистрибутив Ubuntu. После завершения обязательно перезагрузите компьютер — без этого компоненты не активируются.

После перезагрузки Ubuntu запустится автоматически и предложит создать имя пользователя и пароль для Linux-окружения. Этот пароль не связан с учётной записью Windows и будет запрашиваться при выполнении команд через sudo. Ввод пароля в терминале не отображается символами — это нормальное поведение Linux, а не зависание.

☑️ Проверка после установки WSL

Выполнено: 0 / 4

Ручная установка и включение компонентов

Если команда wsl --install недоступна (например, на старых сборках Windows 10), компоненты включаются вручную. В PowerShell от имени администратора по очереди выполните две команды:

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

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Затем перезагрузите ПК, скачайте и установите пакет обновления ядра WSL2 с официального сайта Microsoft и задайте WSL 2 версией по умолчанию:

wsl --set-default-version 2
⚠️ Внимание: не пропускайте перезагрузку между включением компонентов и установкой ядра. Без неё платформа виртуальной машины не запустится, и дистрибутив будет падать с ошибкой при первом старте.

После этого установите нужный дистрибутив из Microsoft Store — доступны Ubuntu, Debian, Kali Linux, openSUSE и другие. Список доступных вариантов можно посмотреть командой wsl --list --online, а установить конкретный — через wsl --install -d ИмяДистрибутива.

📊 Какой дистрибутив Linux вы используете в WSL?
Ubuntu
Debian
Kali Linux
Другой (openSUSE, Fedora Remix и т.п.)

WSL 1 или WSL 2: что выбрать

Две версии подсистемы отличаются архитектурой. WSL 1 транслирует системные вызовы Linux в вызовы Windows, а WSL 2 использует лёгкую виртуальную машину с настоящим ядром Linux. На практике разница ощущается в скорости и совместимости.

КритерийWSL 1WSL 2
Ядро LinuxЭмуляция вызововПолноценное ядро в VM
Скорость работы с файлами LinuxНижеЗаметно выше
Поддержка Docker и systemdОграниченнаяПолная (systemd — на свежих версиях)
Доступ к файлам WindowsБыстрыйМедленнее при работе с /mnt/c
Требования к виртуализацииНе требуетсяОбязательна

Переключить версию для уже установленного дистрибутива можно командой wsl --set-version ИмяДистрибутива 2. Конвертация занимает некоторое время, данные при этом сохраняются. Для большинства задач — веб-разработка, контейнеры, компиляция — предпочтителен именно WSL 2 с его полноценным ядром Linux.

Базовая настройка дистрибутива после установки

Свежая система требует минимальной доводки. Первым делом обновите пакеты — репозитории в образе могут быть устаревшими:

sudo apt update && sudo apt upgrade -y

Далее стоит настроить удобное окружение: установить нужные инструменты (git, curl, build-essential), настроить SSH-ключи для работы с репозиториями и при желании сменить оболочку на zsh. Все настройки хранятся внутри домашней директории Linux, поэтому эксперименты не затрагивают Windows.

  • 📦 Обновите пакеты сразу после первого запуска — это закрывает уязвимости базового образа
  • 🔑 Сгенерируйте SSH-ключ командой ssh-keygen для GitHub или GitLab
  • 📁 Работайте с проектами внутри файловой системы Linux (~/), а не в /mnt/c — так операции с файлами выполняются быстрее
  • 🧩 Установите Windows Terminal для удобной работы с несколькими вкладками и профилями

Тонкие параметры WSL 2 — объём выделяемой памяти, число процессорных ядер, подкачку — можно ограничить через файл .wslconfig в домашней папке пользователя Windows (C:\Users\Имя\.wslconfig). Это полезно, если виртуальная машина WSL забирает слишком много оперативной памяти: задайте, например, memory=4GB в секции [wsl2] и перезапустите подсистему командой wsl --shutdown.

Пример содержимого файла .wslconfig

[wsl2]

memory=4GB

processors=4

swap=2GB

После сохранения выполните wsl --shutdown и запустите дистрибутив заново — лимиты применятся при следующем старте.

Интеграция с Windows: файлы, VS Code и сеть

Одна из сильных сторон WSL — тесная связка с Windows. Из Linux доступна вся файловая система Windows через точки монтирования /mnt/c, /mnt/d и так далее. В обратную сторону файлы Linux открываются через сетевой путь \\wsl$ в Проводнике или командой explorer.exe . прямо из терминала Linux.

Для разработчиков ключевой инструмент — расширение WSL для Visual Studio Code. Оно позволяет открывать проекты из Linux-окружения, запускать отладку и терминал внутри дистрибутива, при этом сам редактор работает в Windows. Достаточно в терминале WSL перейти в папку проекта и выполнить code . — при первом запуске расширение установится автоматически.

По сети в WSL 2 сервисы, запущенные внутри Linux (например, dev-сервер на порту 3000), по умолчанию доступны из Windows через localhost. Это работает благодаря встроенному пробросу портов, и в большинстве сценариев дополнительной настройки не требуется.

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

Чаще всего проблемы возникают на этапе первого запуска. Ошибка вида «Please enable the Virtual Machine Platform» означает, что компонент платформы виртуальной машины не включён или не активирована виртуализация в BIOS/UEFI. Проверьте оба пункта по инструкции из первого раздела.

Если дистрибутив зависает при установке или wsl --install завершается с ошибкой сети, возможная причина — проблемы с доступом к серверам Microsoft Store. Попробуйте установить дистрибутив отдельно через wsl --install -d Ubuntu или из приложения Microsoft Store. Также убедитесь, что служба Служба поддержки виртуализации и связанные компоненты не отключены сторонними «оптимизаторами» системы.

⚠️ Внимание: утилиты для «отключения телеметрии и лишних служб Windows» нередко ломают компоненты, от которых зависит WSL. Если подсистема перестала работать после такой оптимизации, проверьте целостность системы командой sfc /scannow и состояние компонентов Windows.

Для сброса проблемного дистрибутива без переустановки всей подсистемы используется команда wsl --unregister ИмяДистрибутива — она полностью удаляет дистрибутив вместе с данными внутри него, после чего его можно поставить заново. Предварительно сохраните важные файлы, скопировав их в /mnt/c.

Как полностью переустановить WSL с нуля

1) wsl --unregister ИмяДистрибутива для каждого дистрибутива; 2) отключите компоненты «Подсистема Windows для Linux» и «Платформа виртуальной машины» в «Компонентах Windows»; 3) перезагрузите ПК; 4) выполните wsl --install заново. Все данные внутри дистрибутивов будут удалены.

FAQ: частые вопросы о настройке WSL

Чем WSL отличается от обычной виртуальной машины?

WSL 2 технически использует виртуализацию, но это лёгкая служебная VM с глубокой интеграцией в Windows: общий доступ к файлам, единый localhost, запуск Linux-программ из PowerShell и обратно. Настраивать гостевую ОС, сеть и общие папки вручную, как в VirtualBox или VMware, не требуется.

Можно ли установить несколько дистрибутивов одновременно?

Да. Установите их из Microsoft Store или командой wsl --install -d Имя. Все дистрибутивы живут независимо друг от друга, а посмотреть список установленных можно командой wsl -l -v. Запускается конкретный дистрибутив через wsl -d Имя или из меню «Пуск».

Где физически хранятся файлы дистрибутива?

Данные WSL 2 хранятся в виртуальном диске формата VHDX внутри профиля пользователя Windows. Напрямую редактировать файлы в обход механизмов WSL не стоит — для доступа из Windows используйте путь \\wsl$ в Проводнике.

Почему WSL 2 съедает много оперативной памяти?

Виртуальная машина WSL 2 динамически занимает память под задачи и кэш, но не всегда сразу возвращает её системе. Ограничить потребление можно через файл .wslconfig параметром memory, а освободить ресурсы без перезагрузки ПК — командой wsl --shutdown.

Работает ли в WSL графический интерфейс Linux-приложений?

В Windows 11 и актуальных сборках Windows 10 поддерживается WSLg — запуск графических Linux-приложений с выводом окон прямо на рабочий стол Windows. Достаточно установить GUI-приложение через пакетный менеджер и запустить его из терминала WSL. На старых версиях системы эта возможность может отсутствовать — проверьте актуальность обновлений Windows.