WSL install завис на 0%: диагностика и --web-download

Сначала выясните, что именно зависло

Если команда показывает 0,0% сразу после запуска, зафиксируйте полный текст PowerShell и не запускайте несколько одинаковых установок параллельно. Затем проверьте wsl --status и wsl --version: это отделяет проблему самого WSL от проблемы конкретного Ubuntu, Debian или другого дистрибутива. Выполните wsl --list --online и скопируйте точное имя пакета. Если WSL уже установлен и команда wsl --install без параметров показывает справку, Microsoft рекомендует явно выбрать дистрибутив через -d. На рабочем компьютере учитывайте прокси, VPN, SSL-inspection и правила доступа к Microsoft-сервисам: браузер может работать, а системная загрузка — нет. Не начинайте с unregister: зависшая загрузка нового дистрибутива не требует удаления уже работающей Linux-среды.

Совет: Скопируйте ошибку целиком, включая код: он часто полезнее самого процента.

Как повторить установку через web-download

1. Проверьте доступные имена: Выполните wsl --list --online и скопируйте имя дистрибутива.
2. Проверьте версию: Выполните wsl --version и при необходимости wsl --update.
3. Используйте web-download: Запустите wsl --install --web-download -d <DistroName>.
4. Дождитесь результата: Не запускайте параллельную установку того же дистрибутива.
5. Проверьте регистрацию: После завершения выполните wsl -l -v и первый запуск.

Почему VPN и прокси меняют результат

WSL install включает сетевую загрузку, поэтому маршрут имеет значение. Корпоративный прокси может требовать аутентификацию, VPN — менять маршрут, а защитный шлюз — инспектировать TLS. Если на личном компьютере используется сторонний VPN, можно проверить поведение без него только при условии, что это не нарушает требования безопасности. В корпоративной среде не отключайте защиту самостоятельно: передайте администратору команду, код ошибки и время воспроизведения. Если проблема появилась после обновления Windows, выполните wsl --update, перезагрузитесь при запросе и снова проверьте версию. --web-download не является универсальным ремонтом: он меняет канал загрузки дистрибутива, но не исправляет сломанную виртуализацию, DNS или политику сети.

Важно: --web-download не является способом обхода корпоративной политики.

Как читать результат повторной попытки

• С --web-download пошёл прогресс. Канал загрузки. Дождаться установки
• Обе команды стоят на 0%. Сеть, прокси, версия WSL. Проверить доступ и обновление
• Имя не найдено. Неверный -d. Взять имя из online list
• Distro есть, но не стартует. Первый запуск. Диагностировать новый код

Как отличить проблему загрузки от первого запуска

После успешной загрузки и регистрации wsl -l -v покажет дистрибутив в списке. Если он там есть, но окно первого запуска долго не меняется, это уже другой этап. Первый старт может распаковывать файловую систему и просить создать Linux-пользователя. Запустите дистрибутив явно через wsl -d <Name> и посмотрите сообщение. Если появляется отдельный код виртуализации, kernel или регистрации, решайте его как самостоятельную проблему. Такой подход не заставляет снова скачивать то, что уже установлено. Если процент загрузки исчез, а проблема перешла в запуск, сетевые настройки могут быть больше ни при чём. Разделяйте этапы: download, registration, first run.

Чего не делать при зависании на 0%

• Не выполнять unregister рабочих дистрибутивов
• Не удалять вручную каталоги AppData
• Не запускать несколько install одновременно
• Не скачивать случайный rootfs со стороннего сайта
• Фиксировать точный код ошибки
• Не обходить корпоративную политику

Предупреждение: wsl --unregister удаляет данные выбранного дистрибутива и не нужен для проверки сетевой загрузки.

Что сохранить для дальнейшей диагностики

Для повторяемой диагностики сохраните команду, точное имя дистрибутива, wsl --version, код ошибки и время попытки. Если проблема повторяется только в одной разрешённой сети, это сильный сигнал о сетевой политике; если только на одном ПК — смотрите локальную конфигурацию WSL и Windows. Не оценивайте состояние исключительно по проценту: после прерывания может появиться код, который информативнее 0%. Многократные параллельные повторения усложняют журнал и могут оставить процессы, не помогающие понять причину. После успешной установки сохраните рабочую команду и версию WSL — это пригодится, если следующий компьютер поведёт себя иначе.

Если --web-download тоже не помогает

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

Проверка перед новым повтором

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

Что учитывать

WSL install включает сетевую загрузку, поэтому маршрут имеет значение. Корпоративный прокси может требовать аутентификацию, VPN — менять маршрут, а защитный шлюз — инспектировать TLS. Если на личном компьютере используется сторонний VPN, можно проверить поведение без него только при условии, что это не нарушает требования безопасности. В корпоративной среде не отключайте защиту самостоятельно: передайте администратору команду, код ошибки и время воспроизведения. Если проблема появилась после…

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. Install WSL). Пример и формулировки — редакция N1RO на 2026-09-21.

• Install WSL
• Basic commands for WSL