WSL quraşdırılması

WSL Dashboard-u istifadə etməzdən əvvəl Windows sisteminizdə WSL 2 mühiti düzgün şəkildə aktivləşdirilmiş və konfiqurasiya edilmiş olmalıdır. Bu sənəd aşağıdakı üç əsas hissəyə bölünür:

1. WSL-nin aktivləşdirilməsi və konfiqurasiyası: WSL 2-nin əsas quraşdırılması və konfiqurasiyasının tamamlanması.
2. Əmrin işləməsi quraşdırmanın uğurlu olması demək deyil: wsl əmrinin icra oluna bilməsinin Linux-un uğurla quraşdırıla biləcəyi anlamına gəlmədiyini izah edir.
3. Quraşdırma xətalarının aradan qaldırılması: Konfiqurasiya tamamlandıqdan sonra quraşdırma uğursuz olarsa yoxlama və təmir üsulları.

1. WSL-nin aktivləşdirilməsi və konfiqurasiyası

Bu fəsil sizə lazımi əsas parametrləri tamamlamaqda rəhbərlik edəcək. Fəsli tamamladıqdan sonra əmrin işləməsi ilə uğurlu quraşdırma arasındakı fərq üçün 2-ci fəsli oxuyun; quraşdırma hələ də problemli olarsa, 3-cü fəslə baxın.

1.1 Sistem tələblərinin yoxlanılması

WSL 2 Windows versiyası üçün minimum tələblər qoyur. Versiyanızı yoxlamaq üçün Win + R düymələrinə basıb winver yazın:

• Windows 10: 1903 versiyası və ya daha yeni, Build nömrəsi 18362 və ya daha yeni olmalıdır.
• Windows 11: Bütün versiyalar dəstəklənir.

IMPORTANT

Versiyanız çox köhnədirsə, əvvəlcə "Windows Update" vasitəsilə sisteminizi yeniləyin.

1.2 Avadanlıq virtualizasiyasının aktivləşdirilməsi

WSL 2 virtualizasiya texnologiyası üzərində işləyir, buna görə anakartın BIOS/UEFI parametrlərində virtualizasiya texnologiyası (Virtualization Technology) aktivləşdirilməlidir.

• Yoxlama üsulu: "Tapşırıq Meneceri" -> "Performans" sekmesi -> "CPU" açın.
• Vəziyyətə baxma: Sağ aşağıdakı "Virtualizasiya" vəziyyətinin "Aktiv" olduğunu təsdiqləyin.
• Aktivləşdirmə üsulu: Aktiv deyilsə, kompüteri yenidən başladıb BIOS/UEFI parametrlərinə girin, Intel VT-x və ya AMD-V kimi seçim tapıb onu Enabled edin.

1.3 Müvafiq Windows funksiyalarının aktivləşdirilməsi

"Linux üçün Windows Alt Sistemi" və "Virtual Maşın Platforması" funksiyalarını aktivləşdirməlisiniz.

A üsulu: Qrafik interfeys vasitəsilə (tövsiyə olunur)

1. Win + S düymələrinə basın, "Windows funksiyalarını aktivləşdirin və ya deaktiv edin" seçimini axtarıb açın.
2. Aşağıdakı iki seçimi işarələyin:
   • Linux üçün Windows Alt Sistemi (Windows Subsystem for Linux)
   • Virtual Maşın Platforması (Virtual Machine Platform)
3. "OK" düyməsinə klikləyin və istənildikdə kompüteri yenidən başladın.

B üsulu: Komanda sətri vasitəsilə (administrator icazələri)

PowerShell-i administrator olaraq işə salın və aşağıdakı əmrləri icra edin:

# WSL-nin aktivləşdirilməsi
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Virtual maşın platformasının aktivləşdirilməsi
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

İcra tamamlandıqdan sonra kompüteri əl ilə yenidən başladın.

1.4 WSL nüvəsinin quraşdırılması/yenilənməsi

Müasir Windows versiyaları WSL yeniləmələrini Microsoft Store-dan əldə edə bilər.

• Endirmə ünvanı: Microsoft Store – Windows Subsystem for Linux
• Əl ilə endirmə: Mağaza mövcud deyilsə, oflayn quraşdırma üçün ən son .msixbundle və ya .msi quraşdırma paketini WSL GitHub Releases səhifəsindən endirə bilərsiniz.

1.5 WSL 2-nin standart versiya olaraq təyin edilməsi

Yeni quraşdırılan distributivlərin standart olaraq WSL 2 istifadə etməsini təmin etmək üçün terminalda icra edin:

wsl --set-default-version 2

1.6 Tez-tez verilən suallar

