Setup & Config WSL

Ennen kuin käytät WSL Dashboardia, Windows-järjestelmääsi on oltava WSL 2 otettu käyttöön ja määritetty oikein. Tämä dokumentti koostuu seuraavista kolmesta pääosasta:

1. Ota WSL käyttöön ja määritä se: suorita WSL 2:n perusasennus ja -määritys.
2. Toimiva komento ei tarkoita onnistunutta asennusta: selittää, että toimiva wsl-komento ei tarkoita, että Linux voidaan asentaa onnistuneesti.
3. Asennusvirheiden vianmääritys: tarkistus- ja korjaustavat, kun asennus epäonnistuu edelleen määrityksen jälkeen.

1. Ota WSL käyttöön ja määritä se

Tämä luku opastaa sinut tarpeellisten perusasetusten läpi. Tämän luvun jälkeen lue luku 2 ymmärtääksesi eron toimivan komennon ja onnistuneen asennuksen välillä; jos asennus tuottaa edelleen ongelmia, katso luku 3.

1.1 Tarkista järjestelmävaatimukset

WSL 2:lla on vähimmäisvaatimukset Windows-versiolle. Paina Win + R, kirjoita winver ja tarkista versiosi:

• Windows 10: versio 1903 tai uudempi, build-numeron (Build) tulee olla 18362 tai uudempi.
• Windows 11: kaikki versiot tuetaan.

IMPORTANT

Jos versiosi on liian vanha, päivitä järjestelmä ensin "Windows Updaten" kautta.

1.2 Ota laitteistovirtualisointi käyttöön

WSL 2 toimii virtualisointiteknologian avulla, joten virtualisointiteknologia (Virtualization Technology) on otettava käyttöön emolevyn BIOS/UEFI-asetuksissa.

• Tarkistustapa: avaa "Tehtävienhallinta" → "Suorituskyky"-välilehti → "Suoritin".
• Tarkista tila: varmista, että "Virtualisointi"-tila oikeassa alakulmassa näyttää "Käytössä".
• Käyttöönotto: jos se ei ole käytössä, sinun on käynnistettävä tietokone uudelleen, mentävä BIOS/UEFI-asetuksiin, etsittävä vaihtoehto kuten Intel VT-x tai AMD-V ja asetettava se arvoon Enabled.

1.3 Ota Windows-toiminnot käyttöön

Sinun on otettava käyttöön Windowsin "Windows-alijärjestelmä Linuxille" ja "Virtuaalikonealusta" -toiminnot.

Menetelmä A: Graafisen käyttöliittymän kautta (suositeltu)

1. Paina Win + S, etsi ja avaa "Ota Windowsin toiminnot käyttöön tai pois käytöstä".
2. Valitse seuraavat kaksi kohtaa:
   • Windows-alijärjestelmä Linuxille (Windows Subsystem for Linux)
   • Virtuaalikonealusta (Virtual Machine Platform)
3. Napsauta "OK" ja käynnistä tietokone uudelleen, kun siihen kehotetaan.

Menetelmä B: Komentorivin kautta (järjestelmänvalvojan oikeudet)

Suorita PowerShell järjestelmänvalvojana ja suorita seuraavat komennot:

# Ota WSL käyttöön
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Ota virtuaalikonealusta käyttöön
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Suorituksen jälkeen käynnistä tietokone manuaalisesti uudelleen.

1.4 WSL-ytimen asentaminen tai päivittäminen

Nykyaikaiset Windows-versiot voivat hakea WSL-päivitykset Microsoft Storesta.

• Latausosoite: Microsoft Store - Windows Subsystem for Linux
• Manuaalinen lataus: jos Storea ei voi käyttää, voit ladata uusimman .msixbundle- tai .msi-asennuspaketin WSL GitHub Releases -sivulta offline-asennusta varten.

1.5 Määritä WSL 2 oletusversioksi

Varmistaaksesi, että uudet asennetut jakelut käyttävät oletusarvoisesti WSL 2:ta, suorita seuraava komento terminaalissa:

wsl --set-default-version 2

1.6 Usein kysytyt kysymykset

• Virhe 0x80370102: johtuu yleensä siitä, että virtualisointia ei ole otettu käyttöön BIOSissa, tai Hyper-V-ristiriidasta.
• WSL 1:n ja WSL 2:n välillä vaihtaminen: voit käyttää komentoa wsl --set-version <分发版名称> 2 päivittääksesi olemassa olevan WSL 1 -esiintymän WSL 2:ksi.

2. Toimiva komento ei tarkoita onnistunutta asennusta

Se, että komennot kuten wsl --version ja wsl -l -v toimivat normaalisti, ei tarkoita, että edellytykset Linuxin asentamiselle ovat jo olemassa. Ne ovat eri vaiheissa, eikä niitä voi rinnastaa toisiinsa.

Toimiva komento kertoo vain, että:

• ✅ WSL-komponentit Windowsissa on jo otettu käyttöön/asennettu
• ✅ komentorivityökalu wsl.exe on käytettävissä
• ✅ järjestelmä tunnistaa WSL:ään liittyvät komennot

Mutta onnistunut Linux-jakelun asennus edellyttää lisäehtoja. Yleisiä pullonkauloja ovat:

1. Virtualisointi on pois päältä: VT-x / AMD-V ei ole käytössä BIOS/UEFI-asetuksissa, WSL 2 ei käynnisty tai jakelun asennuksen yhteydessä ilmoitetaan virtualisointivirheestä (tarkistustapa: katso 1.2 Ota laitteistovirtualisointi käyttöön).
2. Windows-versio/-build on liian vanha: WSL 2 asettaa vaatimuksia ytimelle ja versiolle; kotiversiossa ja liian vanhoissa yrityslevykuvissa voi puuttua toimintoja (tarkistustapa: katso 1.1 Tarkista järjestelmävaatimukset).
3. Linux-jakelua ei ole vielä asennettu: wsl -l -v luettelee vain asennetut jakelut; jos mitään ei ole asennettu, luettelo on tyhjä, mikä ei tarkoita, että Ubuntu voidaan käynnistää suoraan.
4. Verkko-/Microsoft Store -ongelmat: wsl --install -d <发行版> hakee levykuvat Storesta tai verkosta; yritysverkot, välityspalvelimet ja palomuurit voivat estää tämän.
5. Riittämättömät oikeudet: jakelun asentaminen tai WSL-asetusten muuttaminen edellyttää järjestelmänvalvojan oikeuksia.

TIP

Yksinkertaisesti sanottuna: toimiva WSL-komento ei ole sama kuin Linux on valmis; olet saanut vain "pääsylipun", järjestelmää ei ole vielä asennettu.

3. Asennusvirheiden vianmääritys

Jos wsl --install epäonnistuu edelleen sen jälkeen, kun olet suorittanut määrityksen luvun 1 mukaisesti (tai kun uskot suorittaneesi määrityksen), tarkista seuraavassa järjestyksessä.

3.1 Aloita one-click-tarkistuksella

Suorita PowerShell järjestelmänvalvojana ja suorita seuraavat komennot peräkkäin:

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

• ✅ Jos molemmat komennot toimivat ongelmitta, WSL:n valinnaiset komponentit on otettu käyttöön ja virtualisointiedellytykset täyttyvät pääosin.
• ❌ Jos ne epäonnistuvat, virheilmoitus kertoo suoraan, mitä puuttuu (esim. Virtuaalikonealusta, Hyper-V, BIOS-virtualisointi jne.).

Suorita sen jälkeen systeminfo ja varmista, että tulosteessa näkyy Virtualization Enabled In Firmware: Yes. Jos virheitä ei ole ilmoitettu, voit käytännössä luottavaisin mielin suorittaa wsl --install -komennon jakelun asentamiseksi.

NOTE

Mikään komento ei voi 100 %:n varmuudella taata, että wsl --install onnistuu, mutta yllä olevat tarkistukset vahvistavat, ovatko asennusedellytykset täyttyneet.

3.2 Manuaalinen tarkistuslista

Jos one-click-tarkistus ei pysty paikallistamaan ongelmaa, tarkista kohta kohdalta:

1. Tarkista, onko BIOS-/laiteohjelmistovirtualisointi käytössä: suorita systeminfo PowerShellissä järjestelmänvalvojan oikeuksilla; tulosteessa on näyttävä Virtualization Enabled In Firmware: Yes.
2. Tarkista, ovatko Windows-toiminnot käytössä:

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

   Molempien komentojen tila on oltava Enabled.
3. Tarkista, onko WSL käytettävissä: wsl --version -komennon pitäisi antaa normaali tuloste; jos komentoa ei löydy, WSL-komponentteja ei ole asennettu – palaa lukuun 1.
4. Tarkista, voidaanko WSL 2:ta käyttää (ydin ja virtuaalikonealusta): wsl --set-default-version 2 -komennon pitäisi palata onnistuneesti. Yleisiä syitä: Virtuaalikonealusta ei ole käytössä tai VT-x / AMD-V ei ole käytössä BIOSissa.

