Docker: типичные ошибки и как их исправить

Коротко о главном

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

Контейнеры дают воспроизводимость: одинаковый образ работает на ноутбуке и сервере. Они быстрее VM, проще масштабируются и удобны для CI. Но безопасность и хранение данных требуют отдельного внимания.

Большинство проблем с Docker сводится к нескольким повторяющимся ошибкам. Ниже — что проверить в первую очередь и как не усугубить ситуацию.

Почему это происходит

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

Типичные ошибки

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

1. Permission denied при подключении к Docker

Пользователь не в группе docker или не перелогинился. Проверьте id и перезайдите в сессию.

2. Порт уже занят

Найдите процесс через ss -ltnp и остановите его либо измените публикуемый порт.

3. Данные исчезли после пересоздания контейнера

Контейнеры не хранят данные постоянно. Подключите именованный volume или bind mount и проверьте путь.

Как настроить правильно

Правильная последовательность проста: проверить версию и зависимости, сделать резервную копию конфигурации, внести минимальное изменение, проверить логи и только потом двигаться дальше.

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install docker.io docker-compose-v2

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install docker docker-compose

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S docker docker-compose

1. Запустите службу

Включите Docker в автозагрузку и добавьте пользователя в группу docker. Помните: членство в группе docker фактически даёт root-доступ к хосту.

sudo systemctl enable --now docker
sudo usermod -aG docker $USER

2. Проверьте установку

Запустите тестовый контейнер и убедитесь, что клиент видит демон.

docker run --rm hello-world
docker info

3. Соберите первый образ

Создайте простой Dockerfile. Фиксируйте версию базового образа и не запускайте приложение от root.

FROM python:3.12-slim
WORKDIR /app
COPY . .
RUN pip install --no-cache-dir -r requirements.txt
USER 1000
CMD ["python", "app.py"]

4. Запустите через Compose

Compose описывает сервисы, сети и volume в одном файле. Это удобнее десятков docker run.

services:
  web:
    build: .
    ports:
      - "127.0.0.1:8000:8000"
    restart: unless-stopped

Рабочий конфиг

Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.

{
  "log-driver": "json-file",
  "log-opts": {"max-size": "10m", "max-file": "3"}
}

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 1. Не используйте тег latest в продакшене: фиксируйте конкретную версию.

Не используйте тег latest в продакшене: фиксируйте конкретную версию.

Совет 2. Храните секреты вне образа: в переменных окружения или secrets.

Храните секреты вне образа: в переменных окружения или secrets.

Совет 3. Ограничивайте ресурсы контейнера через —memory и —cpus.

Ограничивайте ресурсы контейнера через —memory и —cpus.

Совет 4. Настройте ротацию логов, иначе диск заполнится.

Настройте ротацию логов, иначе диск заполнится.

Профилактика

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

Сохраните рабочий конфиг в систему контроля версий, добавьте короткий комментарий о том, зачем нужен каждый нестандартный параметр, и запишите команду проверки. Через месяц вы скажете себе спасибо: восстановить логику по чужому файлу без пояснений почти невозможно.

Итог

Большинство ошибок с Docker лечится не переустановкой, а проверкой конфигурации, логов и прав доступа. Действуйте по одному изменению за раз — и причина быстро найдётся.