Pag-configure ng WSL

Bago gamitin ang WSL Dashboard, dapat mong i-enable at i-configure nang tama ang kapaligiran ng WSL 2 sa iyong Windows system. Ang dokumentong ito ay nahahati sa tatlong pangunahing bahagi:

1. I-enable at I-configure ang WSL: Kumpletuhin ang pangunahing installation at configuration ng WSL 2.
2. Ang Available na Command ay Hindi Nangangahulugang Tagumpay ang Pag-install: Ipinaliliwanag na ang maipapatakbong wsl command ay hindi nangangahulugang maaaring mai-install nang tagumpay ang Linux.
3. Pag-troubleshoot ng Nabigong Pag-install: Paraan ng pagsusuri at pag-aayos kapag nabigo pa rin ang pag-install pagkatapos makumpleto ang configuration.

1. I-enable at I-configure ang WSL

Ang kabanatang ito ay gagabay sa iyo sa pagkumpleto ng mga kinakailangang pangunahing setting. Pagkatapos makumpleto ang kabanatang ito, basahin ang Kabanata 2 upang maunawaan ang pagkakaiba sa pagitan ng available na command at tagumpay na pag-install; kung may problema pa rin ang pag-install, sumangguni sa Kabanata 3.

1.1 Suriin ang Mga Kinakailangan ng System

Ang WSL 2 ay may pinakamababang kinakailangan para sa bersyon ng Windows. Pindutin ang Win + R, ilagay ang winver upang suriin ang iyong bersyon:

• Windows 10: Bersyon 1903 o mas bago, at ang build number ay dapat 18362 o mas bago.
• Windows 11: Lahat ng bersyon ay suportado.

IMPORTANT

Kung masyadong luma ang iyong bersyon, i-upgrade muna ang iyong system sa pamamagitan ng "Windows Update".

1.2 I-enable ang Hardware Virtualization

Ang WSL 2 ay tumatakbo sa virtualization technology, kaya dapat i-enable ang Virtualization Technology sa BIOS/UEFI ng motherboard.

• Paraan ng Pagsusuri: Buksan ang "Task Manager" -> "Performance" tab -> "CPU".
• Tingnan ang Status: Tiyakin na ang "Virtualization" status sa kanang ibaba ay nagpapakita ng "Enabled".
• Paraan ng Pag-enable: Kung hindi naka-enable, kailangan mong i-restart ang computer at pumasok sa BIOS/UEFI settings, hanapin ang opsyong tulad ng Intel VT-x o AMD-V at itakda ito sa Enabled.

1.3 I-enable ang Mga Kaugnay na Windows Feature

Kailangan mong i-enable ang mga feature na "Windows Subsystem for Linux" at "Virtual Machine Platform".

Paraan A: Sa pamamagitan ng Graphical Interface (Inirerekomenda)

1. Pindutin ang Win + S, hanapin at buksan ang "Turn Windows features on or off".
2. Lagyan ng check ang dalawang sumusunod na item:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. I-click ang "OK", at i-restart ang computer kapag na-prompt.

Paraan B: Sa pamamagitan ng Command Line (Administrator Rights)

Patakbuhin ang PowerShell bilang administrator at isagawa ang mga sumusunod na 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

Pagkatapos makumpleto, mangyaring i-restart ang computer nang manu-mano.

1.4 I-install/I-update ang WSL Kernel

Ang mga modernong bersyon ng Windows ay maaaring makakuha ng WSL updates sa pamamagitan ng Microsoft Store.

• Download Address: Microsoft Store - Windows Subsystem for Linux
• Manual Download: Kung hindi magamit ang Store, maaari mong i-download ang pinakabagong .msixbundle o .msi installation package mula sa WSL GitHub Releases para sa offline installation.

1.5 Itakda ang WSL 2 bilang Default na Bersyon

Upang matiyak na ang bagong naka-install na distribution ay gumagamit ng WSL 2 bilang default, isagawa sa terminal:

wsl --set-default-version 2

1.6 Mga Madalas Itanong

• Error 0x80370102: Karaniwang dahil hindi naka-enable ang virtualization sa BIOS, o may conflict sa Hyper-V.
• Paglipat sa pagitan ng WSL 1 at WSL 2: Maaari mong gamitin ang wsl --set-version <pangalan-ng-distribution> 2 upang i-upgrade ang kasalukuyang WSL 1 instance sa WSL 2.

