Как установить Docker на Windows

Что проверить перед установкой

• 64-битная Windows 11 версии 23H2 (сборка 22631) или новее либо Windows 10 22H2 (сборка 19045). На странице Docker названы выпуски Pro, Enterprise и Education. В Home и Education работают только Linux-контейнеры — а именно они нужны большинству проектов. Версию покажет команда winver в меню «Пуск».
• Не меньше 8 ГБ памяти и 64-битный процессор с SLAT — он есть у любого компьютера последних десяти лет.
• Виртуализация включена в BIOS или UEFI. Откройте «Диспетчер задач», вкладку «Производительность» › «ЦП» и найдите строку «Виртуализация: Включено».
• WSL версии 2.1.5 или новее. Её поставит или обновит следующий раздел.

Docker Desktop бесплатен для личного пользования, учёбы, некоммерческих open source проектов и небольших компаний — меньше 250 сотрудников и меньше 10 миллионов долларов выручки в год. Компаниям крупнее для работы нужна платная подписка.

Как поставить или обновить WSL 2

Щёлкните правой кнопкой по «Пуску», выберите «Терминал (Администратор)» и выполните первую команду, если WSL на компьютере ещё нет, или вторую, чтобы её обновить. Если система попросит, перезагрузите Windows. Третья команда покажет версию.

Если проверка версии выводит только справку, на компьютере старая встроенная WSL — ей нужна команда обновления из блока выше. Про дистрибутивы и ошибки подробнее: как установить WSL на Windows.

Как установить Docker Desktop на Windows

1. На странице docs.docker.com/desktop/setup/install/windows-install нажмите Docker Desktop for Windows - x86_64. Для компьютеров на процессоре Arm там же есть своя сборка.
2. Запустите Docker Desktop Installer.exe. По умолчанию установщик ставит программу только для вашей учётной записи, права администратора для этого не нужны. Установка для всех пользователей нужна, только если требуются Windows-контейнеры.
3. На странице Configuration оставьте Per-user installation (Recommended): этот вариант работает через WSL 2. У All-users installation пункт Use WSL 2 instead of Hyper-V тоже отмечен. Нажмите OK, а когда установка закончится — Close.

4. Откройте Docker Desktop из меню «Пуск» и нажмите Accept под соглашением Docker Subscription Service Agreement: без этого Docker Desktop не запустится. Входить в аккаунт Docker не обязательно.

Через winget в Терминале установщик пройдёт без своих окон:

Как запустить первый контейнер

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

В выводе ищите строку Hello from Docker!: значит, движок скачал образ и запустил контейнер. Для настоящего сервера попробуйте эту команду, а потом откройте http://localhost:8080:

Как пользоваться Docker из Ubuntu в WSL

Если вы работаете внутри дистрибутива WSL, например Ubuntu, docker работает и там, с теми же контейнерами: для дистрибутива по умолчанию Docker Desktop включает это сам. Для другого откройте Settings › Resources › WSL Integration, включите его и нажмите Apply. Файлы проекта держите в файловой системе Linux (~/projects), а не в /mnt/c: так доступ к ним намного быстрее.

Частые проблемы с Docker Desktop

• WSL update failed или Docker Desktop requires a newer WSL kernel version — в Терминале от имени администратора выполните: wsl --update Потом перезагрузите Windows. Если Microsoft Store на компьютере заблокирован, документация Docker советует поставить свежий .msi WSL со страницы github.com/microsoft/WSL/releases.
• Docker Desktop пишет, что виртуализация не включена, или WSL выдаёт 0x80370102 — включите виртуализацию в BIOS или UEFI (она часто называется Intel VT-x, AMD-V или SVM) и снова загляните в «Диспетчер задач» › «Производительность». Docker советует ещё эту команду в Терминале от имени администратора: bcdedit /set hypervisorlaunchtype auto Потом перезагрузите компьютер.
• Docker Desktop - Unexpected WSL error — проверьте саму WSL командой: wsl -l -v Если и она падает, сначала почините WSL, см. инструкцию по WSL.
• open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified — команда docker не находит движок. Запустите Docker Desktop и дождитесь, пока движок заработает.
• Docker Desktop - Access Denied — при установке для всех пользователей ваша учётная запись должна быть в группе docker-users. Администратор добавляет её командой: net localgroup docker-users <user> /add Затем выйдите из Windows и войдите снова. Docker предупреждает, что эта группа даёт права уровня администратора.