Skrúða WSL

Áður en þú notar WSL Dashboard verður Windows-kerfið þitt að hafa WSL 2 umhverfið virkjað og rétt stillt. Þetta skjal skiptist í eftirfarandi þrjá aðalhluta:

1. Virkja og stilla WSL: Ljúktu grunnuppsetningu og stillingu WSL 2.
2. Skipun sem virkar þýðir ekki að uppsetning hafi tekist: Útskýrir að keyranleg wsl skipun þýðir ekki að hægt sé að setja upp Linux með góðum árangri.
3. Villuleit vegna misheppnaðrar uppsetningar: Aðferðir til að athuga og laga þegar uppsetning mistekst enn eftir stillingar.

1. Virkja og stilla WSL

Þessi kafli leiðir þig í gegnum nauðsynlegar grunnstillingar. Þegar þú hefur lokið þessum kafla skaltu lesa kafla 2 til að skilja muninn á virkri skipun og árangursríkri uppsetningu; ef uppsetningin veldur enn vandamálum skaltu skoða kafla 3.

1.1 Athugaðu kerfiskröfur

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

• Windows 10: útgáfa 1903 eða nýrri, og byggingarnúmerið (Build) verður að vera 18362 eða nær.
• Windows 11: Allar útgáfur eru studdar.

IMPORTANT

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

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

WSL 2 byggir á sýndarvæðingartækni, svo Virtualization Technology verður að vera virkjuð í BIOS/UEFI móðurborðsins.

• Athugunaraðferð: Opnaðu "Task Manager" -> "Afköst" flipann -> "CPU".
• Skoða stöðu: Staðfestu að "Sýndarvæðing" í hægra horninu neðst sýni "Virk".
• Virkjunarleið: Ef það er ekki virkt þarftu að endurræsa tölvuna og fara í BIOS/UEFI stillingarnar, finna valkost eins og Intel VT-x eða AMD-V og stilla hann á Enabled.

1.3 Virkja viðeigandi Windows-eiginleika

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

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

1. Ýttu á Win + S, leitaðu að og opnaðu "Kveikja eða slökkva á Windows-eiginleikum".
2. Merktu 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ínuna (stjórnendaheimildir)

Keyrðu PowerShell sem stjórnandi og keyrðu eftirfarandi skipanir:

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

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

Þegar því er lokið verður þú að endurræsa tölvuna handvirkt.

1.4 Setja upp/uppfæra WSL kjarnann

Nútímalegar Windows-útgáfur geta sótt WSL uppfærslur í gegnum Microsoft Store.

• Niðurhalslóð: Microsoft Store - Windows Subsystem for Linux
• Handvirkt niðurhal: Ef þú getur ekki notað verslunina geturðu sótt nýjustu .msixbundle eða .msi pakkann frá WSL GitHub Releases fyrir uppsetningu án nettengingar.

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

Til að tryggja að nýuppsettar dreifingar noti sjálfgefið WSL 2 skaltu keyra eftirfarandi í skipanalínunni:

wsl --set-default-version 2

1.6 Algengar spurningar

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

2. Skipun sem virkar þýðir ekki að uppsetning hafi tekist

Að skipanir eins og wsl --version og wsl -l -v keyri eðlilega þýðir ekki að skilyrði fyrir uppsetningu Linux séu uppfyllt. Þetta eru tvö mismunandi stig og ekki er hægt að jafna þau.

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

• ✅ WSL-íhluturinn í Windows er virkjaður/uppsettur
• ✅ Skipanalínuverkfærið wsl.exe er tiltækt
• ✅ Kerfið þekkir WSL-tengdar skipanir

En árangursrík uppsetning Linux-dreifingar krefst viðbótarskilyrða. Algeng stað þar sem hægt er að festast:

1. Sýndarvæðing er slökkt: VT-x / AMD-V er ekki virkjað í BIOS/UEFI, WSL 2 getur ekki ræst, eða sýndarvæðingarvilla er tilkynnt við uppsetningu dreifingar (athugunaraðferð: sjá 1.2 Virkja vélbúnaðarsýndarvæðingu).
2. Windows útgáfan/byggingarnúmerið er of gamalt: WSL 2 hefur kröfur til kjarnans og útgáfunnar; Home útgáfan og of gömul enterprise mynd geta vantað eiginleika (athugunaraðferð: sjá 1.1 Athugaðu kerfiskröfur).
3. Engin Linux-dreifing ennþá uppsett: wsl -l -v listar aðeins uppsettar dreifingar; ef ekkert er uppsett er listinn tómur, sem þýðir ekki að hægt sé að keyra Ubuntu beint.
4. Net-/Microsoft Store vandamál: wsl --install -d <dreifing> þarf að sækja myndir frá versluninni eða netinu; fyrirtækjanet, milliþjónar og eldveggir geta lokað á.
5. Ófullnægjandi heimildir: Uppsetning dreifinga eða breyting á WSL-stillingum krefst stjórnendaheimilda.

TIP

Í stuttu máli: Virk WSL-skipun ≠ Linux tilbúið, þú hefur bara fengið "aðgangsmiðann", en kerfið er ekki raunverulega uppsett ennþá.

