SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor · Обновлено 2026-11-11

Установка Docker на Debian 13 и 12 через apt

Пошаговая установка Docker Engine из официального репозитория для Debian 13 и 12. Разбор конфликта docker.io и docker-ce, настройка прав группы docker и работа с iptables.

Как установить Docker на Debian 13 или 12

Чтобы установить Docker в Debian, добавьте официальный apt-репозиторий Docker, а затем установите из него пакеты docker-ce. На 10 ноября 2026 года страница установки Docker содержит два релиза Debian: Debian 13 (trixie) и Debian 12 (bookworm). Debian 11 (bullseye) в этом списке отсутствует.

Процесс установки состоит примерно из десяти команд. После завершения установки важны два аспекта: опубликованные порты контейнеров обходят ваш межсетевой экран, а группа docker эквивалентна правам root. Данное руководство охватывает оба этих момента.

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

Какие версии Debian поддерживает Docker?

Сначала проверьте свой релиз и архитектуру процессора, так как настройка репозитория зависит от обоих параметров.

. /etc/os-release && echo "$PRETTY_NAME ($VERSION_CODENAME)"
dpkg --print-architecture

В первой строке должно быть указано trixie или bookworm. Во второй строке должна быть одна из архитектур, которые Docker перечисляет для Debian: amd64, armhf, arm64 или ppc64el. Если вы еще выбираете тип процессора для аренды, ознакомьтесь с тем, чем отличаются VPS на базе ARM и x86.

Debian 13 — текущий стабильный релиз. Debian 12 является oldstable, и в вики Debian указан период его LTS (долгосрочной поддержки) с 2026-06-11 по 2028-06-30. Если вы настраиваете новый сервер, выбирайте Debian 13. Если вы еще сравниваете системы, статья выбор Linux для вашего VPS поможет принять решение.

Debian 11 требует предварительного обновления. На странице установки Docker эта версия не указана, а вики Debian сообщает, что период её LTS завершился 2026-08-31. Вы можете заметить, что в download.docker.com все еще есть каталог bullseye. Там также есть каталоги для wheezy и jessie. Наличие каталога на сервере не означает, что Docker поддерживает этот релиз: список поддерживаемых версий находится на странице установки. Выполните процедуру обновления для Debian 11 после окончания срока поддержки, а затем вернитесь сюда.

В Debian testing или в производных дистрибутивах, таких как Kali Linux, кодовое имя в приведенных ниже шагах не совпадет. Документация Docker рекомендует заменить его на кодовое имя соответствующего релиза Debian, например trixie.

Есть ли у вас sudo и curl в минимальной установке Debian?

Некоторые минимальные образы Debian не содержат sudo. Проверьте это перед началом работы.

command -v sudo curl

Команда выводит по одному пути для каждого найденного инструмента. Отсутствие строки означает, что инструмент не установлен. Шаг с репозиториями ниже установит curl, поэтому внимание нужно уделить только sudo. Если он отсутствует, войдите в систему как root и добавьте его. Замените YOUR_USER на ваше обычное имя пользователя.

apt update
apt install -y sudo
usermod -aG sudo YOUR_USER

Выйдите из системы и войдите снова под этим пользователем, так как членство в группах считывается при входе. Затем выполните sudo whoami. Команда должна вывести root. Это также подходящий момент, чтобы обезопасить SSH на вашем VPS, так как вы собираетесь запускать на нем больше сервисов.

docker.io или docker-ce: в чем разница?

Это две разные сборки от разных групп разработчиков. Пакет в Debian называется docker.io. Его сопровождает команда Debian Go Packaging Team, которая собирает его из исходного кода Debian, и он зависит от собственных пакетов Debian containerd и runc. Пакет от Docker называется docker-ce, он поставляется из репозитория Docker и использует собственные зависимости Docker containerd.io.

