SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor

Установка Docker на Rocky Linux и AlmaLinux

Пошаговое руководство по установке Docker Engine через dnf. Узнайте, как отключить алиас podman, настроить метки SELinux для bind-mount и избежать утечек портов в сеть.

Установка Docker на Rocky Linux и AlmaLinux

Для установки Docker на Rocky Linux или AlmaLinux необходимо добавить официальный репозиторий Docker, установить движок вместе с плагином compose, а затем активировать службу. Это выполняется четырьмя командами и идентично для обоих дистрибутивов, так как оба являются пересборками Red Hat Enterprise Linux (RHEL) и используют общую структуру пакетов. CentOS Stream работает аналогично. Все инструкции ниже применимы к обоим дистрибутивам, поэтому, если вы еще выбираете между ними, решающими факторами станут обязательства по совместимости, которые берет на себя каждый проект, и поддержка вашего старого процессора.

Установка занимает мало времени, поэтому большая часть этого руководства посвящена отличиям Enterprise Linux (EL) от Ubuntu. Podman может уже занимать команду docker в вашем образе. SELinux ограничивает контейнеры только после включения поддержки SELinux в Docker, после чего он блокирует файлы, смонтированные через bind-mount, пока им не будет присвоена правильная метка. Firewalld не фильтрует порты, опубликованные Docker, поэтому порт контейнера может быть открыт в Интернет, в то время как firewall-cmd будет сообщать, что порты закрыты.

Не используйте скрипт автоматической установки с get.docker.com. В документации Docker указано, что он не рекомендуется для промышленной эксплуатации. Он без предупреждения перезаписывает конфигурацию репозиториев и его нельзя безопасно запускать повторно для обновления. Добавление репозитория вручную означает, что dnf upgrade будет обрабатывать Docker как любой другой пакет в системе. Это также позволяет использовать dnf-automatic, если у вас настроено автоматическое применение обновлений безопасности по расписанию, поэтому заранее решите, хотите ли вы, чтобы Docker обновлялся автоматически или дожидался окна обслуживания. В любом случае, обновление заменяет упакованный бинарный файл, пока старый процесс dockerd продолжает работать, и needs-restarting — это команда, которая показывает, какие службы все еще используют код, который вы только что заменили.

Отвечает ли podman на команду docker?

В Rocky Linux и AlmaLinux пакет podman входит в стандартные репозитории, и многие образы VPS устанавливают его автоматически. Некоторые образы идут дальше и устанавливают podman-docker, который размещает скрипт оболочки по пути /usr/bin/docker, вызывающий podman. В результате каждая введенная вами команда docker запускает podman вместо Docker, поэтому руководство, написанное для Docker, начинает выдавать неожиданные результаты.

Первый признак — это баннер. Скрипт /usr/bin/docker ищет файл с именем nodocker в /etc/containers и в вашем домашнем каталоге ~/.config/containers (внутри $XDG_CONFIG_HOME, если вы его задали). Если ни один из этих файлов не существует, скрипт выводит одну строку перед выполнением любых действий:

Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.

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

command -v docker
rpm -qf "$(command -v docker)"

Ответ, начинающийся с podman-docker, означает, что на команды отвечает podman. Ответ, начинающийся с docker-ce-cli, означает, что установлен настоящий Docker. Если rpm -qf сообщает, что ни один пакет не владеет этим файлом, значит, кто-то установил его вручную, и вам следует изучить скрипт, прежде чем доверять ему.

Podman запускает те же OCI-образы и является приемлемым выбором. Если он вас устраивает, остановитесь на этом. Оба инструмента являются движками контейнеров Linux, поэтому, если вопрос выбора платформы еще открыт, полезно знать, что FreeBSD jails изолируют полноценное пользовательское окружение вместо запуска слоистых образов из реестра. Если вам нужен Docker Engine, сначала удалите конфликтующие пакеты. Вот список, который Docker рекомендует для RHEL:

sudo dnf remove docker docker-client docker-client-latest docker-common \
  docker-latest docker-latest-logrotate docker-logrotate docker-engine podman runc

