К содержимому

Docker Compose network: настройка сети и проверка связи между сервисами

Docker Compose создаёт для проекта отдельную сеть <проект>_default, и сервисы обращаются друг к другу по имени сервиса, а не по localhost. В этой инструкции вы соберёте проект из nginx и приложения, проверите связь по имени и убедитесь, что порты опубликованы правильно.

Руководство Docker 3 мин чтения

01Проверьте, что Docker Compose установлен

На сервере уже должен быть Docker с плагином Compose v2. Команда docker compose пишется через пробел, старый docker-compose не поддерживается с 2023 года. Если плагина нет, установите пакет docker-compose-plugin из репозитория Docker.

bash
docker compose version

02Создайте каталог проекта и файл compose.yaml

Создайте каталог /var/www/example.com и перейдите в него. Имя файла по умолчанию compose.yaml, старое docker-compose.yml тоже читается. Ключ version: в начале файла в Compose v2 устарел и вызывает только предупреждение, поэтому его не пишут.

bash
mkdir -p /var/www/example.com
cd /var/www/example.com

03Опишите сервисы и их сеть

В файле compose.yaml опишите два сервиса: app и nginx. Compose сам создаст сеть <проект>_default, где имя проекта это имя каталога. Сервис nginx обращается к app по имени app и порту 80, а наружу публикует только порт 80 хоста.

yaml
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 из-за табуляции или неверного отступа. Отступы делают пробелами.

bash
docker compose config

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

Запустите сервисы в фоне и посмотрите их состояние. Затем войдите в контейнер nginx и проверьте, что имя app разрешается в IP-адрес контейнера. Из контейнера app база или другой сервис доступны по имени сервиса, а не по localhost.

bash
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.

bash
sudo ss -ltnp | grep :80
curl -I http://203.0.113.10

07Остановите проект

Команда docker compose down останавливает контейнеры и удаляет сеть проекта. Именованные тома при этом сохраняются, удаляет их только docker compose down -v.

bash
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 Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.