Обратный прокси принимает запрос клиента и передаёт его серверу приложения. Для клиента точкой входа остаётся прокси, а внутренняя структура сервиса может меняться.

Одна точка входа

NGINX может отдавать статические файлы и проксировать запросы к приложению. Это позволяет разделить обработку ресурсов и динамических ответов. В конфигурации маршруты описываются блоками location.

Что проверять при ошибке

Если появилась ошибка шлюза, двигайтесь по цепочке: доступен ли прокси, отвечает ли приложение по внутреннему адресу, совпадают ли порт и протокол. Затем проверьте журналы обеих сторон за один и тот же промежуток времени.

Заголовки, которые передаёт прокси, тоже являются частью контракта. Приложению может понадобиться исходное имя хоста или сведения о схеме запроса. Доверять таким сведениям следует только от известных прокси.

Изменения без сюрпризов

nginx -t

Перед применением изменений проверьте синтаксис и доступность упомянутых файлов. Успешная проверка конфигурации не доказывает доступность upstream: её нужно проверять отдельно.

Разделяйте две проверки: «конфигурация корректна» и «запрос проходит весь путь до приложения».