Изучите список действий, которые планирует выполнить dnf, прежде чем подтверждать их. На чистом образе VPS этот список будет коротким. На сервере, который уже использовался, удаление podman может привести к удалению cockpit-podman или другого инструмента, зависящего от него.

В принципе, можно сохранить podman вместе с Docker: удалите только podman-docker, чтобы освободить имя docker, и runc, который заменяется пакетом containerd.io. Документация Docker рассматривает podman как конфликтующий пакет, поэтому такая конфигурация не поддерживается Docker. Если при установке по-прежнему возникает конфликт, используйте полный список для удаления, приведенный выше.

Добавление репозитория Docker с помощью dnf config-manager

Docker публикует RPM-пакеты для Enterprise Linux по адресу download.docker.com. Файл репозитория указывает на дерево CentOS, которое используют Rocky Linux и AlmaLinux для разрешения зависимостей. Указание репозитория CentOS для системы Rocky может показаться ошибкой, пока вы не узнаете как обе дистрибуции произошли от CentOS после того, как Red Hat превратила CentOS в Stream в 2020 году. По состоянию на 10 ноября 2026 года Docker указывает этот репозиторий для CentOS Stream 9 и CentOS Stream 10.

sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

В 5-й версии dnf аргумент --add-repo был удалён, поэтому вторая команда завершается ошибкой в новых релизах. Проверьте версию dnf и выберите подходящий вариант:

dnf --version

Если выводится версия 5.x, используйте форму с подкомандой:

sudo dnf config-manager addrepo --from-repofile=https://download.docker.com/linux/centos/docker-ce.repo

Обе команды записывают один и тот же файл в /etc/yum.repos.d/docker-ce.repo. Неверный синтаксис приводит к ошибке неизвестного аргумента, а не к скрытому некорректному выполнению, поэтому вы не пропустите проблему.

Этот файл репозитория устанавливает baseurl в путь, содержащий $releasever, и dnf подставляет эту переменную из вашего пакета релиза. Rocky Linux и AlmaLinux устанавливают её в значение мажорной версии, например 9 в EL 9 и 10 в EL 10, поэтому репозиторий CentOS корректно работает на системе Rocky. Проверьте подстановку перед установкой:

sudo dnf repoinfo docker-ce-stable

Прочитайте строку Repo-baseurl. Она должна заканчиваться на /9/x86_64/stable или /10/x86_64/stable. Если ваш релиз устанавливает $releasever в значение минорной версии, например 9.6, строка будет содержать /9.6/, и dnf сообщит об ошибке Status code: 404 для этого URL при получении метаданных. Исправьте это, отредактировав /etc/yum.repos.d/docker-ce.repo и заменив $releasever на номер мажорной версии. Ошибка 404 сама по себе не доказывает наличие этой проблемы. Red Hat указывает и другие причины для такой ошибки, включая несоответствие метаданных репозитория и некорректный базовый URL, поэтому вносите изменения только если Repo-baseurl действительно показывает минорную версию. Если там уже указана мажорная версия, замена переменной ничего не изменит.

Установка движка и плагина compose

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

Пакет состоит из пяти компонентов, каждый из которых выполняет свою задачу. docker-ce — это демон, dockerd. docker-ce-cli — это команда docker, которую вы вводите. containerd.io — это среда выполнения контейнеров, которой управляет демон. docker-buildx-plugin отвечает за сборку образов. docker-compose-plugin предоставляет docker compose в качестве подкоманды.

Эти пакеты не устанавливают бинарный файл docker-compose с дефисом. Это был Compose v1, поддержку которого Docker прекратил после того, как Compose v2 стал общедоступным. Любые вызовы docker-compose через дефис необходимо заменить на docker compose через пробел.

При первой установке процесс прерывается для импорта ключа подписи Docker и отображения его отпечатка. Ключ поступает из gpgkey=https://download.docker.com/linux/centos/gpg в файле репозитория, который вы только что добавили, поэтому сверьте отпечаток, выведенный dnf, с этим URL, прежде чем подтверждать импорт.

