Setup & Config WSL

Před použitím aplikace WSL Dashboard musí váš systém Windows správně povolit a nakonfigurovat prostředí WSL 2. Tato dokumentace se skládá ze tří hlavních částí:

1. Povolení a konfigurace WSL: základní kroky instalace a konfigurace WSL 2.
2. Dostupnost příkazů neznamená úspěšnou instalaci: vysvětluje, že spustitelný příkaz wsl nezaručuje úspěšnou instalaci systému Linux.
3. Řešení problémů s instalací: způsoby kontroly a opravy, pokud instalace po dokončení konfigurace stále selhává.

1. Povolení a konfigurace WSL

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

1.1 Kontrola systémových požadavků

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

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

IMPORTANT

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

1.2 Povolení hardwarové virtualizace

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

• Způsob kontroly: otevřete "Správce úloh" -> kartu "Výkon" -> "CPU".
• Kontrola stavu: ověřte, že stav "Virtualizace" v pravém dolním rohu ukazuje "Povoleno".
• Způsob povolení: pokud není povolena, 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í souvisejících funkcí systému Windows

Musíte povolit funkce "Podsystém Windows pro Linux" a "Platforma virtuálních počítačů".

Metoda 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:
   • Podsystém Windows pro Linux (Windows Subsystem for Linux)
   • Platforma virtuálních počítačů (Virtual Machine Platform)
3. Klikněte na "OK" a restartujte počítač, když se zobrazí výzva.

Metoda B: Přes příkazový řádek (práva správce)

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

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

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

Po provedení ručně restartujte počítač.

1.4 Instalace nebo aktualizace jádra WSL

Moderní verze systému Windows mohou získávat aktualizace WSL přes Microsoft Store.

• Adresa ke stažení: Microsoft Store — Windows Subsystem for Linux
• Ruční stažení: pokud obchod není k dispozici, můžete si stáhnout nejnovější instalační balíček .msixbundle nebo .msi ze stránky WSL GitHub Releases pro instalaci offline.

1.5 Nastavení WSL 2 jako výchozí verze

Aby nově instalované distribuce ve výchozím nastavení používaly WSL 2, spusťte v terminálu:

wsl --set-default-version 2

1.6 Časté problémy

• Chyba 0x80370102: obvykle je způsobena tím, že v BIOS není povolena virtualizace, nebo konfliktem s Hyper-V.
• Přepínání mezi WSL 1 a WSL 2: můžete použít příkaz wsl --set-version <název distribuce> 2 pro upgrade stávající instance WSL 1 na WSL 2.

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

To, že příkazy wsl --version, wsl -l -v a podobné proběhnou bez chyb, neznamená, že podmínky pro instalaci systému Linux jsou již splněny. Jde o různé fáze, které nelze ztotožňovat.

Dostupnost příkazů vypovídá pouze o tom, že:

• ✅ součásti WSL v systému Windows jsou již povoleny/nainstalovány
• ✅ nástroj příkazového řádku wsl.exe je k dispozici
• ✅ systém rozpoznává příkazy související s WSL

Ale pro úspěšnou instalaci distribuce systému Linux jsou nutné další podmínky. Nejčastěji se uvázne na následujícím:

1. Virtualizace je vypnutá: v BIOS/UEFI nejsou povoleny VT-x / AMD-V, WSL 2 se nespustí, nebo se při instalaci distribuce hlásí chyba virtualizace (způsob kontroly — 1.2 Povolení hardwarové virtualizace).
2. Příliš stará verze/sestavení systému Windows: WSL 2 má požadavky na jádro a verzi; v edici Home nebo příliš starých podnikových obrazech mohou být funkce neúplné (způsob kontroly — 1.1 Kontrola systémových požadavků).
3. Distribuce systému Linux ještě není nainstalovaná: příkaz wsl -l -v vypíše pouze nainstalované distribuce; pokud není nainstalováno nic, seznam bude prázdný, což neznamená, že lze Ubuntu rovnou spustit.
4. Problémy se sítí / Microsoft Store: příkaz wsl --install -d <distribuce> potřebuje stáhnout obraz z obchodu nebo ze sítě; firemní síť, proxy a brána firewall to mohou blokovat.
5. Nedostatečná oprávnění: pro instalaci distribuce nebo změnu nastavení WSL jsou vyžadována oprávnění správce.

TIP