3.3 Pikataulukko yleisistä vikasyistä

Tilanne	Selitys	Ratkaisu
Virtualisointi ei ole käytössä BIOSissa	Epäonnistuu varmasti	Käynnistä uudelleen, mene BIOSiin ja ota VT-x / AMD-V käyttöön (katso 1.2)
Windows 10 alle 19041	wsl --install ei tuettu	Päivitä järjestelmä (katso 1.1)
Hyper-V / virtualisointi poistettu käytöstä yritysympäristössä	Saattaa epäonnistua	Ota yhteyttä järjestelmänvalvojaan
Vanha järjestelmän kotiversio	Vaatii manuaalisen asennuksen	Asenna WSL-ydin manuaalisesti kohdan 1.4 mukaan

3.4 Virhe 0xc03a0014: virtuaalilevyn tukipalveluntarjoajaa ei löydy

Virheilmoitus on Cannot find a virtual disk support provider for the specified file. Tämä ei ole itse Linux-jakelun ongelma, vaan Windowsin virtuaalilevypino (VHD/VHDX) ei toimi oikein; WSL 2 epäonnistuu jakelun rekisteröinnissä ja ext4.vhdx-tiedoston luonnissa/liittämisessä.

Tee ensin pienin mahdollinen tarkistus: suorita PowerShell järjestelmänvalvojana ja testaa komennolla New-VHD (esim. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Jos myös tämä komento antaa saman virheen, ongelma on 100 % Windows-puolella, ei jakelussa.

Korjaa ongelma seuraavassa järjestyksessä:

1. Virtual Disk -palvelu ei ole käynnissä: avaa services.msc, etsi Virtual Disk -palvelu, aseta käynnistystyypiksi "Automaattinen" ja käynnistä se.

2. WSL / Virtuaalikonealusta ei ole käytössä (tai ei ole tullut voimaan): suorita kohdan 1.3 Ota Windows-toiminnot käyttöön komennot uudelleen ja käynnistä sitten tietokone uudelleen – tämä on pakollista. Windows Home -versiossa ei ole täydellistä Hyper-V:tä, mutta WSL 2 tarvitsee vain Virtuaalikonealustan, ei Hyper-V-hallintakäyttöliittymää.

3. Virtuaalilevyn ajurit/laitteet puuttuvat: avaa Laitehallinta ja tarkista kohdasta "Järjestelmälaitteet / Tallennusohjaimet", löytyvätkö seuraavat:

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

   Jos ne puuttuvat, ne voidaan lisätä manuaalisesti hdwwiz.exe-työkalulla (Tallennusohjaimet → Microsoft → Microsoft VHD Loopback Controller), ja varmista, että FsDepends-palvelua ei ole poistettu käytöstä.

4. Tuotu levykuva ei täytä WSL:n vaatimuksia: kun käytät wsl --import --vhd -komentoa, VHDX-tiedoston on oltava ext4-tiedostojärjestelmässä; se ei saa olla LUKS-salattu levy, tavallinen raw.img, Live ISO tai NTFS/FAT-muotoiltu tyhjä levy. .img / .qcow2 / .iso -tiedostoja ei voi käyttää suoraan wsl --import --vhd -komennolla.

5. Polku-/oikeus-/tiedostojärjestelmäongelmat: kohdekansion on sijaittava NTFS-levyllä (FAT32/exFAT ei toimi); vältä kiinalaisia merkkejä, välilyöntejä ja erikoismerkkejä polussa; älä tuo levykuvia verkkolevyltä, OneDrivesta tai pakatuista kansioista; käytä aina aitoa PowerShell-istuntoa järjestelmänvalvojan oikeuksilla (ei tavallista terminaalia).

6. Vaurioituneet järjestelmäkomponentit: suorita DISM ja SFC peräkkäin järjestelmäkomponenttien korjaamiseksi ja yritä sitten uudelleen:

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

TIP

Kolmannen osapuolen virtuaalikoneet (VirtualBox, VMware) tai tietoturvaohjelmistojen hiekkalaatikko-/kovennustoiminnot (kuten 360, Huorong) voivat häiritä virtuaalilevytoimintoja; poista ne väliaikaisesti käytöstä vianmäärityksen aikana ja yritä uudelleen.