Skip to content

WSL sozlash ​

WSL Dashboard dan foydalanishdan oldin, Windows tizimingizda WSL 2 to'g'ri yoqilgan va sozlangan bo'lishi kerak. Ushbu hujjat quyidagi uchta asosiy qismdan iborat:

  1. WSL ni yoqish va sozlash: WSL 2 ning asosiy o'rnatish va sozlash ishlarini yakunlash.
  2. Buyruq ishlashi o'rnatish muvaffaqiyatli degani emas: wsl buyrug'ining ishlashi Linux o'rnatish muvaffaqiyatli bo'lishini anglatmasligini tushuntiradi.
  3. O'rnatish muvaffaqiyatsizligini tekshirish: Sozlash tugagach, o'rnatish baribir muvaffaqiyatsiz bo'lsa, tekshirish va tuzatish usullari.

1. WSL ni yoqish va sozlash ​

Ushbu bo'lim sizni zarur asosiy sozlashlarni bajarishga yo'naltiradi. Ushbu bo'limni tugatgach, buyruqning ishlashi va o'rnatishning muvaffaqiyati o'rtasidagi farqni tushunish uchun 2-bo'lim ni o'qing; o'rnatishda hali ham muammo bo'lsa, 3-bo'lim ga murojaat qiling.

1.1 Tizim talablarini tekshiring ​

WSL 2 Windows versiyasiga nisbatan minimal talabga ega. Win + R tugmasini bosing, winver ni kiriting va versiyangizni tekshiring:

  • Windows 10: 1903 yoki undan yuqori versiya, Build esa 18362 yoki undan yuqori bo'lishi kerak.
  • Windows 11: Barcha versiyalar qo'llab-quvvatlanadi.

IMPORTANT

Agar versiyangiz juda eski bo'lsa, avval "Windows Update" orqali tizimingizni yangilang.

1.2 Apparat virtualizatsiyasini yoqing ​

WSL 2 virtualizatsiya texnologiyasi asosida ishlaydi, shuning uchun anakart BIOS/UEFI da virtualizatsiya texnologiyasini (Virtualization Technology) yoqish kerak.

  • Tekshirish usuli: "Task Manager" → "Performance" yorlig'i → "CPU" ni oching.
  • Holatni ko'rish: Pastki o'ng burchakdagi "Virtualization" holati "Enabled" ni ko'rsatishini tasdiqlang.
  • Yoqish usuli: Agar yoqilmagan bo'lsa, kompyuterni qayta ishga tushirib, BIOS/UEFI sozlamalariga kirishingiz, Intel VT-x yoki AMD-V kabi variantni topib uni Enabled ga o'rnatishingiz kerak.

1.3 Windows funksiyalarini yoqing ​

Windows ning "Windows Subsystem for Linux" va "Virtual Machine Platform" funksiyalarini yoqishingiz kerak.

Usul A: Grafik interfeys orqali (tavsiya etiladi) ​

  1. Win + S tugmasini bosing, "Turn Windows features on or off" ni qidiring va oching.
  2. Quyidagi ikkita bandni belgilang:
    • Windows Subsystem for Linux
    • Virtual Machine Platform
  3. "OK" tugmasini bosing va so'ralganda kompyuterni qayta ishga tushiring.

Usul B: Buyruq qatori orqali (administrator huquqi) ​

PowerShell ni administrator sifatida ishga tushiring va quyidagi buyruqlarni bajaring:

powershell
# 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

Bajarilgandan so'ng, qo'lda kompyuterni qayta ishga tushiring.

1.4 WSL kernelini o'rnating / yangilang ​

Zamonaviy Windows versiyalari WSL yangilanishlarini Microsoft Store orqali olishi mumkin.

1.5 WSL 2 ni sukut versiya sifatida o'rnating ​

Yangi o'rnatilgan distributivlar sukut bo'yicha WSL 2 dan foydalanishini ta'minlash uchun terminalda quyidagini bajaring:

powershell
wsl --set-default-version 2

1.6 Tez-tez so'raladigan savollar ​

  • Xato 0x80370102: Odatda BIOS da virtualizatsiya yoqilmaganligi yoki Hyper-V bilan to'qnashuv tufayli yuzaga keladi.
  • WSL 1 va WSL 2 o'rtasida almashish: Mavjud WSL 1 instansiyasini WSL 2 ga yangilash uchun wsl --set-version <distributiv-nomi> 2 buyrug'idan foydalanishingiz mumkin.

2. Buyruq ishlashi o'rnatish muvaffaqiyatli degani emas ​

