ИИ‑агенты > Pastukhov Agent > Docker Desktop на Windows

Docker Desktop на Windows

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

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

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

Docker Desktop — программа с графическим интерфейсом для управления контейнерами Docker на Windows. Контейнер — это изолированная среда, в которой приложение работает со своими инструментами и настройками, ничего не «разбрасывая» по всей системе. Docker Desktop берёт на себя всю рутину: запуск, остановку и просмотр контейнеров в интерфейсе, без командной строки. Это самый простой путь запустить Pastukhov Agent на Windows.

Установка Docker Desktop

Скачайте Docker Desktop для Windows с docker.com и запустите установщик. Дальше всё просто:

  • во время установки включите WSL 2 — так контейнеры работают быстрее;
  • перезагрузите компьютер, когда появится запрос;
  • после перезагрузки Docker Desktop запустится сам.

Настройка Docker Desktop

Откройте настройки Docker Desktop (значок шестерёнки) и убедитесь, что WSL 2 включён:

  • General — галочка «Use the WSL 2 based engine» должна стоять;
  • Resources → WSL Integration — включите интеграцию для ваших дистрибутивов Linux.

Настройка проекта

Создайте папку для вашего проекта. Внутри создайте файл docker-compose.yml по Руководству по настройке Docker — или файл .env, если предпочитаете запуск командой. Выберите образ — это готовый «набор» Pastukhov Agent с инструментами:

  • maxpastukhov/agent:dev-latest — полная среда разработки (2,8 ГБ): включает ASP.NET Core и инструменты разработки Node.js;
  • maxpastukhov/agent:min-latest — компактный полнофункциональный образ (570 МБ), если инструменты разработки ASP.NET Core не нужны: Node.js, Python и всё необходимое уже внутри.

Запуск Pastukhov Agent

Откройте терминал (PowerShell, Командную строку или WSL) в папке проекта и запустите контейнер:

# Если используете Docker Compose
docker compose up -d

# Если используете Docker CLI с файлом .env
docker run -d --env-file .env -p 5001:80 -v ./MyProject:/project maxpastukhov/agent:dev-latest

Запущенный контейнер появится на панели Docker Desktop — там можно смотреть его журналы, перезапускать и останавливать контейнер мышью, без командной строки.

Откройте браузер и перейдите по адресу http://localhost:5001 (или тому порту, который вы задали).

Нужны специальные инструменты? Если в проекте используются языки или инструменты, которых нет в образе, его можно расширить собственным Dockerfile — как это сделать, описано в разделе «Расширение образа собственными инструментами» Руководства по настройке Docker.

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

  • На чём работает Docker Desktop — в Windows он использует WSL 2 для лучшей производительности. Если WSL 2 ещё не установлен, программа сама предложит установить его во время настройки.
  • Где хранить файлы проекта — для скорости Docker лучше держать их в файловой системе WSL, а не на дисках Windows. Доступ к файлам WSL из Проводника — через \\wsl$\.
  • Порт не открывается — WSL 2 сам перенаправляет порты в Windows, но если localhost не работает, узнайте IP-адрес WSL командой hostname -I внутри WSL и откройте адрес с этим IP.
  • Больше мощности — выделение памяти и процессора для Docker Desktop настраивается в Settings → Resources, если проектам нужно больше ресурсов.

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