Setup & Config WSL

A WSL Dashboard használata előtt a Windows rendszerén megfelelően engedélyezve és konfigurálva kell lennie a WSL 2 környezetnek. Ez a dokumentum három fő részre oszlik:

1. A WSL engedélyezése és konfigurálása: A WSL 2 alapvető 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ósága nem jelenti azt, hogy a Linux sikeresen telepíthető.
3. Telepítési hibák elhárítása: Ellenőrzési és javítási módszerek arra az esetre, ha a konfigurálás után a telepítés továbbra is sikertelen.

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, hogy megértse a különbséget a parancs elérhetősége és a sikeres telepítés között; ha a telepítéssel továbbra is problémák adódnak, tekintse meg a 3. fejezetet.

1.1 Rendszerkövetelmények ellenőrzése

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

• Windows 10: 1903-as vagy újabb verzió, 18362-es vagy magasabb build szám.
• Windows 11: Minden verzió támogatott.

IMPORTANT

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

1.2 Hardveres virtualizáció engedélyezése

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

• Ellenőrzési mód: Nyissa meg a "Feladatkezelőt" (Task Manager) → "Teljesítmény" (Performance) fül → "CPU".
• Állapot ellenőrzése: Győződjön meg róla, hogy a jobb alsó sarokban lévő "Virtualizáció" (Virtualization) állapot "Engedélyezve" (Enabled) értéket mutat.
• Engedélyezé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, keressen egy Intel VT-x vagy AMD-V jellegű opciót, és állítsa Enabled értékre.

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

Engedélyeznie kell a Windows "Linuxhoz készült Windows alrendszer" (Windows Subsystem for Linux) és "Virtuális gépek platformja" (Virtual Machine Platform) funkcióit.

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

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

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

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

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

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

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

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

A Windows modern verziói a Microsoft Store-on keresztül kaphatnak WSL-frissítéseket.

• Letöltési cím: Microsoft Store - Windows Subsystem for Linux
• Manuális letöltés: Ha nem tudja használni a Store-t, letöltheti a legújabb .msixbundle vagy .msi telepítőcsomagot 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 a WSL 2-t használják, futtassa a következőt a terminálban:

wsl --set-default-version 2

1.6 Gyakori kérdések

• 0x80370102 hiba: Általában az okozza, hogy a BIOS-ban nincs engedélyezve a virtualizáció, vagy konfliktus van a Hyper-V-vel.
• Váltás a WSL 1 és a WSL 2 között: A wsl --set-version <disztribúció-neve> 2 paranccsal frissítheti a meglévő WSL 1 példányt WSL 2-re.

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

Az, hogy az olyan parancsok, mint a wsl --version, wsl -l -v hibátlanul lefutnak, nem jelenti azt, hogy a Linux telepítéséhez szükséges feltételek már teljesülnek. A kettő különböző szakaszban van, és nem tehető egyenlőségjel közéjük.

A parancs elérhetősége csak azt jelenti:

• ✅ A WSL-összetevők engedélyezve / telepítve vannak a Windowsban
• ✅ 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ételeknek is teljesülniük kell. A gyakori elakadási pontok a következők:

1. A virtualizáció ki van kapcsolva: A VT-x / AMD-V nincs engedélyezve a BIOS/UEFI-ben, a WSL 2 nem tud elindulni, vagy virtualizációs hibát jelez a disztribúció telepítésekor (ellenőrzési mód: 1.2 Hardveres virtualizáció engedélyezése).
2. Túl régi Windows-verzió / build szám: A WSL 2 követelményeket támaszt a kernel és a verzió felé; a Home kiadás vagy a túl régi vállalati lemezképek hiányos funkciókkal rendelkezhetnek (ellenőrzési mód: 1.1 Rendszerkövetelmények ellenőrzése).
3. Még nincs ténylegesen telepítve Linux-disztribúció: A wsl -l -v csak a telepített disztribúciókat listázza; ha semmi nincs telepítve, a lista üres, és ez 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 le kell töltenie a lemezképet a Store-ból vagy a hálózatról; a céges hálózat, a proxy és a tűzfal mind blokkolhatja ezt.
5. Elégtelen jogosultságok: A disztribúció 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-parancs működik ≠ a Linux készen áll; csak a "belépőjegyet" kapta meg, de még nincs ténylegesen telepítve a rendszer.

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

Ha az 1. fejezet szerint elvégezte a konfigurálást (vagy úgy gondolja, hogy már elvégezte), de a wsl --install továbbra is sikertelen, ellenőrizze a következő sorrendben.

