Nastavení a konfigurace WSL

Před použitím WSL Dashboard musí být ve vašem systému Windows správně povoleno a nakonfigurováno prostředí WSL 2. Tento dokument se skládá ze tří hlavních částí:

1. Povolení a nastavení WSL: dokončení základní instalace a konfigurace WSL 2.
2. Dostupnost příkazu neznamená úspěšnou instalaci: vysvětlení, že spustitelnost příkazu wsl neznamená úspěšnou instalaci Linuxu.
3. Řešení problémů s instalací: kontrola a náprava, pokud instalace po konfiguraci stále selhává.

1. Povolení a nastavení WSL

Tato kapitola vás provede nezbytným základním nastavením. Po jejím dokončení si přečtěte kapitolu 2, abyste pochopili rozdíl mezi dostupností příkazu a úspěšnou instalací; pokud instalace stále způsobuje problémy, podívejte se na kapitolu 3.

1.1 Kontrola systémových požadavků

WSL 2 má minimální požadavky na verzi Windows. Stiskněte Win + R, zadejte winver a zkontrolujte svou verzi:

• Windows 10: verze 1903 nebo novější, číslo sestavení (Build) musí být 18362 nebo novější.
• Windows 11: podporovány jsou všechny verze.

IMPORTANT

Pokud je vaše verze příliš stará, nejprve systém aktualizujte přes „Windows Update“.

1.2 Zapnutí hardwarové virtualizace

WSL 2 běží na technologii virtualizace, proto musí být v BIOS/UEFI základní desky povolena technologie virtualizace (Virtualization Technology).

• Jak zkontrolovat: otevřete „Správce úloh“ → kartu „Výkon“ → „Procesor“.
• Jak zjistit stav: ověřte, že stav „Virtualizace“ v pravém dolním rohu je „Povoleno“.
• Jak zapnout: pokud není zapnuta, restartujte počítač, vstupte do nastavení BIOS/UEFI, najděte možnost podobnou Intel VT-x nebo AMD-V a nastavte ji na Enabled.

1.3 Povolení příslušných funkcí Windows

Je třeba zapnout funkce „Subsystém Windows pro Linux“ a „Platforma virtuálních počítačů“.

Způsob A: přes grafické rozhraní (doporučeno)

1. Stiskněte Win + S, vyhledejte a otevřete „Zapnout nebo vypnout funkce systému Windows“.
2. Zaškrtněte následující dvě položky:
   • Subsystém Windows pro Linux (Windows Subsystem for Linux)
   • Platforma virtuálních počítačů (Virtual Machine Platform)
3. Klikněte na „OK“ a při výzvě restartujte počítač.

Způsob B: přes příkazový řádek (oprávnění správce)

Spusťte PowerShell jako správce a proveďte následující příkazy:

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

# Povolení platformy virtuálních počítačů
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Po dokončení příkazů restartujte počítač ručně.

1.4 Instalace/aktualizace jádra WSL

Moderní verze Windows mohou získávat aktualizace WSL z Microsoft Store.

• Adresa stažení: Microsoft Store – Windows Subsystem for Linux
• Ruční stažení: pokud není obchod k dispozici, lze nejnovější balíčky .msixbundle nebo .msi stáhnout pro offline instalaci ze stránky WSL GitHub Releases.

1.5 Nastavení WSL 2 jako výchozí verze

Abyste zajistili, že nově nainstalované distribuce budou ve výchozím nastavení používat WSL 2, spusťte v terminálu:

wsl --set-default-version 2

1.6 Často kladené otázky

• Chyba 0x80370102: obvykle znamená, že virtualizace není povolena v BIOS, nebo dochází ke konfliktu s Hyper-V.
• Přepínání mezi WSL 1 a WSL 2: pomocí wsl --set-version <název distribuce> 2 můžete upgradovat stávající instanci WSL 1 na WSL 2.

2. Dostupnost příkazu neznamená úspěšnou instalaci

To, že příkazy wsl --version, wsl -l -v atd. fungují správně, neznamená, že jsou splněny podmínky pro instalaci Linuxu. Jde o různé fáze, které nelze ztotožňovat.

Dostupnost příkazu znamená pouze to, že:

• ✅ Komponenty WSL ve Windows jsou povoleny/nainstalovány
• ✅ Nástroj příkazového řádku wsl.exe je k dispozici
• ✅ Systém rozpoznává příkazy související s WSL

Pro úspěšnou instalaci distribuce Linuxu jsou ale nutné další podmínky. Běžná místa, kde se zaseknete:

1. Vypnutá virtualizace: v BIOS/UEFI nejsou zapnuty VT-x / AMD-V, WSL 2 se nemůže spustit nebo při instalaci distribuce hlásí chybu virtualizace (kontrola viz 1.2 Zapnutí hardwarové virtualizace).
2. Příliš stará verze/číslo sestavení Windows: WSL 2 má požadavky na jádro a verzi; domácí edice nebo příliš staré podnikové obrazy mohou postrádat funkce (kontrola viz 1.1 Kontrola systémových požadavků).
3. Distribuce Linuxu ještě není skutečně nainstalována: wsl -l -v vypisuje pouze nainstalované distribuce; pokud není nainstalováno nic, je seznam prázdný — to neznamená, že lze rovnou spustit Ubuntu.
4. Problémy se sítí / Microsoft Store: wsl --install -d <distribuce> stahuje obrazy z obchodu nebo sítě; firemní sítě, proxy a brány firewall mohou blokovat.
5. Nedostatečná oprávnění: instalace distribucí nebo změna nastavení WSL vyžaduje oprávnění správce.