2. Ang Available na Command ay Hindi Nangangahulugang Tagumpay ang Pag-install

Ang mga command na tulad ng wsl --version at wsl -l -v ay maaaring maipatakbo nang normal, hindi nangangahulugang mayroon ka nang kondisyon para mag-install ng Linux. Ang dalawa ay nasa magkaibang yugto at hindi maaaring i-equate.

Ang available na command ay nangangahulugan lamang na:

• ✅ Ang WSL components sa Windows ay na-enable/naka-install na
• ✅ Ang wsl.exe command line tool ay available
• ✅ Ang system ay makakakilala ng mga kaugnay na WSL command

Ngunit para magtagumpay sa pag-install ng Linux distribution, kailangan pa rin ng karagdagang kondisyon. Ang mga karaniwang pinagkakabitan ay:

1. Naka-off ang virtualization: Hindi naka-enable ang VT-x / AMD-V sa BIOS/UEFI, hindi maaaring magsimula ang WSL 2, o nag-uulat ng virtualization error kapag nag-i-install ng distribution (paraan ng pagsusuri tingnan ang 1.2 I-enable ang Hardware Virtualization).
2. Masyadong mababa ang Windows version/build number: Ang WSL 2 ay may kinakailangan para sa kernel at bersyon; ang home edition, masyadong lumang enterprise image ay maaaring may hindi kumpletong function (paraan ng pagsusuri tingnan ang 1.1 Suriin ang Mga Kinakailangan ng System).
3. Hindi pa talaga naka-install ang Linux distribution: Ang wsl -l -v ay naglilista lamang ng mga naka-install na distribution; kung wala pang naka-install, walang laman ang listahan, hindi ito nangangahulugang maaaring direktang patakbuhin ang Ubuntu.
4. Problema sa network / Microsoft Store: Ang wsl --install -d <distribution> ay kailangang kumuha ng image mula sa Store o network; ang corporate network, proxy, firewall ay lahat maaaring humarang.
5. Kulang sa permission: Ang pag-install ng distribution o pagbabago ng WSL settings ay nangangailangan ng administrator rights.

TIP

Sa madaling salita: Gumagana ang WSL command ≠ Handa na ang Linux, nakuha mo lang ang "ticket sa pagpasok", hindi pa talaga naka-install ang system.

3. Pag-troubleshoot ng Nabigong Pag-install

Pagkatapos makumpleto ang configuration ayon sa Kabanata 1 (o sa tingin mo ay nakumpleto mo na), kung nabigo pa rin ang wsl --install, suriin ayon sa sumusunod na pagkakasunud-sunod.

3.1 Gawin ang "One-Click Check" Muna

Patakbuhin ang PowerShell bilang administrator, isagawa nang sunud-sunod:

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

• ✅ Kung parehong maayos na naipatakbo ang dalawang command na ito, nangangahulugang na-enable na ang WSL optional components at halos natugunan na ang virtualization condition.
• ❌ Kung nabigo, direktang magsasaad kung ano ang kulang (gaya ng Virtual Machine Platform, Hyper-V, BIOS virtualization, atbp.).

Pagkatapos ay isagawa ang systeminfo, tiyakin na lumalabas ang Virtualization Enabled In Firmware: Yes sa output. Kung walang error sa itaas, maaari ka nang ligtas na isagawa ang wsl --install upang mag-install ng distribution.

NOTE

Walang command na makakagarantiya ng 100% na tiyak na magtatagumpay ang wsl --install, ngunit maaaring kumpirmahin ng mga pagsusuri sa itaas kung natugunan na ang mga kondisyon sa pag-install.

3.2 Manual Checklist

Kung hindi pa rin mahanap ng "one-click check" ang problema, suriin nang paisa-isa:

1. Suriin kung naka-enable ang BIOS/firmware virtualization: Sa administrator PowerShell isagawa ang systeminfo, dapat makita ang Virtualization Enabled In Firmware: Yes sa output.
2. Suriin kung naka-enable ang Windows features:

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

   Ang status ng dalawang command ay dapat Enabled.
