expose в docker compose: настройка портов и проверка
Директива expose в compose-файле открывает порт контейнера только для других сервисов проекта и не публикует его на хосте. Чтобы порт стал доступен снаружи, его указывают в ports. Настройка занимает один файл и проверяется командой docker compose ps.
01Проверьте, что Docker Compose установлен
На сервере уже должен работать плагин Compose v2: команда docker compose пишется через пробел. Одна команда покажет версию. Если вывод пустой или команда не найдена, установите пакет docker-compose-plugin из репозитория Docker, как описано в инструкции по установке Docker Compose.
docker compose version
02Создайте compose-файл с директивой expose
В каталоге проекта создайте файл compose.yaml. Сервис app слушает 3000 внутри контейнера, директива expose делает этот порт видимым для других сервисов проекта. Порт наружу не открывается, поэтому с хоста и из интернета он недоступен.
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.
docker compose up -d
docker compose ps
04Опубликуйте порт на хосте через ports
Чтобы сервис был доступен снаружи, замените expose на ports. Запись "8080:3000" публикует порт 3000 контейнера на порту 8080 хоста. Если порт нужен только самому серверу, привяжите его к localhost: "127.0.0.1:8080:3000". Опубликованные порты Docker обходят UFW, поэтому ограничение по адресу обязательно.
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 покажет и процесс, который его держит.
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.
services:
app:
image: nginx:1.24
network_mode: host
07Проверьте связь между сервисами по expose
Сервисы одного проекта видят друг друга по имени сервиса в сети <проект>_default. Из контейнера app база доступна как db:3306, а не как localhost. Директива expose в этом не участвует: связь работает и без неё, а expose лишь документирует порт в конфиге.
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 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: руководство по работе с многоконтейнерными приложениями: все материалы темы