3. Villuleit vegna misheppnaðrar uppsetningar

Ef wsl --install mistekst enn eftir að þú hefur lokið stillingum samkvæmt kafla 1 (eða ef þú telur þig hafa lokið þeim) skaltu athuga í eftirfarandi röð.

3.1 Gerðu fyrst "einn-smells athugun"

Keyrðu PowerShell með stjórnendaheimildum og keyrðu í röð:

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

• ✅ Ef báðar skipanirnar keyra vel er WSL valfrjálsu íhlutirnir virkjaðir og sýndarvæðingarskilyrðin að mestu uppfyllt.
• ❌ Ef þær mistakast segir beint til um hvað vantar (eins og Virtual Machine Platform, Hyper-V, BIOS-sýndarvæðingu o.s.frv.).

Keyrðu síðan systeminfo og staðfestu að Virtualization Enabled In Firmware: Yes birtist í úttakinu. Ef ekkert af því sem nefnt er að ofan gefur villu geturðu með öryggi keyrt wsl --install til að setja upp dreifingu.

NOTE

Engin skipun getur tryggt með 100% vissu að wsl --install takist, en athuganirnar hér að ofan geta staðfest að uppsetningarskilyrðin séu uppfyllt.

3.2 Handvirk athugunarlisti

Ef "einn-smells athugunin" finnur ekki ennþá vandamálið geturðu athugað lið fyrir lið:

1. Athugaðu hvort BIOS/fastbúnaðar sýndarvæðing sé virk: Keyrðu systeminfo í stjórnenda-PowerShell; úttakið verður að sýna Virtualization Enabled In Firmware: Yes.
2. Athugaðu hvort Windows-eiginleikar séu virkjaðir:

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

   Staða beggja skipana ætti að vera Enabled.
3. Athugaðu hvort WSL sé tiltækt: wsl --version ætti að gefa eðlilegt úttak; ef skipunin finnst ekki er WSL-íhluturinn ekki uppsettur — farðu aftur í kafla 1.
4. Athugaðu hvort WSL 2 megi nota (kjarni & Virtual Machine Platform): wsl --set-default-version 2 ætti að skila árangri. Algengar mistök ástæður: Virtual Machine Platform er ekki virkjað, eða VT-x / AMD-V er ekki virkjað í BIOS.

3.3 Flýtilisti yfir algengar mistök ástæður

Tilvik	Lýsing	Meðferð
Sýndarvæðing ekki virkjuð í BIOS	Mistekst ávallt	Endurræstu, farðu í BIOS, virkjaðu VT-x / AMD-V (sjá 1.2)
Windows 10 eldri en 19041	wsl --install ekki stutt	Uppfærðu kerfið (sjá 1.1)
Hyper-V / sýndarvæðing óvirk í fyrirtækisumhverfi	Getur mistekist	Hafðu samband við kerfisstjórann
Gömul Home útgáfa	Krefst handvirkrar uppsetningar	Settu upp WSL kjarnann handvirkt samkvæmt 1.4

3.4 Villa 0xc03a0014: Finna ekki veitanda sýndardisksstuðnings

Villuboðin eru Cannot find a virtual disk support provider for the specified file. Þetta er ekki vandamál með Linux-dreifinguna sjálfa, heldur VHD/VHDX sýndardiskastæði Windows virkar ekki rétt, þannig að WSL 2 mistekst við skráningu dreifinga og stofnun/tengingu ext4.vhdx.

Gerðu fyrst lágmarksstaðfestingu: Keyrðu PowerShell sem stjórnandi og keyrðu New-VHD próf (t.d. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Ef þessi skipun tilkynnir líka sömu villu er vandamálið 100% á Windows-hliðinni, ekki hjá dreifingunni.

Leitaðu og lagfærðu í eftirfarandi röð:

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

2. WSL / Virtual Machine Platform eiginleikinn er ekki virkjaður (eða ekki tekinn gildi): Keyrðu aftur skipanirnar í 1.3 Virkja viðeigandi Windows-eiginleika og endurræstu síðan — það er skylda. 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ýndardiskrekill/búnaður vantar: Opnaðu Tækjastjóra og athugaðu hvort eftirfarandi sé til staðar í "Kerfistæki / Geymslustýringar":

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

   Ef þau vantar geturðu bætt þeim við handvirkt í gegnum hdwwiz.exe (Geymslustýringar → Microsoft → Microsoft VHD Loopback Controller), og staðfestu að FsDepends þjónustan sé ekki óvirk.

4. Innflutta myndin 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óðar-/heimilda-/skráarkerfisvandamál: Markmappan verður að vera á NTFS diski (FAT32/exFAT virkar ekki); forðastu kínverska stafi, bil og sérstafi í slóðum; ekki flytja inn af netdrifi, OneDrive eða þjöppuðum möppum; notaðu ávallt alvöru stjórnenda-PowerShell (ekki venjulega skipanalínu).

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 sandkassa-/herðingareiginleikar öryggishugbúnaðar (eins og 360, Huorong) geta truflað sýndardiskaaðgerðir; þá er hægt að slökkva tímabundið á við villuleit.