WSL aktivieren und konfigurieren

Bevor Sie WSL Dashboard verwenden, muss Ihr Windows-System die WSL 2-Umgebung korrekt aktiviert und konfiguriert haben. Dieses Dokument besteht aus drei Hauptteilen:

1. WSL aktivieren und konfigurieren: Grundinstallation und -konfiguration von WSL 2 durchführen.
2. Verfügbare Befehle bedeuten keine erfolgreiche Installation: erklärt, dass ein ausführbarer wsl-Befehl nicht bedeutet, dass Linux erfolgreich installiert werden kann.
3. Fehlerbehebung bei fehlgeschlagener Installation: Prüf- und Reparaturmethoden, wenn die Installation nach der Konfiguration weiterhin fehlschlägt.

1. WSL aktivieren und konfigurieren

In diesem Kapitel werden Sie durch die notwendigen Grundeinstellungen geführt. Nach Abschluss dieses Kapitels lesen Sie bitte Kapitel 2, um den Unterschied zwischen verfügbaren Befehlen und erfolgreicher Installation zu verstehen. Falls die Installation weiterhin Probleme bereitet, lesen Sie Kapitel 3.

1.1 Systemanforderungen prüfen

WSL 2 hat Mindestanforderungen an die Windows-Version. Drücken Sie Win + R, geben Sie winver ein, um Ihre Version zu prüfen:

• Windows 10: Version 1903 oder höher, und die Build-Nummer muss 18362 oder höher sein.
• Windows 11: Alle Versionen werden unterstützt.

IMPORTANT

Wenn Ihre Version zu alt ist, aktualisieren Sie Ihr System zuerst über "Windows Update".

1.2 Hardware-Virtualisierung aktivieren

WSL 2 basiert auf Virtualisierungstechnologie. Daher müssen Sie Virtualization Technology im BIOS/UEFI des Motherboards aktivieren.

• Prüfmethode: Öffnen Sie den "Task-Manager" -> Registerkarte "Leistung" -> "CPU".
• Status prüfen: Stellen Sie sicher, dass der Status "Virtualisierung" unten rechts "Aktiviert" anzeigt.
• Aktivierungsart: Wenn sie nicht aktiviert ist, müssen Sie den Computer neu starten, in die BIOS/UEFI-Einstellungen gehen, eine Option wie Intel VT-x oder AMD-V finden und auf Enabled setzen.

1.3 Windows-bezogene Funktionen aktivieren

Sie müssen die Windows-Funktionen "Windows-Subsystem für Linux" und "Plattform für virtuelle Computer" aktivieren.

Methode A: Über die grafische Benutzeroberfläche (empfohlen)

1. Drücken Sie Win + S, suchen Sie nach "Windows-Funktionen aktivieren oder deaktivieren" und öffnen Sie es.
2. Aktivieren Sie die folgenden beiden Optionen:
   • Windows-Subsystem für Linux (Windows Subsystem for Linux)
   • Plattform für virtuelle Computer (Virtual Machine Platform)
3. Klicken Sie auf "OK" und starten Sie den Computer neu, wenn Sie dazu aufgefordert werden.

Methode B: Über die Befehlszeile (mit Administratorrechten)

Führen Sie PowerShell als Administrator aus und führen Sie die folgenden Befehle aus:

# WSL aktivieren
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Plattform für virtuelle Computer aktivieren
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Starten Sie den Computer nach der Ausführung manuell neu.

1.4 WSL-Kernel installieren oder aktualisieren

Moderne Windows-Versionen können WSL-Updates über den Microsoft Store beziehen.

• Download-Adresse: Microsoft Store - Windows Subsystem for Linux
• Manueller Download: Wenn der Store nicht verwendet werden kann, können Sie das neueste .msixbundle- oder .msi-Installationspaket von WSL GitHub Releases für eine Offline-Installation herunterladen.

1.5 WSL 2 als Standardversion festlegen

Um sicherzustellen, dass neu installierte Distributionen standardmäßig WSL 2 verwenden, führen Sie im Terminal aus:

wsl --set-default-version 2

1.6 Häufige Probleme

• Fehler 0x80370102: Normalerweise verursacht durch nicht aktivierte Virtualisierung im BIOS oder einen Konflikt mit Hyper-V.
• Wechsel zwischen WSL 1 und WSL 2: Sie können wsl --set-version <Name der Distribution> 2 verwenden, um eine vorhandene WSL 1-Instanz auf WSL 2 zu aktualisieren.

2. Verfügbare Befehle bedeuten keine erfolgreiche Installation

