Docker позволяет запускать приложения в изолированных контейнерах вместе с необходимыми библиотеками и зависимостями. В этой инструкции разберем, как установить Docker Engine и Docker Compose на Debian 13 Trixie из официального репозитория Docker, запустить первый контейнер и проверить его работу. Те же команды подходят для Debian 12 Bookworm. Отдельно рассмотрим настройку прав, сети и MTU. Статья актуальна на октябрь 2026 года.
Что устанавливаем и что нужно для начала
На Linux-сервере обычно устанавливают Docker Engine — набор компонентов для запуска контейнеров. В ее состав входят dockerd, командная утилита Docker CLI, а также containerd и runc.
В этой инструкции также установим:
containerd — среду выполнения контейнеров;
Docker Buildx — расширение для сборки образов;
Docker Compose — плагин для запуска приложений из нескольких контейнеров.
Docker Engine не следует путать с Docker Desktop. Desktop — отдельное приложение с графическим интерфейсом, предназначенное прежде всего для рабочих компьютеров. На обычном Debian-сервере оно не требуется.
Кроме того, в репозитории Debian существует пакет docker.io. Он поддерживается разработчиками дистрибутива, а не Docker. В этой инструкции используется официальный репозиторий Docker и пакет docker-ce.
Перед началом понадобятся:
Debian 13 или Debian 12;
пользователь с правами sudo либо доступ от root;
подключение к интернету;
свободное место на диске для Docker, образов и данных контейнеров.
Образы и данные приложений могут занимать значительно больше места, чем сам Docker Engine.
Подготовка Debian и проверка установленных пакетов
-
1
Сначала проверьте версию системы:
cat /etc/os-releaseВ выводе можно найти название выпуска и его кодовое имя, например:
VERSION="13 (trixie)" VERSION_CODENAME=trixie -
2
Проверьте архитектуру:
dpkg --print-architectureНапример:
amd64 -
3
Обновите индекс пакетов:
sudo apt update -
4
Если Docker раньше уже использовался на сервере, перед изменением установки проверьте работающие контейнеры:
sudo docker ps -aи существующие тома:
sudo docker volume ls
Это особенно важно для рабочих серверов: удаление или замена пакетов не должно подменять полноценную процедуру миграции приложения.
Официальные пакеты Docker могут конфликтовать с docker.io, старым docker-compose, containerd, runc и некоторыми другими пакетами из репозитория дистрибутива. Docker рекомендует удалить конфликтующие пакеты перед установкой официальной версии. При этом данные из /var/lib/docker автоматически не удаляются.
Если Docker или связанные с ним компоненты уже устанавливались на сервере, сначала проверьте, какие конфликтующие пакеты присутствуют в системе:
dpkg --get-selections docker.io docker-compose docker-doc docker-buildx podman-docker containerd runc
Если в выводе есть установленные пакеты, их можно удалить командой:
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-doc docker-buildx podman-docker containerd runc | cut -f1)
Перед подтверждением удаления внимательно проверьте список пакетов, который предлагает удалить apt, особенно если Docker уже используется на рабочем сервере.
На чистой системе конфликтующих пакетов может не быть. В этом случае удалять ничего не требуется и можно переходить к следующему шагу.
Подключение официального репозитория Docker
-
1
Если Docker уже устанавливался на сервере, проверьте, не осталась ли старая запись официального репозитория:
ls /etc/apt/sources.list.d/Если в каталоге есть файл docker.list с записью официального репозитория Docker, проверьте, используется ли он. Перед созданием нового docker.sources старый файл можно удалить, если он больше не нужен, чтобы избежать дублирования записей репозитория:
sudo rm /etc/apt/sources.list.d/docker.listПосле этого создайте актуальный файл docker.sources.
-
2
Установите пакеты, необходимые для загрузки ключа репозитория:
sudo apt update sudo apt install ca-certificates curl -
3
Создайте каталог для ключей APT:
sudo install -m 0755 -d /etc/apt/keyrings -
4
Загрузите официальный ключ Docker:
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc -
5
Разрешите APT читать файл:
sudo chmod a+r /etc/apt/keyrings/docker.asc -
6
Теперь создайте
/etc/apt/sources.list.d/docker.sources: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В строке Suites команда читает
/etc/os-releaseи автоматически подставляет кодовое имя установленной версии Debian:trixieдля Debian 13 илиbookwormдля Debian 12. Архитектуру также не нужно задавать как amd64: командаdpkg --print-architectureопределяет ее автоматически. -
7
Обновите индекс пакетов:
sudo apt updateЕсли нужно проверить, откуда будет установлен Docker, выполните:
apt-cache policy docker-ce
Команда показывает доступные версии пакета и репозитории, из которых APT может его получить.
Именно такой способ с docker.sources, отдельным ключом в /etc/apt/keyrings и автоматическим определением архитектуры используется в актуальной официальной инструкции Docker для Debian.
Установка Docker Engine и Compose
-
1
Установите Docker Engine, CLI, containerd, Buildx и Compose:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -
2
После установки проверьте состояние службы:
sudo systemctl status dockerЕсли Docker работает, в выводе будет:
Active: active (running)Если служба не запустилась автоматически, выполните:
sudo systemctl start dockerНа Debian служба Docker обычно автоматически запускается и добавляется в автозагрузку.
-
3
Проверьте установленную версию клиента и сервера:
sudo docker version -
4
Затем проверьте версию Compose:
sudo docker compose version
Обратите внимание
Cовременный Compose устанавливается как плагин и вызывается командой: docker compose, а не старой командой: docker-compose.
Проверка службы и запуск первого контейнера
Для первой проверки запустите официальный тестовый контейнер:
sudo docker run hello-world
При выполнении команды Docker:
обращается к Docker daemon;
проверяет наличие образа локально;
при необходимости загружает образ;
создает из него контейнер;
запускает контейнер;
выводит тестовое сообщение.
Если появляется сообщение Hello from Docker!, основные компоненты работают корректно. Именно этот тест рекомендует официальная инструкция Docker.
Теперь запустим контейнер с веб-сервером:
sudo docker run --name docker-test -d -p 127.0.0.1:8080:80 nginx:alpine
Где:
--name docker-test — задает имя контейнера;
-d — запускает его в фоновом режиме;
127.0.0.1:8080:80 — связывает порт 8080 сервера с портом 80 контейнера.
Проверьте запущенные контейнеры:
sudo docker ps
Затем отправьте запрос на веб-сервер:
curl http://127.0.0.1:8080
Если установка работает правильно, сервер вернет HTML-код стартовой страницы Nginx.
В примере порт намеренно опубликован только на 127.0.0.1, поэтому веб-сервер доступен только с самого хоста.
Если использовать:
-p 8080:80
Docker по умолчанию публикует порт на всех интерфейсах хоста. В результате сервис может стать доступен из внешней сети.
Docker самостоятельно создает правила для обработки контейнерного трафика, поэтому опубликованные порты взаимодействуют с firewall не так, как порты обычных процессов на хосте. Перед публикацией сервиса в интернет проверьте правила межсетевого экрана сервера и сетевые правила облачной платформы.
Если внешний доступ не требуется, безопаснее явно привязывать порт к 127.0.0.1, как в примере выше.
После проверки остановите учебный контейнер:
sudo docker stop docker-test
Удалите его:
sudo docker rm docker-test
Не публикуйте Docker API в интернет без аутентификации и защиты соединения. Доступ к Docker daemon позволяет управлять контейнерами и фактически предоставляет широкие системные полномочия на сервере.
Основные команды работы с контейнерами
Чаще всего достаточно нескольких команд:
docker psdocker ps -adocker imagesdocker logs NAMEdocker stop NAMEdocker start NAMEdocker rm NAMEdocker rmi IMAGEdocker volume lsdocker network lsЗдесь важно различать 3 понятия:
-
1.
Образ — шаблон, из которого создаются контейнеры.
-
2.
Контейнер — запущенный или остановленный экземпляр образа.
-
3.
Том, или volume — отдельное хранилище для данных приложения.
Файлы, записанные только во внутренний слой контейнера, удаляются вместе с контейнером. Если данные должны переживать его пересоздание — например, это база данных, — их следует хранить в Docker volume или другом постоянном хранилище.
Проверка Docker Compose
-
1
Создайте отдельный каталог для тестового проекта и перейдите в него:
mkdir ~/docker-compose-test cd ~/docker-compose-test -
2
Создайте файл compose.yaml, например, с помощью редактора nano:
nano compose.yaml -
3
Вставьте в файл:
services: web: image: nginx:alpine ports: - "127.0.0.1:8080:80" -
4
Сохраните изменения, нажав Ctrl+X, Y, Enter.
-
5
После этого запустите приложение:
sudo docker compose up -d -
6
Проверьте его состояние:
sudo docker compose psЗатем:
curl http://127.0.0.1:8080
Чтобы остановить приложение и удалить созданные контейнеры и сеть, можно использовать команду:
sudo docker compose down
Команда docker compose down по умолчанию не удаляет именованные тома. Для их удаления используется отдельный параметр -v, поэтому применять его следует осознанно: данные в таких томах будут удалены.
Как использовать Docker без sudo
По умолчанию Docker daemon работает с правами root, а доступ к его Unix-сокету требует соответствующих разрешений. Поэтому команды в инструкции выполняются через sudo.
При необходимости текущего пользователя можно добавить в группу docker:
sudo usermod -aG docker "$USER"
Переменная $USER содержит имя пользователя, под которым выполнен текущий вход в систему. Если нужно добавить другого пользователя, укажите его имя явно, например:
sudo usermod -aG docker username
После этого нужно завершить текущий сеанс и войти в систему снова. Проверить членство в группах можно командой:
groups
Затем:
docker ps
должна выполняться без sudo.
Однако это не просто способ убрать лишнее слово из командной строки. Пользователи группы docker получают широкие возможности управления Docker daemon, фактически сопоставимые с полномочиями root. Поэтому добавлять в эту группу всех пользователей сервера не следует.
Также не нужно решать проблему доступа командой вроде:
chmod 777 /var/run/docker.sock
Она необоснованно расширяет доступ к Docker daemon.
Настройка сети и MTU на облачном сервере
В большинстве случаев после установки Docker не нужно вручную менять MTU.
MTU — максимальный размер сетевого пакета, который интерфейс может передать без фрагментации. В некоторых облачных сетях MTU основного интерфейса сервера отличается от стандартных 1500 байт. Например, в отдельных сетевых конфигурациях он может составлять 1450 байт. Это только пример: фактическое значение следует проверить на конкретном сервере и сверить с документацией облачной платформы.
Проверьте интерфейсы сервера:
ip link
Например:
2: ens3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1450 ...
3: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 ...
Если проблема возникает в пользовательской сети Docker, сначала найдите ее:
sudo docker network ls
Затем посмотрите параметры нужной сети. В примере ниже используется название app-network, но его необходимо заменить на фактическое имя сети из вывода предыдущей команды:
sudo docker network inspect app-network --format '{{json .Options}}'
Если Docker сообщает, что сеть app-network не найдена, попробуйте имя, созданное Docker Compose, например:
sudo docker network inspect docker-compose-test_app-network --format '{{json .Options}}'
Если MTU для сети задан явно, в выводе будет параметр com.docker.network.driver.mtu, например:
{"com.docker.network.driver.mtu":"1450"}
Если такого параметра нет, значит MTU для этой пользовательской сети явно через настройки драйвера не задан.
Так можно сравнить MTU основного интерфейса сервера, стандартного docker0 и параметры нужной пользовательской сети.
Само по себе различие еще не означает, что Docker работает неправильно. Проверять MTU имеет смысл, если появляются характерные симптомы:
контейнер разрешает DNS-имена, но часть соединений не работает;
небольшие ответы загружаются, а крупные зависают;
на самом сервере ресурс доступен, а из контейнера — нет;
проблема воспроизводится только внутри контейнерной сети;
внутри
docker buildзависаютapt,pip,git cloneи другие операции загрузки;TLS-соединение зависает на этапе handshake, например после отправки
ClientHello.
Сначала стоит исключить проблемы DNS, маршрутизации, firewall и самого удаленного сервиса.
На хосте проверьте прохождение пакетов нужного размера и маршрут до сервиса:
ping -M do -s 1422 <адрес>
tracepath <адрес>
Где 1422 — это MTU 1450 минус 28 байт заголовков IPv4 и ICMP.
А из контейнера проверьте соединение с удаленным сервисом, где характерно зависание на TLS:
docker run --rm curlimages/curl -v https://<адрес>
Как изменить MTU стандартного bridge
Если вы подтвердили, что контейнерной сети действительно требуется MTU, например, 1450, используйте конфигурационный файл Docker:
/etc/docker/daemon.json
Если файла еще нет, создайте его. Для MTU 1450 минимальный вариант выглядит так:
{
"mtu": 1450
}
Если daemon.json уже содержит другие параметры, не заменяйте файл целиком — добавьте новую настройку, сохранив корректную структуру JSON.
Например:
{
"log-driver": "local",
"mtu": 1450
}
Docker поддерживает параметр mtu для стандартной bridge-сети, а основной конфигурационный файл daemon в Linux находится в /etc/docker/daemon.json.
Перед перезапуском можно проверить синтаксис:
sudo dockerd --validate --config-file=/etc/docker/daemon.json
При корректном файле Docker сообщит:
configuration OK
Проверка конфигурации через dockerd --validate выполняется без запуска второго Docker daemon.
Затем перезапустите Docker:
sudo systemctl restart docker
Перезапуск Docker может прервать работу запущенных контейнеров, поэтому на рабочем сервере его следует планировать заранее.
Не нужно редактировать:
/lib/systemd/system/docker.service
и вручную добавлять --mtu в ExecStart. Для постоянных настроек daemon предпочтительнее использовать daemon.json.
MTU в Docker Compose
Пользовательские Docker-сети имеют собственные параметры. Для сети проекта Compose MTU можно задать отдельно:
services:
app:
image: nginx:alpine
networks:
- app-network
networks:
app-network:
driver: bridge
driver_opts:
com.docker.network.driver.mtu: "1450"
Docker Compose позволяет передавать параметры сетевому драйверу через driver_opts, а bridge-драйвер поддерживает настройку com.docker.network.driver.mtu.
Параметр "mtu" в /etc/docker/daemon.json задает MTU для стандартной bridge-сети Docker. Для пользовательских сетей, в том числе создаваемых Docker Compose, MTU задается отдельно через параметры сетевого драйвера, как в примере выше.
Если сеть Compose уже создана, изменение driver_opts не перенастроит ее автоматически. Чтобы новый параметр применился, сеть потребуется пересоздать.
Учтите, что пересоздание сети может затронуть работающие контейнеры. В типичном Compose-проекте команда:
sudo docker compose down
Она останавливает и удаляет контейнеры проекта и созданную для него сеть. Это означает временную остановку приложения. На рабочем сервере такое изменение следует выполнять в запланированное окно обслуживания.
После этого приложение можно запустить снова:
sudo docker compose up -d
Не добавляйте -v, если не хотите удалить связанные с проектом именованные тома.
Значение 1450 не универсально и в этой инструкции используется только как пример. Перед изменением Docker проверьте MTU интерфейса сервера и рекомендации для сетевой конфигурации вашей облачной платформы.
Обновление Docker
Если Docker установлен из официального APT-репозитория, сначала обновите индекс:
sudo apt update
Посмотреть доступные версии можно командой:
apt list --all-versions docker-ce
Для установки актуальных пакетов:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Перед обновлением рабочего сервера стоит проверить совместимость новой версии и предусмотреть возможный перезапуск сервисов.
Как удалить Docker
Для удаления установленных пакетов выполните:
sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
При этом образы, контейнеры и тома автоматически не удаляются. Это сделано в том числе для того, чтобы удаление программных пакетов не уничтожало данные приложений.
Если требуется только удалить Docker как программу, на этом можно остановиться.
Полностью очищать каталоги:
/var/lib/docker
/var/lib/containerd
следует только тогда, когда вы намеренно хотите уничтожить локальные образы, контейнеры и данные Docker.
Если Docker больше не будет использоваться на сервере, можно также удалить источник репозитория и его ключ:
sudo rm /etc/apt/sources.list.d/docker.sources
sudo rm /etc/apt/keyrings/docker.asc
Пользовательские конфигурационные файлы, например /etc/docker/daemon.json, автоматически не удаляются.
Типичные ошибки
permission denied при выполнении docker
Если команда:
docker ps
завершается ошибкой доступа к /var/run/docker.sock, используйте:
sudo docker ps
или настройте членство пользователя в группе docker, учитывая предоставляемые ей полномочия.
Cannot connect to the Docker daemon
Проверьте службу:
sudo systemctl status docker
Попробуйте запустить ее:
sudo systemctl start docker
Журнал службы можно посмотреть так:
sudo journalctl -u docker
Ошибка после изменения daemon.json
Проверьте файл:
sudo dockerd --validate --config-file=/etc/docker/daemon.json
Частая причина — пропущенная запятая или другая ошибка синтаксиса JSON.
Порт уже занят
Если Docker сообщает, что не может привязать порт, проверьте, какой процесс его использует:
sudo ss -ltnp
После этого выберите другой свободный порт либо остановите ненужный сервис.
Не загружается Docker-образ
Проверьте доступ в интернет и DNS:
curl -I https://registry-1.docker.io
Эта команда проверяет сетевое соединение с реестром: разрешается ли доменное имя, устанавливается ли HTTPS-соединение и отвечает ли сервер. Но она не проверяет загрузку образов самим Docker.
Например, ответ 401 Unauthorized в этом случае нормален. Он означает, что Registry доступен, но для дальнейшего обращения требуется аутентификация.
Чтобы проверить уже полный сценарий загрузки образа через Docker daemon, выполните:
sudo docker pull hello-world
Если curl получает ответ от Registry, а docker pull завершается ошибкой, проблема, скорее всего, находится не в общей доступности registry-1.docker.io, а на следующем уровне. Например, в настройках Docker daemon, прокси, DNS внутри Docker или доступе к другим адресам, которые используются при загрузке образа.
Не отключайте проверку TLS как универсальный способ решения сетевых проблем.
Ошибка репозитория или ключа
Проверьте:
cat /etc/apt/sources.list.d/docker.sources
и наличие ключа:
ls -l /etc/apt/keyrings/docker.asc
После исправления конфигурации снова выполните:
sudo apt update
Итоги
Для Debian 13 и Debian 12 Docker Engine лучше устанавливать из официального APT-репозитория Docker. Вместе с Engine стоит установить CLI, containerd, Buildx и Compose plugin, после чего проверить систему через hello-world и тестовый веб-контейнер.
По умолчанию команды безопаснее выполнять через sudo. Добавлять пользователя в группу docker следует только с пониманием предоставляемых ему полномочий.
Отдельная настройка MTU нужна не каждой установке Docker. Если в облачной сети действительно используется уменьшенный MTU и диагностика показывает проблему контейнерной сети, постоянную настройку Docker следует задавать через /etc/docker/daemon.json или параметры конкретной пользовательской сети.
Частые вопросы
Чем docker-ce отличается от docker.io?
Нужен ли Docker Desktop на сервере Debian?
Почему Docker работает только через sudo?
Почему docker compose работает, а docker-compose не найден?
Современный Docker Compose устанавливается как плагин Docker CLI и запускается через пробел:
docker compose.
Отдельный docker-compose относится к старому варианту установки.
Нужно ли всегда устанавливать MTU 1450?
Сохранятся ли данные после удаления контейнера?
Была ли статья полезна?
Спасибо за оценку. Рады помочь 😊