Konfigurer WSL

Før du bruger WSL Dashboard, skal dit Windows-system korrekt aktivere og konfigurere WSL 2-miljøet. Dette dokument er opdelt i følgende tre hoveddele:

1. Aktivér og konfigurer WSL: Gennemfør den grundlæggende installation og konfiguration af WSL 2.
2. Kommandoen er tilgængelig ≠ installationen er lykkedes: Forklarer, at en eksekverbar wsl-kommando ikke betyder, at Linux kan installeres med succes.
3. Fejlfinding ved installationsfejl: Metoder til kontrol og reparation, når installationen stadig fejler efter konfigurationen.

1. Aktivér og konfigurer WSL

Dette afsnit vejleder dig gennem den nødvendige grundlæggende opsætning. Når du har gennemført dette afsnit, bedes du læse kapitel 2 for at forstå forskellen mellem en tilgængelig kommando og en vellykket installation; hvis installationen stadig giver problemer, henvises til kapitel 3.

1.1 Kontroller systemkravene

WSL 2 har minimumskrav til Windows-versionen. Tryk på Win + R, og indtast winver for at kontrollere din version:

• Windows 10: version 1903 eller nyere, og buildnummeret skal være 18362 eller nyere.
• Windows 11: Alle versioner understøttes.

IMPORTANT

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

1.2 Aktivér hardwarevirtualisering

WSL 2 kører på virtualiseringsteknologi, så Virtualization Technology skal aktiveres i bundkortets BIOS/UEFI.

• Kontrolmetode: Åbn "Task Manager" -> fanen "Ydeevne" -> "CPU".
• Se status: Kontrollér, at "Virtualisering" i nederste højre hjørne vises som "Aktiveret".
• Aktiveringsmetode: Hvis den ikke er aktiveret, skal du genstarte computeren og gå ind i BIOS/UEFI-indstillingerne, finde en mulighed som Intel VT-x eller AMD-V og indstille den til Enabled.

1.3 Aktivér relevante Windows-funktioner

Du skal aktivere funktionerne "Windows Subsystem for Linux" og "Virtual Machine Platform".

Metode A: Via grafisk grænseflade (anbefalet)

1. Tryk på Win + S, søg efter og åbn "Slå Windows-funktioner til eller fra".
2. Markér følgende to punkter:
   • Windows Subsystem for Linux
   • 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

Når du er færdig, skal du manuelt genstarte computeren.

1.4 Installer/opdater WSL-kernen

Nyere versioner af Windows kan hente WSL-opdateringer via Microsoft Store.

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

1.5 Indstil WSL 2 som standardversion

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

wsl --set-default-version 2

1.6 Ofte stillede spørgsmål

• Fejl 0x80370102: Skyldes normalt, at virtualisering ikke er aktiveret i BIOS, eller at der er en konflikt med Hyper-V.
• Skift mellem WSL 1 og WSL 2: Du kan opgradere en eksisterende WSL 1-instans til WSL 2 med wsl --set-version <distributionsnavn> 2.

2. Kommandoen er tilgængelig ≠ installationen er lykkedes

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

At kommandoen er tilgængelig betyder kun:

• ✅ WSL-komponenten i Windows er aktiveret/installeret
• ✅ Kommandolinjeværktøjet wsl.exe er tilgængeligt
• ✅ Systemet kan genkende WSL-relaterede kommandoer

Men en vellykket installation af en Linux-distribution kræver yderligere betingelser. Almindelige steder, hvor man kan gå i stå:

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-versionen/buildnummeret er for gammelt: WSL 2 har krav til kerne og version; Home-versionen og for gamle enterprise-billeder kan mangle funktioner (kontrolmetode: se 1.1 Kontroller systemkravene).
3. Endnu ingen Linux-distribution installeret: wsl -l -v viser kun installerede distributioner; hvis intet er installeret, er listen tom — det betyder ikke, at man kan køre Ubuntu direkte.
4. Netværks-/Microsoft Store-problemer: wsl --install -d <distribution> skal hente billeder fra butikken eller netværket; virksomhedsnetværk, proxyer og firewalls kan blokere.
5. Utilstrækkelige rettigheder: Installation af distributioner eller ændring af WSL-indstillinger kræver administratorrettigheder.

TIP

Kort sagt: En fungerende WSL-kommando ≠ Linux er klar, du har kun fået "adgangsbilletter", men systemet er ikke reelt installeret endnu.

3. Fejlfinding ved installationsfejl

