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

expose в docker compose: настройка портов и проверка

Директива expose в compose-файле открывает порт контейнера только для других сервисов проекта и не публикует его на хосте. Чтобы порт стал доступен снаружи, его указывают в ports. Настройка занимает один файл и проверяется командой docker compose ps.

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

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

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

bash
docker compose version

02Создайте compose-файл с директивой expose

В каталоге проекта создайте файл compose.yaml. Сервис app слушает 3000 внутри контейнера, директива expose делает этот порт видимым для других сервисов проекта. Порт наружу не открывается, поэтому с хоста и из интернета он недоступен.

yaml
services:
  app:
    image: node:20-alpine
    working_dir: /app
    command: node -e "require('http').createServer((q,s)=>s.end('ok')).listen(3000)"
    expose:
      - "3000"

03Запустите проект и посмотрите порты

Запустите сервисы в фоне и выведите их состояние. В колонке PORTS у сервиса с одним expose будет только внутренний порт 3000/tcp, без адреса хоста. Это и есть отличие от ports, где появляется запись вида 0.0.0.0:8080->80/tcp.

bash
docker compose up -d
docker compose ps

04Опубликуйте порт на хосте через ports

Чтобы сервис был доступен снаружи, замените expose на ports. Запись "8080:3000" публикует порт 3000 контейнера на порту 8080 хоста. Если порт нужен только самому серверу, привяжите его к localhost: "127.0.0.1:8080:3000". Опубликованные порты Docker обходят UFW, поэтому ограничение по адресу обязательно.

yaml
services:
  app:
    image: node:20-alpine
    working_dir: /app
    command: node -e "require('http').createServer((q,s)=>s.end('ok')).listen(3000)"
    ports:
      - "127.0.0.1:8080:3000"

05Проверьте публикацию и ответ сервиса

После правки файла перезапустите проект и проверьте, что порт слушается на хосте. Команда ss покажет адрес 127.0.0.1:8080, а curl вернёт тело ответа приложения. Если порт занят, ss покажет и процесс, который его держит.

bash
docker compose up -d
docker compose ps
sudo ss -ltnp | grep 8080
curl -s http://127.0.0.1:8080

06Настройте сеть host для сервиса

В режиме network_mode: host контейнер использует сетевой стек хоста, и директива ports игнорируется. Сервис слушает порт напрямую на сервере, поэтому конфликт с nginx самого сервера на 80 или 443 возможен. Для базы данных такой режим неудобен: другие сервисы проекта не смогут обратиться к ней по имени db.

yaml
services:
  app:
    image: nginx:1.24
    network_mode: host

07Проверьте связь между сервисами по expose

Сервисы одного проекта видят друг друга по имени сервиса в сети <проект>_default. Из контейнера app база доступна как db:3306, а не как localhost. Директива expose в этом не участвует: связь работает и без неё, а expose лишь документирует порт в конфиге.

bash
docker compose exec app sh -c 'getent hosts db'

Частые ошибки

  • Читатель ждёт, что expose откроет порт в интернет, и получает curl: (7) Failed to connect с хоста.

    expose открывает порт только внутри сети проекта. Для доступа снаружи укажите порт в ports, например "8080:3000".

  • При запуске появляется Bind for 0.0.0.0:80 failed: port is already allocated.

    Порт на хосте занят nginx самого сервера или другим контейнером. Найдите процесс командой sudo ss -ltnp и выберите другой порт хоста в ports.

  • После правки compose-файла сервис не отвечает на новом порту.

    Выполните docker compose up -d: Compose пересоздаст контейнер с новыми портами. Проверьте результат через docker compose ps.

  • В режиме network_mode: host сервис не стартует из-за занятого порта.

    В этом режиме ports не работает, контейнер слушает порт хоста напрямую. Освободите порт или уберите network_mode: host и опубликуйте порт через ports.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем expose отличается от ports в docker compose?

expose делает порт видимым только для сервисов проекта и не публикует его на хосте. ports пробрасывает порт контейнера на порт хоста, и сервис становится доступен снаружи.

Можно ли использовать expose и ports вместе?

Да, они не конфликтуют. ports публикует порт на хосте, expose дополнительно документирует внутренний порт в конфиге.

Почему в network_mode host не работает ports?

В этом режиме контейнер использует сеть хоста и слушает порты напрямую. Проброс портов не нужен, поэтому директива ports игнорируется.

Как проверить, какие порты опубликованы?

Выполните docker compose ps: в колонке PORTS видно соответствие порта хоста и порта контейнера. Команда sudo ss -ltnp покажет, какой процесс слушает порт на сервере.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

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