WSL nie uruchamia się

WSL nieuruchamiający się wskazuje na wyłączoną funkcję Windows Subsystem for Linux lub zatrzymaną usługę LxssManager.

Co oznacza komunikat „WSL nie uruchamia się”

WSL, czyli Windows Subsystem for Linux, jest składnikiem systemu Windows umożliwiającym uruchamianie dystrybucji Linuksa bez instalowania osobnego systemu operacyjnego w trybie podwójnego rozruchu. Jeżeli dystrybucja nie startuje, okno terminala natychmiast się zamyka albo pojawia się komunikat o braku wymaganej funkcji, przyczyną może być wyłączony składnik systemu Windows, nieaktywna funkcja platformy maszyny wirtualnej albo problem z usługą odpowiedzialną za obsługę środowiska WSL.

W starszych wdrożeniach WSL istotna była usługa LxssManager. W nowszych wersjach systemu Windows część funkcji może być obsługiwana przez usługę WSL oraz procesy uruchamiane zależnie od używanej wersji środowiska. Z tego powodu sama obecność lub brak usługi o konkretnej nazwie nie przesądza jeszcze o przyczynie awarii. Najpierw trzeba ustalić wersję WSL, używaną dystrybucję oraz dokładny tekst komunikatu.

Składniki Windows wymagane przez WSL

Podstawowy WSL korzysta z funkcji „Podsystem Windows dla systemu Linux”. WSL 2 wymaga dodatkowo funkcji „Platforma maszyny wirtualnej”, ponieważ jądro Linuksa działa w lekkim środowisku wirtualizacyjnym zarządzanym przez Windows. W systemach, w których wyłączono te składniki, polecenie uruchamiające dystrybucję może zwrócić błąd dotyczący brakującej funkcji, nieprawidłowej konfiguracji albo niemożności uruchomienia wymaganej infrastruktury.

Stan środowiska można sprawdzić poleceniem wsl --status, a listę zainstalowanych dystrybucji wraz z ich stanem i wersją poleceniem wsl --list --verbose. Jeżeli dystrybucja korzysta z WSL 2, należy sprawdzić także, czy w oprogramowaniu układowym komputera jest włączona wirtualizacja sprzętowa. W zależności od platformy może ona występować pod nazwą Intel VT-x albo AMD-V. Wyłączenie tej funkcji może uniemożliwić uruchomienie WSL 2, mimo że same składniki Windows są aktywne.

Sprawdzanie usługi, dystrybucji i konfiguracji

W przypadku starszej implementacji WSL warto sprawdzić w konsoli usług Windows, czy usługa LxssManager nie została zatrzymana lub wyłączona. Weryfikacja powinna obejmować również usługi i składniki systemowe związane z platformą maszyny wirtualnej. Ręczne uruchamianie usługi bez sprawdzenia komunikatów systemowych może jedynie zamaskować problem, jeżeli przyczyną jest uszkodzona konfiguracja funkcji opcjonalnej, niezgodność wersji systemu albo błąd konkretnej dystrybucji.

Przydatne jest rozdzielenie problemu środowiska WSL od problemu pojedynczej dystrybucji. Polecenie wsl --shutdown zatrzymuje działające instancje WSL, a następnie można ponowić próbę uruchomienia wybranej dystrybucji. Jeżeli nie działa tylko jedna dystrybucja, a pozostałe uruchamiają się prawidłowo, przyczyny należy szukać w jej systemie plików, konfiguracji użytkownika lub ustawieniach startowych. Polecenia wsl --update i wsl --version pomagają sprawdzić odpowiednio aktualizacje oraz wersję zainstalowanego pakietu WSL, o ile dana wersja Windows obsługuje te opcje.

Nie należy od razu wykonywać polecenia wsl --unregister. Usuwa ono zarejestrowaną dystrybucję wraz z jej systemem plików, dlatego może doprowadzić do utraty zapisanych w niej danych. Przed taką operacją konieczne jest wykonanie kopii lub eksportu dystrybucji, na przykład za pomocą wsl --export, oraz potwierdzenie, że problem rzeczywiście dotyczy uszkodzonej instalacji, a nie konfiguracji samego WSL.

Diagnostyka komputera, na którym WSL przestał działać

Pełna diagnoza powinna uwzględnić wersję Windows, aktualizacje systemowe, typ WSL 1 albo WSL 2, stan funkcji opcjonalnych, ustawienia wirtualizacji sprzętowej oraz komunikaty zapisane w Podglądzie zdarzeń. Znaczenie ma także sposób instalacji dystrybucji: Microsoft Store, pakiet ręczny lub starszy mechanizm instalacyjny. Te warianty mogą korzystać z innych składników i różnić się sposobem aktualizacji.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC i ich podzespołów, w tym diagnozowaniem problemów z konfiguracją systemu Windows oraz środowiskiem WSL używanym na komputerze domowym lub biurowym. W trakcie sprawdzania można ustalić, czy przyczyną jest wyłączona funkcja systemowa, zatrzymana usługa, niezgodność WSL 2 z konfiguracją sprzętu, błąd aktualizacji czy uszkodzenie konkretnej dystrybucji, bez usuwania jej danych bez wcześniejszego potwierdzenia.