Setup & Config WSL

Innan du använder WSL Dashboard måste ditt Windows-system ha WSL 2 korrekt aktiverat och konfigurerat. Det här dokumentet består av följande tre huvuddelar:

1. Aktivera och konfigurera WSL: slutför grundinstallationen och konfigurationen av WSL 2.
2. Ett fungerande kommando är inte samma sak som en lyckad installation: förklarar att ett körbart wsl-kommando inte innebär att Linux kan installeras.
3. Felsökning av misslyckad installation: kontroll- och åtgärdsmetoder när installationen fortfarande misslyckas efter konfigurationen.

1. Aktivera och konfigurera WSL

Det här kapitlet guidar dig genom de nödvändiga grundinställningarna. Efter det här kapitlet, läs kapitel 2 för att förstå skillnaden mellan ett fungerande kommando och en lyckad installation. Om installationen fortfarande ger problem, se kapitel 3.

1.1 Kontrollera systemkraven

WSL 2 har minimikrav på Windows-versionen. Tryck på Win + R, skriv in winver och kontrollera din version:

• Windows 10: version 1903 eller senare, med buildnummer (Build) 18362 eller högre.
• Windows 11: alla versioner stöds.

IMPORTANT

Om din version är för gammal, uppgradera systemet via "Windows Update" först.

1.2 Aktivera hårdvaruvirtualisering

WSL 2 körs på virtualiseringsteknik, så virtualiseringsteknik (Virtualization Technology) måste vara aktiverad i moderkortets BIOS/UEFI.

• Kontrollmetod: öppna "Aktivitetshanteraren" → fliken "Prestanda" → "Processor".
• Kontrollera status: bekräfta att statusen "Virtualisering" längst ner till höger visar "Aktiverad".
• Aktivera: om den inte är aktiverad måste du starta om datorn, gå in i BIOS/UEFI-inställningarna, hitta ett alternativ som Intel VT-x eller AMD-V och ställa in det på Enabled.

1.3 Aktivera Windows-relaterade funktioner

Du måste aktivera funktionerna "Windows-undersystem för Linux" och "Plattform för virtuella datorer".

Metod A: Via grafiskt gränssnitt (rekommenderas)

1. Tryck på Win + S, sök efter och öppna "Slå på eller av Windows-funktioner".
2. Markera följande två alternativ:
   • Windows-undersystem för Linux (Windows Subsystem for Linux)
   • Plattform för virtuella datorer (Virtual Machine Platform)
3. Klicka på "OK" och starta om datorn när du uppmanas.

Metod B: Via kommandoraden (administratörsbehörighet)

Kör PowerShell som administratör och kör följande kommandon:

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

# Aktivera plattform för virtuella datorer
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Starta sedan om datorn manuellt.

1.4 Installera eller uppdatera WSL-kärnan

Moderna Windows-versioner kan få WSL-uppdateringar via Microsoft Store.

• Nedladdningsadress: Microsoft Store - Windows Subsystem for Linux
• Manuell nedladdning: om du inte kan använda Store kan du ladda ner det senaste .msixbundle- eller .msi-installationspaketet från WSL GitHub Releases för offlineinstallation.

1.5 Ange WSL 2 som standardversion

För att säkerställa att nyinstallerade distributioner använder WSL 2 som standard, kör följande i terminalen:

wsl --set-default-version 2

1.6 Vanliga frågor

• Fel 0x80370102: beror vanligtvis på att virtualisering inte är aktiverad i BIOS, eller på en konflikt med Hyper-V.
• Växla mellan WSL 1 och WSL 2: du kan använda wsl --set-version <分发版名称> 2 för att uppgradera en befintlig WSL 1-instans till WSL 2.

2. Ett fungerande kommando är inte samma sak som en lyckad installation

Att kommandon som wsl --version och wsl -l -v kan köras normalt innebär inte att förutsättningarna för att installera Linux redan finns. De befinner sig i olika faser och kan inte likställas.

Att kommandot fungerar säger bara att:

• ✅ WSL-komponenterna i Windows redan är aktiverade/installerade
• ✅ kommandoradsverktyget wsl.exe är tillgängligt
• ✅ systemet känner igen WSL-relaterade kommandon

Men för att lyckas installera en Linux-distribution krävs ytterligare villkor. Vanliga flaskhalsar är:

1. Virtualisering är avstängd: VT-x / AMD-V är inte aktiverat i BIOS/UEFI, WSL 2 kan inte starta, eller ett virtualiseringsfel rapporteras vid installation av en distribution (kontrollmetod: se 1.2 Aktivera hårdvaruvirtualisering).
2. För låg Windows-version/-build: WSL 2 ställer krav på kärna och version; hemversionen och för gamla företagsavbildningar kan sakna funktioner (kontrollmetod: se 1.1 Kontrollera systemkraven).
3. Ingen Linux-distribution har faktiskt installerats ännu: wsl -l -v listar endast installerade distributioner; om inget är installerat är listan tom, vilket inte innebär att Ubuntu kan köras direkt.
4. Nätverks-/Microsoft Store-problem: wsl --install -d <发行版> måste hämta avbildningar från Store eller nätverket; företagsnätverk, proxyservrar och brandväggar kan blockera detta.
5. Otillräckliga behörigheter: att installera en distribution eller ändra WSL-inställningar kräver administratörsbehörighet.

TIP

Kort sagt: att WSL-kommandot fungerar är inte lika med att Linux är redo; du har bara fått "inträdesbiljetten", systemet är ännu inte installerat.

