Setup & Config WSL

Før du bruger WSL Dashboard, skal dit Windows-system have WSL 2 aktiveret og konfigureret korrekt. Dette dokument består af følgende tre hoveddele:

1. Aktivér og konfigurér WSL: fuldfør basisinstallationen og konfigurationen af WSL 2.
2. Et tilgængeligt kommando betyder ikke en vellykket installation: forklarer, at et kørbart wsl-kommando ikke betyder, at Linux kan installeres.
3. Fejlfinding af mislykket installation: kontrol- og reparationsmetoder, når installationen stadig mislykkes efter konfigurationen.

1. Aktivér og konfigurér WSL

Dette kapitel guider dig gennem de nødvendige grundindstillinger. Efter dette kapitel kan du læse kapitel 2 for at forstå forskellen mellem et tilgængeligt kommando og en vellykket installation; hvis installationen stadig giver problemer, kan du se kapitel 3.

1.1 Kontrollér systemkravene

WSL 2 har minimumskrav til Windows-versionen. Tryk på Win + R, skriv winver ind, og kontrollér din version:

• Windows 10: version 1903 eller nyere med build-nummer (Build) 18362 eller højere.
• Windows 11: alle versioner understøttes.

IMPORTANT

Hvis din version er for gammel, skal du først opgradere systemet via "Windows Update".

1.2 Aktivér hardwarevirtualisering

WSL 2 kører på virtualiseringsteknologi, så virtualiseringsteknologi (Virtualization Technology) skal være aktiveret i bundkortets BIOS/UEFI.

• Kontrolmetode: åbn "Jobliste" (Task Manager) → fanen "Ydeevne" → "CPU".
• Kontrollér status: bekræft, at statusen "Virtualisering" nederst til højre viser "Aktiveret".
• Sådan aktiveres: hvis den ikke er aktiveret, skal du genstarte computeren, gå ind i BIOS/UEFI-indstillingerne, finde en indstilling som Intel VT-x eller AMD-V og sætte den til Enabled.

1.3 Aktivér Windows-relaterede funktioner

Du skal aktivere funktionerne "Windows-undersystem til Linux" og "Virtuel maskinplatform".

Metode A: Via den grafiske grænseflade (anbefales)

1. Tryk på Win + S, søg efter og åbn "Slå Windows-funktioner til eller fra".
2. Marker følgende to elementer:
   • Windows-undersystem til Linux (Windows Subsystem for Linux)
   • Virtuel maskinplatform (Virtual Machine Platform)
3. Klik på "OK", og genstart computeren, når du bliver bedt om det.

Metode B: Via kommandolinjen (administratorrettigheder)

Kør PowerShell som administrator, og udfør følgende kommandoer:

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

# Aktivér Virtual Machine Platform
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Efter udførelse skal du manuelt genstarte computeren.

1.4 Installér eller opdater WSL-kernen

Moderne Windows-versioner kan få WSL-opdateringer via Microsoft Store.

• Downloadadresse: Microsoft Store - Windows Subsystem for Linux
• Manuel download: hvis du ikke kan bruge Store, kan du downloade den nyeste .msixbundle- eller .msi-installationspakke fra WSL GitHub Releases til offline-installation.

1.5 Angiv WSL 2 som standardversion

For at sikre, at nyinstallerede distributioner bruger WSL 2 som standard, skal du udføre følgende i terminalen:

wsl --set-default-version 2

1.6 Ofte stillede spørgsmål

• Fejl 0x80370102: skyldes typisk, at virtualisering ikke er aktiveret i BIOS, eller en konflikt med Hyper-V.
• Skift mellem WSL 1 og WSL 2: du kan bruge wsl --set-version <分发版名称> 2 til at opgradere en eksisterende WSL 1-instans til WSL 2.

2. Et tilgængeligt kommando betyder ikke en vellykket installation

At kommandoer som wsl --version og wsl -l -v kan køres normalt betyder ikke, at betingelserne for at installere Linux allerede er opfyldt. De befinder sig i forskellige faser og kan ikke sidestilles.

At kommandoen er tilgængelig, siger kun, at:

• ✅ WSL-komponenterne i Windows allerede er aktiveret/installeret
• ✅ kommandolinjeværktøjet wsl.exe er tilgængeligt
• ✅ systemet genkender WSL-relaterede kommandoer

Men for at installere en Linux-distribution skal yderligere betingelser være opfyldt. Typiske flaskehalse er:

1. Virtualisering er slået fra: VT-x / AMD-V er ikke aktiveret i BIOS/UEFI, WSL 2 kan ikke starte, eller der rapporteres en virtualiseringsfejl ved installation af en distribution (kontrolmetode: se 1.2 Aktivér hardwarevirtualisering).
2. Windows-version/-build er for lav: WSL 2 stiller krav til kerne og version; hjemmeversionen og for gamle virksomhedsafbildninger kan mangle funktioner (kontrolmetode: se 1.1 Kontrollér systemkravene).
3. Ingen Linux-distribution er faktisk installeret endnu: wsl -l -v viser kun installerede distributioner; hvis intet er installeret, er listen tom, hvilket ikke betyder, at Ubuntu kan køres direkte.
4. Netværks-/Microsoft Store-problemer: wsl --install -d <发行版> skal hente afbildninger fra Store eller netværket; virksomhedsnetværk, proxyer og firewalls kan blokere dette.
5. Utilstrækkelige rettigheder: installation af en distribution eller ændring af WSL-indstillinger kræver administratorrettigheder.

TIP

Kort sagt: at WSL-kommandoen virker er ikke lig med, at Linux er klar; du har kun fået "entre-billetten", systemet er endnu ikke installeret.

