WSL:n määritys

Ennen WSL Dashboardin käyttöä Windows-järjestelmässäsi on oltava oikein käytössä ja määritetty WSL 2 -ympäristö. Tämä dokumentti jakautuu seuraaviin kolmeen pääosaan:

1. WSL:n käyttöönotto ja määritys: WSL 2:n perusasennuksen ja määrityksen suorittaminen.
2. Komennon toimivuus ei tarkoita asennuksen onnistumista: Selittää, että suoritettava wsl-komento ei tarkoita, että Linux voidaan asentaa onnistuneesti.
3. Asennusvirheiden vianmääritys: Tarkistus- ja korjausmenetelmät, kun asennus epäonnistuu määritysten jälkeen.

1. WSL:n käyttöönotto ja määritys

Tämä luku opastaa sinut tarvittavien perusasetusten läpi. Kun olet suorittanut tämän luvun, lue luku 2 ymmärtääksesi komennon toimivuuden ja onnistuneen asennuksen välisen eron; jos asennuksessa on edelleen ongelmia, katso luku 3.

1.1 Tarkista järjestelmävaatimukset

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

• Windows 10: versio 1903 tai uudempi, ja koontiversion (Build) on oltava 18362 tai uudempi.
• Windows 11: Kaikki versiot ovat tuettuja.

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 pohjalta, joten Virtualization Technology on otettava käyttöön emolevyn BIOS/UEFI-asetuksissa.

• Tarkistustapa: Avaa "Tehtävienhallinta" -> "Suorituskyky"-välilehti -> "CPU".
• Tilan tarkistus: Varmista, että oikean alakulman "Virtualisointi"-tila näyttää "Käytössä".
• Käyttöönottotapa: Jos se ei ole käytössä, sinun on käynnistettävä tietokone uudelleen ja mentävä BIOS/UEFI-asetuksiin, löydettävä vaihtoehto kuten Intel VT-x tai AMD-V ja asetettava se Enabled-tilaan.

1.3 Ota Windowsin liittyvät ominaisuudet käyttöön

Sinun on otettava käyttöön "Windows Subsystem for Linux" - ja "Virtual Machine Platform" -ominaisuudet.

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

1. Paina Win + S, etsi ja avaa "Windowsin ominaisuuksien ottaminen käyttöön tai poistaminen käytöstä".
2. Valitse seuraavat kaksi kohtaa:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. Napsauta "OK" ja käynnistä tietokone uudelleen, kun siitä pyydetään.

Tapa 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 Virtual Machine Platform käyttöön
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Kun olet valmis, käynnistä tietokone uudelleen manuaalisesti.

1.4 Asenna/päivitä WSL-ydin

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

• Latausosoite: Microsoft Store - Windows Subsystem for Linux
• Manuaalinen lataus: Jos et voi käyttää kauppaa, voit ladata uusimman .msixbundle- tai .msi-paketin WSL GitHub Releases -sivulta offline-asennusta varten.

1.5 Aseta WSL 2 oletusversioksi

Varmistaaksesi, että uudet jakelut käyttävät oletuksena WSL 2:ta, suorita 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:ssä on ristiriita.
• WSL 1:n ja WSL 2:n vaihtaminen: Voit päivittää olemassa olevan WSL 1 -esiintymän WSL 2:ksi komennolla wsl --set-version <jakelun nimi> 2.

2. Komennon toimivuus ei tarkoita asennuksen onnistumista

Se, että komennot kuten wsl --version ja wsl -l -v toimivat normaalisti, ei tarkoita, että Linuxin asennuksen edellytykset täyttyvät. Nämä ovat eri vaiheissa eivätkä ole sama asia.

Komennon toimivuus tarkoittaa vain:

• ✅ Windowsin WSL-komponentti on käytössä/asennettu
• ✅ wsl.exe-komentorivityökalu on käytettävissä
• ✅ Järjestelmä tunnistaa WSL-liittyvät komennot

Mutta onnistunut Linux-jakelun asennus vaatii lisäedellytyksiä. Yleisiä kohtia, joissa voi jäädä jumiin:

