Setup & Config WSL

Pred uporabo aplikacije WSL Dashboard mora vaš sistem Windows pravilno omogočiti in konfigurirati okolje WSL 2. Ta dokumentacija je sestavljena iz treh glavnih delov:

1. Omogočanje in konfiguracija WSL: osnovni koraki namestitve in konfiguracije WSL 2.
2. Delovanje ukazov ne pomeni uspešne namestitve: pojasnjuje, da izvedljiv ukaz wsl ne zagotavlja uspešne namestitve sistema Linux.
3. Odpravljanje težav pri namestitvi: načini preverjanja in popravila, če namestitev po končani konfiguraciji še vedno spodleti.

1. Omogočanje in konfiguracija WSL

To poglavje vas bo vodilo skozi potrebne osnovne nastavitve. Po končanem poglavju preberite 2. poglavje, da boste razumeli razliko med delovanjem ukazov in uspešno namestitvijo; če namestitev še vedno povzroča težave, si oglejte 3. poglavje.

1.1 Preverjanje sistemskih zahtev

WSL 2 ima minimalne zahteve glede različice sistema Windows. Pritisnite Win + R, vnesite winver in preverite svojo različico:

• Windows 10: različica 1903 ali novejša, številka sestave (Build) pa mora biti 18362 ali višja.
• Windows 11: podprte so vse različice.

IMPORTANT

Če je vaša različica prestara, najprej nadgradite sistem prek Windows Update.

1.2 Omogočanje strojne virtualizacije

WSL 2 deluje na tehnologiji virtualizacije, zato mora biti v BIOS/UEFI matične plošče omogočena tehnologija virtualizacije (Virtualization Technology).

• Način preverjanja: odprite "Upravitelj opravil" -> zavihek "Učinkovitost" -> "CPU".
• Preverjanje stanja: preverite, da stanje "Virtualizacija" v spodnjem desnem kotu prikazuje "Omogočeno".
• Način omogočanja: če ni omogočena, znova zaženite računalnik, vstopite v nastavitve BIOS/UEFI, poiščite možnost, podobno Intel VT-x ali AMD-V, in jo nastavite na Enabled.

1.3 Omogočanje povezanih funkcij sistema Windows

Omogočiti morate funkciji "Podsistem Windows za Linux" in "Platforma navideznih računalnikov".

Metoda A: Prek grafičnega vmesnika (priporočeno)

1. Pritisnite Win + S, poiščite in odprite "Vklop ali izklop funkcij sistema Windows".
2. Označite naslednji dve postavki:
   • Podsistem Windows za Linux (Windows Subsystem for Linux)
   • Platforma navideznih računalnikov (Virtual Machine Platform)
3. Kliknite "OK" in znova zaženite računalnik, ko se prikaže poziv.

Metoda B: Prek ukazne vrstice (skrbniške pravice)

Zaženite PowerShell kot skrbnik in izvedite naslednje ukaze:

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

# Omogoči platformo navideznih računalnikov
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Po izvedbi ročno znova zaženite računalnik.

1.4 Namestitev ali posodobitev jedra WSL

Sodobne različice sistema Windows lahko posodobitve WSL pridobivajo prek Microsoft Store.

• Naslov za prenos: Microsoft Store — Windows Subsystem for Linux
• Ročni prenos: če trgovina ni na voljo, lahko najnovejši namestitveni paket .msixbundle ali .msi prenesete s strani WSL GitHub Releases za namestitev brez povezave.

1.5 Nastavitev WSL 2 kot privzete različice

Da bodo novo nameščene distribucije privzeto uporabljale WSL 2, v terminalu izvedite:

wsl --set-default-version 2

1.6 Pogoste težave

• Napaka 0x80370102: običajno je posledica tega, da virtualizacija v BIOS ni omogočena, ali konflikta s Hyper-V.
• Preklapljanje med WSL 1 in WSL 2: z ukazom wsl --set-version <ime distribucije> 2 lahko obstoječo instanco WSL 1 nadgradite na WSL 2.

