RU

Приложения

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

Установите Docker Engine и Docker Compose из официального репозитория на Debian или Ubuntu: пользователи, журналы, порты, обновления, резервные копии и рекомендации.

5 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Это руководство объясняет, как установить Docker Engine и плагин Docker Compose из официального репозитория Docker, а затем подготовить сервер к промышленной эксплуатации: права пользователей, ротация журналов, публикация портов, обновления и резервное копирование.

Заказать сервер

Для размещения ваших контейнеров HostMyServers предлагает несколько вариантов:

Предварительные требования

  • 64-разрядный сервер под управлением Debian 12/13 или Ubuntu 22.04/24.04
  • SSH-доступ под root или пользователем с правами sudo

Порты: Docker не требует входящих портов. Открывайте только порты публикуемых вами приложений и никогда не выставляйте API Docker (2375 или 2376) в Интернет: доступ к нему равносилен контролю над сервером.

Шаг 1: удалите конфликтующие пакеты

Пакеты Docker из дистрибутива могут конфликтовать с официальными пакетами:

Терминал
sudo apt update
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null | cut -f1)

Ваши образы и тома в /var/lib/docker, если они есть, этой командой не удаляются.

Шаг 2: добавьте официальный репозиторий

Эти команды подходят и для Debian, и для Ubuntu, так как определяют систему по /etc/os-release:

Терминал
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
. /etc/os-release
sudo curl -fsSL "https://download.docker.com/linux/$ID/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 > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/$ID
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Шаг 3: установите Docker

Терминал
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker containerd

Шаг 4: проверьте установку

Терминал
sudo systemctl status docker
docker --version
docker compose version
sudo docker run --rm hello-world

Сообщение Hello from Docker! подтверждает, что движок может загрузить образ и запустить контейнер.

Шаг 5: разрешите доступ пользователю

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

Терминал
sudo usermod -aG docker $USER

Затем проверьте:

Терминал
docker run --rm hello-world

Шаг 6: настройте журналы и демон

По умолчанию драйвер json-file не ограничивает размер журналов, и они могут в итоге заполнить диск. Создайте /etc/docker/daemon.json:

Терминал
sudo nano /etc/docker/daemon.json
JSON
{
  "log-driver": "local",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "live-restore": true
}
Параметр Эффект
log-driver: local Компактный формат журнала с ротацией
max-size, max-file До 3 файлов по 10 МБ на контейнер
live-restore Контейнеры продолжают работать, если демон останавливается

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

Терминал
sudo dockerd --validate --config-file=/etc/docker/daemon.json
sudo systemctl restart docker
docker info --format '{{.LoggingDriver}} {{.LiveRestoreEnabled}}'

Драйвер журналов применяется только к новым контейнерам. Пересоздайте существующие контейнеры, чтобы он начал действовать, например командой docker compose up -d --force-recreate.

Шаг 7: контролируйте публикуемые порты

Если на сервере работает обратный прокси, публикуйте приложения только локально:

YAML
ports:
  - "127.0.0.1:8080:80"

Можно также сделать локальный адрес поведением по умолчанию, добавив эти ключи в /etc/docker/daemon.json:

JSON
{
  "ip": "127.0.0.1",
  "default-network-opts": {
    "bridge": {
      "com.docker.network.bridge.host_binding_ipv4": "127.0.0.1"
    }
  }
}

Объедините их с файлом из шага 6, проверьте его, затем перезапустите Docker. Порт, предназначенный для публичного доступа, придётся указывать явно, например "0.0.0.0:443:443".

Шаг 8: запустите первый проект Compose

Создайте каталог для проекта:

Терминал
sudo mkdir -p /opt/myapp
sudo chown "$USER": /opt/myapp
cd /opt/myapp
nano compose.yaml
YAML
services:
  web:
    image: nginx:1.30-alpine
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - web-data:/usr/share/nginx/html
    healthcheck:
      test: ["CMD", "wget", "-qO-", "http://127.0.0.1/"]
      interval: 30s
      timeout: 5s
      retries: 3

