Як встановити Docker у Rocky Linux або AlmaLinux
Встановіть Docker Engine через dnf у Rocky Linux або AlmaLinux, а потім виправте конфлікт Podman із командою docker і мітки SELinux для bind mount.
Встановлення Docker на Rocky Linux і AlmaLinux
Щоб встановити Docker на Rocky Linux або AlmaLinux, додайте власний репозиторій Docker для dnf, встановіть engine разом із compose plugin, а потім увімкніть сервіс. Це чотири команди, і вони однакові для обох дистрибутивів, оскільки обидва є перебудованими версіями Red Hat Enterprise Linux (RHEL) і використовують однакову структуру пакетів. CentOS Stream працює так само. Усе нижче стосується обох дистрибутивів. Якщо ви ще обираєте між ними, вирішальними факторами є гарантії сумісності, які надає кожен проєкт, і те, чи підтримується ваш старіший CPU.
Встановлення коротке, тому більша частина цього посібника присвячена відмінностям Enterprise Linux (EL) від Ubuntu. У вашому образі команда docker уже може належати Podman. SELinux ізолює контейнери лише після ввімкнення підтримки SELinux у Docker. Після цього SELinux блокує файли, змонтовані через bind mount, доки вони не матимуть правильного міткування. Firewalld не фільтрує опубліковані Docker порти, тому порт контейнера може бути відкритий для інтернету, навіть якщо firewall-cmd повідомляє, що відкритих портів немає.
Не використовуйте скрипт спрощеного встановлення Docker із get.docker.com. В офіційній документації Docker зазначено, що він не рекомендований для production. Скрипт без запиту змінює конфігурацію репозиторіїв, і його не можна безпечно запускати повторно для оновлення. Додавання репозиторію вручну означає, що dnf upgrade працює з Docker так само, як і з будь-яким іншим пакетом у системі. У такому разі engine також потрапляє під дію dnf-automatic, якщо цей сервіс застосовує оновлення безпеки за розкладом, тому заздалегідь вирішіть, чи потрібно автоматично встановлювати виправлення для Docker, чи відкласти їх до вікна обслуговування. У будь-якому разі оновлення замінює встановлений бінарний файл, тоді як старий dockerd продовжує працювати, а needs-restarting визначає, які сервіси все ще виконують код, який щойно було замінено.
Чи вже відповідає podman на команду docker?
Rocky Linux і AlmaLinux постачають podman у стандартних репозиторіях, а багато образів VPS встановлюють його автоматично. Деякі образи йдуть далі та встановлюють podman-docker. Він розміщує shell-скрипт у /usr/bin/docker, який викликає podman. Тоді кожна команда docker, яку ви вводите, фактично запускає podman, тому інструкція для Docker може виводити неочікувані результати.
Перша ознака — банер. Скрипт /usr/bin/docker шукає файл із назвою nodocker у /etc/containers і у вашому власному каталозі ~/.config/containers (у $XDG_CONFIG_HOME, якщо ви його налаштували). Якщо жодного з цих файлів немає, перед виконанням будь-яких дій скрипт виводить один рядок:
Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.Хтось міг створити один із цих файлів, щоб приховати банер, тому не покладайтеся лише на нього. За допомогою бази даних пакетів перевірте, якому пакету належить цей binary:
command -v docker
rpm -qf "$(command -v docker)"Результат, що починається з podman-docker, означає, що відповідає podman. Результат, що починається з docker-ce-cli, означає, що це справжній Docker. Якщо rpm -qf повідомляє, що жоден пакет не володіє цим файлом, його встановили вручну. Перед використанням перевірте вміст скрипту.
Podman запускає ті самі OCI-образи та є цілком прийнятним вибором. Якщо він вам підходить, на цьому можна зупинитися. Обидва рішення є рушіями контейнерів Linux. Якщо рішення щодо платформи ще не прийнято, варто знати, що FreeBSD jails ізолюють повне userland, а не запускають пошарові образи, отримані з registry. Якщо вам потрібен 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 визначають потрібний шлях. Вказати Rocky Linux на репозиторій CentOS може здаватися помилкою, доки не стане зрозуміло, як обидва дистрибутиви походять із CentOS після того, як Red Hat у 2020 році перевів CentOS на Stream. Станом на 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 --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 Linux. Перевірте результат розгортання перед встановленням:
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 справді містить номер підверсії. Якщо рядок уже завершується номером основної версії, заміна змінної нічого не змінить.
Установіть engine і compose plugin
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginП’ять пакетів, і кожен виконує окреме завдання. docker-ce — це daemon, dockerd. docker-ce-cli — це команда docker, яку ви вводите. containerd.io — це container runtime, яким керує daemon. docker-buildx-plugin створює images. docker-compose-plugin додає docker compose як subcommand.
Ці пакети не встановлюють бінарний файл із дефісом docker-compose. Це був Compose v1, підтримку якого Docker припинив після загальної доступності Compose v2. Усе, що викликає docker-compose із дефісом, потрібно замінити на docker compose із пробілом.
Під час першого встановлення система зупиниться, щоб імпортувати signing key Docker, і покаже його fingerprint. Ключ походить із gpgkey=https://download.docker.com/linux/centos/gpg у файлі репозиторію, який ви щойно додали, тому перед підтвердженням порівняйте fingerprint, виведений dnf, із цією URL-адресою.
Одна помилка трапляється достатньо часто, щоб окремо її згадати. Якщо dnf повідомляє, що containerd.io потребує container-selinux, але жоден пакет його не надає, ваш AppStream repository вимкнений. Виконайте 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-worldRPM-пакети Docker після встановлення залишають daemon зупиненим і вимкненим. Тому цей крок наведено на сторінці 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 plugin окремо, оскільки це окремий пакет. Він може бути відсутнім, навіть якщо engine працює:
docker compose versionПісля нового встановлення справний результат має виглядати як Docker Compose version v5.7.0. Це версія, яку репозиторій Docker для EL 9 постачає станом на 10 November 2026. Не дивуйтеся переходу з v2 на v5. У 2025 році Docker випустив Compose v5, функціонально ідентичний v2, і пропустив проміжні номери, щоб уникнути плутанини зі застарілими форматами файлів Compose з позначеннями v2 і v3. Docker підтримує Compose v2 і Compose v5, тому старий сервер, який повертає v2.x.x, усе ще працює, а dnf upgrade оновлює його до v5. Відновлення сервісів після перезавантаження — це окреме питання, не пов’язане з увімкненням daemon, а політики перезапуску визначають, чи запустяться сервіси Compose після завантаження системи.
Чому bind mount повертає помилку permission denied?
Rocky Linux і AlmaLinux за замовчуванням запускають SELinux у режимі enforcing. Перевірте це командою getenforce, яка виводить Enforcing.
Примусове застосування політик на хості саме по собі не ізолює Docker-контейнери. Підтримка SELinux у Docker — це параметр daemon, selinux-enabled, який за замовчуванням вимкнений, а пакет docker-ce не вмикає його автоматично. Коли параметр вимкнений, контейнери запускаються з типом spc_t, тобто без обмежень. Тому bind mount працює без будь-якої мітки, а SELinux не ізолює контейнер від хоста. Щоб SELinux застосовував політики до контейнерів, увімкніть параметр у /etc/docker/daemon.json і перезапустіть daemon. Якщо цей файл уже містить налаштування, додайте ключ до наявного об’єкта, а не перезаписуйте файл:
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 і unshared, прив’язуючи до одного контейнера. Тоді другий контейнер не матиме доступу до того самого шляху. Використовуйте :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. Для іменованих 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: ось для чого існують змінні PUID і PGID. ls -lnZ виводить в одному рядку режим доступу, числового власника та мітку, тому ви можете визначити, яку саме проблему потрібно виправити.
Чому опублікований порт доступний, коли firewalld виглядає закритим?
Firewalld — стандартний firewall у Rocky Linux і AlmaLinux. Перевірте, чи він працює, за допомогою sudo systemctl is-active firewalld. Якщо ви ще не налаштували його на цьому сервері, спочатку відкрийте SSH і вебпорт за допомогою firewalld, оскільки наведена нижче ситуація має сенс лише за наявності робочого набору правил zone, з яким можна порівнювати результат. Тепер опублікуйте порт і перевірте, що firewalld вважає відкритим:
sudo docker run -d --name web -p 8080:80 nginx:alpine
sudo firewall-cmd --list-portsfirewall-cmd виводить порожній рядок. З іншого комп’ютера curl -I http://YOUR_SERVER_IP:8080/ повертає HTTP/1.1 200 OK. Порт відкритий для інтернету, але firewall не показує цього.
Причина полягає в маршруті пакета. Правила zone у firewalld фільтрують трафік, адресований безпосередньо серверу. Опублікований порт не адресований серверу: Docker встановлює правило destination NAT (network address translation), яке змінює адресу призначення на адресу контейнера ще до того, як пакет потрапляє на вхідний шлях сервера. Тому kernel пересилає пакет, а не доставляє його локально. Потім Docker додає свої bridge-інтерфейси до zone firewalld з назвою docker, для якої target має значення ACCEPT, і додає політику пересилання docker-forwarding, що дозволяє пересилання з будь-якої zone до zone docker. Правила вашої zone не бачать цього пакета.
Найпростіше виправлення не потребує правила firewall. Прив’яжіть порт на стороні host до 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 без адреси host публікує порт на всіх інтерфейсах. Винятком є daemon, для якого хтось змінив адресу прив’язування за замовчуванням, наприклад за допомогою "ip": "127.0.0.1" у /etc/docker/daemon.json. Якщо ви не знаєте, чи це було зроблено на цьому сервері, вважайте, що простий -p 8080:80 означає публічне відкриття цього сервісу.
Якщо сервіс має бути доступним з одних адрес і недоступним з інших, Docker передбачає для цього окремий chain. DOCKER-USER обробляється перед власними правилами приймання Docker, тому правило, додане туди, зберігається після перезапуску Docker і повторного створення його chain:
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, і через неї видно chain Docker. Правила, додані таким способом, зникнуть після перезавантаження, якщо їх не зберегти, тому після перевірки запишіть їх у unit systemd.
Docker Engine 28.0, випущений у 2025 році, усунув суміжну проблему: прямий routed-доступ до портів контейнерів, які ніколи не публікувалися, тепер блокується в chain DOCKER. Ця зміна не впливає на опубліковані порти, тому все описане вище залишається актуальним для поточних версій. Варто сформувати одну операційну звичку: після кожного sudo firewall-cmd --reload повторно перевіряйте опублікований порт. Якщо він перестав відповідати, sudo systemctl restart docker повторно встановлює правила Docker.
Адміністратори Ubuntu стикаються з тією самою проблемою через інший інструмент: чому опубліковані порти Docker ігнорують правила ufw. В обох випадках причина — шлях NAT. Змінюється лише firewall, який стоїть перед ним.
Додайте користувача без root до групи docker
Постійно вводити sudo перед кожною командою docker швидко набридає. Група docker усуває цю потребу:
sudo usermod -aG docker $USER
newgrp docker
docker run --rm hello-worldusermod -aG редагує /etc/group, але поточна оболонка вже має власний список груп. Тому зміна не застосовується, доки ви не відкриєте нову оболонку. newgrp docker запускає оболонку з доданою групою, щоб ви могли одразу перевірити результат. Нові SSH-сеанси підхоплюють цю зміну автоматично.
Чітко усвідомлюйте, які права надає ця група. Членство дає право запису до /var/run/docker.sock. Будь-який процес, що може взаємодіяти з цим сокетом, може попросити daemon запустити контейнер із підключеною файловою системою хоста. Одна команда демонструє наслідки:
docker run --rm -v /:/host alpine wc -l /host/etc/shadowВона читає файл, доступний лише root, з облікового запису без прав sudo. В офіційній документації Docker після встановлення зазначено те саме: група docker надає привілеї, еквівалентні root. Додавайте обліковий запис до цієї групи лише в тому разі, якщо ви також надали б цьому обліковому запису sudo. Якщо ви налаштовуєте облікові записи на новому сервері, визначте це разом з іншими аспектами налаштування користувачів за принципом найменших привілеїв на VPS, а не постфактум.
Docker також має rootless mode, у якому daemon працює від непривілейованого користувача. Це окремий спосіб встановлення. Він змінює поведінку storage drivers і портів із номерами нижче 1024. Тому плануйте його як окремий проєкт, а не як прапорець, який можна додати пізніше.
Куди рухатися далі
Тепер у вас є engine, compose plugin, сервіс, який працює після перезавантаження, і три специфічні для EL особливості, описані вище. Наступний крок — compose.yaml для кожного сервісу, а в матеріалі структура Compose-файлу описано формат файлу та команди для роботи з ним. Якщо це ваш перший container host, у матеріалі запуск 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 типово працює в режимі enforcing. Коли параметр selinux-enabled у Docker увімкнено, контейнери запускаються з типом container_t. Тип container_t не має доступу до звичайних міток, які мають каталоги на хості. Тому доступ до створеного вами каталогу забороняється незалежно від його власника та режиму доступу. Перевірте це за допомогою ls -ldZ для шляху на хості та sudo ausearch -m avc -ts recent. Ця команда виводить avc: denied із двома контекстами, що не збігаються. Додайте :z до аргументу тому для даних, спільних між контейнерами. Для даних, приватних для одного контейнера, використовуйте :Z. Ніколи не вказуйте :Z для /home або /usr, оскільки перемаркування виконується рекурсивно й пошкодить систему.
Чи потрібно відкривати порт у firewalld, щоб опублікувати порт контейнера?
Ні, і саме це є проблемою. Правило NAT Docker змінює адресу призначення до того, як пакет потрапляє на вхідний шлях хоста. Тому правила зон firewalld його не перевіряють. Docker також додає свої мости до зони firewalld з назвою docker і цільовим параметром ACCEPT. Контейнер, запущений із -p 8080:80, доступний з інтернету, хоча sudo firewall-cmd --list-ports нічого не виводить. Використовуйте -p 127.0.0.1:8080:80 для публікації на конкретній адресі, якщо доступ до сервісу має бути лише з хоста. Або додайте правила фільтрації до ланцюжка DOCKER-USER. Docker обробляє цей ланцюжок до власних правил приймання.
Чи безпечно додавати мого користувача до групи 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 є альтернативою, коли контейнери потрібно запускати від непривілейованого користувача. Це окремий спосіб встановлення, а не параметр.