Dystrybucja uruchamia się i zamyka natychmiast

Dystrybucja uruchamia się i zamyka natychmiast (WSL) wskazuje na uszkodzony obraz dystrybucji lub błąd konfiguracji w pliku /etc/wsl.conf — pomaga jej ponowna instalacja poleceniem wsl --unregister i ponowne pobranie.

Czym oznacza natychmiastowe zamykanie się dystrybucji WSL

Komunikat „Dystrybucja uruchamia się i zamyka natychmiast” opisuje sytuację, w której środowisko Linux działające w ramach Windows Subsystem for Linux zostaje wywołane, ale nie przechodzi pełnego etapu startowego. Okno terminala może pojawić się tylko na moment, polecenie wsl może zakończyć działanie bez dostępu do powłoki, a uruchomienie konkretnej dystrybucji może kończyć się powrotem do wiersza poleceń systemu Windows. Nie oznacza to automatycznie awarii całego systemu Windows ani uszkodzenia sprzętu.

Przyczyną bywa uszkodzony system plików dystrybucji, nieprawidłowy wpis w pliku /etc/wsl.conf, przerwany proces aktualizacji albo problem z konfiguracją użytkownika startowego. W niektórych przypadkach dystrybucja jest formalnie zarejestrowana w WSL, lecz jej wirtualny dysk lub pliki inicjalizacyjne nie pozwalają na wykonanie pierwszych procesów. Dlatego samo ponowne otwarcie terminala zwykle nie rozwiązuje problemu.

Warto rozróżnić zamykanie się jednej dystrybucji od problemu obejmującego całe środowisko WSL. Jeżeli Ubuntu, Debian lub inna dystrybucja nie startuje, ale pozostałe środowiska działają, podejrzenie kieruje się przede wszystkim na dane i konfigurację tej konkretnej instalacji. Jeżeli natomiast żadna dystrybucja nie uruchamia się prawidłowo, należy sprawdzić usługę WSL, funkcje opcjonalne Windows, wersję komponentów oraz stan maszyny wirtualnej używanej przez WSL 2.

Jak WSL uruchamia dystrybucję i czym różnią się możliwe scenariusze

WSL nie uruchamia dystrybucji tak samo jak klasycznego systemu instalowanego bezpośrednio na dysku komputera. Windows najpierw rozpoznaje zarejestrowane środowisko, a następnie przekazuje mu parametry startowe i przygotowuje warstwę integracji. W wariancie WSL 2 dystrybucja korzysta z wirtualnego dysku w formacie .vhdx oraz lekkiej maszyny wirtualnej. Następnie wykonywane są procesy inicjalizacyjne, montowane są systemy plików i uruchamiana jest powłoka lub wskazana komenda.

Jeżeli błąd występuje przed uruchomieniem powłoki, przyczyną może być niedostępny albo uszkodzony obraz dystrybucji. Gdy powłoka pojawia się i natychmiast znika, większe znaczenie ma konfiguracja użytkownika, skrypt startowy lub program wskazany jako domyślna komenda. Z kolei powtarzające się błędy związane z maszyną wirtualną, jądrem lub funkcjami systemu Windows mogą wskazywać na problem na poziomie samej platformy WSL.

Podstawowe informacje można zebrać bez ingerowania w dane dystrybucji. Przydatne jest polecenie:

wsl --status
wsl --list --verbose

Pierwsze z nich pokazuje ogólny stan WSL, a drugie przedstawia zarejestrowane dystrybucje, ich stan oraz używaną wersję WSL. Dodatkowo można sprawdzić, czy problem dotyczy tylko jednej nazwy dystrybucji, czy również uruchamiania środowiska domyślnego. Wnioski z tych poleceń pomagają wybrać dalszą metodę postępowania i ograniczyć ryzyko niepotrzebnego usuwania danych.

W przypadku WSL 1 i WSL 2 podobny objaw może mieć inne źródło. WSL 1 korzysta z warstwy translacji wywołań systemowych, natomiast WSL 2 używa rzeczywistego jądra Linux w środowisku wirtualnym. Nie należy więc zakładać, że rozwiązanie działające dla jednej wersji będzie właściwe dla drugiej. Przed zmianami warto zapisać nazwę dystrybucji, jej wersję, stan oraz lokalizację danych.

Typowe problemy prowadzące do natychmiastowego zamknięcia

Jednym z częstszych powodów jest niepoprawny plik /etc/wsl.conf. Błąd składni, niewłaściwie ustawiony użytkownik domyślny albo nietrafiona konfiguracja sekcji odpowiedzialnej za uruchamianie usług może spowodować zakończenie startu, zanim użytkownik otrzyma dostęp do powłoki. Podobny efekt może wywołać uszkodzony plik profilu powłoki, na przykład .bashrc lub .profile, jeżeli zawiera polecenie kończące sesję albo odwołujące się do nieistniejącego zasobu.