Hvis wsl --install stadig fejler, efter du har gennemført konfigurationen i henhold til kapitel 1 (eller hvis du mener, du allerede har gennemført den), skal du kontrollere i følgende rækkefølge.

3.1 Start med "one-click-kontrol"

Kør PowerShell med administratorrettigheder og udfør i rækkefølge:

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

• ✅ Hvis begge kommandoer kan køres problemfrit, er WSL-valgfri komponenter aktiveret, og virtualiseringsbetingelserne er stort set opfyldt.
• ❌ Hvis de fejler, vises der direkte, hvad der mangler (f.eks. Virtual Machine Platform, Hyper-V, BIOS-virtualisering osv.).

Kør derefter systeminfo og bekræft, at Virtualization Enabled In Firmware: Yes vises i outputtet. Hvis intet af ovenstående giver fejl, kan du roligt køre wsl --install for at installere en distribution.

NOTE

Ingen kommando kan med 100 % garanti sikre, at wsl --install lykkes, men ovenstående kontrol kan bekræfte, at installationsbetingelserne er opfyldt.

3.2 Manuel kontroltjekliste

Hvis "one-click-kontrol" stadig ikke kan lokalisere problemet, kan du kontrollere punkt for punkt:

1. Kontrollér, om BIOS/firmware-virtualisering er aktiveret: Kør systeminfo i administrator-PowerShell; outputtet skal vise Virtualization Enabled In Firmware: Yes.
2. Kontrollér, om Windows-funktioner 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, er WSL-komponenten ikke installeret — vend tilbage til kapitel 1.
4. Kontrollér, om WSL 2 kan bruges (kerne & Virtual Machine Platform): wsl --set-default-version 2 skal returnere succes. Almindelige fejlårsager: Virtual Machine Platform er ikke aktiveret, eller VT-x / AMD-V er ikke aktiveret i BIOS.

3.3 Hurtig oversigt over almindelige fejlårsager

Situation	Beskrivelse	Håndtering
Virtualisering ikke aktiveret i BIOS	Fejler altid	Genstart, gå ind i BIOS, 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 enterprise-miljø	Kan fejle	Kontakt systemadministratoren
Gammel Home-version	Kræver manuel installation	Installér WSL-kernen manuelt i henhold til 1.4

3.4 Fejl 0xc03a0014: Kan ikke finde udbyderen af support til virtuelle diske

Fejlmeddelelsen er Cannot find a virtual disk support provider for the specified file. Dette er ikke et problem med selve Linux-distributionen, men Windows' VHD/VHDX-stak for virtuelle diske fungerer ikke korrekt, så WSL 2 fejler ved registrering af distributioner og oprettelse/montering af ext4.vhdx.

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

Søg og ret i følgende rækkefølge:

1. Virtual Disk-tjenesten kører ikke: Åbn services.msc, find tjenesten Virtual Disk, indstil starttypen til "Automatisk" og start den.

2. WSL / Virtual Machine Platform-funktionen er ikke aktiveret (eller ikke trådt i kraft): Kør kommandoerne i 1.3 Aktivér relevante Windows-funktioner igen, og genstart derefter obligatorisk. Windows Home har ikke fuldt Hyper-V, men WSL 2 kræver kun Virtual Machine Platform, ikke Hyper-V-administrationsgrænsefladen.

3. Virtuel disk-driver/enhed mangler: Åbn Enhedshåndtering, og kontrollér, om følgende findes under "Systemenheder / Lagringscontrollere":

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

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

4. Det importerede billede opfylder ikke WSL-kravene: Ved brug af wsl --import --vhd skal VHDX'en være et ext4-filsystem, ikke 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-/filsystemproblemer: Målmappen skal ligge på en NTFS-disk (FAT32/exFAT duer ikke); undgå kinesiske tegn, mellemrum og specialtegn i stier; importer ikke fra netværksdrev, OneDrive eller komprimerede mapper; brug altid en ægte administrator-PowerShell (ikke en almindelig terminal).

6. Systemkomponenter er beskadigede: Kør DISM og SFC i rækkefølge for at reparere systemkomponenter, og prøv derefter igen:

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

TIP

Tredjepartsvirtualiseringsmaskiner (VirtualBox, VMware) eller sandkasse-/hærdningsfunktioner i sikkerhedssoftware (f.eks. 360, Huorong) kan forstyrre virtuel disk-operationer; de kan midlertidigt deaktiveres under fejlfinding.