WSL Setup

Sa wala pa gamiton ang WSL Dashboard, ang WSL 2 sa imong Windows system kinahanglan nga tukma nga ma-enable ug ma-configure. Kini nga dokumento nabahin sa tulo ka dagkong parte:

1. I-enable ug i-configure ang WSL: Kompletoha ang batakang pag-install ug pag-configure sa WSL 2.
2. Ang magamit nga command dili pareho sa malampuson nga pag-install: Nagpasabot nga ang pagdagan sa wsl command wala magkahulogan nga malampuson nga ma-install ang Linux.
3. Pagsusi sa mga kapakyasan sa pag-install: Mga pamaagi sa pagsusi ug pag-ayo kung mapakyas pa ang pag-install pagkahuman sa pag-configure.

1. I-enable ug i-configure ang WSL

Kini nga kapitulo mogiya kanimo sa pagkompleto sa gikinahanglang batakang mga setting. Pagkahuman sa kini nga kapitulo, basaha ang kapitulo 2 aron masabtan ang kalainan tali sa magamit nga command ug malampuson nga pag-install; kung aduna pay problema sa pag-install, tan-awa ang kapitulo 3.

1.1 Susiha ang mga kinahanglanon sa sistema

Ang WSL 2 adunay minimum nga kinahanglanon sa bersyon sa Windows. Pindota ang Win + R, i-type ang winver aron masusi ang imong bersyon:

• Windows 10: Bersyon 1903 o mas taas, ug ang Build kinahanglan nga 18362 o mas taas.
• Windows 11: Tanan nga mga bersyon gisuportahan.

IMPORTANT

Kung ubos kaayo ang imong bersyon, i-upgrade una ang imong sistema pinaagi sa "Windows Update".

1.2 I-enable ang hardware virtualization

Ang WSL 2 modagan base sa virtualization technology, busa kinahanglan nga i-enable ang Virtualization Technology sa BIOS/UEFI sa imong motherboard.

• Pamaagi sa pagsusi: Ablihi ang "Task Manager" → tab nga "Performance" → "CPU".
• Susiha ang status: Kumpirmaha nga ang status nga "Virtualization" sa ubos nga tuo nga kanto nagpakita og "Enabled".
• Pamaagi sa pag-enable: Kung wala pa ma-enable, kinahanglan nimong i-restart ang imong computer, mosulod sa BIOS/UEFI settings, pangitaa ang option nga sama sa Intel VT-x o AMD-V ug i-set kini sa Enabled.

1.3 I-enable ang mga feature sa Windows

Kinahanglan nimong i-enable ang "Windows Subsystem for Linux" ug "Virtual Machine Platform" nga mga feature.

Pamaagi A: Pinaagi sa GUI (Girekomenda)

1. Pindota ang Win + S, pangitaa ug ablihi ang "Turn Windows features on or off".
2. I-check ang mosunod nga duha ka butang:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. I-klik ang "OK", ug i-restart ang imong computer kung giawhag.

Pamaagi B: Pinaagi sa command line (Administrator)

Padagana ang PowerShell isip Administrator ug i-execute ang mosunod nga mga command:

# 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

Pagkahuman sa pagpadagan, i-restart ang imong computer nga mano-mano.

1.4 I-install / i-update ang WSL kernel

Ang modernong mga bersyon sa Windows makakuha og WSL updates pinaagi sa Microsoft Store.

• Download link: Microsoft Store - Windows Subsystem for Linux
• Manwal nga pag-download: Kung dili nimo magamit ang Store, makakuha ka og labing bag-ong .msixbundle o .msi installer package sa WSL GitHub Releases para sa offline nga pag-install.

1.5 I-set ang WSL 2 isip default version

Aron masiguro nga ang bag-ong mga distribution mogamit sa WSL 2 isip default, i-execute ang mosunod sa imong terminal:

wsl --set-default-version 2

1.6 Kanunay nga mga pangutana

• Error 0x80370102: Kasagaran tungod kay wala gi-enable ang virtualization sa BIOS, o adunay conflict sa Hyper-V.
• Pagbalhin tali sa WSL 1 ug WSL 2: Mahimo nimong gamiton ang wsl --set-version <pangalan-nga-distribution> 2 aron i-upgrade ang kasamtangang WSL 1 instance ngadto sa WSL 2.

