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

На Ubuntu 24.04 LTS установка Docker Engine и запуск первого контейнера займут примерно 10–20 минут, если у вас есть доступ к интернету и права администратора. В конце команда Docker скачает тестовый образ, запустит контейнер и сообщит, что установка работает. Инструкция рассчитана на Ubuntu 24.04 и устанавливает текущую стабильную версию Docker Engine CE из официального репозитория Docker.

Что понадобится

Перед началом проверьте, что у вас есть:

• Ubuntu 24.04 LTS на компьютере или виртуальной машине;
• подключение к интернету;
• учётная запись с правом запускать команды через sudo;
• терминал: откройте его через поиск приложений или сочетанием клавиш Ctrl+Alt+T.

Команды ниже предназначены для Ubuntu. Не запускайте их в Windows или macOS: там Docker обычно ставят через Docker Desktop, а не через репозиторий Docker Engine для Ubuntu. Если на машине уже есть пакеты Docker из репозитория Ubuntu, сначала проверьте инструкции по удалению конфликтующих пакетов в документации Docker.

Установка Docker Engine

1. Обновите список пакетов и установите утилиты для добавления репозитория:

   sudo apt-get update
   sudo apt-get install ca-certificates curl

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

2. Создайте каталог для ключей и скачайте ключ репозитория Docker:

   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

   Ключ нужен APT, чтобы проверять подлинность пакетов. Проверка: команда завершилась без вывода ошибки; файл ключа доступен для чтения.

3. Добавьте официальный репозиторий Docker в список источников APT:

   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

   Команда подставит архитектуру и кодовое имя установленной Ubuntu. Проверка: файл /etc/apt/sources.list.d/docker.list создан. Не заменяйте в команде кодовое имя наугад.

4. Обновите список пакетов ещё раз и установите Docker Engine с дополнительными компонентами:

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

   APT покажет список пакетов и запросит подтверждение. Нажмите Y, если готовы продолжить. Проверка: установка завершилась без ошибок. Точный номер установленной версии может меняться, поскольку репозиторий содержит обновления.

5. Убедитесь, что служба Docker запущена:

   sudo systemctl status docker

   В выводе найдите состояние active (running). Если статус открыт в режиме просмотра, нажмите q, чтобы вернуться в терминал.

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

   sudo docker run hello-world

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

Что именно произошло

Команда docker run попросила Docker найти образ hello-world. Образ — это подготовленный шаблон с файлами и настройками, из которого запускают контейнер. Если шаблона нет локально, Docker скачивает его из реестра образов Docker Hub. Затем контейнер выполняет короткую программу и завершается. Для следующего запуска образ обычно уже не нужно скачивать повторно.

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

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

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

Чтобы увидеть установленную версию клиента, выполните:

docker --version

Команда показывает версию Docker CLI. Проверить доступность сервера Docker и список образов можно отдельно:

sudo docker info
sudo docker image ls

После первого теста в списке образов появится hello-world. Контейнер завершился, поэтому в списке работающих контейнеров его не будет. Это ожидаемо: выполненная программа не продолжает работать в фоне.

Нужно ли добавлять пользователя в группу docker

Пока команды работают с sudo, менять права не обязательно. Чтобы запускать Docker без него, можно добавить пользователя в группу docker, но это не безобидная настройка: доступ к сокету Docker позволяет управлять контейнерами и фактически получить привилегии уровня root на хосте.

Если это личная машина и риск вам подходит, выполните:

sudo usermod -aG docker $USER

Затем выйдите из сеанса пользователя и войдите снова, чтобы обновились группы. Проверка: команда groups показывает docker, а docker run hello-world работает без sudo. На общей машине или сервере не выдавайте доступ к группе Docker без понимания последствий. Для учебного первого запуска безопаснее оставить sudo.

Если установка или запуск не сработали

• Permission denied при обращении к Docker. Запустите команду с sudo. Если вы добавляли пользователя в группу docker, выйдите из сеанса и войдите снова; добавление в группу не меняет уже открытую сессию.

• Cannot connect to the Docker daemon. Служба не запущена или клиент не может к ней подключиться. Проверьте sudo systemctl status docker. Если служба остановлена, выполните sudo systemctl start docker, затем повторите тест.

• Unable to locate package docker-ce. APT не видит пакет в подключённом источнике. Проверьте, что репозиторий добавлен по инструкции, затем выполните sudo apt-get update. Если при обновлении есть ошибка загрузки, разберите её до установки.

• Не удаётся скачать образ. Проверьте интернет-соединение и повторите запуск позже. В корпоративной сети скачивание может блокировать прокси или правила доступа; в таком случае настройки сети нужно уточнить у администратора.

• systemctl status docker показывает ошибку. Не переустанавливайте пакеты наугад. Сохраните текст ошибки и проверьте журнал службы командой sudo journalctl -u docker --no-pager; причина может зависеть от системы и её конфигурации.

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

После теста не запускайте случайный образ на рабочем сервере: сначала проверьте его источник и документацию. Для следующего безопасного эксперимента выберите конкретную задачу, например запуск веб-сервера, и разберитесь, как контейнеру передать порт и сохранить нужные данные. Перед такой настройкой проверьте, что приложение не публикует чувствительные файлы и доступно только тем, кому вы намеренно открыли порт.

Для установки на другую версию Ubuntu, настройки Docker Desktop или подробностей о безопасности используйте официальную документацию Docker. Названия пакетов и способ установки здесь относятся к Docker Engine на Ubuntu 24.04; состав доступных версий в репозитории со временем меняется.