Pag-configure sa WSL

Sa dili pa gamiton ang WSL Dashboard, ang imong Windows system kinahanglan nga i-enable ug i-configure sa husto ang WSL 2 nga palibot. Kini nga dokumento nabahin sa tulo ka dagkong mga bahin:

1. I-enable ug I-configure ang WSL: Kumpletoha ang base nga installation ug configuration sa WSL 2.
2. Ang Available nga Command Dili Nagpasabot nga Malampuson ang Pag-instalar: Nagpatin-aw nga ang ma-padagan nga wsl command dili nagpasabot nga malampuson nga ma-instalar ang Linux.
3. Pag-troubleshoot sa Napakyas nga Pag-instalar: Pamaagi sa pagsusi ug pag-ayo kung napakyas pa ang pag-instalar pagkahuman sa configuration.

1. I-enable ug I-configure ang WSL

Kini nga kapitulo mogiya kanimo sa pagkumpleto sa mga kinahanglanon nga base nga setting. Pagkahuman sa kapitulong kini, basaha ang Kapitulo 2 aron masabtan ang kalainan tali sa available nga command ug malampuson nga pag-instalar; kung adunay problema pa ang pag-instalar, tan-awa ang Kapitulo 3.

1.1 Susiha ang mga Kinahanglanon sa System

Ang WSL 2 adunay minimum nga kinahanglanon alang sa bersyon sa Windows. Pindota ang Win + R, isulod ang winver aron susihon ang imong bersyon:

• Windows 10: Bersyon 1903 o mas bag-o, ug ang build number kinahanglan 18362 o mas bag-o.
• Windows 11: Tanang bersyon suportado.

IMPORTANT

Kung gamay ra kaayo ang imong bersyon, i-upgrade una ang imong system pinaagi sa "Windows Update".

1.2 I-enable ang Hardware Virtualization

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

• Pamaagi sa Pagsusi: Buksi ang "Task Manager" -> "Performance" tab -> "CPU".
• Tan-awa ang Status: Siguruha nga ang "Virtualization" status sa ubos nga tuo nagpakita og "Enabled".
• Pamaagi sa Pag-enable: Kung wala naka-enable, kinahanglan nimo nga i-restart ang computer ug mosulod sa BIOS/UEFI settings, pangitaa ang opsyon sama sa Intel VT-x o AMD-V ug itakda kini sa Enabled.

1.3 I-enable ang mga Kaugnay nga Windows Feature

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

Pamaagi A: Pinaagi sa Graphical Interface (Girekomenda)

1. Pindota ang Win + S, pangitaa ug buksi ang "Turn Windows features on or off".
2. Markahi ang duha ka mosunod nga item:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. I-click ang "OK", ug i-restart ang computer kung ma-prompt.

Pamaagi B: Pinaagi sa Command Line (Administrator Rights)

Padagana ang PowerShell isip administrator ug isulat ang mosunod nga mga command:

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

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

Pagkahuman makompleto, palihug i-restart ang computer nga mano-mano.

1.4 I-instalar/I-update ang WSL Kernel

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

• Download Address: Microsoft Store - Windows Subsystem for Linux
• Manual Download: Kung dili magamit ang Store, makapalit ka og pinakabag-o nga .msixbundle o .msi installation package sa WSL GitHub Releases alang sa offline installation.

1.5 Itakda ang WSL 2 isip Default nga Bersyon

Aron masiguro nga ang bag-o nga na-instalar nga distribution naggamit og WSL 2 isip default, isulat sa terminal:

wsl --set-default-version 2

1.6 Kanunay nga mga Pangutana

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

2. Ang Available nga Command Dili Nagpasabot nga Malampuson ang Pag-instalar

Ang mga command sama sa wsl --version ug wsl -l -v mahimong ma-padagan nga normal, dili nagpasabot nga naa na nimo ang kondisyon sa pag-instalar og Linux. Ang duha naa sa lain-laing mga yugto ug dili mahimong i-equate.

Ang available nga command nagpasabot lamang nga:

• ✅ Ang WSL components sa Windows na-enable/na-instalar na
• ✅ Ang wsl.exe command line tool available
• ✅ Makaila ang system sa mga kaugnay nga WSL command

Apan aron malampuson nga ma-instalar ang Linux distribution, kinahanglan pa og dugang nga kondisyon. Ang mga kasagarang lugar nga na-stuck:

1. Naka-off ang virtualization: Wala na-enable ang VT-x / AMD-V sa BIOS/UEFI, dili makasugod ang WSL 2, o nag-report og virtualization error kung mag-instalar og distribution (pamaagi sa pagsusi tan-awa ang 1.2 I-enable ang Hardware Virtualization).
2. Ubos kaayo ang Windows version/build number: Ang WSL 2 adunay kinahanglanon alang sa kernel ug bersyon; ang home edition, sobra ka-luma nga enterprise image mahimong kulang og function (pamaagi sa pagsusi tan-awa ang 1.1 Susiha ang mga Kinahanglanon sa System).
3. Wala pa tinuod nga ma-instalar ang Linux distribution: Ang wsl -l -v naglista lamang sa mga na-instalar nga distribution; kung wala pa ma-instalar, walay sulod ang lista, dili kini nagpasabot nga pwede na direkta nga padaganon ang Ubuntu.
4. Problema sa network / Microsoft Store: Ang wsl --install -d <distribution> kinahanglan nga mokuha og image sa Store o network; ang corporate network, proxy, firewall makapugong.
5. Kulang sa permission: Ang pag-instalar og distribution o pag-usab sa WSL settings nagkinahanglan og administrator rights.

TIP

Sa mubo nga pagkasulti: Gumagana ang WSL command ≠ Handa na ang Linux, nakuha ra nimo ang "tiket sa pagsulod", dili pa tinuod nga na-instalar ang system.

3. Pag-troubleshoot sa Napakyas nga Pag-instalar

Pagkahuman makumpleto ang configuration sumala sa Kapitulo 1 (o sa imong hunahuna nakumpleto na), kung napakyas pa ang wsl --install, susiha sumala sa mosunod nga pagkahan-ay.

3.1 Buhaton ang "One-Click Check" Una

Padagana ang PowerShell isip administrator, isulat nga sunud-sunod:

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

• ✅ Kung pareho nga malampuson nga na-padagan kining duha ka command, nagpasabot nga na-enable na ang WSL optional components ug halos natagbaw na ang virtualization condition.
• ❌ Kung napakyas, direkta nga mosulti kung unsa ang kulang (sama sa Virtual Machine Platform, Hyper-V, BIOS virtualization, ug uban pa).

Pagkahuman isulat ang systeminfo, siguruha nga makita ang Virtualization Enabled In Firmware: Yes sa output. Kung walay error sa taas, makapadayon ka na nga luwas sa pagpadagan sa wsl --install aron mag-instalar og distribution.

NOTE

Walay command nga makagarantiya og 100% nga malampuson ang wsl --install, apan ang mga pagsusi sa taas makakumpirma kung natagbaw na ba ang mga kondisyon sa pag-instalar.

3.2 Manual Checklist

Kung dili pa gihapon makita sa "one-click check" ang problema, susiha og tagsa-tagsa:

1. Susiha kung na-enable ang BIOS/firmware virtualization: Sa administrator PowerShell isulat ang systeminfo, kinahanglan makita ang Virtualization Enabled In Firmware: Yes sa output.
2. Susiha kung na-enable ang Windows features:

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

   Ang status sa duha ka command kinahanglan Enabled.
3. Susiha kung available ang WSL: Ang pagpadagan sa wsl --version kinahanglan adunay normal nga output; kung moingon nga wala ang command, nagpasabot nga wala ma-instalar ang WSL components, palihug balik sa Kapitulo 1.
4. Susiha kung magamit ang WSL 2 (kernel & Virtual Machine Platform): Ang pagpadagan sa wsl --set-default-version 2 kinahanglan malampuson. Kasagarang mga dahilan sa kapakyasan: wala na-enable ang Virtual Machine Platform, o wala na-enable ang VT-x / AMD-V sa BIOS.