2. Ang magamit nga command dili pareho sa malampuson nga pag-install

Ang mga command sama sa wsl --version, wsl -l -v mahimong modagan nga normal, apan wala kini magkahulogan nga andam na ang mga kondisyon sa pag-install sa Linux. Kining duha naa sa lain-laing mga yugto, dili kini parehas.

Ang magamit nga command nagpasabot lamang nga:

• ✅ Na-enable/na-install na ang WSL components sa Windows
• ✅ Tugkaran ang wsl.exe command-line tool
• ✅ Makaila ang sistema sa mga WSL-related commands

Apan aron malampuson nga ma-install ang Linux distribution, kinahanglan pa ang dugang nga mga kondisyon. Kasagaran nga mga lugar nga ma-stuck:

1. Gipalong ang virtualization: Wala gi-enable ang VT-x / AMD-V sa BIOS/UEFI, dili makasugod ang WSL 2, o mag-report og virtualization error kung mag-install og distribution (tan-awa ang 1.2 I-enable ang hardware virtualization).
2. Ubos kaayo ang Windows version/Build: Ang WSL 2 adunay mga kinahanglanon sa kernel ug bersyon; ang Home version, karaan kaayo nga enterprise images mahimong kulang sa mga feature (tan-awa ang 1.1 Susiha ang mga kinahanglanon sa sistema).
3. Wala pa gyud ma-install ang Linux distribution: Ang wsl -l -v naglista lamang sa mga na-install nga distribution; kung wala pa bisan unsa nga na-install, walay sulod ang lista, nga dili nagpasabot nga maka-dagan ka dayon sa Ubuntu.
4. Problema sa network / Microsoft Store: Ang wsl --install -d <distribution> kinahanglan nga mag-download og image sa Store o sa network; ang network sa kompanya, proxy, o firewall mahimong maka-block.
5. Kulang sa permiso: Ang pag-install og distribution o pag-usab sa WSL settings nanginahanglan og administrator permission.

TIP

Sa laktud: ang magamit nga WSL commands dili pareho sa andam nga Linux, nakakuha ka lang og "tiket sa pagsulod", apan wala pa gyud ma-install ang sistema.

3. Pagsusi sa mga kapakyasan sa pag-install

Pagkahuman sa pagkompleto sa pag-configure base sa kapitulo 1 (o sa imong hunahuna nga nahuman na), kung mapakyas pa ang wsl --install, susiha sa mosunod nga pagkasunud-sunod.

3.1 Una, buhata ang "one-click check"

Padagana ang PowerShell isip Administrator, ug i-execute sunod-sunod:

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

• ✅ Kung kining duha ka command modagan nga walay problema, nagpasabot nga ang WSL optional features na-enable na, ug hapit kompleto na ang virtualization conditions.
• ❌ Kung mapakyas, direktang magpakita kini kung unsa ang kulang (sama sa Virtual Machine Platform, Hyper-V, BIOS virtualization, ug uban pa).

Dayon i-execute ang systeminfo, ug kumpirmaha nga makita sa output ang Virtualization Enabled In Firmware: Yes. Kung walay sayop sa taas, makasiguro ka na nga i-execute ang wsl --install para mag-install og distribution.

NOTE

Walay bisan unsang command nga makagarantiya sa 100% nga molampos ang wsl --install, apan ang mga check sa taas makakumpirma kung ang mga kondisyon sa pag-install natuman na ba.

3.2 Manwal nga checklist

Kung ang "one-click check" dili gihapon makakita sa problema, susiha ang matag usa:

1. Susiha kung gi-enable ba ang BIOS/firmware virtualization: Sa administrator PowerShell, i-execute ang systeminfo, ug kinahanglan makita sa output ang Virtualization Enabled In Firmware: Yes.
2. Susiha kung gi-enable ba ang mga Windows features:

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

   Ang status sa duha ka command kinahanglan nga Enabled.