wsl --version, wsl -l -v kabi buyruqlar normal ishlashi mumkin, ammo bu Linux o'rnatish shartlari mavjud degani emas. Bu ikkalasi turli bosqichlarda turadi va ularni tenglashtirib bo'lmaydi.

Buyruqning ishlashi faqat quyidagilarni bildiradi:

  • ✅ Windows da WSL komponentlari yoqilgan/o'rnatilgan
  • ✅ wsl.exe buyruq qatori vositasi mavjud
  • ✅ Tizim WSL ga oid buyruqlarni taniy oladi

Ammo Linux distributivini muvaffaqiyatli o'rnatish uchun qo'shimcha shartlar kerak. Ko'pincha muammo tug'diradigan joylar:

  1. Virtualizatsiya o'chirilgan: BIOS/UEFI da VT-x / AMD-V yoqilmagan, WSL 2 ishga tusha olmaydi yoki distributiv o'rnatishda virtualizatsiya xatosi haqida xabar beradi (tekshirish usuli 1.2 Apparat virtualizatsiyasini yoqing).
  2. Windows versiyasi/Build juda eski: WSL 2 kernel va versiyaga talab qo'yadi; Home versiyasi, juda eski korporativ image lar funksiyalari to'liq bo'lmasligi mumkin (tekshirish usuli 1.1 Tizim talablarini tekshiring).
  3. Linux distributivi hali o'rnatilmagan: wsl -l -v faqat o'rnatilgan distributivlarni ro'yxatlaydi; hech narsa o'rnatilmagan bo'lsa ro'yxat bo'sh bo'ladi, bu Ubuntu ni to'g'ridan-to'g'ri ishga tushirish mumkin degani emas.
  4. Tarmoq / Microsoft Store muammosi: wsl --install -d <distributiv> image ni do'kondan yoki tarmoqdan yuklab olishi kerak; korporativ tarmoq, proxy, firewall bularning barchasi bloklashi mumkin.
  5. Huquqlar yetarli emas: Distributiv o'rnatish yoki WSL sozlamalarini o'zgartirish administrator huquqlarini talab qiladi.

TIP

Qisqacha aytganda: WSL buyruqlarining ishlashi Linux tayyor degani emas, siz faqat "kirish chiptasini" oldingiz, tizim hali haqiqatan o'rnatilmagan.

3. O'rnatish muvaffaqiyatsizligini tekshirish ​

1-bo'lim bo'yicha sozlashni tugatganingizdan (yoki tugatgan deb hisoblaganingizdan) so'ng, wsl --install ni bajarish hali ham muvaffaqiyatsiz bo'lsa, quyidagi tartibda tekshiring.

3.1 Avval "bir bosish bilan tekshirish" ni bajaring ​

PowerShell ni administrator sifatida ishga tushiring va navbat bilan bajaring:

powershell
wsl --install --no-distribution
wsl --set-default-version 2
  • ✅ Agar bu ikki buyruq ham muammosiz bajarilsa, WSL ixtiyoriy komponentlari yoqilganini va virtualizatsiya shartlari asosan bajarilganini ko'rsatadi.
  • ❌ Agar muvaffaqiyatsiz bo'lsa, nima yetishmayotganini (masalan, Virtual Machine Platform, Hyper-V, BIOS virtualizatsiyasi va hokazo) to'g'ridan-to'g'ri ko'rsatadi.

So'ng systeminfo ni bajaring va chiqishda Virtualization Enabled In Firmware: Yes paydo bo'lganini tasdiqlang. Agar yuqoridagilarning hech birida xato bo'lmasa, wsl --install ni bajarib distributiv o'rnatishingiz mumkin.

NOTE

Hech qanday buyruq wsl --install ning 100% muvaffaqiyatli bo'lishini kafolatlay olmaydi, ammo yuqoridagi tekshiruvlar o'rnatish shartlari bajarilgan-bajarilmaganini tasdiqlashi mumkin.

3.2 Qo'lda tekshirish ro'yxati ​

Agar "bir bosish bilan tekshirish" muammoni hali ham aniqlay olmasa, har birini alohida tekshiring:

  1. BIOS/firmware virtualizatsiyasi yoqilganligini tekshiring: Administrator PowerShell da systeminfo ni bajaring, chiqishda Virtualization Enabled In Firmware: Yes ko'rinishi kerak.
  2. Windows funksiyalari yoqilganligini tekshiring:
    powershell
    Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
    Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
    Ikkala buyruqning holati Enabled bo'lishi kerak.
  3. WSL mavjudligini tekshiring: wsl --version normal chiqish berishi kerak; agar buyruq topilmadi deb ko'rsatsa, WSL komponentlari o'rnatilmagan degani, 1-bo'lim ga qayting.
  4. WSL 2 dan foydalanish mumkinligini tekshiring (kernel & Virtual Machine Platform): wsl --set-default-version 2 muvaffaqiyatli qaytishi kerak. Keng tarqalgan muvaffaqiyatsizlik sabablari: Virtual Machine Platform yoqilmagan yoki BIOS da VT-x / AMD-V yoqilmagan.

