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

Установка WSL

Не хотите читать всё это?

Просто скиньте в любой ИИ-чат (Claude, ChatGPT и т.д.) ссылку на https://pastukhov.com/agent/wsl.md или на https://pastukhov.com/llms.txt и попросите сгенерировать конфигурационные файлы и команды. Он прочитает документацию, задаст несколько вопросов о вашей настройке и выдаст готовую конфигурацию. Экономьте время — пусть модель читает за вас.

Вы также можете связаться со мной через Telegram — я всегда рад помочь. И это не просто вежливость — мне действительно нравится общаться с единомышленниками, особенно если вы так же увлечены программированием, как и я.

WSL (Windows Subsystem for Linux) позволяет запускать окружение Linux непосредственно в Windows без использования виртуальной машины. Это отличный способ запустить Pastukhov Agent в контейнере 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 Agent

Создайте каталог для вашего проекта и следуйте Руководству по настройке Docker, чтобы настроить и запустить Pastukhov Agent. Ваши проектные файлы доступны как из 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 Agent запущен в 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.