WSL beállítása

A WSL Dashboard használata előtt Windows rendszerén megfelelően engedélyeznie és konfigurálnia kell a WSL 2 környezetet. Ez a dokumentum a következő három nagy részre oszlik:

1. A WSL engedélyezése és konfigurálása: A WSL 2 alap telepítésének és konfigurálásának elvégzése.
2. A parancs elérhetősége nem jelenti a sikeres telepítést: Azt mutatja be, hogy a wsl parancs futtatható még nem jelenti azt, hogy Linux sikeresen telepíthető.
3. Telepítési hibák elhárítása: A konfigurálás után sikertelen telepítés esetén követendő ellenőrzési és javítási módszerek.

1. A WSL engedélyezése és konfigurálása

Ez a fejezet végigvezeti Önt a szükséges alapbeállításokon. A fejezet elvégzése után olvassa el a 2. fejezetet a parancs elérhetősége és a sikeres telepítés közötti különbségről; ha a telepítés továbbra is problémás, tekintse meg a 3. fejezetet.

1.1 Rendszerkövetelmények ellenőrzése

A WSL 2 minimális követelményeket támaszt a Windows verzióval szemben. Nyomja meg a Win + R billentyűket, írja be a winver parancsot a verzió ellenőrzéséhez:

• Windows 10: 1903-as verzió vagy újabb, és a build számnak 18362 vagy újabbnak kell lennie.
• Windows 11: Minden verzió támogatott.

IMPORTANT

Ha a verzió túl régi, először frissítse a rendszert a "Windows Update" segítségével.

1.2 Hardveres virtualizáció bekapcsolása

A WSL 2 virtualizációs technológián fut, ezért az alaplap BIOS/UEFI beállításaiban engedélyezni kell a virtualizációs technológiát (Virtualization Technology).

• Ellenőrzési mód: Nyissa meg a "Feladatkezelőt" -> "Teljesítmény" fület -> "CPU".
• Állapot megtekintése: Ellenőrizze, hogy a jobb alsó sarokban a "Virtualizáció" állapota "Engedélyezve" legyen.
• Bekapcsolási mód: Ha nincs engedélyezve, indítsa újra a számítógépet, lépjen be a BIOS/UEFI beállításokba, keresse meg a Intel VT-x vagy AMD-V jellegű opciót, és állítsa Enabled értékre.

1.3 A kapcsolódó Windows funkciók engedélyezése

Engedélyeznie kell a Windows "Linuxhoz készült Windows alrendszer" és "Virtuális gépek platformja" funkciókat.

A módszer: Grafikus felületen keresztül (ajánlott)

1. Nyomja meg a Win + S billentyűket, keressen és nyissa meg a "Windows-funkciók be- vagy kikapcsolása" elemet.
2. Jelölje be a következő két opciót:
   • Linuxhoz készült Windows alrendszer (Windows Subsystem for Linux)
   • Virtuális gépek platformja (Virtual Machine Platform)
3. Kattintson az "OK" gombra, és indítsa újra a számítógépet, ha a rendszer kéri.

B módszer: Parancssoron keresztül (rendszergazdai jogosultság)

Futtassa a PowerShellt rendszergazdaként, és hajtsa végre a következő parancsokat:

# A WSL engedélyezése
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# A Virtuális gépek platformja engedélyezése
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

A végrehajtás után indítsa újra a számítógépet kézzel.

1.4 A WSL kernel telepítése/frissítése

A modern Windows verziók a Microsoft Store-ból kaphatják meg a WSL-frissítéseket.

• Letöltési cím: Microsoft Store – Windows Subsystem for Linux
• Kézi letöltés: Ha a Store nem érhető el, a legújabb .msixbundle vagy .msi telepítőcsomag letölthető a WSL GitHub Releases oldalról offline telepítéshez.

1.5 A WSL 2 beállítása alapértelmezett verzióként

Annak biztosításához, hogy az újonnan telepített disztribúciók alapértelmezés szerint WSL 2-t használjanak, futtassa a terminálban:

wsl --set-default-version 2

1.6 Gyakori kérdések

• 0x80370102 hiba: Általában a virtualizáció nincs bekapcsolva a BIOS-ban, vagy Hyper-V ütközés van.
• WSL 1 és WSL 2 közötti váltás: A meglévő WSL 1 példányt a wsl --set-version <disztribúció_neve> 2 paranccsal frissítheti WSL 2-re.