Заметное различие заключается в версии. На 10 ноября 2026 года в Debian была представлена версия docker.io 26.1.5 в trixie и 20.10.24 в bookworm, в то время как последним релизом Docker Engine была версия 29.9.3. Эти цифры будут меняться, поэтому не стоит на них полагаться. В разделе о apt policy ниже показано, как узнать текущие значения на вашем сервере.

Пакеты также разделены по-разному. В trixie docker.io указывает docker-cli как рекомендуемый пакет, а Compose является отдельным пакетом с названием docker-compose. Репозиторий Docker предоставляет docker-ce, docker-ce-cli, containerd.io и два плагина для Buildx и Compose.

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

Удаление пакетов, конфликтующих с docker-ce

В документации Docker указано, что перед установкой необходимо удалить конфликтующие пакеты. Эта команда охватывает пакеты Docker для Debian, прослойку Podman, а также автономные containerd и runc.

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc docker-buildx podman-docker containerd runc | cut -f1)

Часть dpkg --get-selections выводит список только установленных пакетов, поэтому apt удаляет только их и ничего более. На чистом сервере удалять может быть нечего.

Этот шаг не удаляет ваши данные. Образы, контейнеры, тома и пользовательские конфигурации в /var/lib/docker остаются на диске. Прочитайте список, который выводит apt, прежде чем подтверждать действие, так как containerd и runc могут использоваться другим программным обеспечением, если сервер не является чистым.

Добавление репозитория Docker apt в формате deb822

Эти команды устанавливают два вспомогательных пакета, загружают ключ подписи GPG (GNU Privacy Guard) от Docker и создают один файл репозитория. Файл использует формат deb822 — многострочный формат, который apt считывает из файлов .sources.

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Оболочка автоматически подставляет значения Suites и Architectures, поэтому вам не нужно ничего редактировать вручную в Debian 13 или 12. Команда tee выводит содержимое созданного файла. Прочитайте его: в Suites должно быть указано ваше кодовое имя дистрибутива. Строка Signed-By означает, что apt принимает пакеты из этого репозитория только в том случае, если они подписаны данным ключом.

Последняя команда sudo apt update должна выполнить получение данных из download.docker.com без ошибок. Если на этом сервере ранее был установлен Docker, старый файл репозитория может сохраниться. Проверьте его наличие:

grep -rl download.docker.com /etc/apt/

Единственным совпадением должен быть файл docker.sources. Второе совпадение, например, старый файл docker.list, означает, что два файла объявляют один и тот же репозиторий. Если apt сообщает о дублирующемся источнике или проблеме Signed-By, выполните действия из раздела исправление дублирующихся источников apt и файлов deb822.

Сравнение docker.io и docker-ce через apt policy

Теперь ваш сервер знает о существовании обоих пакетов. На этом этапе вы решите вопрос с docker.io, опираясь на актуальные данные.

apt policy docker.io docker-ce
apt show docker.io
apt show docker-ce

В выводе apt policy обратите внимание на два параметра для каждого пакета. Строка Candidate указывает версию, которую apt установит прямо сейчас. Таблица версий ниже показывает, какой репозиторий предлагает эту версию. docker-ce должен поступать из download.docker.com, а docker.io — из вашего зеркала Debian.

В выводе apt show сравните поля Maintainer, Depends и Recommends. Эти поля показывают, какие зависимости подтягивает каждый пакет на момент проверки.

Если у docker-ce нет кандидата на установку, значит, apt не считал новый репозиторий. Проверьте вывод tee из предыдущего раздела, затем снова выполните sudo apt update и изучите ошибки.

Установка Docker Engine и плагина Compose

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

Эта команда устанавливает последнюю версию из репозитория. Чтобы выбрать конкретную версию, выведите их список, скопируйте полную строку версии и используйте её для обоих пакетов Engine.

apt list --all-versions docker-ce
VERSION_STRING=paste-the-version-string-here
sudo apt install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin

Как подтвердить, что установка Docker прошла успешно?

