Исправление ошибки 0x80370102 в WSL

Рабочий стол Linux Mint с логотипом snap на экране

Ошибка 0x80370102 возникает при попытке установить и запустить дистрибутив Linux через функцию Windows Subsystem for Linux (WSL). В ряде случаев она проявляется при установке Ubuntu, Debian и других дистро и чаще всего связана с проблемами аппаратной виртуализации в BIOS/UEFI или с состоянием сервисов Windows, отвечающих за WSL.

В этой статье мы подробно разберём возможные причины, приведём последовательные шаги по диагностике и исправлению, а также добавим чек‑листы, способы отката и краткие объяснения терминов. Порядок шагов — от простых к более сложным: сначала проверка, затем включение компонентов Windows и перезапуск сервисов, затем настройки Hyper‑V/Nested Virtualization.

Почему возникает ошибка 0x80370102

Коротко — WSL 2 опирается на возможности аппаратной виртуализации и на ряд системных сервисов. Если какая‑то часть стека не работает, появляется ошибка регистрации дистрибутива (WslRegisterDistribution) и код 0x80370102. Наиболее частые причины:

Аппаратная виртуализация (Intel VT‑x / AMD SVM) отключена в BIOS/UEFI. Без неё WSL 2 не может запустить VM‑ядро.
Компоненты Windows Hyper‑V и Virtual Machine Platform отключены. WSL 2 использует Hyper‑V подсистему.
Используется сборка Windows Insider (предрелизная), где возможны баги с виртуализацией.
Служба LxssManager повреждена, зависла или не запускается — она управляет запуском WSL‑инстансов.
Конфликты с другим ПО для виртуализации (старые версии VirtualBox, VMware Workstation) или с политиками групп (в корпоративной сети).

Важно: прежде чем выполнять сложные шаги, убедитесь, что компьютер аппаратно поддерживает виртуализацию и доступ к BIOS/UEFI у вас есть.

Быстрая проверка совместимости и состояния (факт‑бокс)

Факт‑бокс — что проверить в первую очередь:

Поддержка виртуализации: systeminfo (см. ниже) или Task Manager → Performance → CPU → Virtualization.
Версия Windows: Windows 10 2004+ или Windows 11 рекомендуется для WSL 2.
Состояние сервисов: LxssManager, Hyper‑V related services.
Компоненты Windows: Hyper‑V, Virtual Machine Platform, Windows Subsystem for Linux.

1. Как проверить, включена ли аппаратная виртуализация

Откройте диспетчер задач: нажмите Ctrl + Shift + Esc.
Нажмите «Подробнее», чтобы развернуть окно диспетчера задач.
Перейдите на вкладку «Производительность» → CPU.
Справа под графиком CPU найдите строку “Виртуализация”. Там будет “Включено” или “Отключено”. Также внизу есть блок “Поддержка Hyper‑V”.

Альтернатива через командную строку (запустите CMD от имени администратора):

Нажмите Win + R, введите cmd и нажмите Ctrl + Shift + Enter.
Выполните команду:

systeminfo

В выводе найдите секцию “Требования Hyper‑V” (Hyper‑V Requirements). Если там указано, что необходимые функции отсутствуют, включите виртуализацию в BIOS/UEFI.

Важно: настройка BIOS/UEFI зависит от производителя (ASUS, Dell, HP, Lenovo и т.д.). Обычно опция называется Intel Virtualization Technology, VT‑x, VT‑d, или AMD SVM.

2. Включение Hyper‑V и компонентов Windows для WSL

WSL 2 требует включённых компонентов: “Платформа виртуальной машины” (Virtual Machine Platform) и “Подсистема Windows для Linux” (Windows Subsystem for Linux). Рекомендуется также включить Hyper‑V.

Пошагово через Панель управления:

Откройте Панель управления → Программы → Программы и компоненты.
Нажмите «Включение или отключение компонентов Windows».
В списке отметьте:
- Hyper‑V
- Virtual Machine Platform (Платформа виртуальной машины)
- Windows Subsystem for Linux
Подтвердите и перезагрузите компьютер.

