Docker Desktop на Windows — Макс Пастухов

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

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

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

Docker Desktop предоставляет графический интерфейс для управления контейнерами Docker на Windows. Это руководство охватывает использование Docker Desktop с серверным WSL 2 для запуска Pastukhov Agent — объединяя удобство графического интерфейса с полной изоляцией контейнеров.

Установка 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 для подхода с Docker CLI. Выберите ваш образ:

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

Запуск Pastukhov Agent

Откройте терминал (PowerShell, Command Prompt или WSL) в папке вашего проекта и запустите контейнер:

# Using Docker Compose
docker compose up -d

# Using Docker CLI with .env file
docker run -d --env-file .env -p 5001:80 -v ./MyProject:/project maxpastukhov/agent:dev-latest

Docker Desktop отображает запущенный контейнер на своей панели. Вы можете просматривать журналы, перезапускать или останавливать контейнер через графический интерфейс.

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

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

Советы

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

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