#Что означает ошибка
Win-KeX: не удаётся запустить графическую оболочку
Win-KeX — это графический режим Kali Linux в WSL2. Он не запускается, если у вас WSL 1, не установлен пакет kali-win-kex, отключена поддержка VcXsrv/WSLg, не хватает прав или повреждён профиль VNC. В Windows 11 с WSLg часть графических приложений работает и без Win-KeX.
Проверьте версию WSL и окружение.
Затем пакеты и режим запуска.
Win-KeX работает только в WSL 2. Проверьте версию WSL, установленный пакет kali-win-kex и наличие требуемого дисплея.
#Причины и решения
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| WSL 1 | Не поддерживается. | Переключите на WSL 2. |
| Нет пакета | Не установлен. | apt install kali-win-kex. |
| Устаревший WSL | Обновления. | wsl --update. |
| Сбой X-сервера | Конфликт. | Перезапустите WSL. |
#Пошаговое решение
- Проверьте версию WSLСначала откройте Windows PowerShell (не терминал Kali) и выполните
wsl -l -v. В списке найдите дистрибутив Kali-Linux и версию WSL; если Kali не показан, проверьте, установлен ли дистрибутив. Только после этого переходите к обновлению WSL, а пакеты Win-KeX устанавливайте внутри терминала Kali. - Обновите WSLВ Windows откройте PowerShell и выполните
wsl --version, затемwsl --updateпри наличии поддержки в вашей версии WSL. По завершении выполнитеwsl --shutdown— это остановит все работающие дистрибутивы WSL, поэтому сначала сохраните работу внутри Linux. Запустите Kali снова и проверьтеwsl -l -v. Еслиwsl --versionне распознаётся, уточните выпуск Windows и способ установки WSL прежде чем применять команды из другой версии. - Установите kali-win-kexЗапустите Kali Linux внутри WSL из меню «Пуск» Windows или командой
wsl -d kali-linuxв PowerShell. В терминале Kali выполнитеsudo apt update, затемsudo apt install kali-win-kex. Дождитесь завершения без ошибок, выйдите из сеанса или перезапустите WSL штатно и попробуйтеkex --win(доступность конкретных режимов зависит от пакета). Если пакет не находится, проверьтеcat /etc/os-releaseи Kali-репозиторий; не добавляйте случайные сторонние источники. - Запустите kexВ терминале дистрибутива Kali под WSL выполните
kex --winдля оконного режима Win-KeX, если соответствующий пакет установлен; в некоторых версиях поддерживаются другие режимы, их можно проверить черезkex --help. Если команда не найдена, проверьте установку пакетаkali-win-kexиз официального репозитория Kali. При ошибке дисплея запишите сообщение, выполнитеwsl -l -vв PowerShell и сравните режим WSL 1/2; не удаляйте пользовательские настройки VNC до резервной копии. - Сохраните старые настройки VNC перед сбросомЗакройте Win-KeX. В терминале Kali выполните
mv ~/.vnc ~/.vnc.backup, если каталог существует. Затем снова запустите Win-KeX: настройки будут созданы заново. Если проблема не исчезла, можно восстановить сохранённый каталог; не удаляйте его без копии. - Версии WSL и обновлениеWindows · PowerShellКомандаВерсии WSL и обновление.
wsl -l -vwsl --update
#Проверка WSL
В PowerShell выполните wsl -l -v: у Kali должна быть версия 2. Преобразование: wsl --set-version kali-linux 2. Обновите WSL: wsl --update, перезапуск wsl --shutdown. Внутри Kali проверьте echo $WSL_DISTRO_NAME и echo $DISPLAY. Для Windows 11 WSLg проверьте ls /mnt/wslg.
#Установка и запуск
Внутри Kali: sudo apt update && sudo apt install -y kali-win-kex. Запуск окна: kex --win -s (Window Mode), полный экран kex --esm --ip -s, звук --sound. Первый запуск попросит пароль VNC. Если порт занят: kex --kill и повторите. Для Windows 11 используйте WSLg-режим: kex --wtstart. Все варианты описаны в .
#Типичные ошибки
Чёрный экран: удалите профиль VNC rm -rf ~/.vnc и запустите kex заново. Ошибка vncserver: command not found — пакет не установлен полностью, повторите установку. Нет окна: проверьте брандмауэр и антивирус, блокирующие VNC на localhost. Недостаточно памяти: настройте .wslconfig (memory=4GB). Поддержка systemd в WSL: /etc/wsl.conf [boot] systemd=true. Обновите видеодрайвер Windows для WSLg.
cat /etc/os-releasecommand -v kexcommand -v wsl.exe