Одна ошибка встречается достаточно часто, чтобы упомянуть её отдельно. Если dnf сообщает, что containerd.io требует container-selinux и этот пакет не найден, значит, ваш репозиторий AppStream отключен. Выполните dnf repolist и убедитесь, что appstream присутствует в списке, так как именно там container-selinux поставляется в EL 9 и EL 10.

Запуск Docker и проверка работоспособности

sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
sudo docker run --rm hello-world

RPM-пакеты Docker после установки оставляют демон остановленным и отключенным. Именно поэтому данный шаг присутствует на странице Docker для CentOS, но отсутствует на странице для Ubuntu, где deb-пакет запускает службу автоматически. Если пропустить enable, Docker будет работать только до следующей перезагрузки, после чего выключится вместе со всеми контейнерами.

systemctl status должен выводить Active: active (running). Контейнер hello-world должен вывести This message shows that your installation appears to be working correctly. и завершить работу. Если вместо этого выводится ошибка доступа к /var/run/docker.sock, значит, вы не выполнили sudo, что исправляется разделом о группе docker ниже.

Проверьте плагин compose отдельно, так как это другой пакет, который может отсутствовать, даже если движок работает исправно:

docker compose version

Корректный ответ на свежей установке выглядит как Docker Compose version v5.7.0 — это версия, которую репозиторий Docker для EL 9 предоставляет по состоянию на 10 ноября 2026 года. Не смущайтесь скачком с v2 на v5. Docker выпустил Compose v5 в 2025 году как функционально идентичную версию v2 и пропустил промежуточные номера, чтобы избежать путаницы с устаревшими форматами файлов Compose, обозначенными как v2 и v3. Docker поддерживает как Compose v2, так и Compose v5, поэтому старая система, отвечающая v2.x.x, всё ещё исправна, а dnf upgrade обновит её до v5. Восстановление работы сервисов после перезагрузки — это отдельный вопрос, не связанный с включением демона, и политики перезапуска определяют, будут ли сервисы Compose запускаться при загрузке системы.

Почему bind mount выдает ошибку permission denied?

Rocky Linux и AlmaLinux по умолчанию используют SELinux (Security-Enhanced Linux) в режиме enforcing. Проверьте это с помощью getenforce, которая выводит Enforcing.

Применение политик на хосте само по себе не ограничивает Docker-контейнеры. Поддержка SELinux в Docker — это настройка демона selinux-enabled, которая по умолчанию выключена, и пакет docker-ce не включает её автоматически. Когда она выключена, контейнеры запускаются как spc_t (unconfined type), поэтому bind mount работает без меток, и SELinux не обеспечивает изоляцию контейнера от хоста. Чтобы SELinux ограничивал контейнеры, включите эту настройку в /etc/docker/daemon.json и перезапустите демон. Если в этом файле уже есть настройки, добавьте ключ в существующий объект, а не перезаписывайте файл:

echo '{ "selinux-enabled": true }' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

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

sudo mkdir -p /srv/site
echo hello | sudo tee /srv/site/index.html
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro nginx:alpine cat /usr/share/nginx/html/index.html

Контейнер выведет:

cat: can't open '/usr/share/nginx/html/index.html': Permission denied

Две команды покажут причину. ls -ldZ /srv/site выводит метку, которая для пути внутри /srv является system_u:object_r:var_t:s0, а не container_file_t. Затем sudo ausearch -m avc -ts recent выводит запись аудита ядра, содержащую avc: denied { read }, поле scontext= с указанием container_t и поле tcontext= с указанием метки, которую вы только что видели на директории. Несоответствие между этими двумя полями и является всей сутью проблемы.

Решение заключается в добавлении суффикса к аргументу volume. Docker перемаркирует путь за вас:

sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro,z nginx:alpine cat /usr/share/nginx/html/index.html

