`localhost:9000` внутри контейнера Nginx означает сам Nginx, а не соседний PHP. В Compose обращайтесь к FPM по имени сервиса, например `php:9000`. Docker поддерживает это имя при пересоздании контейнера, даже если внутренний IP изменился.
Но успешное соединение ещё не гарантирует выполнение скрипта. Nginx передаёт `SCRIPT_FILENAME`, а PHP-FPM ищет этот путь в собственной файловой системе. Если контейнеры монтируют код в разные каталоги, сеть исправна, но появится `Primary script unknown`.
Текст ошибки указывает на участок маршрута
| Сообщение | Где сбой | Проверка |
|---|---|---|
| host not found in upstream | DNS/имя сервиса | service name и общая сеть |
| connection refused | порт/listen/process | FPM status и внутренний порт |
| upstream timed out | FPM завис или сеть | логи и timeout без слепого увеличения |
| Primary script unknown | путь к файлу | SCRIPT_FILENAME внутри PHP |
| No input file specified | mapping path | root, alias и mounts |
| 502 после recreate | hard-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:ro | document_root видит index.php |
| php | ./app:/var/www/html:ro | FPM видит тот же путь |
| 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 он может измениться.
- Таймаут увеличивайте только после поиска медленной операции.
Минимальный тест локализует проблему
- Проверить, что сервисы присутствуют в `docker compose ps`.
- Из Nginx разрешить service name PHP и проверить TCP endpoint доступным инструментом.
- Сверить `fastcgi_pass` с фактическим `listen` PHP-FPM.
- Вывести активный Nginx-конфиг и значение root для тестового location.
- В PHP-контейнере проверить существование передаваемого index.php.
- Сделать один HTTP-запрос и сопоставить Nginx/FPM logs по времени.
Схема исправлена, когда контейнер можно пересоздать без ручной смены IP, Nginx подключается к service name, а FPM получает существующий script path. Для разбора подготовьте обезличенные `compose.yaml`, server block, pool listen и по одной строке обоих error logs — секреты окружения и весь дамп конфигурации не нужны.