volumes:
  web-data:

Запустите и проверьте:

Терминал
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=20 web
curl -I http://127.0.0.1:8080

Чтобы опубликовать это приложение по HTTPS, поставьте перед ним обратный прокси. Вы можете начать с руководства Установка Nginx и PHP-FPM и руководства по Let's Encrypt.

Полезные команды

Команда Описание
docker ps -a Список контейнеров
docker compose logs -f Следить за журналами проекта
docker compose restart Перезапустить службы
docker compose down Остановить и удалить контейнеры, сохранив тома
docker system df Показать занятое место

Обновления

Docker Engine

Терминал
sudo apt update
sudo apt install --only-upgrade docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version

live-restore покрывает только корректирующие обновления. При переходе на новую основную версию предусмотрите остановку контейнеров и изучите примечания к выпуску Docker.

Образы приложений

Измените тег в compose.yaml, если вы его фиксируете, затем:

Терминал
cd /opt/myapp
docker compose pull
docker compose up -d
docker image prune

Резервное копирование

Сохраняйте как минимум ваши файлы Compose, файлы .env и тома. Тома находятся в /var/lib/docker/volumes, но лучше архивировать их через временный контейнер. Настоящее имя тома можно узнать командой docker volume ls:

Терминал
cd /opt/myapp
mkdir -p backups
docker compose stop web
docker run --rm -v myapp_web-data:/data:ro -v "$PWD/backups":/backup alpine:3 tar czf /backup/web-data.tar.gz -C /data .
docker compose start web

Чтобы восстановить архив в том:

Терминал
docker compose stop web
docker run --rm -v myapp_web-data:/data -v "$PWD/backups":/backup:ro alpine:3 tar xzf /backup/web-data.tar.gz -C /data
docker compose start web

Для базы данных лучше использовать экспорт средствами самой СУБД (mariadb-dump, pg_dump и т. д.). Затем копируйте резервные копии за пределы сервера.

Рекомендации для промышленной эксплуатации

  • Фиксируйте точную версию образа вместо latest
  • Задавайте для служб restart: unless-stopped и healthcheck
  • Публикуйте как можно меньше портов и, когда возможно, только локально за обратным прокси
  • Храните секреты в защищённом файле .env (chmod 600 .env), вне Git
  • Не используйте privileged: true и не монтируйте /var/run/docker.sock без необходимости
  • Следите за местом на диске с помощью docker system df
  • Регулярно проверяйте восстановление из резервных копий

Если что-то пошло не так

permission denied на /var/run/docker.sock

Ваш пользователь ещё не учитывается в группе docker. Проверьте командой id, затем заново подключитесь по SSH.

Conflicting values set for option Signed-By

Остался старый конфигурационный файл репозитория Docker, часто это /etc/apt/sources.list.d/docker.list. Проверив его содержимое, удалите его:

Терминал
sudo rm /etc/apt/sources.list.d/docker.list
sudo apt update

Cannot connect to the Docker daemon

Терминал
sudo systemctl status docker
sudo journalctl -u docker -n 50 --no-pager
sudo dockerd --validate --config-file=/etc/docker/daemon.json

Синтаксическая ошибка в daemon.json не даёт службе запуститься.

port is already allocated или address already in use

Другой контейнер или служба использует этот порт. Определите её командами sudo ss -ltnp | grep ':8080 ' и docker ps, затем смените порт на стороне сервера.

no space left on device

Терминал
df -h
docker system df
docker image prune
docker builder prune

Используйте docker volume prune только после того, как убедитесь, что в соответствующих томах не осталось нужных данных.

toomanyrequests при загрузке

Достигнут лимит загрузок Docker Hub. Подождите или войдите в свою учётную запись командой docker login.

docker-compose: command not found

Актуальный плагин вызывается с пробелом: docker compose.

Порт остаётся доступным, несмотря на UFW

Это нормальное поведение портов, опубликованных Docker. Опубликуйте порт на 127.0.0.1 или примените ограничения из руководства Настройка UFW.

Ссылки