:z в нижнем регистре перемаркирует содержимое как общее (shared), чтобы несколько контейнеров могли использовать одну и ту же директорию. :Z в верхнем регистре перемаркирует её как частную и неразделяемую (private), привязанную к одному контейнеру, и второму контейнеру, читающему тот же путь, будет отказано в доступе. Используйте :z для всего, к чему также обращается sidecar или контейнер резервного копирования. Используйте :Z для директории базы данных, которой владеет один контейнер.

Документация Docker содержит предупреждение, которое стоит повторить, так как перемаркировка выполняется рекурсивно. Bind-mount системной директории, такой как /home или /usr, с использованием :Z «делает вашу хост-машину неработоспособной, и вам, возможно, придется перемаркировать файлы хоста вручную». Применяйте эти суффиксы к директориям, которые вы создали для контейнера, но никогда не используйте их для системных путей.

В Compose суффикс добавляется к той же строке:

services:
  web:
    image: nginx:alpine
    volumes:
      - /srv/site:/usr/share/nginx/html:ro,z

Существует два ограничения, на которых легко оступиться. Флаг --mount вообще не может установить метку SELinux, поэтому используйте -v, когда она вам нужна. Именованные тома (named volumes) не нуждаются в суффиксе, так как Docker сам маркирует директории, которые создает в /var/lib/docker/volumes.

Не отключайте SELinux. Используйте sudo setenforce 0 только как минутный тест: если после этого контейнер заработал, значит, его блокирует SELinux, хотя и не обязательно из-за метки bind-mount. Прочитайте поле tcontext= в сообщении об отказе. Если это метка директории, ответом будет :z. Если там указано устройство, решением обычно является логическое значение политики (boolean), например sudo setsebool -P container_use_xserver_devices 1 для устройства X server, смонтированного в контейнер. Сразу верните режим enforcing командой sudo setenforce 1. В Enterprise Linux ошибка permission denied при bind mount имеет две разные причины, которые выглядят одинаково изнутри контейнера. Одна — это метка SELinux. Другая — обычное числовое владение пользователем и группой, что является тем, для чего существуют переменные PUID и PGID. ls -lnZ показывает права доступа, числового владельца и метку в одной строке, чтобы вы могли понять, с чем именно боретесь.

Почему опубликованный порт доступен, если firewalld показывает, что он закрыт?

Firewalld — это межсетевой экран по умолчанию в Rocky Linux и AlmaLinux. Проверьте его работу с помощью sudo systemctl is-active firewalld. Если вы еще не настраивали его на этом сервере, сначала выполните открытие SSH и веб-порта в firewalld, так как приведенная ниже особенность понятна только при наличии работающего набора правил зоны для сравнения. Теперь опубликуйте порт и посмотрите, что firewalld считает открытым:

sudo docker run -d --name web -p 8080:80 nginx:alpine
sudo firewall-cmd --list-ports

firewall-cmd выводит пустую строку. С другой машины curl -I http://YOUR_SERVER_IP:8080/ возвращает HTTP/1.1 200 OK. Порт открыт для интернета, а ваш межсетевой экран ничего не сообщает.

Причина кроется в пути, по которому проходит пакет. Правила зоны firewalld фильтруют трафик, адресованный самому хосту. Опубликованный порт не адресован хосту: Docker устанавливает правило destination NAT (трансляция сетевых адресов), которое перезаписывает адрес назначения на адрес контейнера до того, как пакет достигнет входного пути хоста, поэтому ядро пересылает пакет вместо локальной доставки. Затем Docker помещает свои мостовые интерфейсы в зону firewalld под названием docker, целевым действием которой является ACCEPT, и добавляет политику пересылки docker-forwarding, разрешающую пересылку из любой зоны в зону docker. Ваши правила зоны никогда не видят этот пакет.

Самое чистое решение не требует правил межсетевого экрана. Привяжите хостовую часть публикации к loopback и поставьте перед ней reverse proxy:

sudo docker rm -f web
sudo docker run -d --name web -p 127.0.0.1:8080:80 nginx:alpine
curl -I http://127.0.0.1:8080/

