ИИ‑агенты > Pastukhov Agent > Установка WSL

Установка WSL

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

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

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

WSL (Windows Subsystem for Linux) — встроенная в Windows возможность запускать Linux без виртуальной машины и переустановки системы. Простыми словами: вы получаете «настоящий Linux» внутри Windows, с теми же командами и программами. Для Pastukhov Agent это удобный способ запустить его в контейнере Docker на компьютере с Windows: контейнер полностью изолирует программу от остальной системы, а работает всё на скорости родного Linux.

Windows 11

В Windows 11 WSL 2 уже встроен — достаточно одной команды, всё остальное система сделает сама. Откройте терминал (PowerShell или Командная строка) и выполните:

wsl --install

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

Установка Docker

Теперь нужно установить Docker — технологию «контейнеров», в которой работает Pastukhov Agent. В терминале WSL выполните:

# Подготовка (нужные вспомогательные программы)
sudo apt update && sudo apt install -y ca-certificates curl

# Добавление ключа и репозитория Docker
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

# Установка Docker Engine
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Запуск Docker
sudo service docker start

# Добавляем себя в группу docker, чтобы не вводить 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

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

# Включение WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Включение платформы виртуальной машины (обязательно для 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 запущен, откройте браузер в Windows и перейдите по адресу http://localhost:5001 (или тому порту, который вы указали при настройке). WSL 2 сам перенаправляет порты в Windows, поэтому ничего дополнительно настраивать не нужно.

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

# В терминале WSL
hostname -I

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

Полезные советы

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

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