Выполните три проверки в указанном порядке. Каждая из них подтверждает то, что не было проверено предыдущей.

Во-первых, проверьте службу.

sudo systemctl status docker

Служба должна быть в состоянии active. Если это не так, запустите её с помощью sudo systemctl start docker, а затем изучите журнал через sudo journalctl -u docker -n 50. Согласно документации, Docker по умолчанию запускается при загрузке системы в Debian. Вы можете подтвердить это на своём сервере командой systemctl is-enabled docker containerd. Если какая-либо из служб не включена, выполните sudo systemctl enable docker.service containerd.service.

Во-вторых, запустите реальный контейнер.

sudo docker run hello-world

Эта команда загружает небольшой тестовый образ из Docker Hub и запускает его в контейнере. Сообщение с подтверждением от контейнера означает, что клиент и демон работают, а сервер имеет доступ к Docker Hub.

В-третьих, проверьте клиент, сервер и плагин Compose.

sudo docker version
docker compose version

docker version должна отобразить разделы Client и Server. Отсутствие раздела Server означает, что клиент не может связаться с демоном. docker compose version должна вывести строку с версией. У Compose свои номера версий, поэтому они не обязаны совпадать с версией Engine.

Если команда hello-world завершается ошибкой You have reached your pull rate limit, причина в Docker Hub, а не в вашей установке. Docker Hub разрешает 100 запросов на загрузку (pull) за 6 часов для каждого неавторизованного IPv4-адреса или подсети IPv6 /64, и 200 запросов для авторизованной учётной записи Personal. При использовании общего IP-адреса лимит могут исчерпать другие пользователи. Выполните sudo docker login или дождитесь окончания временного интервала.

Почему не стоит использовать скрипт get.docker.com на сервере?

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

Как выполняются обновления Docker в Debian?

Пакеты Docker обновляются через apt, как и другие пакеты. Инструкция Docker предписывает повторить этап установки и выбрать новую версию.

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

Планируйте обновления на сервере с работающими контейнерами. Согласно документации Docker, по умолчанию при завершении работы демона он останавливает запущенные контейнеры. Поэтому сравните sudo docker ps до и после обновления и установите политику перезапуска (restart policy) для всех сервисов, которые должны возобновить работу. Для стеков Compose ознакомьтесь с тем, как автоматически запускать сервисы Compose при загрузке.

Опция live restore в Docker позволяет контейнерам продолжать работу, пока демон выключен. Установите её в /etc/docker/daemon.json. Эта команда перезаписывает файл, поэтому, если он у вас уже есть, добавьте параметр вручную.

sudo tee /etc/docker/daemon.json <<'EOF'
{
  "live-restore": true
}
EOF
sudo systemctl reload docker
sudo docker info

Найдите строку live restore в выводе docker info, чтобы подтвердить применение настройки. У функции live restore есть несколько ограничений. Docker поддерживает её только для патч-релизов, но не для мажорных обновлений демона. Если вы пропускаете релизы при обновлении, демон может не переподключиться к работающим контейнерам. Она также работает только в том случае, если параметры демона, такие как IP-адреса моста и драйвер графа, не изменились. Кроме того, Docker отмечает, что это «относится только к автономным контейнерам, а не к сервисам Swarm». Если live restore не может выполнить переподключение, вам придётся остановить эти контейнеры вручную. Ещё один нюанс: если демон остаётся выключенным долгое время, контейнер может заполнить свой буфер логов объёмом 64K, и запись логов будет заблокирована до перезапуска демона.

Почему опубликованные порты Docker обходят ufw и firewalld?

Прочитайте этот раздел, прежде чем публиковать какие-либо порты. На странице установки Docker прямо сказано: если вы используете ufw (uncomplicated firewall) или firewalld, порты, которые вы открываете с помощью Docker, обходят правила вашего брандмауэра. В документации Docker по брандмауэрам указано, что Docker и ufw несовместимы, так как пакеты маршрутизируются до того, как к ним могут быть применены правила брандмауэра.