1. Virtualisointi on pois päältä: VT-x / AMD-V ei ole käytössä BIOS/UEFI:ssa, WSL 2 ei käynnisty tai jakelun asennuksessa ilmoitetaan virtualisointivirhe (tarkistustapa: katso 1.2 Ota laitteistovirtualisointi käyttöön).
2. Windows-versio/koontiversio on liian vanha: WSL 2:lla on vaatimuksia ytimelle ja versiolle; Home-versiossa ja liian vanhoissa yrityskuvissa voi puuttua ominaisuuksia (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ä, eikä se tarkoita, että Ubuntu voidaan käynnistää suoraan.
4. Verkko-/Microsoft Store -ongelmat: wsl --install -d <jakelu> tarvitsee kuvien noutamisen kaupasta tai verkosta; yritysverkot, välityspalvelimet ja palomuurit voivat estää toiminnan.
5. Riittämättömät oikeudet: Jakelun asentaminen tai WSL-asetusten muuttaminen vaatii järjestelmänvalvojan oikeudet.

TIP

Yksinkertaisesti: Toimiva WSL-komento ≠ Linux valmis, olet vain saanut "pääsylipun", mutta järjestelmää ei ole vielä oikeasti asennettu.

3. Asennusvirheiden vianmääritys

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

3.1 Tee ensin "yhdellä napsautuksella -tarkistus"

Suorita PowerShell järjestelmänvalvojana ja suorita järjestyksessä:

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, ilmoitus kertoo suoraan, mitä puuttuu (esim. Virtual Machine Platform, Hyper-V, BIOS-virtualisointi jne.).

Suorita sitten systeminfo ja varmista, että tulosteessa näkyy Virtualization Enabled In Firmware: Yes. Jos mikään edellä olevista ei anna virhettä, voit luottavaisin mielin suorittaa wsl --install-komennon jakelun asentamiseksi.

NOTE

Mikään komento ei voi 100 %:sesti taata, että wsl --install onnistuu, mutta edellä olevat tarkistukset voivat varmistaa, että asennusedellytykset täyttyvät.

3.2 Manuaalinen tarkistusluettelo

Jos "yhdellä napsautuksella -tarkistus" ei edelleenkään löydä ongelmaa, voit tarkistaa kohdat yksitellen:

1. Tarkista, onko BIOS/laiteohjelmiston virtualisointi käytössä: Suorita systeminfo järjestelmänvalvojan PowerShellissä; tulosteessa on näyttävä Virtualization Enabled In Firmware: Yes.
2. Tarkista, onko Windows-ominaisuudet otettu käyttöön:

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

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

3.3 Yleisten epäonnistumissyiden pikaopas

Tilanne	Kuvaus	Käsittelytapa
Virtualisointi ei käytössä BIOSissa	Epäonnistuu aina	Käynnistä uudelleen, mene BIOSiin, ota VT-x / AMD-V käyttöön (katso 1.2)
Windows 10 vanhempi kuin 19041	wsl --install ei ole tuettu	Päivitä järjestelmä (katso 1.1)
Hyper-V / virtualisointi estetty yritysympäristössä	Voi epäonnistua	Ota yhteyttä järjestelmänvalvojaan
Vanha Home-versio	Vaatii manuaalisen asennuksen	Asenna WSL-ydin manuaalisesti 1.4 kohdan mukaan

3.4 Virhe 0xc03a0014: Virtuaalilevyn tuen tarjoajaa ei löydy

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

Tee ensin minimaalinen varmistus: Suorita PowerShell järjestelmänvalvojana ja suorita New-VHD-testi (esim. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Jos tämä komento antaa myös saman virheen, ongelma on 100 % Windows-päässä eikä jakelussa.

Vianmääritys ja korjaus 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 / Virtual Machine Platform -ominaisuus ei ole käytössä (tai ei ole tullut voimaan): Suorita 1.3 Ota Windowsin liittyvät ominaisuudet käyttöön -kohdan komennot uudelleen ja käynnistä sitten tietokone uudelleen — pakollisesti. Windows Home -versiossa ei ole täydellistä Hyper-V:tä, mutta WSL 2 vaatii vain Virtual Machine Platformin, ei Hyper-V-hallintakäyttöliittymää.

3. Virtuaalilevyn ajuri/laite puuttuu: Avaa Laitehallinta ja tarkista, onko kohdassa "Järjestelmälaitteet / Tallennusohjaimet" seuraavat:

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

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

4. Tuotu levykuva ei täytä WSL:n vaatimuksia: Käytettäessä wsl --import --vhd -komentoa VHDX:n on oltava ext4-tiedostojärjestelmä, ei 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: Kohdehakemiston on sijaittava NTFS-levyllä (FAT32/exFAT ei käy); vältä kiinalaisia merkkejä, välilyöntejä ja erikoismerkkejä poluissa; älä tuo verkkolevyltä, OneDrivesta tai pakatuista kansioista; käytä aina oikeaa järjestelmänvalvojan PowerShelliä (ei tavallista terminaalia).

6. Järjestelmäkomponentit ovat vaurioituneet: Suorita DISM ja SFC järjestyksessä järjestelmäkomponenttien korjaamiseksi ja yritä sitten uudelleen:

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

TIP

Kolmannen osapuolen virtuaalikoneet (VirtualBox, VMware) tai suojausohjelmistojen hiekkalaatikko-/kovennustoiminnot (kuten 360, Huorong) voivat häiritä virtuaalilevytoimintoja; vianmäärityksen aikana ne voi tilapäisesti sulkea.