`localhost:9000` внутри контейнера Nginx означает сам Nginx, а не соседний PHP. В Compose обращайтесь к FPM по имени сервиса, например `php:9000`. Docker поддерживает это имя при пересоздании контейнера, даже если внутренний IP изменился.

Но успешное соединение ещё не гарантирует выполнение скрипта. Nginx передаёт `SCRIPT_FILENAME`, а PHP-FPM ищет этот путь в собственной файловой системе. Если контейнеры монтируют код в разные каталоги, сеть исправна, но появится `Primary script unknown`.

Текст ошибки указывает на участок маршрута

СообщениеГде сбойПроверка
host not found in upstreamDNS/имя сервисаservice name и общая сеть
connection refusedпорт/listen/processFPM status и внутренний порт
upstream timed outFPM завис или сетьлоги и timeout без слепого увеличения
Primary script unknownпуть к файлуSCRIPT_FILENAME внутри PHP
No input file specifiedmapping pathroot, alias и mounts
502 после recreatehard-coded IPзаменить IP именем сервиса

Сначала состояние и DNS, потом Nginx-конфиг

docker compose ps
docker compose logs --tail=100 nginx php
docker compose exec nginx getent hosts php

# Имена nginx/php замените именами сервисов из compose.yaml.
# В минимальном image утилиты getent может не быть.

Команды не меняют состояние, но запускайте их из каталога нужного Compose-проекта. Оба сервиса должны быть в общей сети. Документация Docker указывает, что Compose регистрирует service name во внутреннем DNS; межсервисное соединение использует container port, а опубликованный host port нужен внешнему клиенту.

FastCGI смотрит на внутренний порт

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass php:9000;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

Это условный фрагмент, не готовая замена вашего server block. Nginx разрешает передать FastCGI address как domain name или IP с портом. Имя `php` должно совпадать с service/alias, а FPM — слушать `0.0.0.0:9000` или другой согласованный TCP endpoint. Unix socket работает только если оба контейнера видят один и тот же socket-файл.

FPM и Nginx должны видеть один script path

КонтейнерMountРезультат
nginx./app:/var/www/html:rodocument_root видит index.php
php./app:/var/www/html:roFPM видит тот же путь
php./app:/app:roнужен mapping /app, а не /var/www/html
nginxтолько public:/srv/publicявно согласовать SCRIPT_FILENAME

Проверьте существование ровно того пути, который ушёл в FPM. При `alias`, front controller и разных mount points выражение с `$document_root` может быть неверным. Не добавляйте случайные префиксы до получения фактического значения из debug-конфига и логов.

Healthcheck не заменяет readiness приложения

  • Убедитесь, что FPM master process запущен, а не только container status running.
  • Проверьте итоговый `nginx -T`, потому что include может переопределить location.
  • Смотрите FPM error log вместе с Nginx error log по одному времени запроса.
  • Не публикуйте порт 9000 наружу без необходимости: достаточно внутренней сети.
  • Не закрепляйте container IP — после recreate он может измениться.
  • Таймаут увеличивайте только после поиска медленной операции.

Минимальный тест локализует проблему

  1. Проверить, что сервисы присутствуют в `docker compose ps`.
  2. Из Nginx разрешить service name PHP и проверить TCP endpoint доступным инструментом.
  3. Сверить `fastcgi_pass` с фактическим `listen` PHP-FPM.
  4. Вывести активный Nginx-конфиг и значение root для тестового location.
  5. В PHP-контейнере проверить существование передаваемого index.php.
  6. Сделать один HTTP-запрос и сопоставить Nginx/FPM logs по времени.

Схема исправлена, когда контейнер можно пересоздать без ручной смены IP, Nginx подключается к service name, а FPM получает существующий script path. Для разбора подготовьте обезличенные `compose.yaml`, server block, pool listen и по одной строке обоих error logs — секреты окружения и весь дамп конфигурации не нужны.

Проверенные источники