Настройка WSL и Docker на Windows

Введение

Если вы хотите использовать MCP-серверы с вашими LLM, и у вас Windows, этот гайд для вас (и я вам сочувствую). Здесь описана полная установка WSL + Ubuntu + Docker Desktop.

Чистка предыдущих установок, если они были

⚠️ Этот раздел нужен только если WSL или Docker уже были установлены и что-то пошло не так: например, нет доступа в сеть, WSL не видит VPN, или Docker недоступен внутри WSL. Если устанавливаешь впервые, пропусти и переходи к разделу «Установка».

🗑️ Осторожно с потерей данных: wsl --unregister удаляет все файлы внутри файловой системы Linux-дистрибутива (например, ~/projects). Файлы на Windows-дисках (/mnt/c/...) затронуты не будут.

1. Смотрим список дистрибутивов и удаляем все:

# list all installed distros
 wsl -l -v 

 # destroy distros, in this example only Ubuntu 
 wsl - unregister Ubuntu

2. Удаляем все дистрибутивы с WSL. Есть два варианта: 2.1. Делаем Reset Windows Subsystems for Linux. Пример на скрине

2.2. В Settings > Apps > Apps & Features:

• найди Ubuntu (или Debian и т.д.) — если найдено, нажми Uninstall
• найди Linux — если найдено, нажми Uninstall на всех результатах

3. Отключи компоненты Windows

В Пуск → Включение и отключение компонентов Windows сними галочки:

• Virtual Machine Platform
• Windows Subsystem for Linux

4. Перезагрузи компьютер.

Установка

Все команды в разделе «Установка WSL» выполняются в PowerShell от имени администратора.

Установка WSL

1. Запусти PowerShell от имени администратора и выполни:

wsl - install

эта команда автоматически включает нужные компоненты Windows (Virtual Machine Platform, WSL) и по умолчанию устанавливает Ubuntu. После установки в файловой системе Windows появится раздел Linux.

2. Перезагрузи компьютер.

3. Установи Ubuntu или другой дистрибутив (если вообще ничего в этом не понимаешь, то останься с Ubuntu, из всех дистрибутивов они единственные пишут пакеты специально для WSL).

wsl - install Ubuntu

После этого шага в файловой системе будет видно, что в Linux появился ваш дистрибутив.

4. Зайди в WSL:

# Если установлен только один дистрибутив
 wsl
 # Если установлено несколько - укажи явно
 wsl -d Ubuntu

При первом входе Ubuntu попросит создать имя пользователя и пароль — это будет твой пользователь внутри Linux. Запомни пароль: он потребуется для всех команд sudo.

5. Обнови пакеты и установи базовые инструменты:

# Обновить список пакетов
 sudo apt update

 # Обновить установленные пакеты
 sudo apt upgrade -y

 # если среди пакетов не было curl, wget и git, то нужна еще команда ниже
 # Установить базовые инструменты (curl и git понадобятся при работе с MCP-серверами)
 sudo apt install -y curl wget git

6. Установи Google Chrome в WSL:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt -y install ./google-chrome-stable_current_amd64.deb

Это позволит открывать ссылки прямо из WSL — удобно при OAuth-аутентификации в корпоративных сервисах, чтобы не копировать ссылки вручную в браузер.

7. Ваш WSL-дистрибутив настроен и готов к работе 🎉

Как работать в WSL

• Через PowerShell — wsl — cd ~ чтобы сразу оказаться в домашней папке дистрибутива
• Через приложение — например, открой Ubuntu из меню Пуск

Установка Docker

Docker нужен для работы с MCP-серверами и корпоративными клиентами. Советую не пропускать эти шаги.

Описываю только один вариант с Docker Desktop for Windows — это самый надёжный способ, меньше шансов, что вы запутаетесь и получите потом проблемы.

1. Скачай Docker Desktop с docker.com — для Windows почти всегда нужна версия amd64, не arm
2. В процессе установки обязательно включи опцию «Use WSL 2 instead of Hyper-V»

Настройка интеграции Docker с WSL

Открой Docker Desktop → Settings → Resources → WSL Integration и:

• Включи свой WSL-дистрибутив
• Нажми Apply and Restart

Настройка Docker внутри WSL

Выполни следующие команды внутри WSL:

# Добавить текущего пользователя в группу docker (чтобы не нужен был sudo)
 sudo usermod -aG docker $USER

 # Применить изменения группы без перезапуска WSL
 newgrp docker

Проверь установку:

docker - version # если сработало - Docker доступен в WSL
docker run hello-world # проверяет связь с Docker Hub

📖 Источник: A professional guide to installing WSL and Docker on Windows. Мой гайд во многом основан на указанном источнике, но значительно переработан, так как в оригинале он для меня не сработал.