3. Susiha kung tugkaran ang WSL: Ang wsl --version kinahanglan nga adunay normal nga output; kung moingon nga wala ang command, nagpasabot nga wala ma-install ang WSL components, balik sa kapitulo 1.
4. Susiha kung magamit ang WSL 2 (kernel & Virtual Machine Platform): Ang wsl --set-default-version 2 kinahanglan nga mobalik nga malampuson. Kasagaran nga mga rason sa kapakyasan: wala gi-enable ang Virtual Machine Platform, o wala gi-enable ang VT-x / AMD-V sa BIOS.

3.3 Kasagaran nga mga rason sa kapakyasan

Sitwasyon	Pagpasabot	Pamaagi sa pag-ayo
Wala gi-enable ang virtualization sa BIOS	Sigurado nga mapakyas	I-restart ngadto sa BIOS ug i-enable ang VT-x / AMD-V (tan-awa ang 1.2)
Windows 10 ubos sa 19041	Dili mosuporta sa wsl --install	I-upgrade ang sistema (tan-awa ang 1.1)
Gidili sa enterprise environment ang Hyper-V / virtualization	Mahimong mapakyas	Kontaka ang system administrator
Karaang Home version	Kinahanglan nga mano-mano nga i-install	I-install ang WSL kernel nga mano-mano base sa 1.4

3.4 Error 0xc03a0014: Wala makit-i ang virtual disk support provider

Ang error message: Cannot find a virtual disk support provider for the specified file. Dili kini problema sa Linux distribution mismo, kondili ang VHD/VHDX virtual disk stack sa Windows dili molihok og tarong, napakyas ang WSL 2 sa pagrehistro sa distribution, paghimo/pag-mount sa ext4.vhdx.

Una, buhata ang minimum nga validation: Padagana ang PowerShell isip administrator, ug i-execute ang New-VHD test (pananglitan New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Kung kini nga command mag-report usab og parehas nga error, ang problema 100% naa sa Windows nga parte, walay labot ang distribution.

Susiha ug ayoha sunod-sunod:

1. Wala modagan ang Virtual Disk service: Ablihi ang services.msc, pangitaa ang Virtual Disk service, i-set ang startup type sa "Automatic" ug i-start kini.

2. Wala gi-enable ang WSL / Virtual Machine Platform features (o wala pa mo-effect): I-execute pag-usab ang mga command sa 1.3 I-enable ang mga feature sa Windows, ug dayon kinahanglan gayud nga mag-restart. Ang Windows Home walay kompleto nga Hyper-V, apan ang WSL 2 nanginahanglan lamang sa Virtual Machine Platform, dili sa Hyper-V management interface.

3. Nawala ang virtual disk driver/device: Ablihi ang Device Manager, susiha kung naa ba sa "System devices / Storage controllers":

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

   Kung nawala, mahimo nimong idugang kini nga mano-mano pinaagi sa hdwwiz.exe (Storage controllers → Microsoft → Microsoft VHD Loopback Controller), ug kumpirmaha nga dili disabled ang FsDepends service.

4. Ang gi-import nga image dili mosubay sa WSL requirements: Kung mogamit og wsl --import --vhd, ang VHDX kinahanglan nga ext4 filesystem, dili LUKS-encrypted disk, dili ordinaryong raw.img, dili Live ISO o walay sulod nga disk nga na-format sa NTFS/FAT. Ang .img / .qcow2 / .iso dili direktang ma-import gamit ang wsl --import --vhd.

5. Problema sa path/permission/filesystem: Ang target directory kinahanglan nga naa sa NTFS disk (dili pwede ang FAT32/exFAT); likayi ang Chinese nga mga karakter, space ug special symbols sa path; ayaw pag-import gikan sa network drive, OneDrive, o compressed folders; siguroha nga mogamit ka og tinuod nga administrator PowerShell (dili ordinaryong terminal).

6. Nadaot ang system components: Padagana ang DISM ug SFC sunod-sunod aron ayohon ang system components, ug dayon sulayi pag-usab:

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

TIP

Ang third-party nga mga virtual machine (VirtualBox, VMware) o sandbox/hardening features sa security software (sama sa 360, Huorong) mahimong makasamok sa virtual disk operations; pwede nimo nga temporaryo nga i-off kung nangita og problema.