Setup & Config WSL

Áður en þú notar WSL Dashboard verður WSL 2 að vera rétt virkjað og stillt í Windows-kerfinu þínu. Þetta skjal skipist í þrjá meginhluta:

1. Uppsetning og stilling á WSL: Grunnuppsetning og stilling á WSL 2.
2. Virk skipun er ekki heppnuð uppsetning: Útskýrir að það að wsl skipunin virki þýðir ekki að hægt sé að setja upp Linux.
3. Úrræði við misheppnaðri uppsetningu: Aðferðir til að skoða og laga þegar uppsetning mistekst eftir að stillingum er lokið.

1. Uppsetning og stilling á WSL

Þessi kafli leiðir þig í gegnum nauðsynlegar grunnstillingar. Þegar kaflanum er lokið skaltu lesa kafla 2 til að skilja muninn á því að skipun virki og því að uppsetning takist; ef uppsetning gengur enn ekki skaltu skoða kafla 3.

1.1 Athuga kerfiskröfur

WSL 2 hefur lágmarkskröfur um Windows-útgáfu. Ýttu á Win + R, sláðu inn winver og athugaðu útgáfuna þína:

• Windows 10: Útgáfa 1903 eða nýrri og Build þarf að vera 18362 eða hærri.
• Windows 11: Allar útgáfur eru studdar.

IMPORTANT

Ef útgáfan þín er of gömul skaltu fyrst uppfæra kerfið þitt í gegnum "Windows Update".

1.2 Virkja sýndarvæðingu vélbúnaðar

WSL 2 keyrir á sýndarvæðingartækni, því verður að virkja sýndarvæðingu (Virtualization Technology) í BIOS/UEFI á móðurborðinu.

• Hvernig á að athuga: Opnaðu "Task Manager" → flipann "Performance" → "CPU".
• Skoða stöðu: Staðfestu að staðan "Virtualization" í neðra hægra horninu sýni "Virkjað".
• Hvernig á að virkja: Ef hún er ekki virk þarftu að endurræsa tölvuna, fara í BIOS/UEFI stillingar, finna svipaðan valkost og Intel VT-x eða AMD-V og stilla hann á Enabled.

1.3 Virkja eiginleika Windows

Þú þarft að virkja "Windows Subsystem for Linux" og "Virtual Machine Platform" eiginleikana.

Aðferð A: Í gegnum grafískt viðmót (mælt með)

1. Ýttu á Win + S, leitaðu að og opnaðu "Turn Windows features on or off".
2. Hakaðu við eftirfarandi tvo liði:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. Smelltu á "OK" og endurræstu tölvuna þegar beðið er um það.

Aðferð B: Í gegnum skipanalínu (stjórnandaréttindi)

Keyrðu PowerShell sem stjórnandi og framkvæmdu eftirfarandi skipanir:

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

# Enable Virtual Machine Platform
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Þegar því er lokið skaltu endurræsa tölvuna handvirkt.

1.4 Setja upp / uppfæra WSL kjarnann

Nútímalegar útgáfur af Windows geta fengið WSL uppfærslur í gegnum Microsoft Store.

• Niðurhalsslóð: Microsoft Store - Windows Subsystem for Linux
• Handvirkt niðurhal: Ef þú getur ekki notað Store geturðu sótt nýjustu .msixbundle eða .msi uppsetningarpakkann af WSL GitHub Releases til uppsetningar án nettengingar.

1.5 Setja WSL 2 sem sjálfgefna útgáfu

Til að tryggja að nýuppsettar dreifingar noti WSL 2 sjálfgefið skaltu framkvæma eftirfarandi í flugstöðinni (terminal):

wsl --set-default-version 2

1.6 Algengar spurningar

• Villa 0x80370102: Yfirleitt vegna þess að sýndarvæðing er ekki virkjuð í BIOS, eða vegna árekstra við Hyper-V.
• Skipta milli WSL 1 og WSL 2: Þú getur notað wsl --set-version <nafn-dreifingar> 2 til að uppfæra núverandi WSL 1 tilvik yfir í WSL 2.

