Docker с нуля на Ubuntu 24.04: установка, первый контейнер и проверка | AdminWiki

Docker с нуля на Ubuntu 24.04: установка, первый контейнер и проверка

18 ноября 2026 13 мин. чтения

Что именно мы ставим на Ubuntu 24.04: Docker Engine, а не Docker Desktop

На сервере Ubuntu 24.04 нужен Docker Engine: демон и CLI без графической оболочки. Его ставят из официального репозитория Docker пакетами docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin и docker-compose-plugin. Docker Desktop на сервер не устанавливают: это отдельное приложение для рабочих станций с окном настроек, встроенным Kubernetes и своей моделью лицензирования.

Признак правильной установки простой. Команда docker version показывает две секции: Client и Server. Если видите только Client, демон не запущен или недоступен вашему пользователю. Графического приложения в системе при этом нет и быть не должно.

Инструкция ниже дана для Ubuntu 24.04 (noble) и пакетов из официального репозитория Docker. Номера версий зависят от даты установки: актуального кандидата показывает apt-cache policy docker-ce, уже установленную версию - docker version. Конкретные номера в тексте не фиксируем, иначе гайд устареет через месяц. Если контейнеры для вас новая тема, начните с материала о том, как устроена контейнеризация и зачем нужен Docker.

Docker Engine vs Docker Desktop: что выбрать для сервера

Разница сводится к назначению и способу доставки. Engine работает поверх ядра Linux напрямую, Desktop на Windows и macOS поднимает виртуальную машину с Engine внутри.

КритерийDocker EngineDocker Desktop
Что этоДемон dockerd и CLI dockerПриложение с графическим интерфейсом для рабочей станции
ИнтерфейсКомандная строкаОкно с Dashboard, настройками и расширениями
Где применяетсяСерверы, CI-раннеры, продакшнНоутбуки и рабочие станции разработчиков
Составdocker-ce, docker-ce-cli, containerd.io, buildx, Compose pluginEngine внутри виртуальной машины, Kubernetes, расширения
ЛицензияОткрытый код, базовое использование бесплатноБесплатно для малого бизнеса (менее 250 сотрудников и годовая выручка менее 10 млн долларов), личного использования, образования и некоммерческих open source проектов; для профессионального использования в более крупных организациях нужна платная подписка
Установка на Ubuntu 24.04apt и официальный репозиторий DockerПакет для десктопа, на headless-сервере не нужен

Условия лицензирования Desktop менялись, поэтому перед закупкой сверьте порог и формулировки в актуальной редакции Docker Subscription Service Agreement: лишняя подписка на парке серверов обходится дорого. Для Ubuntu 24.04 с консолью вопрос закрыт: только Engine.

Какие пакеты входят в установку и зачем каждый

Пять пакетов, каждый отвечает за свой слой. Убирать что-то из списка не стоит: docker compose нужен почти на любом сервере, buildx пригодится при первой же сборке образа.

ПакетЧто даёт
docker-ceДемон dockerd и systemd-юнит docker.service
docker-ce-cliКлиент docker, который разбирает команды и обращается к демону через сокет
containerd.ioКонтейнерный рантайм, запускает и останавливает контейнеры
docker-buildx-pluginРасширенная сборка образов, мультиплатформенные сборки, внешний кэш
docker-compose-pluginКоманда docker compose для стеков из compose-файла

docker-compose-plugin ставит плагин к CLI, а не отдельный бинарник docker-compose. Compose v1 был написан на Python и вызывался командой docker-compose; он достиг конца жизненного цикла и больше не поддерживается, а поддерживаемые версии Compose CLI сегодня - v2 и v5, о чём говорит история развития Docker Compose. Образ docker/compose с Compose v1 тоже заморожен и не обновляется, это видно на странице образа docker/compose. В новых установках команду docker-compose не используют. Проверка после установки: docker compose version печатает версию плагина.

Пакет docker.io из репозитория Ubuntu - отдельная сборка, и для сервера её обычно не берут: она не даёт того набора пакетов и плагинов, который описан выше, и обновляется по циклу дистрибутива, а не upstream. Для быстрых экспериментов на одноразовой машине он годится, для сервера берите docker-ce из официального репозитория и получите предсказуемые обновления.

Подготовка системы и подключение официального репозитория Docker

Порядок работ: обновить индексы, поставить утилиты для скачивания, убрать конфликтующие пакеты, добавить ключ и репозиторий, убедиться, что apt видит docker-ce. Первые две команды безопасны и выполняются на любом хосте.

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

Удаление конфликтующих пакетов без потери данных

С docker-ce несовместимы docker.io, docker-doc, docker-compose, docker-compose-v2, podman-docker, containerd и runc из репозитория Ubuntu. apt откажется ставить docker-ce, пока они в системе.

Осторожно: на хосте с рабочими контейнерами сначала сохраните данные. Список того, что живёт на сервере, дают docker ps -a, docker images и docker volume ls; нужные образы выгружают через docker save, содержимое томов копируют в архив, compose-файлы и .env забирают из рабочего каталога. Проверьте процедуру на тестовой машине: удаление пакетов меняет версию рантайма, и старые контейнеры могут не подняться в прежнем виде.

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

Конфликтов не осталось, если вывод проверки чистый:

dpkg -l | grep -E 'docker|containerd|runc'

Строк со статусом ii для перечисленных пакетов быть не должно. Строки rc означают, что пакет удалён и остались только файлы конфигурации, установке они не мешают.

Добавление GPG-ключа и репозитория

Ключ кладём в /etc/apt/keyrings, а не в устаревший apt-key: так apt проверяет подпись только для этого репозитория.

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

Подключение репозитория с архитектурой и кодовым именем дистрибутива. На Ubuntu 24.04 подстановка из /etc/os-release даёт noble:

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

Проверка результата, две команды подряд:

sudo apt update
apt-cache policy docker-ce

В выводе apt update нет ошибок подписи, а apt-cache policy показывает строку Candidate и источник https://download.docker.com/linux/ubuntu с компонентом stable. Если появилось сообщение NO_PUBKEY или «signature couldn't be verified», проверьте три вещи: путь в signed-by совпадает с реальным файлом ключа, файл читается (ls -l /etc/apt/keyrings/docker.asc), в строке репозитория стоит то же кодовое имя, что выдаёт . /etc/os-release && echo $VERSION_CODENAME.

Альтернатива - официальный скрипт get.docker.com: он делает то же самое одной командой, но без контроля, какой именно репозиторий и какие пакеты подключаются. Для продакшна ручное подключение предпочтительнее: вы видите каждое изменение и можете закрепить версию.

Установка docker-ce и docker-compose-plugin

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

Во время установки apt создаёт systemd-юнит, запускает docker.service и включает автозапуск. Отдельно ничего запускать не нужно.

systemctl status docker --no-pager
docker version
docker compose version

Ожидаемый результат: в статусе active (running), в docker version две секции Client и Server с версиями, в docker compose version строка вида Docker Compose version v2.x. Номера зависят от даты установки и стабильно растут, поэтому сверяйте их с выводом apt-cache policy, а не с текстом гайда.

Обходные пути вроде trusted=yes в строке репозитория, ключа --allow-unauthenticated или отключения проверки подписи пакетов не применяйте: вы теряете контроль над тем, что ставите на сервер, и получаете ровно ту проблему, от которой защищает подпись.

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

Запуск без sudo через группу docker: как настроить и какие риски

По умолчанию сокет принадлежит root и группе docker с правами 0660, поэтому обычный пользователь получает ошибку доступа. Снимается она добавлением в группу.

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

Пакет docker-ce создаёт группу сам, тогда groupadd вернёт сообщение, что группа уже существует, и его можно пропустить. Дальше проверка:

id -nG
getent group docker

Первая команда показывает, что docker есть в списке групп текущей сессии, вторая - кто вообще входит в группу. newgrp меняет группу только в открытой оболочке; для остальных сессий и для SSH переподключитесь, иначе ошибка сохранится.

Почему группа docker равна root и что это значит на практике

Доступ к /var/run/docker.sock позволяет запустить контейнер с любыми монтированиями, правами и пространствами имён. Один такой запуск даёт чтение и запись файлов хоста, включая /etc/shadow и ключи в /root: границы прав пользователя исчезают. Формально это не sudo, фактически это root-эквивалентный доступ, и выдавать его «на всякий случай» всем разработчикам нельзя.

Отдельно про права на сокет: chmod 666 /var/run/docker.sock и тем более 777 на каталоги проекта делают дыру шире, потому что снимают последний барьер для любого процесса в системе. Такие «решения» из инструкций в интернете не применяйте.

Рабочая практика для сервера с несколькими администраторами: ограниченный список участников, учёт членства через getent group docker, регулярная сверка. Что смотреть на хосте после выдачи прав, разобрано в чек-листе аудита безопасности Docker-хостов.

Альтернативы для автоматизации без выдачи группы docker

Для CI/CD полный доступ к демону чаще всего избыточен, и есть три направления.

  • Rootless-режим. Демон и контейнеры работают внутри user namespace от непривилегированного пользователя, как описано в документации Docker по rootless-режиму. Настраивается через пакет docker-ce-rootless-extras (при необходимости ставится командой sudo apt-get install -y docker-ce-rootless-extras) и скрипт dockerd-rootless-setuptool.sh; если предварительные требования не выполнены, скрипт сам покажет справку. Часть возможностей ограничена: проброс портов и сети устроены иначе, а порты ниже 1024 без дополнительной настройки обычно недоступны.
  • Отдельный пользователь деплоя. Учётка с минимальными правами, у которой в системе нет ничего лишнего; сборка и запуск идут от неё, а не от аккаунта администратора.
  • Прокси перед сокетом. Небольшой сервис, который принимает HTTP-запросы и пропускает только разрешённые методы Docker API, например список контейнеров или перезапуск одного сервиса. Полный доступ к демону при этом не выдаётся.

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

Первый контейнер и проверка установки: hello-world и docker version

docker run hello-world

Что происходит по шагам: клиент docker по сокету просит демон запустить контейнер, демон не находит образ локально, скачивает его с Docker Hub, создаёт контейнер, тот печатает сообщение и завершается с кодом 0.

Hello from Docker!
This message shows that your installation appears to be working correctly.

Такой вывод подтверждает три вещи одновременно: клиент нашёл демон, демон работает и умеет запускать контейнеры, сеть до реестра есть.

Что означает вывод hello-world и как читать docker version

hello-world не проверяет disk space, лимиты памяти и работу портов. Для полной картины добавьте ещё несколько команд.

КомандаЧто проверяетОжидаемый результат
docker run --rm hello-worldСвязь CLI с демоном, доступ к Docker Hub, работу рантаймаСообщение Hello from Docker!, код возврата 0
docker versionВерсии клиента и демона, версию APIСекции Client и Server заполнены
docker infoСостояние демона, драйвер хранилища, число образов и контейнеров, версию ядраВывод без ошибок, заполнены Storage Driver и Kernel Version
docker compose versionНаличие плагина Compose v2Строка с версией плагина
systemctl is-active dockerЗапущена ли службаactive
systemctl is-enabled dockerВключён ли автозапускenabled

В docker version секция Client содержит версию CLI, API, Go и платформу OS/Arch. Секция Server дополнительно показывает версию Engine, containerd, runc, драйвер хранилища и cgroup driver. Отсутствие секции Server - сигнал, что демон не отвечает: смотрите раздел диагностики ниже. Порядок работы с контейнерами после первого запуска разобран в шпаргалке по базовым командам Docker.

Базовая настройка демона и автозапуск

Автозапуск установка включает сама, но проверить стоит: после перезагрузки сервера контейнеры с restart policy должны подняться без ручного вмешательства.

systemctl is-enabled docker
sudo systemctl enable --now docker

Минимальный /etc/docker/daemon.json решает самую частую эксплуатационную проблему: неограниченные логи контейнеров. По умолчанию json-file растёт, пока не заполнит диск, и тогда демон начинает сыпать ошибками.

{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

Второй полезный параметр - "data-root": "/srv/docker", если образы и тома нужно держать на отдельном диске. Осторожно: на хосте с уже работающими контейнерами смена data-root без переноса содержимого /var/lib/docker означает, что демон стартует с пустым каталогом и ваши контейнеры просто исчезнут из списка. Данные переносят заранее, при остановленном демоне, и проверяют на тестовой машине.

Проверка конфигурации перед применением:

sudo python3 -m json.tool /etc/docker/daemon.json

Команда печатает файл, если JSON корректен, и указывает строку с ошибкой, если нет. Дальше применение и контроль:

sudo systemctl reload docker
systemctl status docker --no-pager
journalctl -u docker -n 50 --no-pager

Настройки логирования применяются через reload, смену data-root требует полного restart. Сломанный JSON не даст демону стартовать вообще: в journalctl будет строка вида «unable to configure the Docker daemon with file /etc/docker/daemon.json» с указанием причины. Удалённый доступ к сокету по TCP, TLS-сертификаты и авторизация в этой статье не рассматриваются; открывать сокет наружу без TLS и аутентификации нельзя.

Типичные ошибки первого запуска и как их диагностировать

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

СимптомПричинаКоманда проверкиЧто сделать
permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sockПользователь не в группе docker или не перелогинилсяid -nG, getent group dockerusermod -aG docker, затем переподключение по SSH
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?Служба остановлена или падает при стартеsystemctl status docker --no-pager, journalctl -u docker -n 100 --no-pagerРазобрать причину в логе, затем запустить службу
apt отказывается ставить docker-ce из-за конфликтовОстались docker.io, containerd или runc из Ubuntudpkg -l | grep -E 'docker|containerd|runc'Удалить конфликтующие пакеты после резервной копии
NO_PUBKEY или signature couldn't be verifiedНеверный путь к ключу или синтаксис signed-bysudo apt update, cat /etc/apt/sources.list.d/docker.listИсправить путь и кодовое имя, повторить apt update
dial tcp: lookup registry-1.docker.io: i/o timeout, TLS handshake timeoutНет выхода в интернет или нужен проксиcurl -I https://registry-1.docker.io/v2/, docker pull hello-worldНастроить прокси через systemd drop-in и перезапустить docker
unable to configure the Docker daemon with file /etc/docker/daemon.jsonСинтаксическая ошибка в JSONsudo python3 -m json.tool /etc/docker/daemon.jsonИсправить JSON, перезапустить демон
bind: address already in useПорт на хосте занят другим процессомss -ltnp | grep -E ':80|:8080'Выбрать другой порт публикации или освободить занятый

По первой ошибке порядок такой: id -nG показывает группы текущей сессии, getent group docker - состав группы в системе. Если пользователь в группе есть, а ошибка осталась, вы не перелогинились. После переподключения docker version должен показать секцию Server.

Если демон не отвечает, лог даёт точную причину: journalctl -u docker -n 100 --no-pager. Частые поводы - сломанный daemon.json, занятый порт, отсутствие места на диске. Проверка свободного места: df -h /var/lib/docker. После исправления systemctl start docker и повторный docker version.

При проблемах с сетью учтите: ответ 401 от curl -I https://registry-1.docker.io/v2/ означает, что реестр доступен и требует авторизации, это норма для анонимного запроса. Таймаут или отказ в соединении указывают на сеть, DNS или прокси. Корпоративный прокси задаётся отдельным drop-in файлом для docker.service с переменными HTTP_PROXY, HTTPS_PROXY и NO_PROXY, после чего демон перезапускается.

Чек-лист готовности сервера после установки

Пройдите список целиком, это занимает пару минут и закрывает вопрос «а точно всё работает».

  • docker version выводит обе секции, Client и Server.
  • docker info отрабатывает без ошибок, заполнены Storage Driver и Kernel Version.
  • docker compose version печатает версию плагина.
  • systemctl is-enabled docker возвращает enabled.
  • systemctl is-active docker возвращает active.
  • docker run --rm hello-world завершается с кодом 0, проверить можно через echo $? сразу после запуска.
  • id -nG содержит docker, если вы осознанно включили пользователя в группу.
  • daemon.json проходит валидацию и применён, логи контейнеров ограничены по размеру.
  • journalctl -u docker -p err -n 50 --no-pager не показывает свежих ошибок.

Последний пункт про безопасность, который часто откладывают. Контейнеры используют ядро хостовой ОС, поэтому ошибка в ядре превращается в выход за границу контейнера. Публиковали разбор цепочки, где уязвимости nginx вместе с ошибкой в реализации SCTP ядра Linux позволили выбраться из Docker-контейнера на сервере (описание демонстрации); успех зависел от доступности SCTP, настроек контейнера и состояния ядра, но вывод устойчивый: обновления ядра и хоста остаются обязательными.

Docker не отменяет файрвол, обновления и работу контейнеров от непривилегированного пользователя. Минимальный набор целей и метрик для проверки хоста и образов описан в материале о том, как выстроить системный подход к аудиту безопасности Docker. Начните с этих девяти пунктов чек-листа, а следующая задача - первый собственный образ и compose-файл для вашего сервиса.

Поделиться: