Docker на Ubuntu: установка и первый контейнер без ошибок

За 10–15 минут вы установите Docker Engine на Ubuntu 24.04 LTS, проверите, что служба работает, и запустите тестовый контейнер. Инструкция подходит для Docker Engine 27.x и более новых версий из официального stable-репозитория; на выходе вы увидите сообщение об успешном запуске.

Что нужно до начала

Нужен компьютер или виртуальная машина с Ubuntu 24.04 LTS, подключением к интернету и учётной записью с правами администратора. Команды ниже рассчитаны на Ubuntu, не на Windows, macOS или сервер с другим дистрибутивом. На них установщик и расположение системных файлов могут отличаться.

Docker Engine устанавливается из официального репозитория Docker. Это не Docker Desktop: графическое приложение для Windows и macOS здесь не рассматриваем. В командах используется sudo, поэтому пароль от учётной записи администратора должен быть у вас под рукой.

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

1. Удалите конфликтующие пакеты, если они есть. В Ubuntu могут быть установлены пакеты с похожими названиями, но из другого источника. Команда удаляет только перечисленные пакеты; если их нет, это не мешает продолжить.

   sudo apt remove docker.io docker-doc docker-compose podman-docker containerd runc

   Проверка: команда завершилась без ошибки. Сообщение о том, что пакеты не установлены, — нормальный результат.

2. Подготовьте APT и добавьте ключ репозитория Docker. APT — менеджер пакетов Ubuntu: он загружает и обновляет программы из настроенных источников.

   sudo apt update
   sudo apt install ca-certificates curl
   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

   Проверка: файл /etc/apt/keyrings/docker.asc создан, а команды завершились без сообщения об ошибке. Предупреждение о доступных обновлениях Ubuntu не означает, что установка Docker не удалась.

3. Добавьте официальный репозиторий. Команда определяет архитектуру компьютера и кодовое имя Ubuntu, поэтому не нужно подставлять их вручную.

   echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo ${UBUNTU_CODENAME:-$VERSION_CODENAME}) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   sudo apt update

   Проверка: обновление списка пакетов заканчивается без ошибки о том, что репозиторий или его Release-файл недоступен. В выводе APT должен появиться источник Docker.

4. Установите Docker Engine и плагины. Вместе с движком ставятся командная строка, containerd и плагины Buildx и Compose. Для первого запуска достаточно самого движка и команды docker.

   sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

   Проверка: APT завершил установку и вернул командную строку. Если он сообщает, что пакета нет, не скачивайте случайный архив: сначала проверьте кодовое имя Ubuntu и настройку репозитория.

5. Проверьте версию и запустите тестовый контейнер. Тег hello-world указывает на небольшой образ, который Docker скачает, если его ещё нет на компьютере.

   sudo docker --version
   sudo docker run hello-world

   Проверка: первая команда выводит версию Docker, а вторая — текст Hello from Docker!. После этого контейнер завершает работу: для теста это ожидаемо.

Если hello-world запустился, значит Docker смог обратиться к демону, загрузить образ и выполнить контейнер. Это проверка базовой установки, а не готовности приложения к продакшену.

Если не получилось

• Package docker-ce has no installation candidate. APT не видит пакет в подключённом источнике. Проверьте, что у вас именно Ubuntu 24.04, файл репозитория создан в /etc/apt/sources.list.d/docker.list, а команда sudo apt update прошла без ошибок. На другом дистрибутиве Ubuntu подставлять кодовое имя наугад нельзя.

• Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Клиент не может связаться с фоновой службой Docker. Выполните sudo systemctl status docker; если служба остановлена, запустите sudo systemctl start docker, затем повторите тест.

• permission denied while trying to connect to the Docker daemon socket. Часто команда запущена без sudo, а у текущего пользователя нет доступа к сокету Docker. Для первых проверок используйте sudo docker run hello-world. Добавление пользователя в группу docker снимает необходимость в sudo, но даёт права, близкие к root; не делайте это на общей или рабочей машине без понимания последствий.

• Temporary failure resolving или ошибка загрузки образа. Контейнерный движок не может получить доступ к сети или разрешить имя реестра. Проверьте интернет на самой машине, DNS и сетевые ограничения, затем повторите команду. Сам факт успешной установки Docker не гарантирует, что доступ к реестру не блокирует прокси или межсетевой экран.

• Для другого дистрибутива не находится репозиторий Ubuntu. Не продолжайте установку командами для Ubuntu на Debian или другой системе. Откройте официальную инструкцию именно для своей ОС: имена пакетов и шаги настройки источника отличаются.

Что делать дальше

После теста проверьте, что Docker запускается после перезагрузки: sudo systemctl is-enabled docker. Если команда сообщает enabled, служба включена при старте системы. Затем запустите контейнер с приложением, которое не требует открывать порты или хранить важные данные, и разберитесь с томами, сетями и Compose отдельно. При проблеме в рабочем сервисе смотрите логи контейнера, состояние службы и доступность образа: успешный hello-world сам по себе не проверяет эти части вашей инфраструктуры.

Контейнер — изолированный процесс, запущенный из образа. Образ содержит файловую систему и настройки, необходимые для запуска; контейнер использует их как основу, но его данные не обязательно сохраняются после удаления.