Docker Compose: руководство по работе с многоконтейнерными приложениями
Docker Compose запускает несколько контейнеров одной командой по описанию в файле compose.yaml. Он поднимает сеть, тома и сервисы в нужном порядке, а останавливает и пересоздаёт их без ручного ввода длинных команд docker run. На этой странице собраны установка, основные команды, конфигурация и разбор частых ошибок.
Что такое Docker Compose и как он работает
Docker Compose читает файл compose.yaml в каталоге проекта и создаёт из него контейнеры, сеть и тома. Каждый сервис в файле получает имя, образ или инструкцию сборки, порты и переменные окружения. При запуске Compose создаёт отдельную сеть, в которой контейнеры обращаются друг к другу по именам сервисов. Состояние проекта хранится в метках контейнеров, поэтому команды up и down работают с целой группой, а не с отдельными контейнерами.
Установка Docker Compose на Ubuntu 24.04
В Ubuntu 24.04 пакет docker-compose-plugin ставится из официального репозитория Docker. После установки команда вызывается как docker compose с пробелом, а не как отдельный бинарник docker-compose. Проверить версию можно командой docker compose version.
sudo apt update
sudo apt install -y docker-compose-plugin
docker compose version
Основные команды Docker Compose
Запуск всех сервисов в фоне выполняет docker compose up -d. Посмотреть статус контейнеров проекта позволяет docker compose ps, а логи одного сервиса в реальном времени выводят через docker compose logs -f app. Остановка и удаление контейнеров вместе с сетью выполняет docker compose down, при этом тома сохраняются, если не указан флаг -v. Внутрь работающего контейнера заходят командой docker compose exec app sh.
docker compose up -d
docker compose ps
docker compose logs -f app
docker compose down
docker compose exec app sh
Файл compose.yaml: структура и пример
Файл compose.yaml лежит в корне проекта и начинается с ключа services. В примере описаны два сервиса: nginx с пробросом порта 80 и php-fpm, который обрабатывает скрипты из каталога /var/www/example.com. Оба сервиса находятся в одной сети по умолчанию и видят друг друга по именам. Проверить синтаксис перед запуском можно командой docker compose config.
services:
web:
image: nginx:1.27
ports:
- "80:80"
volumes:
- /var/www/example.com:/var/www/example.com:ro
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
depends_on:
- app
app:
image: php:8.3-fpm
volumes:
- /var/www/example.com:/var/www/example.com
working_dir: /var/www/example.com
Переменные окружения и файл.env
Compose автоматически читает файл.env из каталога проекта и подставляет значения в compose.yaml через синтаксис ${ИМЯ}. Это удобно для паролей и тегов образов, которые не должны попадать в репозиторий. Значения из.env не передаются в контейнер сами по себе, для этого нужен ключ environment или env_file в описании сервиса.
services:
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
MYSQL_DATABASE: example
volumes:
- db_data:/var/lib/mysql
volumes:
db_data:
Безопасность при работе с Docker Compose
Контейнеры по умолчанию работают от root внутри образа, поэтому для php-fpm и nginx лучше указать пользователя с ограниченными правами. Порт базы данных не публикуйте на хост без необходимости: внутри сети Compose сервисы доступны по имени. Файл.env с паролями добавьте в.gitignore и не копируйте в образ. Для проверки итоговой конфигурации перед запуском используйте docker compose config.
services:
app:
image: php:8.3-fpm
user: "1000:1000"
volumes:
- /var/www/example.com:/var/www/example.com
Типичные проблемы и их решение
Если docker compose up -d завершается ошибкой port is already allocated, значит порт уже занят другим процессом: проверьте ss -tlnp и измените публикацию порта. Ошибка no such file or directory для compose.yaml возникает, когда команда запущена не из каталога проекта. Контейнер сразу перезапускается, если в логах видна ошибка приложения: смотрите docker compose logs -f app.
ss -tlnp | grep :80
docker compose logs -f app
Частые ошибки
-
Запуск
docker compose upбез флага-dоставляет процесс в терминале и блокирует сессию.Для фонового режима используйте
docker compose up -d, а логи смотрите отдельно черезdocker compose logs -f. -
Файл.env с паролями попадает в git, и секреты становятся доступны всем.
Добавьте
.envв.gitignoreи передавайте значения через переменные окружения на сервере. -
Порт 80 уже занят другим веб-сервером, и Compose выдаёт
port is already allocated.Остановите конфликтующий сервис или измените левую часть проброса порта, например на
8080:80.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем отличается docker compose от docker-compose?
docker compose это плагин к Docker CLI, а docker-compose это отдельная утилита на Python. В Ubuntu 24.04 ставьте плагин docker-compose-plugin и используйте команду с пробелом.
Где Compose ищет файл конфигурации?
По умолчанию в текущем каталоге ищется compose.yaml или docker-compose.yml. Другой файл можно указать флагом -f, например docker compose -f /opt/app/compose.yaml up -d.
Как обновить образы и перезапустить сервисы?
Выполните docker compose pull, затем docker compose up -d. Compose пересоздаст контейнеры с новыми образами, сохранив тома.
Сохраняются ли данные базы при docker compose down?
Да, если данные лежат в именованном томе. Тома удаляются только при явном указании флага -v: docker compose down -v.
Всё по теме Docker
Руководства по теме28
- docker images: работа с образами Docker на Ubuntu 24.04
- Установка Docker и Docker Compose на Ubuntu 24.04
- Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция
- Установка Portainer на Ubuntu 24.04: пошаговая настройка
- Docker volumes: настройка и проверка на Ubuntu 24.04
- Установка GitLab в Docker на Ubuntu 24.04
- Установка Docker Engine на Ubuntu 24.04
- Docker и GitHub: пошаговая настройка на Ubuntu 24.04
- Docker Swarm на Ubuntu 24.04: пошаговая настройка кластера
- Как настроить доступ к docker sock на Ubuntu 24.04
- Установка Docker Compose на Ubuntu 24.04
- Nextcloud в Docker: пошаговая инструкция для Ubuntu 24.04
- docker update: изменение лимитов контейнера на Ubuntu 24.04
- docker login на Ubuntu 24.04: вход в registry и проверка
- Как посмотреть контейнеры Docker на Ubuntu 24.04
- Docker Compose file на Ubuntu 24.04: пошаговая настройка
- Redis в Docker: пошаговая инструкция для Ubuntu 24.04
- Docker node: настройка веб-сервера на Ubuntu 24.04
- Docker ports: настройка проброса портов и проверка
- Docker Compose network: настройка сети и проверка связи между сервисами
- PostgreSQL в Docker Compose: пошаговая инструкция
- docker compose restart: перезапуск сервисов и проверка
- Portainer install: установка и запуск в Docker на Ubuntu 24.04
- Запуск n8n через docker compose на Ubuntu 24.04
- Установка Nginx Proxy Manager через Docker Compose на Ubuntu 24.04
- expose в docker compose: настройка портов и проверка
- docker compose run command на Ubuntu 24.04: пошаговая инструкция
- Airflow через Docker Compose на Ubuntu 24.04: пошаговая инструкция