Причина кроется в адресе публикации по умолчанию. При использовании -p 8080:80 демон публикует порт на всех адресах хоста, как 0.0.0.0, так и [::]. Сам Docker заявляет, что публикация портов контейнера по умолчанию небезопасна. Правило ufw, запрещающее 8080, не остановит этот трафик.

Повседневное решение — публиковать порт на loopback, адресе, доступном только самому серверу. В этом тесте используется пример от самого Docker.

sudo docker run -d --name web -p 127.0.0.1:8080:80 -p '[::1]:8080:80' nginx
curl -I http://127.0.0.1:8080

Команда curl должна показать заголовки ответа от nginx. Теперь выполните проверку с другого компьютера, подставив публичный адрес вашего сервера вместо SERVER_IP:

curl -I --max-time 5 http://SERVER_IP:8080

Этот запрос должен завершиться ошибкой, что означает, что контейнер доступен только с самого сервера. Удалите тестовый контейнер с помощью sudo docker rm -f web.

В файле Compose укажите адрес в записи ports. Если не указывать адрес в этой записи, Compose привяжет порт ко всем интерфейсам.

services:
  web:
    image: nginx
    ports:
      - "127.0.0.1:8080:80"

Некоторые порты должны оставаться публичными, но с ограничениями, например, только для одного офисного адреса. Для таких случаев используйте цепочку DOCKER-USER. Docker обрабатывает эту цепочку перед своими собственными правилами, и это место, которое Docker предоставляет для фильтрации опубликованных портов. Команды приведены в руководстве почему Docker обходит UFW и как это исправить.

В Debian действуют еще два правила из документации Docker. По умолчанию Docker создает правила брандмауэра с помощью iptables, поэтому добавляйте пользовательские правила через iptables или ip6tables. В Docker Engine 29 также появился экспериментальный бэкенд nftables, который выбирается с помощью опции демона firewall-backend. В этом бэкенде нет цепочки DOCKER-USER: ваши собственные правила nft размещаются в отдельных таблицах, и вам не следует изменять таблицы Docker напрямую. Также не устанавливайте "iptables": false в конфигурации демона. Docker предупреждает, что это, скорее всего, нарушит работу сети контейнеров.

Запуск Docker без прав root: группа docker и rootless-режим

Демон Docker работает от имени root и владеет Unix-сокетом. Ваш пользователь не может обратиться к этому сокету без sudo, если вы не предоставите ему доступ. Существует два стандартных способа.

Группа docker

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

Если группа уже существует, groupadd сообщит об этом, и вы сможете продолжить. Команда newgrp применяет изменения группы только в текущей оболочке. Выйдите из системы и войдите снова, чтобы применить их повсеместно. Теперь последняя команда должна выполняться без sudo.

Если вы ранее запускали Docker с sudo, вы можете увидеть следующее:

WARNING: Error loading config file: /home/user/.docker/config.json - stat /home/user/.docker/config.json: permission denied

Причина в том, что sudo оставил ~/.docker с неверным владельцем или правами доступа. Исправьте это:

sudo chown "$USER":"$USER" /home/"$USER"/.docker -R
sudo chmod g+rwx "$HOME/.docker" -R

Теперь о рисках. Документация Docker гласит, что группа docker предоставляет привилегии уровня root. Это связано с тем, что Docker может смонтировать каталог / хоста в контейнер, после чего контейнер сможет изменять файловую систему хоста без каких-либо ограничений. Таким образом, скомпрометированная учетная запись в группе docker равносильна скомпрометированной учетной записи root. Добавляйте в группу только тех, кому вы уже доверяете права root. На сервере использование sudo docker для каждой команды является разумным выбором.

Rootless-режим

Rootless-режим запускает демон и контейнеры от имени обычного пользователя, поэтому пользователь не получает права root через Docker. Вашему пользователю требуется как минимум 65536 подчинённых идентификаторов пользователей и групп. Проверьте их:

