Руководство по установке подсистемы Windows для Linux в Windows 10

Возможны два варианта установки подсистемы Windows для Linux (WSL):

  • Упрощенная установка (предварительный выпуск) : wsl --install.

    Для выполнения упрощенной команды установки wsl --install нужно присоединиться к Программе предварительной оценки Windows и установить предварительную сборку Windows 10 (сборка ОС 20262 или более поздняя). При этом вам не потребуется выполнять шаги установки вручную. Все что нужно сделать — это открыть окно командной строки с правами администратора и запустить команду wsl --install. После перезапуска вы сможете использовать WSL.

  • Установка вручную : выполните приведенные ниже шаги.

    Ниже указаны шаги по установке WSL вручную, которые также можно использовать для установки Linux в любой версии Windows 10.

Примечание

Если во время установки возникла проблема, обратитесь к разделу Устранение неполадок установки в нижней части этой страницы.

Упрощенная установка для участников программы предварительной оценки Windows

Процесс установки подсистемы Windows для Linux был значительно улучшен в последних предварительных сборках Windows 10 для участников программы предварительной оценки Windows — приведенные ниже шаги, которые выполняются вручную, были заменены одной командой.

Чтобы использовать упрощенную команду установки wsl --install, вы должны:

  • присоединиться к Программе предварительной оценки Windows;
  • установить предварительную сборку Windows 10 (сборка ОС 20262 или более поздней версии);
  • открыть окно командной строки от имени администратора.

Если эти требования выполнены, выполните следующие действия, чтобы установить WSL:

  • В командной строке, открытой в режиме администратора, выполните команду wsl.exe --install.
  • Перезапустите компьютер.

При первом запуске недавно установленного дистрибутива Linux откроется окно консоли, и вам будет предложено подождать, чтобы файлы распаковались и сохранились на компьютере. Все будущие запуски должны занимать меньше секунды.

Затем необходимо будет создать учетную запись пользователя и пароль для нового дистрибутива Linux.

Поздравляем! Вы успешно установили и настроили дистрибутив Linux, который полностью интегрирован с операционной системой Windows.

Команда --install выполняет следующие действия:

  • включает дополнительные компоненты WSL и платформы виртуальных машин;
  • скачивает и устанавливает последнюю версию ядра Linux;
  • задает WSL 2 в качестве среды по умолчанию;
  • скачивает и устанавливает дистрибутив Linux (может потребоваться перезагрузка) .

По умолчанию в качестве устанавливаемого дистрибутива Linux используется Ubuntu. Чтобы изменить дистрибутив, используйте команду wsl --install -d <Distribution Name>. (Замените <Distribution Name> именем нужного дистрибутива.) Дополнительные дистрибутивы Linux можно добавить на компьютер после первоначальной установки — для этого выполните команду wsl --install -d <Distribution Name>.

Чтобы просмотреть список доступных дистрибутивов Linux, введите wsl --list --online.

Шаги по установке вручную

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

Шаг 1. Включение подсистемы Windows для Linux

Перед установкой дистрибутивов Linux в Windows необходимо включить дополнительный компонент "Подсистема Windows для Linux".

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

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

Теперь перейдите к шагу 2 и выполните обновление до WSL 2. Если вы хотите установить только WSL 1, вы можете перезагрузить компьютер и перейти к разделу Шаг 6. Установка дистрибутива Linux по выбору. Чтобы выполнить обновление до WSL 2, дождитесь перезагрузки компьютера и перейдите к следующему шагу.

Шаг 2. Проверка требований для запуска WSL 2

Для обновления до WSL 2 требуется Windows 10.

  • Для 64-разрядных систем: версия 1903 или более поздняя со сборкой 18362 или более поздней версии.
  • Для систем ARM64: версия 2004 или более поздняя со сборкой 19041 или более поздней версии.
  • Сборки ниже 18362 не поддерживают WSL 2. Для обновления версии Windows используйте помощник по обновлению Windows.

Чтобы проверить версию и номер сборки, нажмите клавиши Windows+R, введите winver и нажмите кнопку ОК. В меню "Параметры" выполните обновление до последней версии Windows.

Примечание

Если вы используете Windows 10 версии 1903 или 1909, в меню Windows откройте меню "Параметры", перейдите к разделу "Обновления и безопасность" и выберите "Проверить наличие обновлений". Номер сборки должен быть 18362.1049 и выше или 18363.1049 и выше с номером дополнительной сборки не ниже 1049. Подробнее: поддержка WSL 2 вскоре будет реализована в Windows 10 версий 1903 и 1909. См. инструкции по устранению неполадок.

Шаг 3. Включение компонента виртуальных машин

Перед установкой WSL 2 необходимо включить необязательный компонент Платформа виртуальных машин. Для использования этой функции на компьютере потребуются возможности виртуализации.

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

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

