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

Установка подсистемы Windows для LinuxInstall the Windows Subsystem for Linux

Перед установкой дистрибутивов Linux в Windows необходимо включить дополнительный компонент "Подсистема Windows для Linux".Before installing any Linux distributions on Windows, you must enable the "Windows Subsystem for Linux" optional feature.

Запустите PowerShell с правами администратора и выполните следующую команду.Open PowerShell as Administrator and run:

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

Чтобы установить только WSL 1, необходимо перезагрузить компьютер и перейти к пункту Install your Linux distribution of choice (Установить дистрибутив Linux), в противном случае дождитесь перезапуска и переходите к обновлению до WSL 2.To only install WSL 1, you should now restart your machine and move on to Install your Linux distribution of choice, otherwise wait to restart and move on to update to WSL 2. Узнайте больше о сравнении WSL 2 и WSL 1.Read more about Comparing WSL 2 and WSL 1.

Обновление до WSL 2Update to WSL 2

Чтобы выполнить обновление до WSL 2, необходимо выполнить следующие условия:To update to WSL 2, you must meet the following criteria:

Включение необязательного компонента "Virtual Machine Platform" (Платформа виртуальной машины)Enable the 'Virtual Machine Platform' optional component

Перед установкой WSL 2 необходимо включить необязательный компонент "Virtual Machine Platform" (Платформа виртуальных машин).Before installing WSL 2, you must enable the "Virtual Machine Platform" optional feature.

Запустите PowerShell с правами администратора и выполните следующую команду.Open PowerShell as Administrator and run:

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

Перезапустите компьютер, чтобы завершить установку и обновление WSL до WSL 2.Restart your machine to complete the WSL install and update to WSL 2.

Задать WSL 2 в качестве версии по умолчаниюSet WSL 2 as your default version

Выполните следующую команду в PowerShell, чтобы задать WSL 2 в качестве версии по умолчанию при установке нового дистрибутива Linux:Run the following command in PowerShell to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

После выполнения этой команды может появиться следующее сообщение: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel.You might see this message after running that command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. Перейдите по ссылке (https://aka.ms/wsl2kernel) и установите MSI-файл с этой страницы документации, чтобы установить на компьютере ядро Linux для WSL 2.Please follow the link (https://aka.ms/wsl2kernel) and install the MSI from that page on our documentation to install a Linux kernel on your machine for WSL 2 to use. После установки ядра выполните команду еще раз. Она должна успешно завершиться без отображения сообщения.Once you have the kernel installed, please run the command again and it should complete successfully without showing the message.

Примечание

Обновление с WSL 1 до WSL 2 может занять несколько минут в зависимости от размера целевого дистрибутива.The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Если вы используете устаревшую установку WSL 1 из Юбилейного обновления Windows 10 или обновления Creators Update, может возникнуть ошибка обновления.If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. Выполните эти инструкции, чтобы удалить устаревшие дистрибутивы.Follow these instructions to uninstall and remove any legacy distributions.

Если wsl --set-default-version выполняется как недопустимая команда, введите wsl --help.If wsl --set-default-version results as an invalid command, enter wsl --help. Если --set-default-version нет в списке, это указывает на отсутствие поддержки в ОС. Вам нужно выполнить обновление до версии 2004, сборка 19041 или более поздней.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 2004, Build 19041 or higher.

Установка дистрибутива Linux по выборуInstall your Linux distribution of choice

  1. Откройте Microsoft Store и выберите предпочтительный дистрибутив Linux.Open the Microsoft Store and select your favorite Linux distribution.

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

    Ниже приведены ссылки на страницы Microsoft Store для каждого дистрибутива:The following links will open the Microsoft store page for each distribution:

  2. На странице дистрибутива щелкните "Получить".From the distribution's page, select "Get".

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

Настройка нового дистрибутиваSet up a new distribution

При первом запуске недавно установленного дистрибутива Linux откроется окно консоли, и вам будет предложено подождать минуту или две, чтобы файлы распаковались и сохранились на компьютере.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. Все будущие запуски должны занимать меньше секунды.All future launches should take less than a second.

Затем необходимо будет создать учетную запись пользователя и пароль для нового дистрибутива Linux.You will then need to create a user account and password for your new Linux distribution.

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

Установите вашу версию дистрибутива на WSL 1 или WSL 2Set your distribution version to WSL 1 or WSL 2

Вы можете проверить версию WSL, назначенную каждому из установленных дистрибутивов Linux, открыв командную строку PowerShell и введя команду (доступна только в сборке Windows 19041 или более поздней версии): wsl -l -v.You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 19041 or higher): wsl -l -v