3.3 Umumiy muvaffaqiyatsizlik sabablari ​

HolatTavsifYechim usuli
BIOS da virtualizatsiya yoqilmaganAlbatta muvaffaqiyatsizBIOS ga qayta kirib VT-x / AMD-V ni yoqing (qarang 1.2)
Windows 10 19041 dan pastwsl --install ni qo'llab-quvvatlamaydiTizimni yangilang (qarang 1.1)
Korxona muhitida Hyper-V / virtualizatsiya taqiqlanganMuvaffaqiyatsiz bo'lishi mumkinTizim administratoriga murojaat qiling
Eski Home versiyasiQo'lda o'rnatish kerak1.4 bo'yicha WSL kernelini qo'lda o'rnating

3.4 Xato 0xc03a0014: Virtual disk yordamchi provayderi topilmadi ​

Xato xabari: Cannot find a virtual disk support provider for the specified file. Bu Linux distributivining o'zi bilan bog'liq muammo emas, balki Windows VHD/VHDX virtual disk steki to'g'ri ishlamayapti, WSL 2 distributivni ro'yxatga olishda, ext4.vhdx ni yaratish/ulashda muvaffaqiyatsiz bo'ladi.

Avval minimal tekshiruv qiling: PowerShell ni administrator sifatida ishga tushiring va New-VHD testini bajaring (masalan, New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Agar bu buyruq ham xuddi shunday xato haqida xabar bersa, muammo 100% Windows tomonda, distributivga aloqasi yo'q.

Quyidagi tartibda tekshiring va tuzating:

  1. Virtual Disk xizmati ishlamayapti: services.msc ni oching, Virtual Disk xizmatini toping, ishga tushirish turini "Automatic" ga o'rnating va uni ishga tushiring.

  2. WSL / Virtual Machine Platform funksiyalari yoqilmagan (yoki kuchga kirmagan): 1.3 Windows funksiyalarini yoqing dagi buyruqlarni qayta bajaring va so'ng albatta qayta ishga tushirishingiz kerak. Windows Home to'liq Hyper-V ga ega emas, lekin WSL 2 faqat Virtual Machine Platform ni talab qiladi, Hyper-V boshqaruv interfeysini emas.

  3. Virtual disk drayveri/qurilmasi yetishmayapti: Device Manager ni oching, "System devices / Storage controllers" da quyidagilar mavjudligini tekshiring:

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

    Yetishmasa, hdwwiz.exe orqali qo'lda qo'shishingiz mumkin (Storage controllers → Microsoft → Microsoft VHD Loopback Controller) va FsDepends xizmati o'chirilmaganligini tasdiqlang.

  4. Import qilingan image WSL talablariga mos emas: wsl --import --vhd dan foydalanganda VHDX ext4 fayl tizimi bo'lishi kerak, LUKS shifrlangan disk, oddiy raw.img, Live ISO yoki NTFS/FAT da formatlangan bo'sh disk bo'la olmaydi. .img / .qcow2 / .iso to'g'ridan-to'g'ri wsl --import --vhd bilan import qilib bo'lmaydi.

  5. Yo'l/huquq/fayl tizimi muammosi: Maqsadli papka NTFS diskda bo'lishi kerak (FAT32/exFAT bo'lmaydi); yo'lda xitoycha belgilar, bo'sh joy va maxsus belgilardan saqlaning; tarmoq diskidan, OneDrive dan yoki siqilgan papkalardan import qilmang; albatta haqiqiy administrator PowerShell dan foydalaning (oddiy terminal emas).

  6. Tizim komponentlari buzilgan: Tizim komponentlarini tuzatish uchun DISM va SFC ni navbat bilan ishga tushiring, so'ng qayta urinib ko'ring:

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

TIP

Uchinchi tomon virtual mashinalari (VirtualBox, VMware) yoki xavfsizlik dasturlarining sandbox/hardening funksiyalari (masalan, 360, Huorong) virtual disk operatsiyalariga xalaqit berishi mumkin; tekshirish paytida ularni vaqtincha o'chirib ko'ring.