Пошаговое руководство: Установка Docker Desktop на Windows и macOS

Docker Desktop — это обычная отправная точка, когда вы хотите запускать контейнеры на ноутбуке с Windows или macOS. Установка проста, но некоторые системные настройки могут помешать запуску Docker после завершения установки.

Это руководство проведет вас через установку Docker Desktop на Windows и macOS, а затем проверит, что Docker CLI, Docker Engine и тестовый контейнер работают корректно.

Что устанавливает Docker Desktop

Docker Desktop предоставляет локальную среду Docker с Docker CLI, Docker Engine, Docker Compose, панелью управления и опциональной поддержкой Kubernetes. В Windows Docker Desktop обычно запускает контейнеры Linux через WSL 2. В macOS он запускает контейнеры внутри легковесной виртуальной машины Linux.

Для повседневной разработки это означает, что вы можете выполнять такие команды, как:

docker run hello-world
docker compose up
docker build -t my-app .

Вам не нужно предварительно устанавливать отдельный пакет Docker Engine.

Сначала проверьте требования

Docker со временем меняет требования к платформе, поэтому перед установкой на старые машины проверьте текущую документацию Docker. В большинстве современных конфигураций вы должны подтвердить эти основы.

Требования для Windows

Используйте поддерживаемую 64-разрядную версию Windows и поддерживайте ее в актуальном состоянии. Docker Desktop лучше всего работает с бэкендом WSL 2, поэтому установите WSL до или во время настройки:

wsl --install

Запустите эту команду из повышенной привилегией PowerShell или командной строки, затем перезагрузитесь, если Windows попросит.

Также проверьте аппаратную виртуализацию. Откройте Диспетчер задач, перейдите на вкладку Производительность, выберите ЦП и найдите Виртуализация: Включено. Если она отключена, включите ее в настройках BIOS или UEFI.

Docker Desktop предназначен для настольных сред Windows, а не для Windows Server.

Требования для macOS

Используйте поддерживаемую версию macOS на Apple Silicon или Intel Mac. Загрузите правильный установщик для вашего типа чипа. Если вы не уверены, какой у вас Mac, откройте меню Apple > Об этом Mac и проверьте строку с чипом или процессором.

Docker Desktop требует достаточного объема памяти и дискового пространства для запуска виртуальной машины Linux и хранения образов. Если вы планируете запускать базы данных или многокомпонентные стеки локально, выделите Docker больше памяти в настройках после установки.

Установка Docker Desktop на Windows

Загрузите Docker Desktop с официального сайта Docker. Избегайте сторонних зеркал загрузки для инструментов разработчика.

Запустите установщик .exe и оставьте опцию WSL 2 включенной, когда она появится. Если установщик предложит добавить необходимые компоненты Windows, разрешите это. После установки перезагрузите компьютер, если будет предложено.

Откройте Docker Desktop из меню «Пуск». При первом запуске примите условия лицензии и дайте Docker завершить настройку. Если Docker сообщает о проблеме с WSL, обновите WSL и попробуйте снова:

wsl --update

Если вы используете корпоративный ноутбук, программное обеспечение для защиты конечных точек может мешать виртуализации или локальной сети. В этом случае проверьте политику вашей компании в отношении Docker Desktop, прежде чем изменять настройки брандмауэра или антивируса.

Установка Docker Desktop на macOS

Загрузите Docker Desktop для Mac с официального сайта Docker. Выберите установщик для Apple Silicon для Mac с чипами M-серии и установщик для Intel для Mac на Intel.

Откройте файл .dmg, затем перетащите Docker в папку «Программы». Запустите Docker из «Программ». macOS может запросить ваш пароль или разрешение на установку вспомогательных компонентов, используемых для сети и виртуализации.

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

Проверка установки

Откройте терминал и проверьте клиент и сервер Docker:

docker version

Вы должны увидеть как раздел клиента, так и раздел сервера. Если вы видите только информацию о клиенте или ошибку о подключении к демону, Docker Desktop еще не запущен или не удалось запустить.

Запустите стандартный тестовый контейнер:

docker run hello-world

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

Вы также можете проверить Docker Compose:

docker compose version

Используйте команду docker compose с пробелом для Compose v2, которая включена в Docker Desktop.

Настройка первых параметров

Откройте настройки Docker Desktop после первого успешного теста.

В Windows проверьте Ресурсы > Интеграция WSL и включите интеграцию для дистрибутивов Linux, где вы выполняете команды разработки. Если вы используете Ubuntu в WSL, это позволит вам запускать docker из оболочки Ubuntu.

Как в Windows, так и в macOS просмотрите Ресурсы. Небольшие проекты могут работать нормально с настройками по умолчанию, но локальный Kubernetes, базы данных и большие сборки часто требуют больше памяти или дискового пространства.

Включайте Kubernetes только в том случае, если вам нужен локальный одноузловой кластер. Если оставить его выключенным, Docker Desktop будет работать легче.

Распространенные проблемы при установке

Если Docker не запускается в Windows, сначала убедитесь, что виртуализация включена и WSL установлен:

wsl --status

Если WSL устарел, выполните:

wsl --update

Если docker version не может подключиться к демону Docker, убедитесь, что Docker Desktop запущен и завершил загрузку. В macOS проверьте значок в строке меню. В Windows проверьте область уведомлений.

Если тестовый контейнер не может подключиться к сети, протестируйте из другой сети или состояния VPN. VPN-клиенты и корпоративные прокси часто влияют на сеть Docker. В Docker Desktop есть настройки прокси, которые можно настроить, если ваша среда требует их.

Как только docker run hello-world заработает, ваша локальная среда контейнеров готова. Хорошим следующим шагом будет запуск одной службы, которую вы уже знаете, например Nginx:

docker run --rm -p 8080:80 nginx

Затем откройте http://localhost:8080. Если вы видите страницу приветствия Nginx, Docker может загружать образы, запускать контейнеры и публиковать порты на вашей машине.