Pastukhov Code > Установка WSL

Технологии извлечения и анализа данных

Установка WSL

Don’t want to read through all this?

Just point any AI chat (Claude, ChatGPT, etc.) to this page in Markdown or to the llms.txt index, and ask it to generate the config files and commands for you. It’ll read the docs, ask you a few questions about your setup, and give you ready-to-use configuration. Save your time — let the model do the reading.

You could also contact me via Telegram — I’m always eager to help. I’m not being just polite here — I really like to chat with like-minded people, especially if you love coding as much as I do.

WSL (Windows Subsystem for Linux) позволяет запускать окружение Linux непосредственно в Windows без использования виртуальной машины. Это отличный способ запустить Pastukhov Code в контейнере Docker в Windows — вы получаете полную изоляцию Docker с производительностью родного Linux.

Windows 11

Windows 11 включает поддержку WSL 2 из коробки. Откройте терминал (PowerShell или Командная строка) и выполните:

wsl --install

Это установит WSL 2 с Ubuntu в качестве дистрибутива по умолчанию. Перезагрузите компьютер по запросу. После перезагрузки Ubuntu откроется автоматически — задайте имя пользователя и пароль для окружения Linux.

Установка Docker

В терминале WSL установите Docker:

# Install prerequisites
sudo apt update && sudo apt install -y ca-certificates curl

# Add Docker's GPG key and repository
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Install Docker Engine
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Start Docker
sudo service docker start

# Add your user to the docker group (so you don't need sudo)
sudo usermod -aG docker $USER

После добавления пользователя в группу docker закройте и снова откройте терминал WSL, чтобы изменения вступили в силу. Проверьте работу Docker:

docker --version
docker compose version

Запуск Pastukhov Code

Создайте каталог для вашего проекта и следуйте Руководству по настройке Docker, чтобы настроить и запустить Pastukhov Code. Ваши проектные файлы доступны как из Windows (через \\wsl$\Ubuntu\ в Проводнике), так и из терминала WSL.

Windows 10

WSL 2 в Windows 10 требует дополнительного шага — включения платформы виртуальной машины. Откройте PowerShell от имени администратора и выполните:

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

# Enable Virtual Machine Platform (required for WSL 2)
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Перезагрузите компьютер, затем снова откройте PowerShell и установите WSL 2 как версию по умолчанию:

wsl --set-default-version 2

Установите Ubuntu из Microsoft Store (найдите “Ubuntu”) или выполните:

wsl --install -d Ubuntu

После установки откройте Ubuntu и задайте имя пользователя и пароль. Затем следуйте тем же шагам установки Docker из раздела Windows 11 выше.

Доступ к приложению

Когда Pastukhov Code запущен в Docker, откройте браузер в Windows и перейдите по адресу http://localhost:5001 (или любому другому порту, который вы настроили). WSL 2 автоматически перенаправляет порты в Windows, поэтому дополнительная настройка сети не требуется.

Если порт по какой-то причине недоступен, найдите IP-адрес WSL:

# In WSL terminal
hostname -I

Затем откройте http://<этот-ip>:5001 в браузере Windows.

Советы

  • Доступ к файлам — Ваши диски Windows смонтированы в WSL под /mnt/c/, /mnt/d/ и т.д. Однако для лучшей производительности Docker храните файлы проекта внутри файловой системы WSL (например, ~/projects/), а не на дисках Windows.
  • Автозапуск Docker — Чтобы Docker запускался автоматически при открытии WSL, добавьте sudo service docker start в ваш ~/.bashrc или ~/.zshrc.
  • Альтернатива Docker Desktop — Если вы предпочитаете графический интерфейс Docker, см. Руководство по Docker Desktop в Windows для настройки Docker Desktop с бэкендом WSL 2. Docker Desktop автоматически интегрируется с WSL 2, поэтому вы можете пропустить ручную установку Docker.

Для получения подробностей о конфигурации Docker (файлы compose, переменные окружения, учетные данные) см. Руководство по настройке Docker. Для установки через нативный установщик Windows см. Руководство по установке Windows.