3. Suriin kung available ang WSL: Ang pagpapatakbo ng wsl --version ay dapat may normal na output; kung sinasabing hindi umiiral ang command, nangangahulugang hindi naka-install ang WSL components, mangyaring bumalik sa Kabanata 1.
4. Suriin kung magagamit ang WSL 2 (kernel & Virtual Machine Platform): Ang pagpapatakbo ng wsl --set-default-version 2 ay dapat magtagumpay. Karaniwang dahilan ng pagkabigo: hindi naka-enable ang Virtual Machine Platform, o hindi naka-enable ang VT-x / AMD-V sa BIOS.

3.3 Mabilis na Sanggunian ng Mga Karaniwang Dahilan ng Pagkabigo

Sitwasyon	Paglalarawan	Paraan ng Paghawak
Hindi naka-enable ang virtualization sa BIOS	Tiyak na mabibigo	I-restart papasok sa BIOS, i-enable ang VT-x / AMD-V (tingnan ang 1.2)
Windows 10 na mababa sa 19041	Hindi sumusuporta sa wsl --install	I-upgrade ang system (tingnan ang 1.1)
Enterprise environment na nag-disable ng Hyper-V / virtualization	Maaaring mabigo	Makipag-ugnayan sa system administrator
Lumang home edition system	Kailangan ng manual installation	Manu-manong i-install ang WSL kernel ayon sa 1.4

3.4 Error 0xc03a0014: Hindi Makahanap ng Virtual Disk Support Provider

Ang error message ay Cannot find a virtual disk support provider for the specified file. Hindi ito problema ng Linux distribution mismo, kundi hindi gumagana nang normal ang VHD/VHDX virtual disk stack ng Windows, nabigo ang WSL 2 sa pagrehistro ng distribution, paggawa/pag-mount ng ext4.vhdx.

Gawin muna ang minimal na validation: Patakbuhin ang PowerShell bilang administrator, isagawa ang New-VHD test (halimbawa New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Kung ang command na ito ay nag-uulat din ng parehong error, 100% ang problema ay nasa Windows side, walang kaugnayan sa distribution.

Suriin at ayusin ayon sa sumusunod na pagkakasunud-sunod:

1. Hindi tumatakbo ang Virtual Disk service: Buksan ang services.msc, hanapin ang Virtual Disk service, itakda ang startup type sa "Automatic" at simulan ito.

2. Hindi naka-enable (o hindi pa epektibo) ang WSL / Virtual Machine Platform features: Muling isagawa ang mga command sa 1.3 I-enable ang Mga Kaugnay na Windows Feature, pagkatapos ay dapat mag-restart. Ang Windows home edition ay walang kumpletong Hyper-V, ngunit ang WSL 2 ay nangangailangan lamang ng Virtual Machine Platform, hindi ang Hyper-V management interface.

3. Kulang ang virtual disk driver/device: Buksan ang Device Manager, suriin kung mayroon sa "System devices / Storage controllers":

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

   Kapag kulang, maaaring idagdag nang manu-mano sa pamamagitan ng hdwwiz.exe (Storage controllers → Microsoft → Microsoft VHD Loopback Controller), at tiyakin na ang FsDepends service ay hindi naka-disable.

4. Ang na-import na image ay hindi sumusunod sa WSL requirements: Kapag gumagamit ng wsl --import --vhd, ang VHDX ay dapat ext4 file system, hindi maaaring LUKS encrypted disk, ordinaryong raw.img, Live ISO, o walang laman na disk na naka-format sa NTFS/FAT. Ang .img / .qcow2 / .iso ay hindi maaaring direktang wsl --import --vhd.

5. Problema sa path/permission/file system: Ang target directory ay dapat nasa NTFS disk (hindi magagawa ang FAT32/exFAT); iwasan ang Chinese characters, space, at special symbols sa path; huwag mag-import mula sa network drive, OneDrive, o compressed folder; siguraduhing gumagamit ng tunay na administrator PowerShell (hindi ordinaryong terminal).

6. Sirang system components: Isagawa ang DISM at SFC nang sunud-sunod upang ayusin ang system components, pagkatapos ay subukan muli:

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

TIP

Ang mga third-party virtual machine (VirtualBox, VMware) o sandbox/hardening function ng security software (gaya ng 360, Huorong) ay maaaring makagambala sa virtual disk operations; maaari mong pansamantalang i-off ang mga ito habang nag-troubleshoot.