wsl --version, wsl -l -v und andere Befehle können normal ausgeführt werden, bedeuten aber nicht, dass die Bedingungen für die Installation von Linux erfüllt sind. Beides befindet sich in unterschiedlichen Phasen und darf nicht gleichgesetzt werden.

Ein verfügbarer Befehl bedeutet nur, dass:

• ✅ die WSL-Komponente in Windows aktiviert/installiert ist
• ✅ das Befehlszeilentool wsl.exe verfügbar ist
• ✅ das System die WSL-bezogenen Befehle erkennt

Für eine erfolgreiche Installation einer Linux-Distribution sind jedoch zusätzliche Bedingungen erforderlich. Häufige Stolperfallen sind:

1. Virtualisierung deaktiviert: VT-x / AMD-V ist im BIOS/UEFI nicht aktiviert, WSL 2 kann nicht starten, oder beim Installieren der Distribution wird ein Virtualisierungsfehler gemeldet (Prüfmethode: siehe 1.2 Hardware-Virtualisierung aktivieren).
2. Windows-Version/-Build zu alt: WSL 2 hat Anforderungen an Kernel und Version; die Home-Edition oder zu alte Unternehmensimages können unvollständige Funktionen haben (Prüfmethode: siehe 1.1 Systemanforderungen prüfen).
3. Noch keine Linux-Distribution installiert: wsl -l -v listet nur installierte Distributionen auf; wenn nichts installiert ist, ist die Liste leer – das bedeutet nicht, dass Sie Ubuntu direkt ausführen können.
4. Netzwerk-/Microsoft-Store-Probleme: wsl --install -d <Distribution> muss das Image aus dem Store oder über das Netzwerk laden; Firmennetzwerke, Proxys und Firewalls können den Vorgang blockieren.
5. Unzureichende Berechtigungen: Für die Installation einer Distribution oder das Ändern von WSL-Einstellungen sind Administratorrechte erforderlich.

TIP

Einfach gesagt: Ein verfügbarer WSL-Befehl bedeutet nicht, dass Linux bereit ist – Sie haben nur eine "Eintrittskarte" erhalten, aber noch kein System installiert.

3. Fehlerbehebung bei fehlgeschlagener Installation

Nachdem Sie die Konfiguration gemäß Kapitel 1 abgeschlossen haben (oder glauben, sie abgeschlossen zu haben), prüfen Sie in der folgenden Reihenfolge, wenn wsl --install weiterhin fehlschlägt.

3.1 Zuerst den Ein-Klick-Test durchführen

Führen Sie in PowerShell mit Administratorrechten nacheinander aus:

wsl --install --no-distribution
wsl --set-default-version 2

• ✅ Wenn beide Befehle problemlos ausgeführt werden können, sind die optionalen WSL-Komponenten aktiviert und die Virtualisierungsbedingungen grundsätzlich erfüllt.
• ❌ Bei einem Fehler wird direkt angezeigt, was fehlt (z. B. Plattform für virtuelle Computer, Hyper-V, BIOS-Virtualisierung usw.).

Führen Sie dann systeminfo aus und stellen Sie sicher, dass Virtualization Enabled In Firmware: Yes in der Ausgabe erscheint. Wenn keiner der obigen Schritte einen Fehler meldet, können Sie wsl --install in der Regel bedenkenlos ausführen, um eine Distribution zu installieren.

NOTE

Kein Befehl kann zu 100 % garantieren, dass wsl --install erfolgreich ist, aber die obigen Prüfungen bestätigen, ob die Installationsbedingungen erfüllt sind.

3.2 Manuelle Prüfliste

Wenn der Ein-Klick-Test das Problem weiterhin nicht lokalisieren kann, prüfen Sie Punkt für Punkt:

1. Prüfen, ob die BIOS-/Firmware-Virtualisierung aktiviert ist: Führen Sie in einer Administratoren-PowerShell systeminfo aus; die Ausgabe muss Virtualization Enabled In Firmware: Yes enthalten.
2. Prüfen, ob die Windows-Funktionen aktiviert sind:

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
   Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   Der Status beider Befehle muss Enabled sein.
3. Prüfen, ob WSL verfügbar ist: wsl --version sollte eine normale Ausgabe erzeugen; wenn die Meldung erscheint, dass der Befehl nicht existiert, ist die WSL-Komponente nicht installiert – kehren Sie zu Kapitel 1 zurück.
4. Prüfen, ob WSL 2 verfügbar ist (Kernel und Plattform für virtuelle Computer): wsl --set-default-version 2 sollte erfolgreich zurückkehren. Häufige Fehlerursachen: Die Plattform für virtuelle Computer ist nicht aktiviert, oder VT-x / AMD-V ist im BIOS nicht aktiviert.