• 0x80370102 xətası: Adətən BIOS-da virtualizasiyanın açılmaması və ya Hyper-V münaqişəsi ilə bağlıdır.
• WSL 1 və WSL 2 arasında keçid: Mövcud WSL 1 instansını wsl --set-version <distributiv_adı> 2 əmri ilə WSL 2-yə yüksəldə bilərsiniz.

2. Əmrin işləməsi quraşdırmanın uğurlu olması demək deyil

wsl --version, wsl -l -v kimi əmrlərin normal icra oluna bilməsi, Linux quraşdırılması üçün şərtlərin hazır olması demək deyil. Bunlar fərqli mərhələlərdir və bərabərləşdirilə bilməz.

Əmrin işləməsi yalnız bunu göstərir:

• ✅ Windows-da WSL komponentləri aktivləşdirilib/quraşdırılıb
• ✅ wsl.exe komanda sətri aləti əlçatandır
• ✅ Sistem WSL ilə əlaqəli əmrləri tanıyır

Lakin Linux distributivinin uğurla quraşdırılması üçün əlavə şərtlər lazımdır. Tez-tez ilişilib qalınan yerlər:

1. Virtualizasiya bağlanıb: BIOS/UEFI-də VT-x / AMD-V aktiv deyil; WSL 2 başlaya bilmir və ya distributiv quraşdırılarkən virtualizasiya xətası bildirilir (yoxlama üsulu: 1.2 Avadanlıq virtualizasiyasının aktivləşdirilməsi).
2. Windows versiyası/Build nömrəsi çox aşağıdır: WSL 2 nüvə və versiya tələbləri qoyur; Home versiyaları və çox köhnə korporativ görüntülər funksiya baxımından natamam ola bilər (yoxlama üsulu: 1.1 Sistem tələblərinin yoxlanılması).
3. Linux distributivi hələ də faktiki olaraq quraşdırılmayıb: wsl -l -v yalnız quraşdırılmış distributivləri siyahılayır; heç nə quraşdırılmayıbsa siyahı boşdur, bu Ubuntu-nun birbaşa işlədilə biləcəyi demək deyil.
4. Şəbəkə / Microsoft Store problemləri: wsl --install -d <distributiv> əmri mağazadan və ya şəbəkədən görüntü endirməlidir; korporativ şəbəkə, proxy və firewall mane ola bilər.
5. Qeyri-kafi icazələr: Distributiv quraşdırmaq və ya WSL parametrlərini dəyişdirmək administrator icazələri tələb edir.

TIP

Sadə dillə: WSL əmrləri işləyir ≠ Linux hazırdır, yalnız "giriş biletini" almısınız, sistem hələ faktiki quraşdırılmayıb.

3. Quraşdırma xətalarının aradan qaldırılması

1-ci fəslə görə konfiqurasiyanı tamamladıqdan (və ya tamamladığınızı düşündükdən) sonra wsl --install hələ də uğursuz olursa, aşağıdakı ardıcıllıqla yoxlayın.

3.1 Əvvəlcə "bir klik yoxlaması"

PowerShell-i administrator olaraq işə salın və ardıcıllıqla icra edin:

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

• ✅ İki əmr də problemsiz icra olunursa, WSL isteğe bağlı komponentləri aktivləşib və virtualizasiya şərtləri böyük ölçüdə təmin olunub.
• ❌ Uğursuz olarsa, nəyin çatışmadığını birbaşa göstərir (virtual maşın platforması, Hyper-V, BIOS virtualizasiyası və s.).

Sonra systeminfo icra edin və çıxışda Virtualization Enabled In Firmware: Yes ifadəsinin göründüyünü təsdiqləyin. Yuxarıdakıların hamısı xətasızdırsa, distributiv quraşdırmaq üçün wsl --install əmrini rahatlıqla icra edə bilərsiniz.

NOTE

Heç bir əmr wsl --install-in 100% uğurlu olacağını zəmanətə ala bilməz, lakin yuxarıdakı yoxlamalar quraşdırma şərtlərinin təmin olunub-olunmadığını təsdiqləyə bilər.

3.2 Əl ilə yoxlama siyahısı

"Bir klik yoxlaması" problemi tapa bilmirsə, maddə-maddə yoxlayın:

1. BIOS/proqram təminatı virtualizasiyasının açıq olub-olmadığını yoxlamaq: Administrator PowerShell-də systeminfo icra edin; çıxışda Virtualization Enabled In Firmware: Yes görünməlidir.
2. Windows funksiyalarının açıq olub-olmadığını yoxlamaq:

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

   Hər iki əmrin vəziyyəti Enabled olmalıdır.