Inną grupę przyczyn stanowią problemy z wirtualnym dyskiem dystrybucji. Nagłe wyłączenie komputera, błędy nośnika, brak wolnego miejsca lub przerwana operacja aktualizacyjna mogą doprowadzić do niespójności systemu plików. Wtedy dystrybucja może być widoczna na liście, ale nie będzie w stanie zamontować wymaganych katalogów. Przed próbą naprawy należy ustalić, czy w środowisku znajdują się ważne projekty, klucze, konfiguracje lub dane, ponieważ część działań administracyjnych może zmienić stan instalacji.

Na zachowanie WSL wpływają także aktualizacje Windows, aktualizacje pakietu WSL oraz ustawienia funkcji wirtualizacji. Nieprawidłowo działające składniki opcjonalne, konflikt z oprogramowaniem zabezpieczającym lub uszkodzone komponenty systemowe mogą powodować błędy pojawiające się przy każdym uruchomieniu. W takiej sytuacji przydatne jest porównanie zachowania kilku dystrybucji oraz sprawdzenie komunikatów w Podglądzie zdarzeń.

Warto zachować ostrożność przy poleceniu wsl --unregister. Usuwa ono z systemu wybraną dystrybucję razem z jej lokalnym systemem plików. Nie jest to zwykły restart ani odświeżenie konfiguracji. Zastosowanie tego polecenia może być uzasadnione wtedy, gdy dane zostały wcześniej wyeksportowane lub gdy instalacja jest uszkodzona i ma zostać odtworzona od początku. Bez kopii zapasowej wykonanie polecenia może doprowadzić do utraty plików znajdujących się wyłącznie wewnątrz tej dystrybucji.

Bezpieczniejszym etapem diagnostycznym jest wykonanie kopii lub eksportu środowiska, o ile dystrybucja nadal odpowiada na polecenia. Następnie można sprawdzić konfigurację startową, wyłączyć problematyczną komendę inicjalizacyjną, zaktualizować komponent WSL i ponownie uruchomić środowisko. Jeżeli dystrybucja nie pozwala na wejście do powłoki, działania naprawcze powinny być dobierane na podstawie objawów, komunikatów błędów i znaczenia przechowywanych danych.

Kiedy najlepiej zgłosić sprzęt do serwisu - Dystrybucja uruchamia się i zamyka natychmiast

Do serwisu warto zgłosić się wtedy, gdy dystrybucja zawiera ważne dane, a każda próba uruchomienia kończy się natychmiastowym zamknięciem, albo gdy problem wystąpił po awarii systemu, błędzie dysku lub nieudanej aktualizacji. Pomoc techniczna jest szczególnie przydatna, gdy nie jest jasne, czy źródło znajduje się w konfiguracji Linux, składnikach WSL, systemie Windows, sterownikach lub nośniku danych. Przed rozpoczęciem prac można określić, czy priorytetem ma być odzyskanie danych, przywrócenie uruchamiania, czy przygotowanie czystej instalacji.

W Warszawie takie przypadki obsługuje Warszawskie Pogotowie Komputerowe 24/7, gdzie można przekazać laptop do sprawdzenia pod kątem systemu Windows, WSL i stanu nośnika. W przypadku laptopa wykonywana jest darmowa diagnoza LAPTOPA, co pozwala najpierw ustalić zakres problemu i ocenić, czy konieczna będzie naprawa konfiguracji, odtworzenie dystrybucji, zabezpieczenie plików czy szersza diagnostyka systemu.

Do zgłoszenia dobrze dołączyć nazwę dystrybucji, informację o używanej wersji WSL, opis ostatnich zmian oraz treść komunikatu wyświetlanego przed zamknięciem. Jeżeli wykonywano już polecenia administracyjne, należy podać ich kolejność, zwłaszcza w przypadku eksportu, importu, resetowania lub wyrejestrowywania dystrybucji. Pozwala to ograniczyć liczbę prób wykonywanych metodą przypadkową i dobrać postępowanie do rzeczywistego stanu danych.

Jeżeli problem dotyczy wyłącznie uruchamiania dystrybucji, nie należy od razu usuwać całego WSL ani kasować katalogów aplikacji. Najpierw powinno się ustalić, czy środowisko można uruchomić z inną komendą, odczytać pliki z obrazu, wykonać kopię i dopiero potem przeprowadzić reinstalację. Takie podejście zwiększa szansę na zachowanie konfiguracji projektów, pakietów i danych użytkownika.