Адреса, EXPOSE и публикация портов

Когда вы открываете localhost в браузере на ноутбуке, вы обращаетесь к ноутбуку. Когда Python слушает 127.0.0.1 внутри контейнера, это loopback самого контейнера. Одинаковое имя не делает два сетевых окружения одним.

# Внутри app.py
HTTPServer(("0.0.0.0", 8000), Handler).serve_forever()

0.0.0.0 в вызове сервера означает принимать подключения на всех IPv4-интерфейсах его окружения. Это адрес привязки сокета, а не адрес, который требуется отправить пользователю для открытия сайта. Конкретный адрес клиента зависит от того, как опубликован порт.

Типичный симптом неверной привязки: процесс работает, ошибок Python нет, но запрос снаружи не проходит. Менять JSON в таком случае бессмысленно — обработчик ещё не получил запрос. Начните с адреса прослушивания и фактического порта приложения.

EXPOSE 8000 документирует порт приложения в образе. Инструкция сама не запускает сервер и не создаёт доступ с хоста. Для явной публикации используется параметр -p при запуске контейнера.

docker run --rm -p 127.0.0.1:8080:8000 qa-api:v1

# В другом терминале на том же компьютере:
curl -i http://localhost:8080/

Здесь 127.0.0.1 — интерфейс хоста для публикации, 8080 — порт хоста, 8000 — порт контейнера. Браузер обращается к 8080, а приложение продолжает слушать 8000. Для локальной практики явно выбран loopback хоста.

Если написать только -p 8080:8000, порт по умолчанию публикуется на всех адресах хоста. Открыть localhost:8000 в этом примере — перепутать стороны отображения. Подробности и формат приведены в Docker Docs о публикации портов.

Сначала установите, работает ли контейнер: docker ps -a покажет завершение, а docker logs — ошибку приложения. Если Python не стартовал, настройка публикации не сделает сервис доступным. Затем проверьте реальный адрес и порт сервера в коде или конфигурации.

docker ps -a
docker logs qa-api
docker port qa-api
curl -i http://localhost:8080/

Эти команды предполагают запуск с --name qa-api. docker port показывает опубликованные порты конкретного экземпляра; сравните их с адресом в curl. Если порт хоста 8080 уже занят, Docker может отклонить запуск: выберите другой порт хоста, например 127.0.0.1:8081:8000, сохранив порт контейнера.

Отказ соединения, тайм-аут и ответ 404 — разные наблюдения. При 404 HTTP-сервер уже ответил: нужно проверить путь и маршрутизацию приложения. При тайм-ауте возможны проблемы сети или зависший процесс; одного сообщения недостаточно для уверенного вывода. Записывайте точный симптом, а не только «сайт недоступен».