3. Felsökning av misslyckad installation

Om wsl --install fortfarande misslyckas efter att du har slutfört konfigurationen enligt kapitel 1 (eller när du tror att du har slutfört konfigurationen), kontrollera i följande ordning.

3.1 Börja med en one-click-kontroll

Kör PowerShell som administratör och utför följande i tur och ordning:

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

• ✅ Om båda kommandona kan köras utan problem är WSL:s valfria komponenter aktiverade och virtualiseringsvillkoren är i stort sett uppfyllda.
• ❌ Vid felmeddelande anges direkt vad som saknas (t.ex. Plattform för virtuella datorer, Hyper-V, BIOS-virtualisering osv.).

Kör därefter systeminfo och bekräfta att Virtualization Enabled In Firmware: Yes visas i utdata. Om inga fel rapporteras kan du i princip tryggt köra wsl --install för att installera en distribution.

NOTE

Inget kommando kan till 100 % garantera att wsl --install lyckas, men ovanstående kontroller bekräftar om installationsvillkoren är uppfyllda.

3.2 Manuell kontrollista

Om one-click-kontrollen inte kan lokalisera problemet, kontrollera punkt för punkt:

1. Kontrollera om BIOS-/firmwarevirtualisering är aktiverad: kör systeminfo i en PowerShell med administratörsbehörighet; i utdata måste Virtualization Enabled In Firmware: Yes synas.
2. Kontrollera om Windows-funktionerna är aktiverade:

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

   Status för båda kommandona ska vara Enabled.
3. Kontrollera om WSL är tillgängligt: wsl --version ska ge normal utdata; om kommandot inte finns rapporteras WSL-komponenterna inte vara installerade – gå tillbaka till kapitel 1.
4. Kontrollera om WSL 2 kan användas (kärna och plattform för virtuella datorer): wsl --set-default-version 2 ska returneras framgångsrikt. Vanliga orsaker: Plattform för virtuella datorer är inte aktiverad, eller VT-x / AMD-V är inte aktiverat i BIOS.

3.3 Snabbguide för vanliga felorsaker

Situation	Förklaring	Åtgärd
Virtualisering inte aktiverad i BIOS	Misslyckas garanterat	Starta om, gå in i BIOS och aktivera VT-x / AMD-V (se 1.2)
Windows 10 lägre än 19041	wsl --install stöds inte	Uppgradera systemet (se 1.1)
Hyper-V / virtualisering inaktiverat i företagsmiljö	Kan misslyckas	Kontakta systemadministratören
Gammal hemversion av systemet	Kräver manuell installation	Installera WSL-kärnan manuellt enligt 1.4

3.4 Fel 0xc03a0014: ingen provider för virtuella diskar hittades

Felmeddelandet är Cannot find a virtual disk support provider for the specified file. Detta är inte ett problem med själva Linux-distributionen, utan Windows virtuella diskstack (VHD/VHDX) fungerar inte korrekt; WSL 2 misslyckas när den registrerar en distribution och skapar/monterar ext4.vhdx.

Gör först en minimal validering: kör PowerShell som administratör och testa med New-VHD (t.ex. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Om även detta kommando rapporterar samma fel ligger problemet till 100 % på Windows-sidan och inte på distributionen.

Åtgärda i följande ordning:

1. Virtual Disk-tjänsten körs inte: öppna services.msc, hitta tjänsten Virtual Disk, ställ in starttyp på "Automatisk" och starta den.

2. WSL / Plattform för virtuella datorer är inte aktiverade (eller har inte trätt i kraft): kör kommandona i 1.3 Aktivera Windows-relaterade funktioner igen och starta sedan om datorn – detta krävs. Windows Home har inte fullständig Hyper-V, men WSL 2 behöver bara Plattform för virtuella datorer, inte Hyper-V-hanteringsgränssnittet.

3. Drivrutiner/enheter för virtuella diskar saknas: öppna Enhetshanteraren och kontrollera under "Systemenheter / Lagringskontrollenheter" om följande finns:

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

   Om de saknas kan de läggas till manuellt via hdwwiz.exe (Lagringskontrollenheter → Microsoft → Microsoft VHD Loopback Controller) och bekräfta att tjänsten FsDepends inte är inaktiverad.

4. Importerad avbild uppfyller inte WSL-kraven: vid användning av wsl --import --vhd måste VHDX ha filsystemet ext4; det får inte vara en LUKS-krypterad disk, en vanlig raw.img, en Live ISO eller en tom disk formaterad med NTFS/FAT. .img / .qcow2 / .iso kan inte användas direkt med wsl --import --vhd.

5. Sökvägs-/behörighets-/filsystemsproblem: målmappen måste ligga på en NTFS-disk (FAT32/exFAT fungerar inte); undvik kinesiska tecken, mellanslag och specialtecken i sökvägen; importera inte från nätverksdiskar, OneDrive eller komprimerade mappar; använd alltid en riktig PowerShell med administratörsbehörighet (inte en vanlig terminal).

6. Skadade systemkomponenter: kör DISM och SFC i tur och ordning för att reparera systemkomponenterna och försök sedan igen:

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

TIP

Virtuella maskiner från tredje part (VirtualBox, VMware) eller sandlåde-/härdningsfunktioner i säkerhetsprogram (t.ex. 360, Huorong) kan störa åtgärder med virtuella diskar; stäng av dem tillfälligt under felsökningen och försök igen.