2. Virk skipun er ekki heppnuð uppsetning

Skipanir eins og wsl --version og wsl -l -v geta keyrt án vandræða, en það þýðir ekki að skilyrði til að setja upp Linux séu fyrir hendi. Þetta eru tvö ólík stig og ekki er hægt að setja samasemmerki á milli þeirra.

Að skipun virki þýðir aðeins:

• ✅ WSL-íhlutirnir í Windows eru virkjaðir/uppsettir
• ✅ wsl.exe skipanalínutólið er tiltækt
• ✅ Kerfið þekkir WSL-tengdar skipanir

En til að setja upp Linux-dreifingu með góðum árangri þarf viðbótarskilyrði. Algengir staðir þar sem það festist:

1. Sýndarvæðing er óvirk: VT-x / AMD-V ekki virkjuð í BIOS/UEFI, WSL 2 getur ekki ræst, eða uppsetning dreifingar skilar sýndarvæðingarvillu (athugaðu í 1.2 Virkja sýndarvæðingu vélbúnaðar).
2. Windows útgáfa/Build of gömul: WSL 2 hefur kröfur um kjarna og útgáfu; Home útgáfa, of gömul fyrirtækjaimage geta skort virkni (athugaðu í 1.1 Athuga kerfiskröfur).
3. Linux-dreifing í raun ekki uppsett: wsl -l -v listar aðeins uppsettar dreifingar; ef ekkert er sett upp er listinn tómur, sem þýðir ekki að þú getir keyrt Ubuntu beint.
4. Net / Microsoft Store vandamál: wsl --install -d <dreifing> þarf að sækja image úr Store eða af netinu; fyrirtækjanet, proxy eða eldveggur geta allt lokað á það.
5. Ónæg réttindi: Uppsetning dreifingar eða breytingar á WSL-stillingum krefst stjórnandaréttinda.

TIP

Í stuttu máli: að WSL-skipanir virki þýðir ekki að Linux sé tilbúið, þú ert bara búinn að fá "aðgöngumiðann" en ekki sett upp kerfið í raun.

3. Úrræði við misheppnaðri uppsetningu

Eftir að þú hefur klárað stillingarnar samkvæmt kafla 1 (eða telur þig hafa klárað), ef wsl --install mistekst enn, skaltu athuga eftirfarandi í þessari röð.

3.1 Einföld athugun

Keyrðu PowerShell sem stjórnandi og framkvæmdu í röð:

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

• ✅ Ef báðar þessar skipanir keyra vel þýðir það að WSL-valkvæmir íhlutir eru virkjaðir og sýndarvæðingarskilyrði að mestu uppfyllt.
• ❌ Ef það mistekst kemur fram hvað vantar (eins og Virtual Machine Platform, Hyper-V, BIOS-sýndarvæðing o.s.frv.).

Framkvæmdu síðan systeminfo og staðfestu að Virtualization Enabled In Firmware: Yes komi fram í úttakinu. Ef ekkert af ofangreindu skilar villu geturðu að mestu leyti treyst því að framkvæma wsl --install til að setja upp dreifinguna.

NOTE

Engin skipun getur 100% tryggt að wsl --install heppnist, en ofangreindar athuganir staðfesta hvort uppsetningarskilyrði séu uppfyllt.

3.2 Handvirkur athugunarlisti

Ef "einfalda athugunin" finnur enn ekki vandamálið geturðu athugað hvern lið:

1. Athugaðu hvort BIOS/firmware sýndarvæðing sé virk: Keyrðu systeminfo í stjórnanda-PowerShell; í úttakinu þarf að sjást Virtualization Enabled In Firmware: Yes.
2. Athugaðu hvort Windows-eiginleikar séu virkir:

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

   Staða beggja skipana á að vera Enabled.