TIP

Jednoduše řečeno: funkční příkazy WSL ≠ Linux připraven — máte jen „vstupenku“, ale systém ještě skutečně není nainstalován.

3. Řešení problémů s instalací

Pokud po dokončení konfigurace podle kapitoly 1 (nebo pokud si myslíte, že jste konfiguraci dokončili) příkaz wsl --install stále selhává, zkontrolujte v následujícím pořadí.

3.1 Nejprve „rychlé ověření“

Spusťte PowerShell jako správce a postupně proveďte:

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

• ✅ Pokud oba příkazy proběhnou bez chyb, volitelné komponenty WSL jsou povoleny a podmínky virtualizace jsou v zásadě splněny.
• ❌ Při selhání systém přímo oznámí, co chybí (např. platforma virtuálních počítačů, Hyper-V, virtualizace v BIOS atd.).

Poté spusťte systeminfo a ověřte, že se ve výstupu objeví Virtualization Enabled In Firmware: Yes. Pokud nikde nejsou chyby, můžete se bez obav pustit do wsl --install pro instalaci distribuce.

NOTE

Žádný příkaz nemůže na 100 % zaručit úspěch wsl --install, ale výše uvedené kontroly potvrzují, zda jsou splněny podmínky instalace.

3.2 Ruční kontrolní seznam

Pokud „rychlé ověření“ problém neodhalí, zkontrolujte položku po položce:

1. Ověření zapnuté virtualizace v BIOS/firmwaru: spusťte systeminfo v PowerShellu jako správce; ve výstupu musí být řádek Virtualization Enabled In Firmware: Yes.
2. Ověření povolených funkcí Windows:

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

   Stav obou příkazů by měl být Enabled.
3. Ověření dostupnosti WSL: wsl --version by měl poskytnout normální výstup; pokud systém hlásí, že příkaz neexistuje, komponenty WSL nejsou nainstalovány — vraťte se k kapitole 1.
4. Ověření možnosti použít WSL 2 (jádro a platforma virtuálních počítačů): wsl --set-default-version 2 by měl úspěšně vrátit. Časté příčiny selhání: není povolena platforma virtuálních počítačů, nebo v BIOS nejsou zapnuty VT-x / AMD-V.

3.3 Rychlý přehled častých příčin selhání

Situace	Popis	Řešení
V BIOS není povolena virtualizace	Jisté selhání	Restartujte, vstupte do BIOS a zapněte VT-x / AMD-V (viz 1.2)
Windows 10 nižší než 19041	wsl --install není podporován	Aktualizujte systém (viz 1.1)
V podnikovém prostředí je zakázán Hyper-V / virtualizace	Možné selhání	Kontaktujte správce systému
Stará domácí edice	Vyžaduje ruční instalaci	Ručně nainstalujte jádro WSL podle 1.4

3.4 Chyba 0xc03a0014: nebyl nalezen poskytovatel podpory virtuálních disků

Chybové hlášení: Cannot find a virtual disk support provider for the specified file. To není problém samotné distribuce Linuxu, ale zásobník virtuálních disků VHD/VHDX systému Windows nefunguje správně — WSL 2 selhává při registraci distribuce, vytváření/připojování ext4.vhdx.

Nejprve minimální ověření: spusťte v PowerShellu jako správce test New-VHD (např. New-VHD -Path C:\test.vhdx -SizeBytes 1GB). Pokud tento příkaz hlásí stejnou chybu, problém je na 100 % na straně Windows a nesouvisí s distribucí.

Ověřujte a opravujte v tomto pořadí:

1. Služba Virtual Disk neběží: otevřete services.msc, najděte službu Virtual Disk, nastavte typ spouštění na „Automaticky“ a spusťte ji.

2. Funkce WSL / platforma virtuálních počítačů nejsou povoleny (nebo se neprojevily): znovu spusťte příkazy z 1.3 Povolení příslušných funkcí Windows a poté je nutné restartovat. Domácí edice Windows nemá plný Hyper-V, ale WSL 2 potřebuje pouze platformu virtuálních počítačů, nikoli rozhraní pro správu Hyper-V.

3. Chybějící ovladač/zařízení virtuálního disku: otevřete Správce zařízení a zkontrolujte, zda v „Systémová zařízení / Řadiče úložiště“ existují:

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

   Pokud chybí, lze je přidat ručně přes hdwwiz.exe (řadiče úložiště → Microsoft → Microsoft VHD Loopback Controller) a ověřte, že služba FsDepends není zakázána.

4. Importovaný obraz nesplňuje požadavky WSL: při wsl --import --vhd musí být VHDX ve souborovém systému ext4; nesmí to být LUKS šifrovaný disk, běžný raw.img, Live ISO ani prázdný disk naformátovaný NTFS/FAT. .img / .qcow2 / .iso nelze přímo použít s wsl --import --vhd.

5. Problémy s cestou/oprávněními/souborovým systémem: cílový adresář musí být na disku NTFS (FAT32/exFAT nefungují); v cestě se vyhněte čínským znakům, mezerám a speciálním symbolům; neimportujte ze síťových disků, OneDrive nebo komprimovaných složek; vždy používejte skutečný PowerShell správce (ne běžný terminál).

6. Poškození systémových komponent: postupně spusťte DISM a SFC pro opravu systémových komponent a pak to zkuste znovu:

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

TIP

Třetí strany virtuální stroje (VirtualBox, VMware) nebo sandbox/posilující funkce bezpečnostního softwaru (např. 360, Huorong) mohou narušovat operace s virtuálními disky; při odstraňování problémů je lze dočasně vypnout.