Перезапустите компьютер, чтобы завершить установку и обновление WSL до WSL 2.

Шаг 4. Скачивание пакета обновления ядра Linux

  1. Скачайте пакет последней версии:

    Примечание

    Если вы используете компьютер ARM64, вместо этого скачайте пакет ARM64. Если вы не знаете, какой тип компьютера используете, откройте командную строку или PowerShell и введите systeminfo | find "System Type". Предостережение. В версиях Windows на языках, отличающихся от английского, может потребоваться изменить текст поиска (например, на немецком языке это будет systeminfo | find "Systemtyp").

  2. Запустите пакет обновления, скачанный на предыдущем этапе. (Для запуска щелкните дважды. Появится запрос на повышение уровня разрешений. Нажмите кнопку "Да", чтобы утвердить эту установку.)

Когда установка завершится, перейдите к следующему шагу — выбору WSL 2 в качестве версии по умолчанию при установке новых дистрибутивов Linux. (Пропустите этот шаг, если вы хотите, чтобы новые дистрибутивы Linux были установлены в WSL 1).

Примечание

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

Шаг 5. Выбор WSL 2 в качестве версии по умолчанию

Откройте PowerShell и выполните следующую команду, чтобы задать WSL 2 в качестве версии по умолчанию при установке нового дистрибутива Linux:

wsl --set-default-version 2

Шаг 6. Установка дистрибутива Linux по выбору

  1. Откройте Microsoft Store и выберите предпочтительный дистрибутив Linux.

    Представление дистрибутивов Linux в Microsoft Store

    Ниже приведены ссылки на страницы Microsoft Store для каждого дистрибутива:

  2. На странице дистрибутива щелкните "Получить".

    Дистрибутивы Linux в Microsoft Store

При первом запуске недавно установленного дистрибутива Linux откроется окно консоли, и вам будет предложено подождать минуту или две, чтобы файлы распаковались и сохранились на компьютере. Все будущие запуски должны занимать меньше секунды.

Затем необходимо будет создать учетную запись пользователя и пароль для нового дистрибутива Linux.

Распаковка Ubuntu в консоли Windows

Поздравляем! Вы успешно установили и настроили дистрибутив Linux, который полностью интегрирован с операционной системой Windows.

Установка Терминала Windows (необязательно)

В Терминале Windows можно использовать несколько вкладок (чтобы быстро переходить между несколькими командными строками Linux, командной строкой Windows, PowerShell, Azure CLI и пр.), создавать пользовательские сочетания клавиш (для открытия и закрытия вкладок, копирования и вставки и пр.), а также применять функцию поиска и пользовательские темы (цветовые схемы, стили и размеры шрифтов, а также фоновое изображение, размытие и прозрачность). Подробнее.

Установка Терминала Windows

Терминал Windows

Установите вашу версию дистрибутива на WSL 1 или WSL 2

Вы можете проверить версию WSL, назначенную каждому из установленных дистрибутивов Linux, открыв командную строку PowerShell и введя команду (доступна только в сборке Windows 18362 или выше): wsl -l -v.

wsl --list --verbose

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

wsl --set-version <distribution name> <versionNumber>

Не забудьте заменить <distribution name> на фактическое имя дистрибутива и <versionNumber> с номером "1" или "2". Вы можете всегда вернуться к WSL версии 1, выполнив эту команду и заменив "2" на "1".

Примечание

Обновление с WSL 1 до WSL 2 может занять несколько минут в зависимости от размера целевого дистрибутива. Если вы используете устаревшую установку WSL 1 из Юбилейного обновления Windows 10 или обновления Creators Update, может возникнуть ошибка обновления. Выполните эти инструкции, чтобы удалить устаревшие дистрибутивы.

Если wsl --set-default-version выполняется как недопустимая команда, введите wsl --help. Если --set-default-version нет в списке, это указывает на отсутствие поддержки в ОС. Вам нужно выполнить обновление до версии 1903, сборки 18362 или выше. Если вы используете сборку 19041 для ARM64, эта команда может завершиться ошибкой при использовании PowerShell. В этом случае можно использовать командную строку вместо выполнения команды wsl.exe.

После выполнения команды может появиться следующее сообщение: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. Это значит, что вам по-прежнему нужно установить пакет обновления MSI для ядра Linux.

Кроме того, если вы хотите сделать WSL 2 архитектурой по умолчанию, выполните следующую команду:

wsl --set-default-version 2

Будет установлена версия любого нового дистрибутива, установленного в WSL 2.

Устранение неполадок установки

Ниже перечислены возможные ошибки и способы их устранения. Другие распространенные ошибки и способы их устранения приведены в разделе Устранение неполадок подсистемы Windows для Linux.

  • Сбой установки с ошибкой 0x80070003

    • Подсистема Windows для Linux работает только на системном диске (обычно это диск C:). Убедитесь, что дистрибутивы хранятся на системном диске.
    • Выберите Параметры -> **Система --> Хранилище -> Другие параметры хранилища: Изменить место сохранения нового содержимого. Изображение параметров системы для установки приложений на диске C:
  • Сбой WslRegisterDistribution с ошибкой 0x8007019e

    • Дополнительный компонент "Подсистема Windows для Linux" не включен.
    • Выберите Панель управления -> Программы и компоненты -> Включение или отключение компонентов Windows и установите флажок Подсистема Windows для Linux или используйте командлет PowerShell, упомянутый в начале этой статьи.
  • Сбой установки с ошибкой 0x80070003 или ошибкой 0x80370102.

    • Убедитесь, что в BIOS вашего компьютера включена виртуализация. Расположение этого параметра зависит от компьютера, но обычно он находится в разделе настроек ЦП в BIOS.
    • Для WSL2 требуется, чтобы ЦП поддерживал функцию преобразования адресов второго уровня (SLAT), которая появилась в процессорах Intel Nehalem (Intel Core 1-го поколения) и AMD Opteron. Более старые ЦП (например, Intel Core 2 Duo) не смогут запускать WSL2, даже если платформа виртуальной машины успешно установлена.
  • При попытке обновления возникает ошибка Invalid command line option: wsl --set-version Ubuntu 2.

    • Убедитесь, что у вас включена подсистема Windows для Linux и используется сборка Windows 18362 или выше. Чтобы включить WSL, выполните эту команду в командной строке PowerShell с правами администратора: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.
  • Запрошенную операцию не удалось выполнить из-за ограничения системы виртуального диска. Файлы виртуального жесткого диска должны быть распакованными, незашифрованными и не разреженными.

    • Снимите флажок Compress contents (Сжимать содержимое) (а также флажок Encrypt contents (Шифровать содержимое), если он установлен), открыв папку профиля для дистрибутива Linux. Он должен находиться в подпапке файловой системы Windows, для примера: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited....
    • В этом профиле дистрибутива Linux должна находиться папка LocalState. Щелкните эту папку правой кнопкой мыши, чтобы отобразить меню параметров. Выберите Properties (Свойства) > Advanced (Дополнительно) и убедитесь, что флажки Compress contents to save disk space (Сжимать содержимое для экономии места на диске) и Encrypt contents to secure data (Шифровать содержимое для защиты данных) не установлены. Если вы увидите запрос на применение параметров к текущей папке или ко всем вложенным папкам и файлам, выберите вариант только для текущей папки, так как вы очищаете только флаг сжатия. После этого команда wsl --set-version будет работать правильно.

Снимок экрана с параметрами свойств дистрибутива WSL

Примечание

В этом примере папка LocalState для дистрибутива Ubuntu 18.04 расположена по адресу C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

Чтобы получать обновленные сведения, проверьте ветку № 4103 в документации GitHub WSL, где отслеживается эта проблема.

  • Термин WSL не распознан как имя командлета, функции, файла скрипта или действующей программы.

    • Убедитесь, что установлен дополнительный компонент Подсистема Windows для Linux. Кроме того, эта ошибка возникнет, если вы используете устройство ARM64 и выполняете эту команду в PowerShell. Вместо этого запустите wsl.exe из PowerShell Core или командной строки.
  • Error: This update only applies to machines with the Windows Subsystem for Linux (Ошибка. Это обновление применяется только к компьютерам с подсистемой Windows для Linux).

    • Чтобы установить пакет обновления MSI для ядра Linux, нужно сначала включить WSL. В случае сбоя отображается следующее сообщение: This update only applies to machines with the Windows Subsystem for Linux.
    • Есть три возможные причины, по которым вы видите это сообщение:
    1. Вы используете старую версию Windows, которая не поддерживает WSL 2. Требования к версиям и ссылки пакеты обновления см. на шаге 2.

    2. Компонент WSL не включен. Необходимо вернуться к шагу 1 и убедиться, что на компьютере включен необязательный компонент WSL.

    3. Когда он будет включен, перезагрузите компьютер, чтобы изменения вступили в силу, и повторите попытку.

  • Error: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel . (Ошибка. Для WSL 2 требуется обновление компонента ядра. Дополнительные сведения см. здесь: https://aka.ms/wsl2kernel ).

    • Эта ошибка возникает, если пакет ядра Linux отсутствует в папке %SystemRoot%\system32\lxss\tools. Чтобы устранить ошибку, установите пакет обновления MSI для ядра Linux, как описано на шаге 4 в этих инструкциях по установке. Возможно, вам потребуется удалить пакет MSI в разделе Установка и удаление программ, а затем снова установить его.