3.1 Először végezze el az "egy kattintásos ellenőrzést"

Futtassa a PowerShellt rendszergazdaként, és hajtsa végre egymás után:

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

• ✅ Ha mindkét parancs hibátlanul lefut, az azt jelenti, hogy a WSL opcionális összetevői engedélyezve vannak, és a virtualizációs feltételek nagyjából teljesülnek.
• ❌ Ha sikertelen, azonnal jelzi, hogy mi hiányzik (pl. Virtuális gépek platformja, Hyper-V, BIOS-virtualizáció stb.).

Ezután futtassa a systeminfo parancsot, és győződjön meg róla, hogy a kimenetben szerepel a Virtualization Enabled In Firmware: Yes szöveg. Ha a fentiekben nincs hiba, nagyjából nyugodtan futtathatja a wsl --install parancsot a disztribúció telepítéséhez.

NOTE

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

3.2 Kézi ellenőrzési lista

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

1. A BIOS/belső vezérlőprogram (firmware) virtualizációjának ellenőrzése: Rendszergazdai PowerShellben futtassa a systeminfo parancsot; a kimenetben szerepelnie kell a Virtualization Enabled In Firmware: Yes értéknek.
2. A Windows-funkciók engedélyezésének ellenőrzése:

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

   Mindkét parancs állapotának Enabled értékűnek kell lennie.
3. A WSL elérhetőségének ellenőrzése: Futtassa a wsl --version parancsot; normál kimenetet kell kapnia; ha azt jelzi, hogy a parancs nem létezik, az azt jelenti, hogy a WSL-összetevők nincsenek telepítve; térjen vissza az 1. fejezethez.
4. A WSL 2 használhatóságának ellenőrzése (kernel és virtuális gépek platformja): A wsl --set-default-version 2 parancsnak sikeresen vissza kell térnie. Gyakori hibaokok: nincs engedélyezve a virtuális gépek platformja, vagy a BIOS-ban nincs engedélyezve a VT-x / AMD-V.

3.3 Gyakori hibaokok gyors áttekintése

Eset	Magyarázat	Kezelési mód
A BIOS-ban nincs engedélyezve a virtualizáció	Biztosan sikertelen	Indítsa újra, lépjen be a BIOS-ba, és engedélyezze a VT-x / AMD-V-t (lásd 1.2)
Windows 10 19041 alatt	A wsl --install nem támogatott	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 kiadású rendszer	Kézi telepítés szükséges	Telepítse manuálisan a WSL-kernelt az 1.4 pont szerint

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

A hibaüzenet a következő: Cannot find a virtual disk support provider for the specified file. Ez nem a Linux-disztribúció problémája, hanem az, hogy a Windows VHD/VHDX virtuális lemezrendszere (stack) nem működik megfelelően; a WSL 2 a disztribúció regisztrálásakor vagy az ext4.vhdx létrehozásakor / csatlakoztatásakor hibázik.

Először végezze el a minimális ellenőrzést: Futtassa a PowerShellt rendszergazdaként, és tesztelje a New-VHD parancsot (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 oldalán van, és nem függ a disztribúciótól.

Ellenőrizze és javítsa a következő sorrendben:

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 érvénybe): Futtassa újra az 1.3 A Windows kapcsolódó funkcióinak engedélyezése részben szereplő parancsokat, majd újra kell indítania a gépet. A Windows Home kiadásában nincs teljes Hyper-V, de a WSL 2-nek csak a virtuális gépek platformjára van szüksége, nem a Hyper-V felügyeleti felületére.

3. Hiányzó virtuális lemez-illesztőprogramok / eszközök: Nyissa meg az Eszközkezelőt (Device Manager), és ellenőrizze, hogy a "Rendszereszközök / Tárolóvezérlők" között szerepelnek-e a következők:

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

   Ha hiányoznak, manuálisan hozzáadhatók a hdwwiz.exe segítségével (Tárolóvezérlők → Microsoft → Microsoft VHD Loopback Controller), és győződjön meg róla, hogy a FsDepends szolgáltatás nincs letiltva.

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

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

6. Sérült rendszerösszetevők: Futtassa egymás után a DISM és az SFC parancsokat a rendszerösszetevők javításához, majd próbálja újra:

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

TIP

A harmadik féltől származó virtualizációs szoftverek (VirtualBox, VMware) vagy a biztonsági szoftverek sandbox/megerősítő funkciói (mint a 360, Huorong) zavarhatják a virtuális lemezműveleteket; hibakeresés közben ideiglenesen kikapcsolhatja őket.