2. Delovanje ukazov ne pomeni uspešne namestitve

To, da ukazi wsl --version, wsl -l -v in podobni izvedejo brez napak, ne pomeni, da so pogoji za namestitev sistema Linux že izpolnjeni. Gre za različni fazi, ki ju ni mogoče enačiti.

Delovanje ukazov pomeni le, da:

• ✅ so komponente WSL v sistemu Windows že omogočene/nameščene
• ✅ je orodje ukazne vrstice wsl.exe na voljo
• ✅ sistem prepoznava ukaze, povezane z WSL

Toda za uspešno namestitev distribucije sistema Linux so potrebni dodatni pogoji. Najpogosteje se zatakne pri naslednjem:

1. Virtualizacija je izklopljena: v BIOS/UEFI nista omogočena VT-x / AMD-V, WSL 2 se ne zažene ali pa se pri namestitvi distribucije prijavi napaka virtualizacije (način preverjanja — 1.2 Omogočanje strojne virtualizacije).
2. Prestara različica/sestava sistema Windows: WSL 2 ima zahteve glede jedra in različice; v izdaji Home ali prestarih poslovnih slikah so lahko funkcije nepopolne (način preverjanja — 1.1 Preverjanje sistemskih zahtev).
3. Distribucija sistema Linux še ni nameščena: ukaz wsl -l -v izpiše le nameščene distribucije; če ni nameščeno nič, bo seznam prazen, kar ne pomeni, da lahko Ubuntu takoj zaženete.
4. Težave z omrežjem / Microsoft Store: ukaz wsl --install -d <distribucija> mora prenesti sliko iz trgovine ali iz omrežja; podjetniško omrežje, proxy in požarni zid lahko to blokirajo.
5. Premalo dovoljenj: za namestitev distribucije ali spreminjanje nastavitev WSL so potrebna skrbniška dovoljenja.

TIP

Preprosto povedano: delujoči ukazi WSL ≠ Linux je pripravljen — imate le "vstopnico", sam sistem pa še ni nameščen.

3. Odpravljanje težav pri namestitvi

Če namestitev po konfiguraciji v skladu s 1. poglavjem (ali ko menite, da je konfiguracija končana) z ukazom wsl --install še vedno spodleti, preverjajte v navedenem vrstnem redu.

3.1 Najprej izvedite "hitro preverjanje"

Zaženite PowerShell kot skrbnik in zaporedoma izvedite:

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

• ✅ Če se oba ukaza izvedeta brez težav, so izbirne komponente WSL omogočene in so pogoji virtualizacije v bistvu izpolnjeni.
• ❌ Če pride do napake, bo sistem takoj namignil, kaj manjka (npr. platforma navideznih računalnikov, Hyper-V, virtualizacija BIOS itd.).

Nato izvedite systeminfo in v izpisu potrdite, da se pojavi Virtualization Enabled In Firmware: Yes. Če zgoraj ni bilo nobenih napak, lahko brez skrbi izvedete wsl --install za namestitev distribucije.

NOTE

Noben ukaz ne more 100% zagotoviti uspeha wsl --install, vendar zgornja preverjanja potrdijo, ali so pogoji za namestitev izpolnjeni.

3.2 Ročni kontrolni seznam

Če "hitro preverjanje" ni odkrilo težave, preverite po točkah:

1. Preverite, ali je omogočena virtualizacija BIOS/vdelane programske opreme: v PowerShellu kot skrbnik izvedite systeminfo; v izpisu mora biti vidno Virtualization Enabled In Firmware: Yes.
2. Preverite, ali so funkcije sistema Windows omogočene:

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

   Stanje obeh ukazov mora biti Enabled.
3. Preverite razpoložljivost WSL: ukaz wsl --version mora vrniti običajen izpis; če sporoči, da ukaz ne obstaja, komponente WSL niso nameščene — vrnite se k 1. poglavju.
4. Preverite možnost uporabe WSL 2 (jedro in platforma navideznih računalnikov): ukaz wsl --set-default-version 2 mora uspešno izvesti. Pogosti vzroki neuspeha: platforma navideznih računalnikov ni omogočena ali v BIOS nista omogočena VT-x / AMD-V.