Если вы предпочитаете PowerShell (администратор), используйте:

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

После выполнения перезагрузите систему.

Выберите

Опция

Включение Hyper‑V в списке компонентов Windows

Примечание: в корпоративной среде некоторые политики групп (Group Policy) могут блокировать изменения компонентов. Обратитесь к администратору.

3. Перезапуск службы LxssManager

Если служба LxssManager зависла или работает некорректно, WSL не сможет зарегистрировать дистрибутивы. Перезапуск службы часто устраняет проблему.

Нажмите Win + R, введите services.msc и нажмите Enter.
В списке служб найдите LxssManager.
Кликните правой кнопкой → Свойства → Остановить → Запустить.

Или через PowerShell (запущенный от имени администратора):

Restart-Service LxssManager

Или через командную строку:

net stop LxssManager
net start LxssManager

После перезапуска попробуйте снова установить дистрибутив: в Microsoft Store или через команду wsl –install.

Свойства службы LxssManager

Нажмите кнопку

4. Включение Nested Virtualization и изменение оперативной памяти в Hyper‑V

Если вы запускаете WSL внутри виртуальной машины Hyper‑V (например, nested setup для разработчиков), необходимо включить Nested Virtualization и корректно настроить память виртуальной машины.

Откройте PowerShell от имени администратора.
Выполните команду (замените на имя вашей VM):

Set-VMProcessor  -ExposeVirtualizationExtensions $true

Запустите Hyper‑V Manager, выберите виртуальную машину → Settings → Memory.
Увеличьте значение Startup RAM (например, удвойте текущее), выключите “Enable Dynamic Memory”.
Примените изменения и перезагрузите виртуальную машину.

Выполнение команды для включения виртуализационных расширений

Измените настройки памяти в Hyper‑V

Эти шаги особенно важны, если вы пытаетесь установить WSL 2 внутри гостевой ОС Hyper‑V.

5. Дополнительные шаги и альтернативные подходы

Если предыдущие шаги не помогли, попробуйте следующее:

Убедитесь, что вы не используете предрелизную сборку Windows Insider; при возможности вернитесь на стабильную версию.
Обновите Windows — иногда баги виртуализации исправляют обновления.
Обновите драйверы BIOS/UEFI и микрокода CPU (через прошивку от производителя).
Если у вас установлены старые версии VirtualBox/VMware, обновите их до версий с поддержкой Hyper‑V или временно удалите, чтобы исключить конфликт.
Если не получается запустить WSL 2, временно переключитесь на WSL 1: в PowerShell выполните:

wsl --set-default-version 1

Это уменьшит функциональность (нет полноценного VM‑ядра), но позволит работать с большинством инструментов командной строки.

В крайнем случае выполните сброс WSL дистрибутива: в меню Параметры → Приложения → выберите дистрибутив → Дополнительные параметры → Сброс. Либо используйте:

wsl --unregister

и затем установите вновь.

Критерии приёмки

После выполнения шагов задача считается решённой, если выполняются все пункты:

WSL дистрибутив успешно устанавливается без ошибки 0x80370102.
Команда wsl –list –verbose показывает зарегистрированный дистрибутив и версию WSL (1 или 2).
В Task Manager → Performance → CPU показана “Виртуализация: Включено”.
Служба LxssManager работает (Status: Running).

Процедура — SOP для быстрого устранения (для администраторов и пользователей)

Проверить аппаратную виртуализацию через Task Manager или systeminfo.
Включить в BIOS/UEFI Intel VT‑x / AMD SVM при необходимости.
Включить компоненты Windows: Virtual Machine Platform, Windows Subsystem for Linux, Hyper‑V.
Перезапустить LxssManager (Restart‑Service LxssManager).
Если VM‑окружение: включить Nested Virtualization и увеличить RAM.
Обновить Windows и прошивку BIOS, если проблема остаётся.
В крайнем случае переключиться на WSL 1 или удалить/переустановить дистрибутив.