3.3 Schnellübersicht häufiger Fehlerursachen

Situation	Erklärung	Vorgehen
Virtualisierung im BIOS nicht aktiviert	Scheitert sicher	Neu starten und VT-x / AMD-V im BIOS aktivieren (siehe 1.2)
Windows 10 unter 19041	wsl --install wird nicht unterstützt	System aktualisieren (siehe 1.1)
Hyper-V / Virtualisierung in der Unternehmensumgebung deaktiviert	Kann fehlschlagen	Systemadministrator kontaktieren
Alte Home-Edition	Manuelle Installation erforderlich	WSL-Kernel gemäß 1.4 manuell installieren

3.4 Fehler 0xc03a0014: Anbieter für virtuelle Datenträgerunterstützung nicht gefunden

Die Fehlermeldung lautet Cannot find a virtual disk support provider for the specified file. Dies ist kein Problem der Linux-Distribution selbst, sondern ein Zeichen dafür, dass der VHD/VHDX-Virtualdisk-Stapel von Windows nicht ordnungsgemäß funktioniert: WSL 2 schlägt beim Registrieren der Distribution und beim Erstellen/Mounten von ext4.vhdx fehl.

Führen Sie zuerst eine minimale Überprüfung durch: Führen Sie PowerShell als Administrator aus und testen Sie New-VHD (z. B. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Wenn dieser Befehl ebenfalls denselben Fehler meldet, liegt das Problem zu 100 % auf der Windows-Seite und nicht an der Distribution.

Prüfen und reparieren Sie in der folgenden Reihenfolge:

1. Der Dienst Virtual Disk läuft nicht: Öffnen Sie services.msc, suchen Sie den Dienst Virtual Disk, setzen Sie den Starttyp auf "Automatisch" und starten Sie ihn.

2. WSL-/Plattform-für-virtuelle-Computer-Funktionen nicht aktiviert (oder nicht wirksam): Führen Sie die Befehle aus 1.3 Windows-bezogene Funktionen aktivieren erneut aus und starten Sie danach unbedingt neu. Windows Home verfügt nicht über vollständiges Hyper-V, aber WSL 2 benötigt nur die Plattform für virtuelle Computer, nicht die Hyper-V-Verwaltungsoberfläche.

3. Virtuelle Datenträgertreiber/-geräte fehlen: Öffnen Sie den Geräte-Manager und prüfen Sie unter "Systemgeräte / Speichercontroller", ob die folgenden Elemente vorhanden sind:

   • Microsoft Virtual Disk Provider
   • Microsoft Virtual Drive Enumerator
   • Microsoft VHD Loopback Controller

   Falls sie fehlen, können Sie sie über hdwwiz.exe manuell hinzufügen (Speichercontroller → Microsoft → Microsoft VHD Loopback Controller), und stellen Sie sicher, dass der Dienst FsDepends nicht deaktiviert ist.

4. Das importierte Image entspricht nicht den WSL-Anforderungen: Bei der Verwendung von wsl --import --vhd muss das VHDX ein ext4-Dateisystem haben; es darf sich nicht um eine LUKS-verschlüsselte Platte, eine normale raw.img, eine Live-ISO oder eine mit NTFS/FAT formatierte leere Platte handeln. .img / .qcow2 / .iso können nicht direkt mit wsl --import --vhd verwendet werden.

5. Pfad-/Berechtigungs-/Dateisystemprobleme: Das Zielverzeichnis muss sich auf einem NTFS-Laufwerk befinden (FAT32/exFAT funktionieren nicht); vermeiden Sie chinesische Zeichen, Leerzeichen und Sonderzeichen im Pfad; importieren Sie nicht von Netzlaufwerken, OneDrive oder komprimierten Ordnern; verwenden Sie unbedingt eine echte Administrator-PowerShell (und kein normales Terminal).

6. Beschädigte Systemkomponenten: Führen Sie nacheinander DISM und SFC aus, um die Systemkomponenten zu reparieren, und versuchen Sie es dann erneut:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   sfc /scannow

TIP

Drittanbieter-VMs (VirtualBox, VMware) oder Sandbox-/Härtungsfunktionen von Sicherheitssoftware (z. B. 360, Huorong) können virtuelle Datenträgeroperationen stören; Sie können sie während der Fehlersuche vorübergehend deaktivieren.