3. Athugaðu hvort WSL sé tiltækt: wsl --version á að skila eðlilegu úttaki; ef skipunin finnst ekki þýðir það að WSL-íhlutirnir eru ekki uppsettir, farðu aftur í kafla 1.
4. Athugaðu hvort hægt sé að nota WSL 2 (kjarni & Virtual Machine Platform): wsl --set-default-version 2 á að skila árangri. Algengar ástæður bilunar: Virtual Machine Platform ekki virkjuð, eða VT-x / AMD-V ekki virkjað í BIOS.

3.3 Algengar orsakir bilana

Aðstæður	Lýsing	Meðferð
Sýndarvæðing ekki virkjuð í BIOS	Mistekst örugglega	Endurræstu inn í BIOS og virkjaðu VT-x / AMD-V (sjá 1.2)
Windows 10 undir 19041	Styður ekki wsl --install	Uppfærðu kerfið (sjá 1.1)
Fyrirtækjaumhverfi bannar Hyper-V / sýndarvæðingu	Gæti mistekist	Hafðu samband við kerfisstjóra
Gömul Home útgáfa	Þarf handvirka uppsetningu	Settu WSL kjarnann upp handvirkt samkvæmt 1.4

3.4 Villa 0xc03a0014: Enginn stuðningur við sýndardiska

Villuskilaboðin: Cannot find a virtual disk support provider for the specified file. Þetta er ekki vandamál með Linux-dreifinguna sjálfa, heldur virka VHD/VHDX sýndardiskastakkurinn í Windows ekki rétt, WSL 2 mistekst þegar dreifing er skráð eða ext4.vhdx búið til/tengt.

Gerðu fyrst lágmarksprófun: Keyrðu PowerShell sem stjórnandi og framkvæmdu New-VHD prófið (t.d. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Ef þessi skipun skilar sömu villu er vandamálið 100% á Windows-hliðinni og tengist dreifingunni ekki.

Skoðaðu og lagfærðu í þessari röð:

1. Virtual Disk þjónustan keyrir ekki: Opnaðu services.msc, finndu Virtual Disk þjónustuna, stilltu ræsingargerð á "Automatic" og ræstu hana.

2. WSL / Virtual Machine Platform eiginleikar ekki virkjaðir (eða ekki teknir gildi): Framkvæmdu aftur skipanirnar í 1.3 Virkja eiginleika Windows og þá verður að endurræsa. Windows Home hefur ekki fulla Hyper-V, en WSL 2 þarf aðeins Virtual Machine Platform, ekki Hyper-V stjórnunarviðmótið.

3. Sýndardiskarekill/tæki vantar: Opnaðu Device Manager og athugaðu hvort eftirfarandi sé til staðar í "System devices / Storage controllers":

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

   Ef þau vantar geturðu bætt þeim við handvirkt með hdwwiz.exe (Storage controllers → Microsoft → Microsoft VHD Loopback Controller) og staðfestu að FsDepends þjónustan sé ekki óvirkjuð.

4. Innflutt image uppfyllir ekki WSL-kröfur: Þegar wsl --import --vhd er notað verður VHDX að vera ext4 skráarkerfi, ekki LUKS-dulkóðaður diskur, venjuleg raw.img, Live ISO eða tómur diskur sniðinn með NTFS/FAT. .img / .qcow2 / .iso er ekki hægt að nota beint með wsl --import --vhd.

5. Slóð/réttindi/skráarkerfisvandamál: Markmöppan verður að vera á NTFS diski (FAT32/exFAT duga ekki); forðastu kínverska stafi, bil og sértákn í slóð; ekki flytja inn af netdiski, OneDrive eða þjöppuðum möppum; notaðu endilega alvöru stjórnanda-PowerShell (ekki venjulega flugstöð).

6. Kerfisíhlutir skemmdir: Keyrðu DISM og SFC í röð til að gera við kerfisíhluti og reyndu svo aftur:

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

TIP

Þriðja aðila sýndarvélar (VirtualBox, VMware) eða sandbox/öryggisstyrkingareiginleikar öryggishugbúnaðar (eins og 360, Huorong) geta truflað sýndardiskaaðgerðir; hægt er að slökkva tímabundið á þeim meðan leitað er að vandamálinu.