Контейнер Docker публикует порт, но сайт с компьютера не открывается

#Что означает ошибка и при каких условиях возникает

Если Docker показывает опубликованный порт, но браузер не подключается, проверьте адрес прослушивания внутри контейнера, сопоставление портов и доступ с хоста. EXPOSE в Dockerfile само по себе не открывает порт. Даже при ports сервис обязан слушать правильный внутренний порт и адрес 0.0.0.0 внутри контейнера; привязка к 127.0.0.1 внутри контейнера часто мешает доступу через публикацию.

#Как различить причины

#Пошаговая диагностика и исправление

1. Узнайте, что конкретно не открываетсяОткройте браузер на том же компьютере, где работает Docker, и попробуйте http://127.0.0.1:8080 для примера с портом 8080; в своём проекте используйте именно указанный host-порт. Отдельно запишите, получается ли подключиться с другого компьютера. Не считайте эти случаи одинаковыми: если локально работает, причина чаще вне контейнера.
2. Откройте Compose и прочтите публикацию портовВ каталоге проекта откройте терминал и выполните docker compose ps. В колонке PORTS ищите запись 127.0.0.1:8080->8000/tcp или подобную. Слева от стрелки — host-порт, справа — порт внутри контейнера. Если указан только 8000/tcp без стрелки, порт может быть лишь открыт для внутренних соединений, но не опубликован хосту. Откройте compose.yaml в редакторе и найдите блок ports: у нужного сервиса.
3. Сверьте порт из журнала программыВыполните docker compose logs --tail=60 web, где web — имя сервиса. В журнале часто видно, на каком адресе и порту слушает программа: 127.0.0.1:8000 указывает на контейнерный loopback, а 0.0.0.0:8000 — на все интерфейсы контейнера. Если журнал ничего не сообщает, проверьте конфигурацию самой программы; не предполагайте порт по одному EXPOSE.
4. Проверьте соединение внутри контейнераПри наличии клиентской программы в образе выполните локальный HTTP-запрос к 127.0.0.1:8000 из самого контейнера: для образа Python используйте docker compose exec web python -c "import urllib.request; print(urllib.request.urlopen('http://127.0.0.1:8000/',timeout=3).status)". Ожидаемый HTTP 200 означает, что сервис внутри доступен. Если Connection refused, сначала устраните ошибку запуска приложения, а не публикацию портов.
5. Исправьте адрес прослушивания приложенияЕсли в настройках приложения указан 127.0.0.1, в конфигурации самого приложения укажите 0.0.0.0 для контейнерного слушателя. Например, учебный python -m http.server 8000 --bind 0.0.0.0. Это не означает, что порт следует открывать всему интернету: на стороне хоста в ports: безопаснее оставить 127.0.0.1, когда внешний доступ не требуется. Сохраните копию исходной конфигурации для отката.
6. Исправьте сопоставление портов и проверьте YAMLВ compose.yaml замените неверную пару портов на фактическую, например 127.0.0.1:8080:8000. Прежде чем запускать, выполните docker compose config -q. Если возникла ошибка YAML, проверьте отступы, кавычки, отсутствие конфликтующего network_mode; не пробуйте бессистемно менять несколько настроек сразу.
7. Примените только к отдельному тестовому сервисуВ учебном проекте после docker compose up -d откройте http://127.0.0.1:8080 в браузере на хосте. При правильной конфигурации появится список файлов сервера Python. Если сервис рабочий, согласуйте пересоздание контейнера с владельцем и проверку зависимостей: кратковременная недоступность возможна. Для отката восстановите сохранённый YAML и повторите согласованное развёртывание.
8. Если локально работает, но с другой машины нетПроверьте, не задана ли осознанная локальная привязка 127.0.0.1. Вынесение сервиса наружу требует проверки авторизации, TLS, правил брандмауэра и корпоративных ограничений. Не отключайте защиту для проверки. Запишите IP/порт источника, способ обращения и результат браузера, затем обсудите настройку внешнего доступа с администратором.
9. Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
   Выберите подходящий вариант — это не команды для последовательного выполнения

   Вариант 1Проверка объявленных портов и журнала web (заменить именем сервиса).

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Проверка объявленных портов и журнала web (заменить именем сервиса). Не требует администратора ОС, но необходим разрешённый доступ к Docker.

   docker compose ps

   docker compose logs --tail=60 web

   Вариант 2Только если образ содержит Python, сервис назван web и слушает 8000.

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Только если образ содержит Python, сервис назван web и слушает 8000. Проверка обращается к самому контейнеру, успешный пример — число 200.

   docker compose exec web python -c "import urllib.request; print(urllib.request.urlopen('http://127.0.0.1:8000/',timeout=3).status)"

   Вариант 3Проверка синтаксиса и запуск учебного проекта.

   Linux · Терминал (Bash)С осторожностьюКопировать всёВыделить

   Проверка синтаксиса и запуск учебного проекта. На рабочем проекте up может обновить контейнеры, поэтому сначала согласуйте изменения.

   docker compose config -q

   docker compose up -d

   Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

#Минимальный пример для отдельного тестового проекта

services:
  web:
    image: python:3.12-alpine
    command: ["python", "-m", "http.server", "8000", "--bind", "0.0.0.0"]
    ports:
      - "127.0.0.1:8080:8000"

#Как проверить результат и что делать, если проблема осталась

Успех — docker compose ps показывает нужную публикацию, проверка внутри контейнера отвечает, а браузер на хосте открывает http://127.0.0.1:8080. Если внутренний запрос не работает, ищите неисправность приложения. Если внутри работает, а с хоста нет, сверяйте пары портов, привязку host IP и окружение Docker.