Что именно мы ставим на 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 Engine | Docker Desktop |
|---|---|---|
| Что это | Демон dockerd и CLI docker | Приложение с графическим интерфейсом для рабочей станции |
| Интерфейс | Командная строка | Окно с Dashboard, настройками и расширениями |
| Где применяется | Серверы, CI-раннеры, продакшн | Ноутбуки и рабочие станции разработчиков |
| Состав | docker-ce, docker-ce-cli, containerd.io, buildx, Compose plugin | Engine внутри виртуальной машины, Kubernetes, расширения |
| Лицензия | Открытый код, базовое использование бесплатно | Бесплатно для малого бизнеса (менее 250 сотрудников и годовая выручка менее 10 млн долларов), личного использования, образования и некоммерческих open source проектов; для профессионального использования в более крупных организациях нужна платная подписка |
| Установка на Ubuntu 24.04 | apt и официальный репозиторий 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 docker | usermod -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 из Ubuntu | dpkg -l | grep -E 'docker|containerd|runc' | Удалить конфликтующие пакеты после резервной копии |
| NO_PUBKEY или signature couldn't be verified | Неверный путь к ключу или синтаксис signed-by | sudo 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 | Синтаксическая ошибка в JSON | sudo 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-файл для вашего сервиса.