Konfiguracija WSL

Pred uporabo WSL Dashboard mora biti v vašem sistemu Windows pravilno omogočeno in konfigurirano okolje WSL 2. Ta dokument je razdeljen na tri glavne dele:

1. Omogočanje in konfiguracija WSL: dokončanje osnovne namestitve in konfiguracije WSL 2.
2. Razpoložljivost ukaza ne pomeni uspešne namestitve: razlaga, da izvršljiv ukaz wsl ne pomeni nujno, da je namestitev Linux uspešna.
3. Odpravljanje napak pri namestitvi: preverjanje in popravilo, ko namestitev po konfiguraciji še vedno ne uspe.

1. Omogočanje in konfiguracija WSL

To poglavje vas vodi skozi potrebne osnovne nastavitve. Po končanem poglavju preberite 2. poglavje, da razumete razliko med razpoložljivostjo ukaza in uspešno namestitvijo; če še vedno prihaja do težav pri namestitvi, si oglejte 3. poglavje.

1.1 Preverjanje sistemskih zahtev

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

• Windows 10: različica 1903 ali novejša, z internim številom gradnje (Build) 18362 ali višjim.
• Windows 11: podprte so vse različice.

IMPORTANT

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

1.2 Omogočanje strojne virtualizacije

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

• Način preverjanja: odprite "Upravitelj opravil" -> zavihek "Zmogljivost" -> "CPU".
• Preverjanje stanja: preverite, da je stanje "Virtualizacija" v spodnjem desnem kotu prikazano kot "Omogočeno".
• Način omogočanja: če ni omogočeno, morate znova zagnati računalnik, vstopiti v nastavitve BIOS/UEFI in poiskati možnost, kot je Intel VT-x ali AMD-V, ter jo nastaviti na Enabled.

1.3 Omogočanje ustreznih funkcij sistema Windows

Omogočiti morate funkciji "Pod sistem Windows za Linux" in "Platforma virtualnih strojev".

Način 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 možnosti:
   • Pod sistem Windows za Linux (Windows Subsystem for Linux)
   • Platforma virtualnih strojev (Virtual Machine Platform)
3. Kliknite "V redu" in ob pozivu znova zaženite računalnik.

Način 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 virtualnih strojev
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Po končanem izvajanju znova zaženite računalnik ročno.

1.4 Namestitev/posodobitev jedra WSL

Novejše različice sistema Windows lahko posodobitve WSL pridobijo iz Microsoft Store.

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

1.5 Nastavitev WSL 2 kot privzete različice

Da zagotovite, da nove distribucije privzeto uporabljajo WSL 2, v terminalu izvedite:

wsl --set-default-version 2

1.6 Pogosta vprašanja

• Napaka 0x80370102: običajno pomeni, da virtualizacija v BIOS-u ni omogočena ali da prihaja do konflikta s Hyper-V.
• Preklop 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. Razpoložljivost ukaza ne pomeni uspešne namestitve

To, da ukazi, kot so wsl --version in wsl -l -v, delujejo normalno, ne pomeni, da so pogoji za namestitev Linux že izpolnjeni. Gre za dve različni fazi, ki ju ni mogoče enačiti.

Razpoložljivost ukaza pomeni le:

• ✅ Komponente WSL v sistemu Windows so omogočene/nameščene
• ✅ Orodje ukazne vrstice wsl.exe je na voljo
• ✅ Sistem prepozna ukaze, povezane z WSL

Za uspešno namestitev distribucije Linux pa so potrebni dodatni pogoji. Pogoste težave, kjer se zatakne:

1. Virtualizacija je izklopljena: VT-x / AMD-V ni omogočen v BIOS/UEFI, WSL 2 se ne more zagnati ali pa pri namestitvi distribucije poroča o napaki virtualizacije (način preverjanja: 1.2 Omogočanje strojne virtualizacije).
2. Različica/številka gradnje sistema Windows je prenizka: WSL 2 ima zahteve glede jedra in različice; domača izdaja ali prestara poslovna slika morda nimata vseh funkcij (način preverjanja: 1.1 Preverjanje sistemskih zahtev).
3. Distribucija Linux dejansko ni nameščena: wsl -l -v izpiše le nameščene distribucije; če ni nameščena nobena, je seznam prazen, kar ne pomeni, da lahko neposredno zaženete Ubuntu.
4. Težave z omrežjem / Microsoft Store: wsl --install -d <distribucija> prenaša sliko iz trgovine ali omrežja; poslovno omrežje, proxy ali požarni zid lahko to blokirajo.
5. Nezadostna dovoljenja: za namestitev distribucij ali spreminjanje nastavitev WSL so potrebna skrbniška dovoljenja.

TIP

Preprosto povedano: ukaz WSL deluje ≠ Linux je pripravljen, dobili ste le "vstopnico", sistem pa še ni dejansko nameščen.

3. Odpravljanje napak pri namestitvi

Če po konfiguraciji v skladu s 1. poglavjem (ali če menite, da je konfiguracija že opravljena) izvajanje wsl --install še vedno spodleti, preverite v naslednjem vrstnem redu.

3.1 Najprej izvedite "hitri preizkus"

Zaženite PowerShell kot skrbnik in zaporedoma izvedite:

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

• ✅ Če oba ukaza delujeta brez težav, so izbirne komponente WSL omogočene in pogoji virtualizacije v osnovi izpolnjeni.
• ❌ Če spodletita, bo sistem neposredno sporočil, kaj manjka (npr. platforma virtualnih strojev, Hyper-V, virtualizacija BIOS itd.).

Nato izvedite systeminfo in v izpisu potrdite, da se prikaže Virtualization Enabled In Firmware: Yes. Če ni nobene napake, lahko mirno izvedete wsl --install za namestitev distribucije.

NOTE

Noben ukaz ne more 100 % zagotoviti, da bo wsl --install uspel, vendar zgornji pregled potrjuje, ali so pogoji za namestitev izpolnjeni.

3.2 Ročni seznam preverjanj

Če "hitri preizkus" ne odkrije težave, preverite po točkah:

1. Preverite, ali je virtualizacija BIOS/vdelane programske opreme omogočena: v skrbniškem PowerShellu izvedite systeminfo; v izpisu mora biti 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, ali je WSL na voljo: wsl --version mora dati normalen izpis; če sporoči, da ukaz ne obstaja, komponente WSL niso nameščene – vrnite se na 1. poglavje.
4. Preverite, ali je WSL 2 uporaben (jedro in platforma virtualnih strojev): wsl --set-default-version 2 mora uspešno vrniti rezultat. Pogosta razloga za neuspeh: platforma virtualnih strojev ni omogočena ali pa VT-x / AMD-V ni omogočen v BIOS-u.

3.3 Hitri pregled pogostih razlogov za neuspeh

Stanje	Opis	Rešitev
Virtualizacija BIOS ni omogočena	Zagotovo neuspeh	Znova zaženite in v BIOS-u omogočite VT-x / AMD-V (glej 1.2)
Windows 10 nižji od 19041	wsl --install ni podprt	Nadgradite sistem (glej 1.1)
V poslovnem okolju je Hyper-V/virtualizacija onemogočena	Možen neuspeh	Obrnite se na sistemskega skrbnika
Stara domača izdaja sistema	Potrebna je ročna namestitev	Ročno namestite jedro WSL po 1.4

3.4 Napaka 0xc03a0014: ni mogoče najti ponudnika podpore virtualnega diska

Sporočilo o napaki je Cannot find a virtual disk support provider for the specified file. To ni težava distribucije Linux, temveč sklad virtualnih diskov VHD/VHDX sistema Windows ne deluje pravilno; WSL 2 ob registraciji distribucije ter ustvarjanju/priklapljanju ext4.vhdx spodleti.

Najprej naredite minimalno preverjanje: v skrbniškem PowerShellu izvedite test New-VHD (npr. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Če tudi ta ukaz poroča enako napako, je težava 100 % na strani sistema Windows in ni povezana z distribucijo.

Odpravljajte po naslednjem 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 virtualnih strojev nista omogočeni (ali nista učinkoviti): znova izvedite ukaze iz 1.3 Omogočanje ustreznih funkcij sistema Windows in nato obvezno znova zaženite sistem. Domača izdaja sistema Windows nima celotnega Hyper-V, vendar WSL 2 potrebuje le platformo virtualnih strojev, ne upraviteljskega vmesnika Hyper-V.

3. Gonilnik/naprava virtualnega diska manjka: odprite upravitelja naprav in preverite, ali v "Sistemske naprave / Krmilniki shranjevanja" obstajajo:

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

   Če manjkajo, jih lahko ročno dodate s hdwwiz.exe (Krmilniki shranjevanja → Microsoft → Microsoft VHD Loopback Controller) in preverite, da storitev FsDepends ni onemogočena.

4. Uvožena slika ne ustreza zahtevam WSL: pri uporabi wsl --import --vhd mora biti VHDX datotečni sistem ext4; ne sme biti šifriran disk LUKS, navadna raw.img, Live ISO ali prazna plošča, formatirana z NTFS/FAT. .img / .qcow2 / .iso ni mogoče neposredno uvoziti z wsl --import --vhd.

5. Težave s potjo/dovoljenji/datotečnim sistemom: ciljna mapa mora biti na disku NTFS (FAT32/exFAT ne deluje); izogibajte se kitajskim znakom, presledkom in posebnim simbolom v poti; ne uvažajte z omrežnih pogonov, OneDrive ali stisnjenih map; obvezno uporabite pravi skrbniški PowerShell (ne navaden terminal).

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

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

TIP

Programi drugih proizvajalcev za virtualne stroje (VirtualBox, VMware) ali peskovnik/okrepljene funkcije varnostne programske opreme (npr. 360, Huorong) lahko motijo operacije virtualnih diskov; med odpravljanjem napak jih lahko začasno izklopite.