3.3 Paspas nga Sanggunian sa Kasagarang mga Dahilan sa Kapakyasan

Sitwasyon	Paghulagway	Paagi sa Pagdumala
Wala na-enable ang virtualization sa BIOS	Tino nga mapakyas	I-restart ngadto sa BIOS, i-enable ang VT-x / AMD-V (tan-awa ang 1.2)
Windows 10 nga ubos sa 19041	Dili nagsuporta sa wsl --install	I-upgrade ang system (tan-awa ang 1.1)
Enterprise environment nga nag-disable sa Hyper-V / virtualization	Mahimong mapakyas	Pakig-uban sa system administrator
Lumang home edition system	Kinahanglan ang manual installation	Mano-mano nga i-instalar ang WSL kernel sumala sa 1.4

3.4 Error 0xc03a0014: Dili Makakita og Virtual Disk Support Provider

Ang error message kay Cannot find a virtual disk support provider for the specified file. Dili kini problema sa Linux distribution mismo, kundi ang VHD/VHDX virtual disk stack sa Windows dili naggana nga normal, napakyas ang WSL 2 sa pag-rehistro sa distribution, paghimo/pag-takod sa ext4.vhdx.

Buhaton una ang minimal nga validation: Padagana ang PowerShell isip administrator, isulat ang New-VHD test (pananglitan New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Kung kini nga command nag-report usab og parehas nga error, 100% ang problema naa sa Windows side, walay kalabotan sa distribution.

Susiha ug ayoha sumala sa mosunod nga pagkahan-ay:

1. Dili nagdagan ang Virtual Disk service: Buksi ang services.msc, pangitaa ang Virtual Disk service, itakda ang startup type sa "Automatic" ug sugdi kini.

2. Wala na-enable (o wala pa epektibo) ang WSL / Virtual Machine Platform features: Usba nga isulat ang mga command sa 1.3 I-enable ang mga Kaugnay nga Windows Feature, pagkahuman kinahanglan mag-restart. Ang Windows home edition walay kompleto nga Hyper-V, apan ang WSL 2 nagkinahanglan lamang og Virtual Machine Platform, dili ang Hyper-V management interface.

3. Kulang ang virtual disk driver/device: Buksi ang Device Manager, susiha kung aduna sa "System devices / Storage controllers":

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

   Kung kulang, mahimo nga idugang nga mano-mano pinaagi sa hdwwiz.exe (Storage controllers → Microsoft → Microsoft VHD Loopback Controller), ug siguruha nga ang FsDepends service wala naka-disable.

4. Ang na-import nga image dili nagsunod sa WSL requirements: Kung naggamit og wsl --import --vhd, ang VHDX kinahanglan ext4 file system, dili pwede LUKS encrypted disk, ordinaryong raw.img, Live ISO, o walay sulod nga disk nga naka-format sa NTFS/FAT. Ang .img / .qcow2 / .iso dili pwede direkta nga wsl --import --vhd.

5. Problema sa path/permission/file system: Ang target directory kinahanglan naa sa NTFS disk (dili pwede ang FAT32/exFAT); likayi ang Chinese characters, space, ug special symbols sa path; ayaw pag-import sa network drive, OneDrive, o compressed folder; siguruha nga naggamit og tinuod nga administrator PowerShell (dili ordinaryong terminal).

6. Nadaot nga system components: Isulat ang DISM ug SFC nga sunud-sunod aron ayuhon ang system components, pagkahuman sulayi pag-usab:

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

TIP

Ang third-party virtual machine (VirtualBox, VMware) o sandbox/hardening function sa security software (sama sa 360, Huorong) mahimong makasamok sa virtual disk operations; mahimong temporaryo nga i-off kini samtang nag-troubleshoot.