Как установить Linux в Windows 10

Действия по установке для старых версий WSL вручную

Для простоты мы обычно советуем применять wsl —install для установки подсистемы Windows для Linux, но если вы используете более старую сборку Windows, эта команда может не поддерживаться. Этапы установки вручную описаны ниже. Если во время установки возникла проблема, см. раздел Установка руководства по устранению неполадок.

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

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

Запустите PowerShell от имени администратора (меню «Пуск» > 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.

• Для систем x64: версия 1903 или более поздняя со сборкой 18362 или более поздней версии.
• Для систем ARM64: версия 2004 или более поздняя со сборкой 19041 или более поздней версии.

Либо Windows 11.

Сборки ниже 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. Скачайте пакет последней версии:
   • Пакет обновления ядра Linux в WSL 2 для 64-разрядных компьютеров.

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

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

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

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

wsl --set-default-version 2 

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

1. Откройте Microsoft Store и выберите предпочтительный дистрибутив Linux. Ниже приведены ссылки на страницы Microsoft Store для каждого дистрибутива:
   • Ubuntu 18.04 LTS
   • Ubuntu 20.04 LTS
   • Ubuntu 22.04 LTS
   • openSUSE Leap 15.1
   • SUSE Linux Enterprise Server 12 SP5
   • SUSE Linux Enterprise Server 15 SP1
   • Kali Linux
   • Debian GNU/Linux
   • Fedora Remix for WSL
   • Pengwin
   • Pengwin Enterprise
   • Alpine WSL
   • Raft (пробная версия)
2. На странице дистрибутива щелкните «Получить».

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

ПОЗДРАВЛЯЕМ! Вы успешно установили и настроили дистрибутив Linux, который полностью интегрирован с операционной системой Windows.

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

Если во время установки возникла проблема, см. раздел Установка руководства по устранению неполадок.

Скачивание дистрибутивов

Бывают сценарии, когда вы не можете (или не хотите) устанавливать дистрибутивы WSL Linux с помощью Microsoft Store. Вы можете использовать номер SKU классической ОС Windows Server или Long-Term Servicing (LTSC), который не поддерживает Microsoft Store, или политики корпоративной сети и административные параметры запрещают использовать Microsoft Store в вашей среде. В таких случаях, хотя WSL можно использовать, возможно, потребуется загрузить дистрибутивы Linux напрямую.

Если приложение Microsoft Store недоступно, вы можете скачать и вручную установить дистрибутивы Linux, используя следующие ссылки:

• Ubuntu
• Ubuntu 22.04 LTS
• Ubuntu 20.04
• Ubuntu 20.04 ARM
• Ubuntu 18.04
• Ubuntu 18.04 ARM
• Ubuntu 16.04
• Debian GNU/Linux
• Kali Linux
• SUSE Linux Enterprise Server 12
• SUSE Linux Enterprise Server 15 с пакетом обновления 2 (SP2)
• SUSE Linux Enterprise Server 15 с пакетом обновления 3
• openSUSE Tumbleweed
• openSUSE Leap 15.3
• openSUSE Leap 15.2
• Oracle Linux 8.5
• Oracle Linux 7.9
• Fedora Remix for WSL

Это приведет к скачиванию пакетов .appx в выбранную папку.

Кроме того, при желании вы можете скачать предпочтительные дистрибутивы с помощью командной строки, используя командлет PowerShell Invoke-WebRequest. Например, для скачивания Ubuntu 20.04:

Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing 

Если загрузка занимает много времени, выключите индикатор выполнения, задав $ProgressPreference = ‘SilentlyContinue’ .

Кроме того, вы можете использовать служебную программу командной строки для скачивания. Чтобы скачать Ubuntu 20.04 с помощью curl:

curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004 

В этом примере выполняется curl.exe (а не только curl ), чтобы в PowerShell вызывался реальный исполняемый файл curl, а не его псевдоним для Invoke-WebRequest в PowerShell.

После скачивания дистрибутива перейдите к папке со скачанным файлом и выполните следующую команду в этом каталоге, где app-name — имя APPX-файла дистрибутива Linux.

Add-AppxPackage .\app_name.appx 

Когда загрузка пакета Appx завершится, вы можете запустить новый дистрибутив, дважды щелкнув файл appx. (Команда wsl -l не покажет, что дистрибутив установлен, пока этот шаг не будет завершен.)

Если вы используете Windows Server или у вас возникли проблемы с выполнением приведенной выше команды, можно найти альтернативные инструкции по установке на странице документации Windows Server, чтобы установить файл .appx , изменив его на ZIP-файл.

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

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

Установка Linux на Windows с помощью WSL

Предварительные требования

Для использования приведенных ниже команд необходимо использовать Windows 10 версии 2004 и более поздних версий (сборка 19041 и более поздних версий) или Windows 11. Если вы используете более ранние версии, см. страницу установки вручную.

Команда установки WSL

Теперь вы можете установить все необходимое для запуска WSL с помощью одной команды. Откройте PowerShell или командную строку Windows в режиме администратора , щелкнув правой кнопкой мыши и выбрав «Запуск от имени администратора», введите команду wsl —install, а затем перезапустите компьютер.

wsl --install 

Эта команда включит функции, необходимые для запуска WSL и установки дистрибутива Ubuntu для Linux. (Этот дистрибутив по умолчанию можно изменить.)

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

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

Приведенная выше команда работает, только если WSL не установлена вообще. Если вы выполнили wsl —install и видите текст справки WSL, попробуйте выполнить wsl —list —online , чтобы просмотреть список доступных дистрибутивов. Затем выполните wsl —install -d для установки дистрибутива. Сведения об удалении WSL см. в разделе Удаление устаревшей версии WSL или Отмена регистрации или удаление дистрибутива Linux.

Изменение установленного дистрибутива Linux по умолчанию

По умолчанию в качестве устанавливаемого дистрибутива Linux используется Ubuntu. Для этого используйте флаг -d .

• Чтобы изменить установленный дистрибутив, введите wsl —install -d . Замените именем дистрибутива, который хотите установить.
• Чтобы просмотреть список доступных дистрибутивов Linux, доступных для скачивания через Интернет-магазин, введите wsl —list —online или wsl -l -o .
• Чтобы установить дополнительные дистрибутивы Linux после исходной установки, можно также использовать команду wsl —install -d .

Если вы хотите установить дополнительные дистрибутивы из командной строки Linux или Bash (а не из PowerShell или командной строки), используйте .exe в команде wsl.exe —install -d . Чтобы получить список доступных дистрибутивов, используйте wsl.exe -l -o .

Если во время установки возникла проблема, см. раздел Установка руководства по устранению неполадок.

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

Настройка сведений о пользователе Linux

После установки WSL необходимо создать учетную запись пользователя и пароль для установленного дистрибутива Linux. Дополнительные сведения см. в статье Рекомендации по настройке среды разработки WSL.

Советы и рекомендации

Мы рекомендуем использовать наше пошаговое руководство Рекомендации по настройке среды разработки WSL. В нем описано, как настроить имя пользователя и пароль для установленных дистрибутивов Linux, использовать основные команды WSL, установить и настроить Терминал Windows, настроить управление версиями Git, отредактировать код и выполнить отладку с помощью удаленного сервера VS Code. Кроме того, в руководстве приведены рекомендации по хранению файлов, настройке базы данных, подключению внешнего диска, настройке ускорения GPU и пр.

Проверьте, какая версия WSL запущена

Вы можете получить список установленных распределений Linux и проверить версию WSL, задав команду wsl -l -v в PowerShell или в Командной строке Windows.

Чтобы задать значение WSL 1 или WSL 2 для версии по умолчанию при установке нового распределения Linux, используйте команду wsl —set-default-version , заменив на 1 или 2.

Чтобы определить распределение Linux по умолчанию для использования с командой wsl , введите wsl -s или wsl —setdefault , заменив именем распределения Linux, который вы хотите использовать. Например, в PowerShell или CMD введите wsl -s Debian , чтобы задать для распределения значение по умолчанию — Debian. Теперь запуск wsl npm init в PowerShell приведет к выполнению npm init команды в Debian.

Чтобы запустить определенное распределение WSL из PowerShell или Командной строки Windows без изменения распределения по умолчанию, выполните команду wsl -d , заменив именем распределения, которое вы хотите использовать.

Дополнительные сведения см. в руководстве по основным командам для WSL.

Обновление версии WSL 1 до WSL 2

Для новых установок Linux, выполненных с помощью команды wsl —install , по умолчанию будет задано WSL 2.

С помощью команды wsl —set-version можно перейти с версии WSL 2 на WSL 1 или обновить ранее установленные дистрибутивы Linux с версии WSL 1 до WSL 2.

Чтобы проверить, какая установлена версия распределения Linux — WSL 1 или WSL 2, — выполните команду wsl -l -v .

Для изменения версий выполните команду wsl —set-version 2 , заменив именем дистрибутива Linux, который требуется обновить. Например, команда wsl —set-version Ubuntu-20.04 2 настроит распределение Ubuntu 20,04 на использование WSL 2.

Если вы установили WSL вручную, до того как команда wsl —install стала доступна, возможно, вам также потребуется включить необязательный компонент виртуальной машины, используемый WSL 2, и установить пакет ядра, если это еще не сделано.

Список команд WSL см. в справочнике по командам для WSL; рекомендации по использованию одной из версий в рабочем сценарии см. в статье со сравнением WSL 1 и WSL 2; для получения общих сведений о настройке надлежащего рабочего процесса разработки с помощью WSL ознакомьтесь с рекомендациями по настройке среды разработки WSL.

Способы запуска нескольких распределений Linux с помощью WSL

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

Существует несколько способов запуска распределений Linux после их установки:

1. Установка Терминала Windows(Рекомендовано). Использование Терминала Windows поддерживает необходимое для установки количество командных строк и позволяет открывать их в нескольких вкладках или областях окна, а также быстро переключаться между несколькими распределениями Linux или другими командными строками (PowerShell, Командной строкой, PowerShell, Azure CLI и т. д.). Вы можете полностью настроить терминал, используя уникальные цветовые схемы, стили шрифтов, размеры, фоновые изображения и пользовательские сочетания клавиш. Подробнее.
2. Вы можете напрямую открыть распределение Linux, для этого откройте меню «Пуск» Windows и введите имя установленного распределения. Например, «Ubuntu». После этого Ubuntu откроется в собственном окне консоли.
3. В Командной строке Windows или PowerShell можно ввести имя установленного распределения. Пример: ubuntu
4. Из PowerShell или командной строки Windows можно открыть распределение Linux по умолчанию в текущей командной строке, введя wsl.exe .
5. Из PowerShell или командной строки Windows можно использовать распределение Linux по умолчанию в текущей командной строке без ввода новой, введя команду wsl [command] . Замена [command] командой WSL, например wsl -l -v для вывода списка установленных распределений или wsl pwd , чтобы узнать место подключения текущего пути к каталогу в WSL. В PowerShell команда get-date предоставит дату из файловой системы Windows, а wsl date предоставит дату из файловой системы Linux.

Выбранный метод должен зависеть от ваших действий. Если вы открыли командную строку WSL в Командной строке Windows или окне PowerShell и хотите выйти, введите команду exit .

Хотите испытать новейшие предварительные версии функций WSL?

Чтобы поработать с самыми последними функциями или обновлениями для WSL, присоединитесь к Программе предварительной оценки Windows. Когда вы присоединитесь к участникам Программы предварительной оценки Windows, вы сможете выбрать канал для получения предварительных сборок в меню параметров Windows и будете автоматически получать предварительные версии функций и обновления для WSL, связанные с этой сборкой. Можно выбрать одно из следующих значений.

• Канал разработчика: последние обновления, но низкая стабильность.
• Бета-канал: идеально подходит для ранних последователей; более надежные сборки, чем в канале разработки.
• Канал предварительного выпуска: предварительные версии исправлений и основных функций следующей версии Windows непосредственно перед предоставлением их общедоступной версии.

Дополнительные ресурсы

• Блог, посвященный командной строке Windows: установка WSL с помощью одной команды теперь поддерживается в Windows 10 версии 2004 и выше

Install Linux on Windows with WSL

Developers can access the power of both Windows and Linux at the same time on a Windows machine. The Windows Subsystem for Linux (WSL) lets developers install a Linux distribution (such as Ubuntu, OpenSUSE, Kali, Debian, Arch Linux, etc) and use Linux applications, utilities, and Bash command-line tools directly on Windows, unmodified, without the overhead of a traditional virtual machine or dualboot setup.

Prerequisites

You must be running Windows 10 version 2004 and higher (Build 19041 and higher) or Windows 11 to use the commands below. If you are on earlier versions please see the manual install page.

Install WSL command

You can now install everything you need to run WSL with a single command. Open PowerShell or Windows Command Prompt in administrator mode by right-clicking and selecting «Run as administrator», enter the wsl —install command, then restart your machine.

wsl --install 

This command will enable the features necessary to run WSL and install the Ubuntu distribution of Linux. (This default distribution can be changed).

If you’re running an older build, or just prefer not to use the install command and would like step-by-step directions, see WSL manual installation steps for older versions.

The first time you launch a newly installed Linux distribution, a console window will open and you’ll be asked to wait for files to de-compress and be stored on your machine. All future launches should take less than a second.

The above command only works if WSL is not installed at all, if you run wsl —install and see the WSL help text, please try running wsl —list —online to see a list of available distros and run wsl —install -d to install a distro. To uninstall WSL, see Uninstall legacy version of WSL or unregister or uninstall a Linux distribution.

Change the default Linux distribution installed

By default, the installed Linux distribution will be Ubuntu. This can be changed using the -d flag.

• To change the distribution installed, enter: wsl —install -d . Replace with the name of the distribution you would like to install.
• To see a list of available Linux distributions available for download through the online store, enter: wsl —list —online or wsl -l -o .
• To install additional Linux distributions after the initial install, you may also use the command: wsl —install -d .

If you want to install additional distributions from inside a Linux/Bash command line (rather than from PowerShell or Command Prompt), you must use .exe in the command: wsl.exe —install -d or to list available distributions: wsl.exe -l -o .

If you run into an issue during the install process, check the installation section of the troubleshooting guide.

To install a Linux distribution that is not listed as available, you can import any Linux distribution using a TAR file. Or in some cases, as with Arch Linux, you can install using an .appx file. You can also create your own custom Linux distribution to use with WSL.

Set up your Linux user info

Once you have installed WSL, you will need to create a user account and password for your newly installed Linux distribution. See the Best practices for setting up a WSL development environment guide to learn more.

Set up and best practices

We recommend following our Best practices for setting up a WSL development environment guide for a step-by-step walk-through of how to set up a user name and password for your installed Linux distribution(s), using basic WSL commands, installing and customizing Windows Terminal, set up for Git version control, code editing and debugging using the VS Code remote server, good practices for file storage, setting up a database, mounting an external drive, setting up GPU acceleration, and more.

Check which version of WSL you are running

You can list your installed Linux distributions and check the version of WSL each is set to by entering the command: wsl -l -v in PowerShell or Windows Command Prompt.

To set the default version to WSL 1 or WSL 2 when a new Linux distribution is installed, use the command: wsl —set-default-version , replacing with either 1 or 2.

To set the default Linux distribution used with the wsl command, enter: wsl -s or wsl —setdefault , replacing with the name of the Linux distribution you would like to use. For example, from PowerShell/CMD, enter: wsl -s Debian to set the default distribution to Debian. Now running wsl npm init from Powershell will run the npm init command in Debian.

To run a specific wsl distribution from within PowerShell or Windows Command Prompt without changing your default distribution, use the command: wsl -d , replacing with the name of the distribution you want to use.

Learn more in the guide to Basic commands for WSL.

Upgrade version from WSL 1 to WSL 2

New Linux installations, installed using the wsl —install command, will be set to WSL 2 by default.

The wsl —set-version command can be used to downgrade from WSL 2 to WSL 1 or to update previously installed Linux distributions from WSL 1 to WSL 2.

To see whether your Linux distribution is set to WSL 1 or WSL 2, use the command: wsl -l -v .

To change versions, use the command: wsl —set-version 2 replacing with the name of the Linux distribution that you want to update. For example, wsl —set-version Ubuntu-20.04 2 will set your Ubuntu 20.04 distribution to use WSL 2.

If you manually installed WSL prior to the wsl —install command being available, you may also need to enable the virtual machine optional component used by WSL 2 and install the kernel package if you haven’t already done so.

To learn more, see the Command reference for WSL for a list of WSL commands, Comparing WSL 1 and WSL 2 for guidance on which to use for your work scenario, or Best practices for setting up a WSL development environment for general guidance on setting up a good development workflow with WSL.

Ways to run multiple Linux distributions with WSL

WSL supports running as many different Linux distributions as you would like to install. This can include choosing distributions from the Microsoft Store, importing a custom distribution, or building your own custom distribution.

There are several ways to run your Linux distributions once installed:

1. Install Windows Terminal(Recommended) Using Windows Terminal supports as many command lines as you would like to install and enables you to open them in multiple tabs or window panes and quickly switch between multiple Linux distributions or other command lines (PowerShell, Command Prompt, PowerShell, Azure CLI, etc). You can fully customize your terminal with unique color schemes, font styles, sizes, background images, and custom keyboard shortcuts. Learn more.
2. You can directly open your Linux distribution by visiting the Windows Start menu and typing the name of your installed distributions. For example: «Ubuntu». This will open Ubuntu in it’s own console window.
3. From Windows Command Prompt or PowerShell, you can enter the name of your installed distribution. For example: ubuntu
4. From Windows Command Prompt or PowerShell, you can open your default Linux distribution inside your current command line, by entering: wsl.exe .
5. From Windows Command Prompt or PowerShell, you can use your default Linux distribution inside your current command line, without entering a new one, by entering: wsl [command] . Replacing [command] with a WSL command, such as: wsl -l -v to list installed distributions or wsl pwd to see where the current directory path is mounted in wsl. From PowerShell, the command get-date will provide the date from the Windows file system and wsl date will provide the date from the Linux file system.

The method you select should depend on what you’re doing. If you’ve opened a WSL command line within a Windows Prompt or PowerShell window and want to exit, enter the command: exit .

Want to try the latest WSL preview features?

Try the most recent features or updates to WSL by joining the Windows Insiders Program. Once you have joined Windows Insiders, you can choose the channel you would like to receive preview builds from inside the Windows settings menu to automatically receive any WSL updates or preview features associated with that build. You can choose from:

• Dev channel: Most recent updates, but low stability.
• Beta channel: Ideal for early adopters, more reliable builds than the Dev channel.
• Release Preview channel: Preview fixes and key features on the next version of Windows just before its available to the general public.

Additional resources

• Windows Command Line Blog: Install WSL with a single command now available in Windows 10 version 2004 and higher