Сначала нарисуйте маршрут

Укажите, какие домены и пути принимает Nginx, где слушает backend и как он доступен: на loopback, внутреннем адресе или Unix-сокете. Не публикуйте порт приложения наружу, если он должен принимать запросы только от прокси. Сетевую доступность проверьте отдельно от конфигурации Nginx.

Сначала схема. На ней отметьте, кто завершает TLS, какой компонент доверяет исходному Host, как формируется X-Forwarded-For, кому доверяет backend и куда направляется запрос с неизвестным доменом.

Директива proxy_pass задает протокол и адрес upstream. Если после адреса указан URI, совпавшая часть нормализованного запроса заменяется заданным URI; без URI исходный путь передается по другому правилу. Сверьте примеры с документацией модуля и проверьте конечный URL приложения.

Передайте нужный контекст

Приложению часто нужны исходный hostname и схема запроса. Настройте заголовки, которые оно ожидает, например Host, X-Real-IP и X-Forwarded-For. Не доверяйте произвольному клиентскому заголовку как реальному IP: proxy chain должен быть известен и настроен с доверенными адресами.

Если Nginx стоит за CDN или балансировщиком, используйте real-IP-модуль только для документированных доверенных сетей. Иначе клиент может подставить собственное значение и исказить журналы или правила доступа. HTTPS между клиентом и Nginx и HTTPS от Nginx к upstream - две отдельные настройки.

Отдельно настройте WebSocket и таймауты

WebSocket использует переключение протокола через Upgrade и требует специальной прокси-конфигурации. В документации Nginx специальный режим указан начиная с 1.3.13; пример использует запрос Upgrade и ответ backend 101. Не считайте, что обычный HTTP-пример автоматически поддерживает постоянное соединение. Таймауты, буферы и размер заголовков выбирайте по документации приложения и наблюдаемым ошибкам.

Проверьте синтаксис через nginx -t, затем примените конфигурацию штатным reload, а не останавливайте сервис без причины. Запросите тестовый путь, проверьте журнал Nginx и backend, редиректы и ответы приложения. Проверьте обе версии пути: со слешем и без.

Официальные разделы Nginx о proxy_pass, WebSocket и real-IP-модуле проверены 8 октября 2026 года. Для выбора сервера смотрите сравнение Nginx и Apache и раздел хостинга для сайтов. Конфигурации не менялись.