2. A parancs elérhetősége nem jelenti a sikeres telepítést

Az, hogy a wsl --version, wsl -l -v stb. parancsok megfelelően végrehajthatók, még nem jelenti azt, hogy a Linux telepítésének feltételei biztosítottak. Ez a kettő különböző szakasz, nem tehető egyenlőségjel közéjük.

A parancs elérhetősége csak annyit jelent, hogy:

• ✅ A WSL összetevők engedélyezve/telepítve vannak a Windows-ban
• ✅ A wsl.exe parancssori eszköz elérhető
• ✅ A rendszer felismeri a WSL-hez kapcsolódó parancsokat

A Linux disztribúció sikeres telepítéséhez azonban további feltételek szükségesek. A gyakori elakadási pontok:

1. A virtualizáció ki van kapcsolva: A BIOS/UEFI beállításaiban nincs engedélyezve a VT-x / AMD-V, így a WSL 2 nem indul, vagy a disztribúció telepítésekor virtualizációs hibát jelez (ellenőrzési mód: 1.2 Hardveres virtualizáció bekapcsolása).
2. A Windows verzió/build száma túl alacsony: A WSL 2 követelményeket támaszt a kernel és a verzió felé; a Home kiadás és a túl régi vállalati rendszerképek hiányosak lehetnek (ellenőrzési mód: 1.1 Rendszerkövetelmények ellenőrzése).
3. A Linux disztribúció ténylegesen még nincs telepítve: A wsl -l -v csak a telepített disztribúciókat listázza; ha semmi nincs telepítve, a lista üres, ami nem jelenti azt, hogy az Ubuntu közvetlenül futtatható.
4. Hálózati / Microsoft Store problémák: A wsl --install -d <disztribúció> parancsnak a Store-ból vagy hálózatról kell letöltenie a rendszerképet; a vállalati hálózat, proxy és tűzfal mind akadályozhatják.
5. Elégtelen jogosultságok: A disztribúciók telepítéséhez vagy a WSL beállítások módosításához rendszergazdai jogosultság szükséges.

TIP

Egyszerűen fogalmazva: a WSL parancsok működése ≠ a Linux készen áll, csak a "belépőjegyet" kapta meg, de a rendszer még nincs ténylegesen telepítve.

3. Telepítési hibák elhárítása

Ha a 1. fejezet szerinti konfiguráció elvégzése után (vagy ha Ön úgy gondolja, hogy elvégezte) a wsl --install továbbra is hibát jelez, ellenőrizze a következő sorrendben.

3.1 Először az "egygombos ellenőrzés"

Futtassa a PowerShellt rendszergazdaként, és hajtsa végre sorrendben:

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

• ✅ Ha mindkét parancs zökkenőmentesen lefut, a WSL választható összetevői engedélyezve vannak, és a virtualizációs feltételek nagyjából teljesülnek.
• ❌ Ha hiba történik, közvetlenül jelzi, mi hiányzik (pl. Virtuális gépek platformja, Hyper-V, BIOS virtualizáció stb.).

Ezután futtassa a systeminfo parancsot, és ellenőrizze, hogy a kimenetben megjelenik a Virtualization Enabled In Firmware: Yes sor. Ha a fentiek mind hiba nélkül lefutnak, nagyjából nyugodtan futtathatja a wsl --install parancsot a disztribúció telepítéséhez.

NOTE

Semmilyen parancs nem garantálja 100%-osan a wsl --install sikerét, de a fenti ellenőrzések megerősítik, hogy a telepítési feltételek teljesülnek-e.

3.2 Kézi ellenőrző lista

Ha az "egygombos ellenőrzés" sem tudja azonosítani a problémát, ellenőrizze pontról pontra:

1. A BIOS/firmware virtualizáció bekapcsolásának ellenőrzése: Rendszergazdai PowerShellben futtassa a systeminfo parancsot; a kimenetben szerepelnie kell a Virtualization Enabled In Firmware: Yes sornak.
2. A Windows funkciók bekapcsoltságának ellenőrzése:

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

   Mindkét parancs állapotának Enabled értéknek kell lennie.
3. A WSL elérhetőségének ellenőrzése: A wsl --version parancsnak normál kimenetet kell adnia; ha a parancs nem létezik, a WSL összetevők nincsenek telepítve, térjen vissza a 1. fejezethez.
4. A WSL 2 használatának ellenőrzése (kernel & Virtuális gépek platformja): A wsl --set-default-version 2 parancsnak sikeresen vissza kell térnie. Gyakori okok: a Virtuális gépek platformja nincs engedélyezve, vagy a BIOS-ban nincs bekapcsolva a VT-x / AMD-V.

3.3 Gyakori hibaokok gyors áttekintése

Helyzet	Leírás	Kezelési mód
A BIOS-ban nincs bekapcsolva a virtualizáció	Mindenképpen hiba	Indítsa újra, lépjen be a BIOS-ba, és kapcsolja be a VT-x / AMD-V-t (lásd 1.2)
Windows 10 alacsonyabb, mint 19041	Nem támogatja a wsl --install parancsot	Frissítse a rendszert (lásd 1.1)
Vállalati környezetben letiltott Hyper-V / virtualizáció	Lehetséges hiba	Forduljon a rendszergazdához
Régi Home verziójú rendszer	Kézi telepítés szükséges	Telepítse kézzel a WSL kernelt az 1.4 szerint

3.4 0xc03a0014 hiba: A virtuális lemez támogató szolgáltatója nem található

A hibajelentés: Cannot find a virtual disk support provider for the specified file. Ez nem a Linux disztribúció problémája, hanem a Windows VHD/VHDX virtuális lemez-stackje nem működik megfelelően, a WSL 2 nem tudja regisztrálni a disztribúciót, vagy létrehozni/csatolni az ext4.vhdx fájlt.

Először végezzen minimális ellenőrzést: Futtassa a PowerShellt rendszergazdaként, és tesztelje a New-VHD paranccsal (pl. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Ha ez a parancs is ugyanezt a hibát jelzi, a probléma 100%-ban a Windows oldalon van, nem a disztribúcióban.

A hibaelhárítás és javítás sorrendje:

1. A Virtual Disk szolgáltatás nem fut: Nyissa meg a services.msc fájlt, keresse meg a Virtual Disk szolgáltatást, állítsa az indítási típust "Automatikus" értékre, és indítsa el.

2. A WSL / Virtuális gépek platformja funkció nincs engedélyezve (vagy nem lépett életbe): Hajtsa végre újra a 1.3 A kapcsolódó Windows funkciók engedélyezése részben szereplő parancsokat, majd újra kell indítani a rendszert. A Windows Home kiadásban nincs teljes Hyper-V, de a WSL 2 csak a Virtuális gépek platformját igényli, nem a Hyper-V felügyeleti felületét.

3. A virtuális lemez illesztőprogramja/eszköze hiányzik: Nyissa meg az Eszközkezelőt, és ellenőrizze, hogy a "Rendszereszközök / Tárhelyvezérlők" között megtalálhatók-e:

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

   Ha hiányzik, kézzel adhatja hozzá a hdwwiz.exe segítségével (Tárhelyvezérlők → Microsoft → Microsoft VHD hurokvezérlő), és győződjön meg arról, hogy a FsDepends szolgáltatás nincs letiltva.

4. Az importált rendszerkép nem felel meg a WSL követelményeinek: A wsl --import --vhd használatakor a VHDX fájlnak ext4 fájlrendszerűnek kell lennie; nem lehet LUKS titkosított lemez, sima raw.img, Live ISO vagy NTFS/FAT formázott üres lemez. A .img / .qcow2 / .iso fájlok nem használhatók közvetlenül a wsl --import --vhd paranccsal.

5. Útvonal/jogosultság/fájlrendszer problémák: A célkönyvtárnak NTFS lemezen kell lennie (FAT32/exFAT nem megfelelő); az útvonalban kerülje a kínai karaktereket, szóközöket és speciális szimbólumokat; ne importáljon hálózati lemezről, OneDrive-ról vagy tömörített mappából; mindenképpen valódi rendszergazdai PowerShellt használjon (nem sima terminált).

6. Rendszerösszetevők sérülése: Sorban futtassa a DISM és SFC parancsokat a rendszerösszetevők javításához, majd próbálkozzon újra:

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

TIP

A harmadik féltől származó virtuális gépek (VirtualBox, VMware) vagy biztonsági szoftverek sandbox/megerősítő funkciói (pl. 360, Huorong) zavarhatják a virtuális lemez műveleteket; hibaelhárításkor ideiglenesen kapcsolja ki őket, majd próbálja újra.