3. WSL-nin əlçatan olub-olmadığını yoxlamaq: wsl --version normal çıxış verməlidir; əmr tapılmadı xətası verirsə, WSL komponentləri quraşdırılmayıb, 1-ci fəslə qayıdın.
4. WSL 2-nin istifadə oluna bilməsini yoxlamaq (nüvə & virtual maşın platforması): wsl --set-default-version 2 uğurla qayıtmalıdır. Ümumi uğursuzluq səbəbləri: virtual maşın platforması aktivləşdirilməyib və ya BIOS-da VT-x / AMD-V açılmayıb.

3.3 Ümumi uğursuzluq səbəblərinin sürətli istinadı

Vəziyyət	Təsvir	Həll üsulu
BIOS-da virtualizasiya açılmayıb	Qəti uğursuzluq	Yenidən başladıb BIOS-a girərək VT-x / AMD-V açın (bax 1.2)
Windows 10, 19041-dən aşağı	wsl --install dəstəkləmir	Sistemi yeniləyin (bax 1.1)
Korporativ mühitdə Hyper-V / virtualizasiya deaktiv edilib	Mümkün uğursuzluq	Sistem administratoru ilə əlaqə saxlayın
Köhnə Home versiyası sistemi	Əl ilə quraşdırma tələb olunur	1.4 bölməsinə görə WSL nüvəsini əl ilə quraşdırın

3.4 0xc03a0014 xətası: Virtual disk dəstək provayderi tapılmadı

Xəta mesajı Cannot find a virtual disk support provider for the specified file şəklindədir. Bu, Linux distributivinin problemi deyil; Windows-un VHD/VHDX virtual disk yığını düzgün işləmir, WSL 2 distributivi qeydiyyatdan keçirərkən və ya ext4.vhdx yaradarkən/montaj edərkən uğursuz olur.

Əvvəlcə minimal yoxlama edin: PowerShell-i administrator olaraq işə salın və New-VHD ilə test edin (məs. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Bu əmr də eyni xətanı bildirirsə, problem 100% Windows tərəfindədir, distributivlə əlaqəsi yoxdur.

Aşağıdakı ardıcıllıqla xətanın aradan qaldırılması və təmiri:

1. Virtual Disk xidməti işləmir: services.msc faylını açın, Virtual Disk xidmətini tapın, başlanğıc növünü "Avtomatik" edin və işə salın.

2. WSL / virtual maşın platforması funksiyaları aktivləşdirilməyib (və ya qüvvəyə minməyib): 1.3 Müvafiq Windows funksiyalarının aktivləşdirilməsi bölməsindəki əmrləri yenidən icra edin, sonra mütləq yenidən başladın. Windows Home versiyasında tam Hyper-V yoxdur, lakin WSL 2 yalnız virtual maşın platformasını tələb edir, Hyper-V idarəetmə interfeysini deyil.

3. Virtual disk sürücüsü/cihazı çatışmır: Cihaz Menecerini açın, "Sistem cihazları / Saxlama nəzarətçiləri" altında bunların olub-olmadığını yoxlayın:

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

   Çatışmırlarsa, hdwwiz.exe ilə əl ilə əlavə edə bilərsiniz (Saxlama nəzarətçiləri → Microsoft → Microsoft VHD loopback nəzarətçisi) və FsDepends xidmətinin deaktiv edilmədiyini təsdiqləyin.

4. İdxal edilən görüntü WSL tələblərinə uyğun deyil: wsl --import --vhd istifadə edərkən VHDX ext4 fayl sistemi olmalıdır; LUKS şifrəli disk, adi raw.img, Live ISO və ya NTFS/FAT formatlı boş disk ola bilməz. .img / .qcow2 / .iso faylları birbaşa wsl --import --vhd ilə istifadə edilə bilməz.

5. Yol/icazə/fayl sistemi problemləri: Hədəf qovluq NTFS diskdə olmalıdır (FAT32/exFAT olmaz); yolda Azərbaycan hərfləri, boşluqlar və xüsusi simvollardan qaçının; şəbəkə diskindən, OneDrive-dan və ya sıxılmış qovluqdan idxal etməyin; mütləq həqiqi administrator PowerShell-i istifadə edin (adi terminal deyil).

6. Sistem komponentləri zədələnib: Sistem komponentlərini təmir etmək üçün ardıcıl olaraq DISM və SFC icra edin, sonra yenidən cəhd edin:

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

TIP

Üçüncü tərəf virtual maşınları (VirtualBox, VMware) və ya təhlükəsizlik proqramlarının sandbox/möhkəmləndirmə funksiyaları (məs. 360, Huorong) virtual disk əməliyyatlarına müdaxilə edə bilər; xəta axtararkən onları müvəqqəti söndürüb yenidən cəhd edin.