grep ^$(whoami): /etc/subuid
grep ^$(whoami): /etc/subgid

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

sudo apt install uidmap docker-ce-rootless-extras
sudo systemctl disable --now docker.service docker.socket
sudo rm /var/run/docker.sock
dockerd-rootless-setuptool.sh install

Инструмент выведет строки, которые нужно добавить в профиль вашей оболочки — скопируйте их. Он также создаст контекст CLI (интерфейса командной строки) rootless и сделает его текущим. Выполните docker info: в разделе клиента должен отображаться контекст rootless, а в параметрах безопасности (Security Options) — rootless.

Управляйте демоном с помощью systemctl --user start docker.service. Чтобы запускать его при загрузке системы, выполните sudo loginctl enable-linger $USER. На странице rootless-режима в документации Docker приведена полная справка. Ознакомьтесь с ней перед переносом реальных рабочих нагрузок.

Как удалить Docker в Debian?

Команда purge удаляет пакеты. Она не удаляет ваши образы, контейнеры или тома, поэтому следующие две строки rm удаляют их. Эти две строки нельзя отменить, поэтому сначала сделайте резервную копию ваших томов.

sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
sudo rm /etc/apt/sources.list.d/docker.sources
sudo rm /etc/apt/keyrings/docker.asc

Любой файл конфигурации, который вы редактировали, например /etc/docker/daemon.json, останется до тех пор, пока вы не удалите его вручную. О том, что сохраняет и удаляет purge по сравнению с remove, читайте в различия apt remove, purge и autoremove.

Что делать после установки

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

FAQ

Можно ли установить Docker на Debian 11?

На странице установки Docker по состоянию на 10 ноября 2026 года указаны только Debian 13 (trixie) и Debian 12 (bookworm). Debian 11 в списке отсутствует, а согласно вики Debian, период его LTS-поддержки завершился 2026-08-31. Директория bullseye всё ещё существует на сервере загрузки Docker, но это не означает наличие поддержки. Сначала обновите сервер до одной из поддерживаемых версий Debian, затем установите Docker.

В чём разница между docker.io и docker-ce в Debian?

docker.io — это сборка от Debian, которую поддерживает команда Debian Go Packaging Team; она зависит от системных библиотек containerd и runc. docker-ce — это сборка от компании Docker, доступная в их собственном репозитории apt. На 10 ноября 2026 года версия в репозиториях Debian была устаревшей как для trixie, так и для bookworm. Выполните apt policy docker.io docker-ce, чтобы увидеть обе версии и их источники на вашем сервере. Установите один пакет и удалите другой, так как документация Docker рассматривает docker.io как конфликтующий пакет.

Как проверить корректность установки Docker в Debian?

Выполните sudo systemctl status docker и убедитесь, что служба активна. Затем запустите sudo docker run hello-world: эта команда загрузит тестовый образ и выведет подтверждающее сообщение из контейнера. В завершение используйте sudo docker version, чтобы увидеть разделы Client и Server, и docker compose version для проверки плагина Compose.

Почему ufw не блокирует порт Docker-контейнера в Debian?

Трафик Docker для опубликованных портов маршрутизируется до того, как применяются правила ufw, а порт, опубликованный без указания адреса, привязывается ко всем адресам хоста. Публикуйте внутренние сервисы на loopback-интерфейсе, например, через -p 127.0.0.1:8080:80, и проводите тестирование с другой машины. Если порт должен оставаться публичным, фильтруйте его в цепочке DOCKER-USER с помощью iptables или ip6tables.

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

Только если вы доверяете этому пользователю права root. В документации Docker указано, что группа docker предоставляет привилегии уровня root, так как участник группы может смонтировать директорию хоста / в контейнер и изменить любой файл. На общем сервере продолжайте использовать sudo или перейдите на rootless-режим, чтобы демон и контейнеры запускались от имени обычного пользователя.

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