3.3 Hiter pregled pogostih vzrokov neuspeha

Stanje	Opis	Način rešitve
Virtualizacija ni omogočena v BIOS	Nujno se konča z napako	Znova zaženite računalnik, vstopite v BIOS in omogočite VT-x / AMD-V (glej 1.2)
Windows 10 nižji od 19041	wsl --install ni podprt	Nadgradite sistem (glej 1.1)
Podjetniško okolje onemogoča Hyper-V / virtualizacijo	Možen neuspeh	Obrnite se na skrbnika sistema
Stara izdaja Home sistema	Zahteva ročno namestitev	Ročno namestite jedro WSL v skladu z 1.4

3.4 Napaka 0xc03a0014: ni mogoče najti ponudnika podpore za navidezne diske

Sporočilo o napaki: Cannot find a virtual disk support provider for the specified file. Težava ni v sami distribuciji sistema Linux, temveč v tem, da sklad navideznih diskov VHD/VHDX v sistemu Windows ne deluje pravilno, zato WSL 2 ne more registrirati distribucije ter ustvariti/pripeti ext4.vhdx.

Najprej izvedite minimalno preverjanje: zaženite PowerShell kot skrbnik in preizkusite New-VHD (npr. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Če ta ukaz poroča o isti napaki, je težava 100% na strani sistema Windows in ni povezana z distribucijo.

Preverjajte in popravljajte v tem vrstnem redu:

1. Storitev Virtual Disk ne teče: odprite services.msc, poiščite storitev Virtual Disk, nastavite vrsto zagona na "Samodejno" in jo zaženite.

2. Funkciji WSL / platforma navideznih računalnikov nista omogočeni (ali nista začeli veljati): znova izvedite ukaze iz 1.3 Omogočanje povezanih funkcij sistema Windows in nato obvezno znova zaženite računalnik. Izdaja Home sistema Windows nima polnega Hyper-V, vendar WSL 2 potrebuje le platformo navideznih računalnikov, ne konzole za upravljanje Hyper-V.

3. Manjkajo gonilniki/naprave navideznih diskov: odprite Upravitelja naprav in preverite, ali v razdelku "Sistemske naprave / Krmilniki pomnilnika" obstajajo:

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

   Če jih ni, jih lahko ročno dodate prek hdwwiz.exe (Krmilniki pomnilnika → Microsoft → Microsoft VHD Loopback Controller), poleg tega se prepričajte, da storitev FsDepends ni onemogočena.

4. Uvožena slika ne ustreza zahtevam WSL: pri uporabi wsl --import --vhd mora imeti datoteka VHDX datotečni sistem ext4; ne ustrezajo šifrirani diski LUKS, navadne raw.img, Live ISO ali prazni diski, formatirani v NTFS/FAT. Datotek .img / .qcow2 / .iso ni mogoče neposredno uporabiti z wsl --import --vhd.

5. Težave s potjo/dovoljenji/datotečnim sistemom: ciljni imenik mora biti na disku NTFS (FAT32/exFAT nista primerna); v poti se izogibajte šumnikom, presledkom in posebnim znakom; ne uvažajte z omrežnih diskov, OneDrive ali stisnjenih map; vedno uporabljajte pravi PowerShell, zagnan kot skrbnik (ne navaden terminal).

6. Poškodovane sistemske komponente: zaporedoma zaženite DISM in SFC za popravilo sistemskih komponent ter nato poskusite znova:

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

TIP

Navidezni računalniki tretjih oseb (VirtualBox, VMware) ali funkcije peskovnika/utrjevanja varnostne programske opreme (npr. 360, Huorong) lahko motijo delo z navideznimi diski; pri diagnosticiranju jih lahko začasno izklopite in poskusite znova.