3. Fejlfinding af mislykket installation

Hvis wsl --install stadig mislykkes, efter at du har fuldført konfigurationen i henhold til kapitel 1 (eller når du mener, du har fuldført konfigurationen), skal du kontrollere i følgende rækkefølge.

3.1 Start med en one-click-kontrol

Kør PowerShell som administrator, og udfør følgende i rækkefølge:

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

• ✅ Hvis begge kommandoer kan køres uden problemer, betyder det, at WSLs valgfrie komponenter er aktiveret, og at virtualiseringsbetingelserne stort set er opfyldt.
• ❌ Hvis de mislykkes, angives det direkte, hvad der mangler (f.eks. Virtuel maskinplatform, Hyper-V, BIOS-virtualisering osv.).

Kør derefter systeminfo, og bekræft, at Virtualization Enabled In Firmware: Yes vises i outputtet. Hvis der ikke rapporteres nogen fejl, kan du i praksis trygt køre wsl --install for at installere en distribution.

NOTE

Ingen kommando kan garantere 100 %, at wsl --install lykkes, men kontrollerne ovenfor bekræfter, om installationsbetingelserne er opfyldt.

3.2 Manuel kontrolliste

Hvis one-click-kontrollen ikke kan lokalisere problemet, kan du kontrollere punkt for punkt:

1. Kontrollér, om BIOS-/firmware-virtualisering er aktiveret: kør systeminfo i en PowerShell med administratorrettigheder; i outputtet skal Virtualization Enabled In Firmware: Yes kunne ses.
2. Kontrollér, om Windows-funktionerne er aktiveret:

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

   Status for begge kommandoer skal være Enabled.
3. Kontrollér, om WSL er tilgængeligt: wsl --version skal give normalt output; hvis kommandoen ikke findes, betyder det, at WSL-komponenterne ikke er installeret – gå tilbage til kapitel 1.
4. Kontrollér, om WSL 2 kan bruges (kerne og virtuel maskinplatform): wsl --set-default-version 2 skal returneres med succes. Typiske årsager: Virtuel maskinplatform er ikke aktiveret, eller VT-x / AMD-V er ikke aktiveret i BIOS.

3.3 Hurtig oversigt over almindelige fejlårsager

Situation	Forklaring	Løsning
Virtualisering ikke aktiveret i BIOS	Mislykkes helt sikkert	Genstart, gå ind i BIOS, og aktivér VT-x / AMD-V (se 1.2)
Windows 10 lavere end 19041	wsl --install understøttes ikke	Opgrader systemet (se 1.1)
Hyper-V / virtualisering deaktiveret i virksomhedsmiljø	Kan mislykkes	Kontakt systemadministratoren
Gammel hjemmeversion af systemet	Kræver manuel installation	Installér WSL-kernen manuelt i henhold til 1.4

3.4 Fejl 0xc03a0014: ingen udbyder til virtuelle diske fundet

Fejlmeddelelsen er Cannot find a virtual disk support provider for the specified file. Dette er ikke et problem med selve Linux-distributionen, men Windows' virtuelle diskstack (VHD/VHDX) fungerer ikke korrekt; WSL 2 mislykkes, når den registrerer en distribution og opretter/monterer ext4.vhdx.

Foretag først en minimal validering: kør PowerShell som administrator, og test med New-VHD (f.eks. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Hvis også denne kommando rapporterer samme fejl, ligger problemet 100 % på Windows-siden og ikke på distributionen.

Løs problemet i følgende rækkefølge:

1. Virtual Disk-tjenesten kører ikke: åbn services.msc, find tjenesten Virtual Disk, sæt starttypen til "Automatisk", og start den.

2. WSL / Virtuel maskinplatform er ikke aktiveret (eller ikke trådt i kraft): kør kommandoerne i 1.3 Aktivér Windows-relaterede funktioner igen, og genstart derefter – dette er obligatorisk. Windows Home har ikke fuldstændig Hyper-V, men WSL 2 har kun brug for Virtuel maskinplatform, ikke Hyper-V-administrationsgrænsefladen.

3. Drivere/enheder til virtuelle diske mangler: åbn Enhedshåndtering, og kontrollér under "Systemenheder / Lagringskontrollere", om følgende findes:

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

   Hvis de mangler, kan de tilføjes manuelt via hdwwiz.exe (Lagringskontrollere → Microsoft → Microsoft VHD Loopback Controller), og bekræft, at tjenesten FsDepends ikke er deaktiveret.

4. Importeret afbildning opfylder ikke WSL-kravene: ved brug af wsl --import --vhd skal VHDX have filsystemet ext4; det må ikke være en LUKS-krypteret disk, en almindelig raw.img, en Live ISO eller en tom disk formateret med NTFS/FAT. .img / .qcow2 / .iso kan ikke bruges direkte med wsl --import --vhd.

5. Sti-/rettigheds-/filsystemsproblemer: målmappen skal ligge på en NTFS-disk (FAT32/exFAT virker ikke); undgå kinesiske tegn, mellemrum og specialtegn i stien; importer ikke fra netværksdrev, OneDrive eller komprimerede mapper; brug altid en ægte PowerShell med administratorrettigheder (ikke en almindelig terminal).

6. Beskadigede systemkomponenter: kør DISM og SFC i rækkefølge for at reparere systemkomponenterne, og prøv derefter igen:

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

TIP

Virtuelle maskiner fra tredjeparter (VirtualBox, VMware) eller sandkasse-/hærdningsfunktioner i sikkerhedssoftware (f.eks. 360, Huorong) kan forstyrre handlinger med virtuelle diske; slå dem midlertidigt fra under fejlfindingen, og prøv igen.