Роли и чек‑листы (кто что делает)

Домашний пользователь:
- Проверить Task Manager → Virtualization.
- Включить компоненты через Панель управления или PowerShell.
- Перезагрузить и попытаться установить дистрибутив.
Разработчик/DevOps внутри VM:
- Убедиться, что Nested Virtualization включена для гостевой VM.
- Настроить память VM и отключить динамическую память.
Системный администратор:
- Проверить политикy групп (GPO), запрещающие Hyper‑V.
- Обновить BIOS/UEFI и драйверы, обеспечить поддержку на уровне инфраструктуры.

Когда это не помогает: контрпримеры и возможные причины провала

Если аппаратная виртуализация отключена аппаратно (нельзя включить из‑за политик или на старом железе), WSL 2 работать не будет.
В корпоративных средах политики безопасности могут блокировать инсталляцию Hyper‑V. В таком случае нужна координация с IT‑отделом.
При аппаратных неисправностях CPU или материнской платы включение виртуализации может быть невозможным.

Диагностическое дерево (для быстрого выбора пути действий)

flowchart TD
  A[Начать: ошибка 0x80370102] --> B{Проверить Virtualization в Task Manager}
  B -- 'Включено' --> C{Проверить Hyper-V и VMP на Windows}
  B -- 'Отключено' --> D[Включить VT‑x/AMD SVM в BIOS/UEFI]
  D --> E[Перезагрузить и повторить установку]
  C -- 'Отключены' --> F[Включить компоненты Windows и перезагрузить]
  C -- 'Включены' --> G[Перезапустить LxssManager]
  G --> H{Ошибка ушла?}
  H -- 'Да' --> I[Готово]
  H -- 'Нет' --> J[Проверить конфликты с другим ПО/обновления BIOS]
  J --> K[Связаться с поддержкой/IT]

Краткий глоссарий (1‑строчные определения)

WSL: Windows Subsystem for Linux — подсистема для запуска Linux‑окружения в Windows.
WSL 2: вторая версия WSL, использующая лёгкую виртуальную машину на базе Hyper‑V.
Hyper‑V: технология аппаратной виртуализации Microsoft.
LxssManager: служба Windows, управляющая экземплярами WSL.
Nested Virtualization: возможность запускать виртуализацию внутри виртуальной машины.

Безопасность и приватность

При изменении настроек BIOS/UEFI и включении Hyper‑V убедитесь, что действия соответствуют политике безопасности вашей организации. Обновления прошивки BIOS должны загружаться только с официального сайта производителя.

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

Проверьте поддержку виртуализации в Task Manager или с помощью systeminfo.
Включите Hyper‑V и Virtual Machine Platform в компонентах Windows и перезагрузите ПК.
Перезапустите службу LxssManager; при необходимости выполните Restart‑Service LxssManager.
Для Nested‑сценариев включите ExposeVirtualizationExtensions и скорректируйте память VM.
Если всё ещё не помогло, обновите Windows/BIOS и проверьте конфликты с другим ПО.

Если вы выполнили все шаги и ошибка повторяется, обратитесь в поддержку Microsoft или к системному администратору: они смогут посмотреть логи и диагностировать проблему глубже.

Социальный превью (рекомендуемое):

Заголовок превью: “Как исправить ошибку 0x80370102 при установке WSL”
Краткое описание: “Пошаговое руководство: проверка виртуализации, включение Hyper‑V, перезапуск LxssManager и настройки Nested Virtualization.”

Короткое объявление для команды (100–200 слов)

Если в нашей среде разработчики сталкиваются с ошибкой 0x80370102 при установке WSL, следуйте стандартному SOP: проверьте аппаратную виртуализацию, включите Hyper‑V и Virtual Machine Platform, перезапустите службу LxssManager и, при необходимости, включите Nested Virtualization и увеличьте стартовую память VM. Если проблема не устраняется — соберите логи, версию Windows и информацию о BIOS и передайте в IT‑поддержку.