Docker Compose network: настройка сети и проверка связи между сервисами
Docker Compose создаёт для проекта отдельную сеть <проект>_default, и сервисы обращаются друг к другу по имени сервиса, а не по localhost. В этой инструкции вы соберёте проект из nginx и приложения, проверите связь по имени и убедитесь, что порты опубликованы правильно.
01Проверьте, что Docker Compose установлен
На сервере уже должен быть Docker с плагином Compose v2. Команда docker compose пишется через пробел, старый docker-compose не поддерживается с 2023 года. Если плагина нет, установите пакет docker-compose-plugin из репозитория Docker.
docker compose version
02Создайте каталог проекта и файл compose.yaml
Создайте каталог /var/www/example.com и перейдите в него. Имя файла по умолчанию compose.yaml, старое docker-compose.yml тоже читается. Ключ version: в начале файла в Compose v2 устарел и вызывает только предупреждение, поэтому его не пишут.
mkdir -p /var/www/example.com
cd /var/www/example.com
03Опишите сервисы и их сеть
В файле compose.yaml опишите два сервиса: app и nginx. Compose сам создаст сеть <проект>_default, где имя проекта это имя каталога. Сервис nginx обращается к app по имени app и порту 80, а наружу публикует только порт 80 хоста.
services:
app:
image: nginx:1.24
expose:
- "80"
nginx:
image: nginx:1.24
ports:
- "80:80"
depends_on:
- app
04Проверьте конфигурацию перед запуском
Команда docker compose config проверяет файл и печатает итоговый конфиг. Ошибки YAML видны там же, например yaml: line 12: did not find expected key из-за табуляции или неверного отступа. Отступы делают пробелами.
docker compose config
05Запустите проект и проверьте сеть
Запустите сервисы в фоне и посмотрите их состояние. Затем войдите в контейнер nginx и проверьте, что имя app разрешается в IP-адрес контейнера. Из контейнера app база или другой сервис доступны по имени сервиса, а не по localhost.
docker compose up -d
docker compose ps
docker compose exec nginx getent hosts app
06Проверьте публикацию портов и доступность
Порт 80 на хосте должен слушать Docker. Команда sudo ss -ltnp покажет, кто держит порт. Если порт уже занят nginx самого сервера, вы увидите ошибку Bind for 0.0.0.0:80 failed: port is already allocated. Запрос к http://203.0.113.10 должен вернуть страницу nginx.
sudo ss -ltnp | grep :80
curl -I http://203.0.113.10
07Остановите проект
Команда docker compose down останавливает контейнеры и удаляет сеть проекта. Именованные тома при этом сохраняются, удаляет их только docker compose down -v.
docker compose down
Частые ошибки
-
В конфиге приложения указан
localhostвместо имени сервиса, и соединение с базой не устанавливается.Внутри сети проекта обращайтесь к другому сервису по имени, например
db:3306.localhostвнутри контейнера указывает на сам контейнер. -
При запуске появляется
Bind for 0.0.0.0:80 failed: port is already allocated.Порт на хосте уже занят nginx самого сервера или другим контейнером. Найдите процесс командой
sudo ss -ltnpи освободите порт или опубликуйте другой, например8080:80. -
Команда
docker composeзавершается сpermission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock.Пользователь не в группе
dockerили не вошёл заново послеsudo usermod -aG docker $USER. Выйдите из сессии и войдите снова. Группаdockerравна правам root на сервере. -
Порт опубликован как
80:80, и сервис доступен из интернета, хотя нужен только самому серверу.Публикуйте порт только на localhost:
127.0.0.1:8080:80. Docker обходит UFW, поэтому правило файрвола не закроет опубликованный порт.
Deploykin
Как это делается в Deploykin
В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Как сервисы Docker Compose видят друг друга?
Compose создаёт для проекта сеть <проект>_default, где имя проекта это имя каталога. Внутри неё сервисы обращаются друг к другу по имени сервиса, например app:80 или db:3306.
Нужно ли создавать сеть вручную в compose.yaml?
Нет. Compose создаёт сеть default автоматически при docker compose up. Своя сеть нужна, когда к проекту подключают внешние контейнеры или несколько проектов.
Почему порт из compose.yaml доступен из интернета?
Docker публикует порты в обход UFW. Если порт должен быть доступен только на сервере, публикуйте его как 127.0.0.1:8080:80.
Что делает docker compose down с сетью?
Команда останавливает контейнеры и удаляет сеть проекта. Именованные тома сохраняются, удаляет их только docker compose down -v.
Ещё по теме
- Руководство · Docker docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
- Руководство · Docker Установка Portainer на Ubuntu 24.04: пошаговая настройка Установите Portainer в Docker Compose на Ubuntu 24.04: проверка Docker, compose-файл, запуск, доступ к панели и проверка через curl и docker compose ps.
- Руководство · Docker Docker volumes: настройка и проверка на Ubuntu 24.04 Пошаговая настройка docker volumes на Ubuntu 24.04: создание тома, подключение к контейнеру, проверка сохранности данных после перезапуска и типичные ошибки.
- Руководство · Docker Установка GitLab в Docker на Ubuntu 24.04 Установите GitLab в Docker на Ubuntu 24.04: подготовка, compose-файл, запуск, проверка и типичные ошибки с командами.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы