Ошибка port is already allocated возникает при привязке порта на хосте. Запишите адрес из сообщения целиком: 0.0.0.0:8080 и 127.0.0.1:8080 описывают разные области прослушивания, а TCP и UDP — разные протоколы. Затем найдите владельца этой привязки. Остановка случайного контейнера может убрать ошибку и одновременно выключить другой сайт.
Два контейнера могут слушать внутренний порт 80 в разных сетевых пространствах. Конфликт появляется, когда оба публикуют его на один адрес и порт хоста. Для тестового проекта обычно достаточно сменить внешний порт, сохранив внутренний. Прежде чем редактировать YAML, посмотрите итоговую конфигурацию после подстановки переменных и объединения Compose-файлов.
Условный конфликт двух проектов
# проект A
ports:
- "127.0.0.1:8080:80"
# проект B — отдельный внешний порт
ports:
- "127.0.0.1:8081:80"В короткой записи слева находится порт хоста, справа — порт контейнера. Привязка к loopback подходит, когда доступ идёт через reverse proxy на этом же хосте. Docker документирует, что публикация без host IP по умолчанию может сделать порт доступным на внешних интерфейсах. Выбирайте область доступа осознанно и отдельно проверяйте firewall.
Три чтения показывают реальную картину
docker compose config
docker ps --format 'table {{.Names}} {{.Ports}}'
sudo ss -ltnp 'sport = :8080'Последняя команда относится к Linux и TCP. Для UDP нужен просмотр соответствующих UDP-сокетов. Вывод Compose может содержать подставленные секреты: изучайте его локально и удаляйте чувствительные значения из отчёта. Если Docker использует удалённый context, команда docker ps показывает удалённый Engine, а локальный ss — текущую машину; такие результаты нельзя сравнивать как один сервер.
| Владелец | Что это означает | Действие |
|---|---|---|
| другой Compose-проект | внешний порт занят намеренно | дать новому проекту другой host port |
| системный Nginx | вход уже обслуживает proxy | проксировать к свободному loopback-порту |
| контейнер того же проекта | старый экземпляр ещё работает | сверить labels, сервис и порядок обновления |
| процесс неизвестен | назначение не установлено | найти службу по PID до остановки |
Смена порта затрагивает путь до приложения
После выбора нового host port обновите upstream reverse proxy, healthcheck снаружи контейнера и локальные ссылки. Внутренние обращения между сервисами обычно идут по имени сервиса и container port: менять их вслед за внешней публикацией не требуется. EXPOSE в Dockerfile описывает порт образа и сам по себе не создаёт host-привязку.
- проверьте, не задан ли тот же порт в override-файле;
- сверьте значение переменной PORT в текущем окружении;
- учтите TCP/UDP и IPv4/IPv6 при поиске сокета;
- при network_mode: host обычная модель port mapping меняется;
- проверьте, кто управляет контейнером: Compose, systemd или другой оркестратор.
Обновление двух экземпляров требует двух привязок
При параллельном запуске старой и новой версии фиксированный host port нельзя занять дважды. Один практический вариант — поднять новую версию на временном loopback-порту, проверить ответ и затем переключить proxy. Старый экземпляр сохраняют до успешной проверки, после чего останавливают штатно. Это проектное решение, его нужно согласовать с текущей схемой деплоя.
Не удаляйте volumes и не выполняйте глобальную очистку Docker ради освобождения порта. Ни удаление данных, ни пересборка образа не объясняют владельца слушающего сокета. Если сервис нужен другим пользователям, смена его порта требует обновления клиентов или сохранения прежнего входа через proxy.
Результат проверяем снаружи и внутри
- Прочитать итоговый mapping после правки.
- Убедиться, что контейнер запущен и слушает ожидаемый внутренний порт.
- Получить ответ через новый loopback host port.
- Проверить публичный адрес через reverse proxy.
- Перезапустить проект штатным способом и повторить проверку.
Сохраните исходный mapping и upstream, чтобы вернуть прежний маршрут при ошибке. Для разбора конфликта полезны точный текст ошибки, версия Docker, выбранный context, обезличенный раздел ports и строки docker ps и ss. Эти данные позволяют определить владельца без отключения соседних сервисов.