wsl --list --verbose

Чтобы настроить дистрибутив для одной из версий WSL, выполните:To set a distribution to be backed by either version of WSL please run:

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

Не забудьте заменить <distribution name> на фактическое имя дистрибутива и <versionNumber> с номером "1" или "2".Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. Вы можете всегда вернуться к WSL версии 1, выполнив эту команду и заменив "2" на "1".You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

Кроме того, если вы хотите сделать WSL 2 архитектурой по умолчанию, выполните следующую команду:Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

Будет установлена версия любого нового дистрибутива, установленного в WSL 2.This will set the version of any new distribution installed to WSL 2.

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

Ниже перечислены возможные ошибки и способы их устранения.Below are related errors and suggested fixes. Другие распространенные ошибки и способы их устранения приведены в разделе Устранение неполадок подсистемы Windows для Linux.Refer to the WSL troubleshooting page for other common errors and their solutions.

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

    • Подсистема Windows для Linux работает только на системном диске (обычно это диск C:).The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Убедитесь, что дистрибутивы хранятся на системном диске.Make sure that distributions are stored on your system drive:
    • Выберите Параметры -> Хранилище -> More Storage Settings: (Другие параметры хранилища:) Изменить место сохранения нового содержимого. Изображение параметров системы для установки приложений на диске C:Open Settings -> Storage -> More Storage Settings: Change where new content is saved Picture of system settings to install apps on C: drive
  • Сбой WslRegisterDistribution с ошибкой 0x8007019eWslRegisterDistribution failed with error 0x8007019e

    • Дополнительный компонент "Подсистема Windows для Linux" не включен.The Windows Subsystem for Linux optional component is not enabled:
    • Выберите Панель управления -> Программы и компоненты -> Включение или отключение компонентов Windows и установите флажок Подсистема Windows для Linux или используйте командлет PowerShell, упомянутый в начале этой статьи.Open Control Panel -> Programs and Features -> Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.
  • Сбой установки с ошибкой 0x80070003 или ошибкой 0x80370102.Installation failed with error 0x80070003 or error 0x80370102

    • Убедитесь, что в BIOS вашего компьютера включена виртуализация.Please make sure that virtualization is enabled inside of your computer's BIOS. Расположение этого параметра зависит от компьютера, но обычно он находится в разделе настроек ЦП в BIOS.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
  • При попытке обновления возникает ошибка Invalid command line option: wsl --set-version Ubuntu 2.Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Убедитесь, что у вас включена подсистема Windows для Linux и используется сборка Windows 19041 или более поздней версии.Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 19041 or higher. Чтобы включить WSL, выполните эту команду в командной строке PowerShell с правами администратора: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.To enable WSL run this command in a PowerShell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux. Полную инструкцию по установке WSL см. здесь.You can find the full WSL install instructions here.
  • Запрошенную операцию не удалось выполнить из-за ограничения системы виртуального диска. Файлы виртуального жесткого диска должны быть распакованными, незашифрованными и не разреженными.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.

    • Чтобы получать обновленные сведения, проверьте поток GitHub WSL № 4103, где отслеживается эта проблема.Please check WSL GitHub thread #4103 where this issue is being tracked for updated information.
  • Термин WSL не распознан как имя командлета, функции, файла скрипта или действующей программы.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.

    • Убедитесь, что установлен дополнительный компонент Подсистема Windows для Linux.Ensure that the Windows Subsystem for Linux Optional Component is installed. Кроме того, эта ошибка возникнет, если вы используете устройство ARM64 и выполняете эту команду в PowerShell.Additionally, if you are using an ARM64 device and running this command from PowerShell, you will receive this error. Вместо этого запустите wsl.exe из PowerShell Core или командной строки.Instead run wsl.exe from PowerShell Core, or Command Prompt.