Jednoduše řečeno: fungující příkazy WSL ≠ Linux je připraven — máte jen "vstupenku", ale samotný systém ještě není nainstalován.

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

Pokud instalace po konfiguraci podle kapitoly 1 (nebo když si myslíte, že jste konfiguraci dokončili) stále selhává příkazem wsl --install, postupujte v uvedeném pořadí.

3.1 Nejprve proveďte "rychlou kontrolu"

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

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

• ✅ Pokud oba příkazy proběhnou bez problémů, volitelné součásti WSL jsou povoleny a podmínky virtualizace jsou v zásadě splněny.
• ❌ Pokud dojde k chybě, systém rovnou napoví, co chybí (např. platforma virtuálních počítačů, Hyper-V, virtualizace BIOS atd.).

Poté spusťte systeminfo a ve výstupu ověřte, že se objevuje Virtualization Enabled In Firmware: Yes. Pokud výše uvedené proběhlo bez chyb, můžete bez obav spustit wsl --install pro instalaci distribuce.

NOTE

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

3.2 Ruční kontrolní seznam

Pokud "rychlá kontrola" problém nezjistila, projděte jednotlivé položky:

1. Zkontrolujte, zda je povolena virtualizace BIOS/firmwaru: v PowerShellu jako správce spusťte systeminfo; ve výstupu musí být vidět Virtualization Enabled In Firmware: Yes.
2. Zkontrolujte, zda jsou povoleny funkce systému 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. Zkontrolujte dostupnost WSL: příkaz wsl --version by měl vrátit normální výstup; pokud hlásí, že příkaz neexistuje, součásti WSL nejsou nainstalovány — vraťte se ke kapitole 1.
4. Zkontrolujte možnost použití WSL 2 (jádro a platforma virtuálních počítačů): příkaz wsl --set-default-version 2 by měl úspěšně proběhnout. Časté příčiny selhání: není povolena platforma virtuálních počítačů nebo v BIOS nejsou povoleny VT-x / AMD-V.

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

Situace	Popis	Způsob řešení
Virtualizace není povolena v BIOS	Nezbytně skončí chybou	Restartujte počítač, vstupte do BIOS a povolte VT-x / AMD-V (viz 1.2)
Windows 10 nižší než 19041	wsl --install není podporován	Aktualizujte systém (viz 1.1)
Podnikové prostředí zakazuje Hyper-V / virtualizaci	Možné selhání	Obraťte se na správce systému
Stará edice Home systému	Vyžaduje ruční instalaci	Ručně nainstalujte jádro WSL podle 1.4

3.4 Chyba 0xc03a0014: nelze najít poskytovatele podpory virtuálního disku

Chybové hlášení: Cannot find a virtual disk support provider for the specified file. Problém není v samotné distribuci systému Linux, ale v tom, že zásobník virtuálních disků VHD/VHDX v systému Windows nepracuje správně, kvůli čemuž WSL 2 nemůže zaregistrovat distribuci a vytvořit/připojit ext4.vhdx.

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

Postupujte 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í souvisejících funkcí systému Windows a poté musíte restartovat. Edice Home systému Windows nemá plný Hyper-V, ale WSL 2 potřebuje pouze platformu virtuálních počítačů, nikoli konzoli správy Hyper-V.

3. Chybí ovladače/zařízení virtuálních disků: otevřete Správce zařízení a zkontrolujte, zda v sekci "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 ujistěte se, že služba FsDepends není zakázána.

4. Importovaný obraz neodpovídá požadavkům WSL: při použití wsl --import --vhd musí mít soubor VHDX souborový systém ext4; nevyhovují šifrované disky LUKS, běžné raw.img, Live ISO ani prázdné disky naformátované na NTFS/FAT. Soubory .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 nejsou vhodné); v cestě se vyhněte diakritice, mezerám a speciálním znakům; neimportujte ze síťových disků, OneDrive ani komprimovaných složek; vždy používejte skutečný PowerShell spuštěný jako správce (ne běžný terminál).

6. Poškozené systémové součásti: postupně spusťte DISM a SFC pro opravu systémových součástí a poté to zkuste znovu:

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

TIP

Virtuální stroje třetích stran (VirtualBox, VMware) nebo funkce sandboxu/posílení bezpečnostního softwaru (např. 360, Huorong) mohou narušovat operace s virtuálními disky; při diagnostice je můžete dočasně vypnout a zkusit to znovu.