Локальный curl возвращает HTTP/1.1 200 OK, а тот же запрос с другой машины больше не устанавливает соединение. При настройках Docker по умолчанию аргумент -p без указания адреса хоста публикует порт на всех интерфейсах. Исключением является демон, где кто-то изменил адрес привязки по умолчанию, например, с помощью "ip": "127.0.0.1" в /etc/docker/daemon.json. Если вы не уверены, что это было сделано на данном сервере, считайте, что использование -p 8080:80 в чистом виде — это решение сделать сервис публично доступным.

Когда вам нужно, чтобы сервис был доступен с одних адресов, но не с других, Docker резервирует для вас цепочку. DOCKER-USER обрабатывается перед собственными правилами accept в Docker, поэтому правило, помещенное туда, сохраняется после перезапуска Docker и перезаписи его цепочек:

sudo iptables -I DOCKER-USER -i enp1s0 ! -s 203.0.113.10 -j DROP
sudo iptables -S DOCKER-USER

Используйте имя интерфейса из ip route show default, а не предполагайте eth0, так как современные образы EL используют имена вроде enp1s0 или ens3. В Rocky и AlmaLinux команда iptables является уровнем совместимости поверх nftables, и цепочки Docker видны через нее. Правила, добавленные таким образом, исчезают после перезагрузки, если их не сохранить, поэтому запишите их в systemd unit, когда убедитесь в их корректности.

Docker Engine 28.0, выпущенный в 2025 году, закрыл смежную уязвимость: прямой маршрутизируемый доступ к портам контейнеров, которые не были опубликованы, теперь блокируется в цепочке DOCKER. Это изменение не затрагивает опубликованные порты, поэтому все вышесказанное остается актуальным для текущих версий. Стоит выработать одну рабочую привычку: после любого sudo firewall-cmd --reload повторно проверяйте опубликованный порт. Если он перестал отвечать, sudo systemctl restart docker переустановит правила Docker.

Администраторы Ubuntu сталкиваются с той же проблемой через другой инструмент, что объясняет, почему опубликованные порты Docker игнорируют правила ufw. В обоих случаях причина заключается в пути NAT. Меняется только используемый межсетевой экран.

Добавление пользователя без прав root в группу docker

Ввод sudo перед каждой командой docker быстро утомляет, а группа docker позволяет этого избежать:

sudo usermod -aG docker $USER
newgrp docker
docker run --rm hello-world

usermod -aG редактирует /etc/group, но текущая оболочка уже загрузила список групп, поэтому изменения не вступят в силу до начала новой сессии. newgrp docker запускает оболочку с уже примененными правами группы, что позволяет сразу проверить результат. Новые SSH-сессии подхватывают изменения автоматически.

Четко осознавайте, какие права дает эта группа. Членство в ней предоставляет доступ на запись к /var/run/docker.sock, а любой процесс, имеющий доступ к этому сокету, может отправить демону запрос на запуск контейнера с примонтированной файловой системой хоста. Одна команда демонстрирует, что это означает:

docker run --rm -v /:/host alpine wc -l /host/etc/shadow

Эта команда считывает файл, доступный только пользователю root, из учетной записи без прав sudo. Официальная документация Docker по пост-установке подтверждает это: группа docker предоставляет привилегии, эквивалентные правам root. Добавляйте учетную запись в эту группу только в том случае, если вы готовы предоставить ей права sudo. Если вы настраиваете учетные записи на новом сервере, решайте этот вопрос одновременно с остальной настройкой пользователей с минимальными привилегиями на VPS, а не постфактум.

В Docker также предусмотрен rootless-режим, в котором демон запускается от имени непривилегированного пользователя. Это отдельный путь установки, который меняет поведение драйверов хранилища и работу с портами ниже 1024, поэтому планируйте его как самостоятельную задачу, а не как опцию, которую можно добавить позже.

Дальнейшие шаги

Теперь у вас есть движок, плагин compose, сервис, который автоматически запускается после перезагрузки, и три специфичных для EL поведения, описанных выше. Следующий шаг — настройка compose.yaml для каждого сервиса, а в структуре Compose-файла рассматриваются формат файла и управляющие им команды. Если это ваш первый контейнерный хост, в руководстве запуск Docker на VPS освещаются вопросы выбора размера ресурсов, хранения данных и гигиены образов, которые остались за рамками данного руководства.

FAQ

Работает ли репозиторий Docker для CentOS на Rocky Linux и AlmaLinux?

Да. Добавьте https://download.docker.com/linux/centos/docker-ce.repo с помощью dnf config-manager. Переменная baseurl в этом файле содержит $releasever, а Rocky Linux и AlmaLinux раскрывают её в номер мажорной версии. Таким образом, система EL 9 обращается к дереву CentOS 9, а EL 10 — к дереву CentOS 10. Проверьте раскрытие переменной с помощью sudo dnf repoinfo docker-ce-stable и прочитайте строку Repo-baseurl. Если эта строка указывает конкретный минорный релиз, например 9.6, а dnf сообщает Status code: 404 при получении метаданных, проблему решит редактирование /etc/yum.repos.d/docker-ce.repo для использования только номера мажорной версии. Если в строке уже указан номер мажорной версии, ошибка 404 вызвана другой причиной, например несоответствием метаданных репозитория или неверным базовым URL, и редактирование переменной не поможет.

Можно ли установить Docker и podman на один сервер?

Документация Docker указывает podman и runc как конфликтующие пакеты и рекомендует удалить оба перед установкой Docker Engine. Конкретный конфликт возникает из-за пакета podman-docker, который владеет /usr/bin/docker и превращает любую команду docker в команду podman. Выполните rpm -qf "$(command -v docker)", чтобы увидеть, какой пакет владеет этим путем. Если вывод начинается с podman-docker, значит, запросы обрабатывает podman. Docker не поддерживает одновременную работу обоих движков, поэтому на важном сервере выберите что-то одно.

Почему я получаю ошибку permission denied при использовании bind mount?

В Rocky Linux и AlmaLinux по умолчанию включен SELinux. Как только параметр Docker selinux-enabled активирован (по умолчанию он выключен), контейнеры запускаются с типом container_t. Этот тип не имеет доступа к стандартным меткам обычных директорий хоста, поэтому доступ к созданной вами директории будет запрещен независимо от владельца и прав доступа. Проверьте это с помощью ls -ldZ для пути на хосте и sudo ausearch -m avc -ts recent, которая выведет avc: denied с двумя несовпадающими контекстами. Добавьте :z к аргументу volume для контента, совместно используемого контейнерами, или :Z для контента, доступного только одному контейнеру. Никогда не указывайте :Z на /home или /usr, так как рекурсивная перемаркировка нарушит работу хоста.

Нужно ли открывать порт в firewalld для публикации порта контейнера?

Нет, и в этом заключается проблема. Правило NAT в Docker перезаписывает адрес назначения до того, как пакет попадет в цепочку input хоста, поэтому правила зоны firewalld его не проверяют. Docker также помещает свои мосты в зону firewalld под названием docker с целью ACCEPT. Контейнер, запущенный с -p 8080:80, доступен из Интернета, даже если sudo firewall-cmd --list-ports ничего не выводит. Выполняйте публикацию на конкретный адрес с помощью -p 127.0.0.1:8080:80, если доступ к сервису должен иметь только хост, или вставляйте правила фильтрации в цепочку DOCKER-USER, которую Docker обрабатывает перед своими собственными правилами accept.

Безопасно ли добавлять пользователя в группу docker?

Это равносильно предоставлению прав root. Участник группы docker может записывать данные в /var/run/docker.sock, а docker run --rm -v /:/host alpine wc -l /host/etc/shadow затем считывает файл, доступный только root, от имени учетной записи без прав sudo. Документация Docker после установки подтверждает это соответствие. Добавляйте в группу только те учетные записи, которым вы уже доверяете права sudo, а для общих или сервисных учетных записей продолжайте использовать sudo docker. Альтернативой для запуска контейнеров от имени непривилегированного пользователя является Rootless mode; это отдельный способ установки, а не просто настройка.

Была ли эта статья полезной?