Настройка обратного прокси nginx: пошаговое руководство
Узнайте, как настроить блок server в nginx для проксирования запросов. Разбираем параметры proxy_pass, заголовки для приложений, поддержку WebSocket и лимиты загрузки.
Что делает конфигурация обратного прокси-сервера nginx
Обратный прокси-сервер nginx принимает запросы, поступающие на порты 80 и 443, передает каждый из них приложению, которое уже ожидает соединение на локальном порту, а затем возвращает ответ этого приложения в браузер. Конфигурация представляет собой единый блок server, и этот блок невелик. Почти вся сложность заключается в пяти-шести строках, которые сообщают вашему приложению, кто был реальным клиентом и какой протокол этот клиент использовал.
Все приведенное ниже строится с нуля на Ubuntu 24.04 с использованием пакета nginx из дистрибутива. Отправной точкой является приложение, которое уже отвечает на 127.0.0.1:3000. Если вы еще не определились с выбором прокси, сравнение nginx с Caddy и Traefik — это то, что стоит прочитать в первую очередь. Ниже показано, как выглядит ответ nginx, строка за строкой.
Запускайте эти конфигурации на своем сервере. Тестируйте каждое изменение с помощью sudo nginx -t перед перезагрузкой и читайте то, что он выводит.
Где nginx хранит конфигурацию в Ubuntu
sudo apt update
sudo apt install -y nginx
ls -l /etc/nginx/sites-enabled/Основной файл — /etc/nginx/nginx.conf. В нем задаются глобальные параметры внутри блока http { }, после чего подключаются два каталога: /etc/nginx/conf.d/*.conf и /etc/nginx/sites-enabled/*. В Ubuntu и Debian для каждого сайта создается отдельный файл в /etc/nginx/sites-available/, который активируется через символическую ссылку в /etc/nginx/sites-enabled/. Удаление ссылки отключает сайт, но сохраняет файл конфигурации.
Две директивы, которые потребуются далее, работают только в контексте http и никогда внутри блока server: map и upstream. Разместите их в отдельном файле в каталоге /etc/nginx/conf.d/, так как содержимое этого каталога подключается на уровне http.
В пакете по умолчанию активирован сайт default. Он помечен как default_server, что означает, что он обрабатывает любой запрос, если заголовок Host не совпадает ни с одним server_name в вашей конфигурации. Пока этот сайт включен, запросы, не соответствующие вашим доменным именам, будут попадать на него, а не в ваше приложение. Удалите символическую ссылку, как только настроите собственный сайт.
sudo rm /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload nginxМинимальный server block для проксирования одного приложения
server {
listen 80;
listen [::]:80;
server_name app.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
}
}Сохраните это как /etc/nginx/sites-available/app.example.com, затем включите конфигурацию и примените её.
sudo ln -s /etc/nginx/sites-available/app.example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
curl -sI -H 'Host: app.example.com' http://127.0.0.1/listen 80; привязывается к IPv4, а listen [::]:80; — к IPv6. Если убрать вторую строку, любое IPv6-соединение с вашим сервером будет отклонено. Браузер с поддержкой dual-stack, чей DNS-запрос (domain name system) возвращает AAAA-запись, обычно переключается на IPv4 и скрывает проблему. Однако пользователь с доступом только по IPv6 или клиент, который пытается использовать только первый полученный адрес, увидит ошибку соединения, в то время как пользователи IPv4 увидят работающий сайт. В отчёте об ошибке, который вы получите, будет сказано: «у меня всё работает».
server_name сопоставляется с заголовком Host, который отправляет браузер. Можно указать несколько имён через пробел. Если ни один блок не подходит, nginx использует тот, который помечен как default_server, поэтому стандартный сайт из пакета пришлось удалить.
location / выполняет префиксное сопоставление пути запроса, а / соответствует любому пути. proxy_pass — это адрес, к которому nginx открывает соединение. Оставляйте приложение привязанным к 127.0.0.1, чтобы единственный путь к нему вёл через nginx. Если приложение запущено в контейнере, публикуйте его как 127.0.0.1:3000:3000, а не как 3000:3000, поскольку Docker создаёт собственные правила и публикует порты в обход ufw, поэтому открытый порт будет доступен из Интернета независимо от настроек ufw. В документации Docker цепочка DOCKER-USER указана как место для фильтрации такого трафика, но привязка к 127.0.0.1 — более простое решение.
Строка curl отправляет корректный заголовок Host с самого сервера, что позволяет протестировать блок до того, как DNS начнёт указывать на него.
Что nginx отправляет на upstream без дополнительных настроек
proxy_pass сам по себе скрывает от вашего приложения четыре вещи.
Пакет nginx 1.24.0, который поставляется в Ubuntu 24.04, по умолчанию использует протокол HTTP/1.0 при обращении к backend и отправляет Connection: close, поэтому каждый запрос открывает новое соединение с upstream, и обновление протокола невозможно. В nginx 1.29.7, выпущенном в марте 2026 года, эти настройки по умолчанию были изменены: начиная с этой версии, nginx использует HTTP/1.1 при работе с upstream, не отправляет заголовок Connection и повторно использует соединения из пула вместо открытия нового соединения для каждого запроса. Даже в этом случае для обновления до WebSocket по-прежнему требуются заголовки, указанные ниже.
Заголовок Host перезаписывается значением в proxy_pass, которое равно 127.0.0.1:3000. Приложение, формирующее абсолютные ссылки на основе Host, теперь создает ссылки, которые никто за пределами сервера не сможет открыть.
Соединение, поступающее в приложение, исходит от nginx, поэтому приложение видит адрес клиента 127.0.0.1. В результате каждая строка лога и каждый лимит запросов внутри приложения фиксируют прокси, а не посетителя.
Приложение не может определить, что браузер использовал HTTPS, так как полученное соединение является обычным HTTP на адресе loopback.
Четыре строки исправляют все эти проблемы.
Четыре заголовка, которые необходимо настроить, и что именно они позволяют увидеть бэкенду
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}Host содержит имя, которое ввел посетитель. $host — это имя из запроса, из которого удален порт, а все буквы приведены к нижнему регистру. Установите его, чтобы приложение формировало корректные абсолютные URL: например, для редиректа после входа в систему или ссылки в письме для сброса пароля. Если его не указать, приложение будет считать 127.0.0.1:3000 своим собственным именем. Стандартный параметр proxy_redirect в nginx перезаписывает заголовок Location или Refresh, который указывает на адрес proxy_pass, поэтому обычный редирект после входа обычно срабатывает корректно. Однако абсолютные URL, которые приложение вставляет в страницы и письма (например, ссылка на сброс пароля), будут указывать на 127.0.0.1:3000 — адрес, который браузер посетителя не сможет открыть. Если вашему приложению также требуется порт (например, если вы обслуживаете его на 8080), используйте $http_host, который передает заголовок в точности так, как его отправил клиент.
X-Real-IP содержит одно значение: $remote_addr — адрес, с которого nginx принял соединение. Приложения считывают его для собственных журналов доступа и ограничения частоты запросов (rate limiting).
X-Forwarded-For содержит список. $proxy_add_x_forwarded_for добавляет $remote_addr к тому, что клиент уже поместил в этот заголовок, поэтому значения разделяются запятыми, а запись, добавленная вашим nginx, оказывается последней. Эта деталь определяет, можно ли доверять заголовку: клиент может отправить любой X-Forwarded-For, какой захочет, поэтому приложению, считывающему первую запись, можно передать любой адрес. Когда nginx является пограничным сервером, используйте $remote_addr вместо этого, чтобы отбросить версию клиента. Если перед ним стоит CDN или другой прокси, используйте set_real_ip_from и real_ip_header из модуля realip, чтобы сам $remote_addr стал истинным адресом клиента.
X-Forwarded-Proto содержит http или https. Фреймворки считывают его, чтобы решить, помечать ли cookies как Secure и нужно ли принудительно перенаправлять на HTTPS. Если опустить этот заголовок на TLS-сайте, приложение, настроенное на принудительный HTTPS, увидит http, ответит редиректом на HTTPS-адрес, получит следующий запрос через nginx, снова увидит http и снова выполнит редирект. Браузер сдастся и покажет ERR_TOO_MANY_REDIRECTS.
Повторение этих четырех строк в каждой location приводит к расхождениям в конфигурации. Поместите их в один файл и используйте директиву include.
# /etc/nginx/snippets/proxy-headers.conf
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;location / {
include snippets/proxy-headers.conf;
proxy_pass http://127.0.0.1:3000;
}Наследование здесь имеет подвох. Блок location наследует директивы proxy_set_header из своего блока server только в том случае, если в самом location не определено ни одной такой директивы. Добавьте хотя бы один proxy_set_header внутри location, и все заголовки, определенные на уровне server, будут отброшены для этого блока. Поэтому держите их все на одном уровне или используйте include для вставки фрагмента в каждый location, который выполняет проксирование.
Почему моё WebSocket-приложение подключается, а затем отключается?
Потому что настройки по умолчанию запрещают обновление протокола, а стандартный таймаут чтения закрывает простаивающий туннель через 60 секунд. WebSocket начинается как HTTP-запрос, содержащий Upgrade: websocket и Connection: Upgrade. Это заголовки hop-by-hop, что означает, что прокси должен обработать их самостоятельно, а не передавать дальше. В nginx 1.24.0 из состава Ubuntu 24.04 протокол upstream по умолчанию установлен в HTTP/1.0, в котором механизм обновления протокола отсутствует. Оба параметра необходимо вернуть вручную.
Карта (map) размещается в контексте http, в отдельном файле.
# /etc/nginx/conf.d/websocket.conf
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}Затем настраивается location.
location / {
include snippets/proxy-headers.conf;
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
}Карта нужна для того, чтобы один location мог обслуживать оба типа трафика. При обычном запросе $http_upgrade пуст, поэтому $connection_upgrade принимает значение close. При запросе на обновление протокола он содержит websocket, поэтому upstream получает заголовок Connection: upgrade. Жесткое указание proxy_set_header Connection "upgrade"; привело бы к отправке этого заголовка при каждом обычном запросе страницы, на что некоторые бэкенды отвечают ошибкой 400.
proxy_http_version 1.1; является значением по умолчанию начиная с nginx 1.29.7, поэтому в этих версиях данная строка ничего не меняет и не вредит. В пакете версии 1.24.0 она обязательна. Строки Upgrade и Connection необходимы в любой версии, так как nginx никогда не передает эти два заголовка автоматически.
proxy_read_timeout — это причина сообщений вида «загружается, а потом перестает обновляться». По умолчанию установлено 60 секунд, и этот параметр измеряет интервал между двумя операциями чтения из бэкенда, а не общее время жизни соединения. WebSocket, который остается неактивным в течение 60 секунд, закрывается nginx, и в консоли браузера отображается закрытие сокета с кодом 1006. Приложения, которые отправляют собственный heartbeat чаще одного раза в минуту, этого не замечают. Приложения, которые этого не делают, обрываются через минуту. Чаще всего это проявляется в онлайн-редакторах и дашбордах, распространенным примером является самостоятельно развернутый экземпляр n8n за HTTPS.
Почему завершающий слэш в proxy_pass меняет мои URL?
Правило формулируется одним предложением. Если proxy_pass заканчивается на URI (идентификатор ресурса), даже на простой /, nginx удаляет часть пути запроса, которая совпала с префиксом location, и подставляет на это место указанный URI. Если proxy_pass заканчивается на хосте и порте, путь запроса передается без изменений.
location /app/ {
proxy_pass http://127.0.0.1:3000/;
}Запрос к /app/status доходит до бэкенда как /status.
location /app/ {
proxy_pass http://127.0.0.1:3000;
}Запрос к /app/status доходит до бэкенда как /app/status.
Выбор формы зависит от приложения. Приложению с настройкой базового пути или подпапки нужна вторая форма, при этом в настройках приложения должен быть указан /app. Приложению, которое ничего не знает о префиксах, нужна первая форма. У первой формы есть очевидный недостаток: HTML, который возвращает приложение, все еще содержит абсолютные пути, такие как /static/main.css. Браузер запрашивает их из корня сайта, ни один location не совпадает, и страница отображается без стилей. В сетевой вкладке браузера видно, что запросы к этим ресурсам возвращают 404. Решение заключается в настройке базового пути самого приложения или в добавлении второго location location /static/, указывающего на тот же бэкенд.
Location с регулярным выражением не может содержать URI в proxy_pass. sudo nginx -t отклоняет такую конфигурацию и указывает причину: "proxy_pass" cannot have URI part in location given by regular expression, or inside named location, or inside "if" statement, or inside "limit_except" block.
Весь этот класс проблем исчезает, когда каждое приложение получает собственное имя, app.example.com, проксируемое с location /. Использование подпутей оправдано только в том случае, если вы не можете добавить DNS-записи.
Как разместить несколько бэкендов под одним именем?
С помощью блока upstream. Он относится к контексту http, поэтому размещайте его перед блоком server в том же файле или в /etc/nginx/conf.d/.
upstream app_backend {
least_conn;
server 127.0.0.1:3000 max_fails=3 fail_timeout=30s;
server 127.0.0.1:3001 max_fails=3 fail_timeout=30s;
keepalive 32;
}Затем укажите его в location: proxy_pass http://app_backend;.
Метод по умолчанию — round robin. least_conn направляет каждый запрос на бэкенд с наименьшим количеством активных соединений, что подходит для запросов разной длительности. ip_hash привязывает один клиентский адрес к одному бэкенду. ip_hash необходим, когда приложение хранит сессии в собственной памяти, так как round robin между двумя такими бэкендами будет случайно разлогинивать пользователей, если запрос попадет на инстанс, который не видел их сессию. Перенос сессий в общее хранилище — более правильное решение.
max_fails=3 fail_timeout=30s означает, что три неудачные попытки в течение 30 секунд исключают сервер из ротации на 30 секунд. Когда все серверы в блоке переходят в это состояние, клиенты получают 502, а в логе ошибок появляется no live upstreams while connecting to upstream.
keepalive 32 поддерживает до 32 неактивных соединений с бэкендами открытыми для каждого рабочего процесса, что исключает TCP-рукопожатие для большинства запросов. В версии 1.24.0 из Ubuntu 24.04 эта строка включает кэширование. Начиная с nginx 1.29.7 кэширование включено по умолчанию, но задокументированное значение по умолчанию — keepalive 32 local;, а параметр local запрещает совместное использование кэшированных соединений между разными location. Поэтому в версии 1.29.7 и новее обычный keepalive 32; не просто повторяет значение по умолчанию: пропуская local, он позволяет любому location, проксирующему на тот же upstream-сервер, повторно использовать пул соединений, что отличается от стандартного поведения. В этих версиях либо не указывайте эту строку, либо напишите keepalive 32 local;, чтобы сохранить настройки по умолчанию, и используйте ее в чистом виде только если вам нужно такое совместное использование. Параметр local появился в 1.29.7, поэтому пакет 1.24.0 его не поддерживает. Для HTTP-бэкендов рекомендуемая nginx настройка пула — это proxy_http_version, установленный в 1.1 (или 2, начиная с nginx 1.29.4), с очисткой заголовка Connection при передаче на upstream. nginx также документирует постоянные соединения HTTP/1.0, создаваемые отправкой Connection: Keep-Alive бэкенду, который их поддерживает, но отмечает, что этот метод не рекомендуется. Начиная с 1.29.7, обе части рекомендуемой настройки являются значениями по умолчанию. В версии 1.24.0 добавьте proxy_http_version 1.1; и proxy_set_header Connection ""; в location самостоятельно, иначе nginx продолжит отправлять HTTP/1.0 с Connection: close, и пул не будет использоваться повторно. Если в том же location используется карта для WebSocket, измените пустой случай с close на пустую строку, чтобы обычные запросы не содержали заголовок Connection, что позволит повторно использовать пул соединений.
map $http_upgrade $connection_upgrade {
default upgrade;
'' '';
}Имена внутри блока upstream разрешаются при запуске nginx. Если ваш бэкенд — это контейнер, который получает новый адрес при перезапуске, nginx продолжит использовать старый адрес до тех пор, пока вы не выполните перезагрузку. nginx 1.27.3 и новее могут отслеживать такие изменения без перезагрузки через resolver, zone в блоке upstream и параметр resolve в каждой строке server, но пакет 1.24.0 выпущен раньше. Внутри сети Docker вы можете перенести разрешение имен на момент запроса с помощью встроенного резолвера.
resolver 127.0.0.11 valid=10s;
set $backend http://app:3000;
proxy_pass $backend;Когда контейнеры появляются и исчезают настолько часто, что вам приходится постоянно редактировать nginx, лучше использовать прокси, который считывает метки контейнеров. Traefik перед несколькими приложениями Docker Compose строит свои маршруты на основе самих контейнеров.
Почему загрузка файлов завершается ошибкой 413 Request Entity Too Large?
client_max_body_size по умолчанию составляет 1 мегабайт. Запросы с телом большего размера отклоняются nginx с кодом 413, а в лог ошибок записывается client intended to send too large body. Увеличьте это значение в блоке server или в конкретном location, где происходит загрузка.
client_max_body_size 512m;Значение 0 полностью отключает проверку. При использовании 512m nginx всё равно будет отклонять тела запросов, превышающие этот лимит, поэтому ошибка 413, возникающая после изменения настройки, указывает на то, что источником проблемы является не backend. Проверьте действующее значение client_max_body_size в location, отвечающем за загрузку, и лог ошибок nginx, прежде чем проверять лимиты самого приложения.
По умолчанию nginx считывает всё тело запроса перед открытием соединения с upstream, записывая крупные данные во временный файл на диске. Это защищает приложение от медленных клиентов, так как backend получает данные для загрузки на полной локальной скорости. Для очень больших файлов можно использовать потоковую передачу.
proxy_request_buffering off;Для загрузки данных по частям (chunked) в HTTP/1.1 на версии 1.24.0 также установите proxy_http_version 1.1; в соответствующем location, иначе nginx продолжит буферизировать тело запроса. В этом случае backend будет получать данные по мере их поступления и должен быть готов к их обработке. Как только nginx начинает передачу тела запроса в upstream, он больше не может повторить запрос к другому upstream в случае ошибки.
client_body_timeout, составляющий по умолчанию 60 секунд, применяется к интервалу между двумя последовательными операциями чтения тела запроса, а не ко всей загрузке целиком. Медленная, но стабильная загрузка не будет прервана. Зависшая загрузка будет сброшена.
Буферизация ответов и настройка, нарушающая вывод в реальном времени
proxy_buffering включена по умолчанию, и в большинстве случаев это именно то, что требуется. Nginx считывает ответ от вашего приложения так быстро, как приложение успевает его записывать, удерживает его и передает медленному клиенту с его собственной скоростью. Воркер приложения завершает работу раньше, вместо того чтобы оставаться занятым на протяжении всей медленной загрузки.
Это нарушает потоковую передачу ответов. События, отправляемые сервером (Server-sent events), и вывод логов в реальном времени не отображаются у пользователя, пока буфер не заполнится. Отключайте буферизацию только в этом конкретном location.
proxy_buffering off;Если вы управляете приложением, лучше отправлять заголовок X-Accel-Buffering: no только для потоковых ответов. Nginx считывает этот заголовок для каждого ответа и отключает буферизацию только для него, поэтому обычные страницы сохраняют все преимущества.
Когда в error log появляется сообщение upstream sent too big header while reading response header from upstream, это означает, что заголовки ответа не поместились в один буфер. proxy_buffer_size по умолчанию равен одной странице памяти, 4 или 8 килобайтам в зависимости от платформы, и длинные куки или большие заголовки аутентификации переполняют его. Увеличьте оба значения.
proxy_buffer_size 16k;
proxy_buffers 8 16k;Где в этой конфигурации место для TLS?
На уровне Nginx, перед всеми остальными компонентами. TLS (transport layer security) завершается на прокси-сервере, а соединение от Nginx к приложению остается обычным HTTP через loopback-адрес, где его не может перехватить никто другой в сети. Приложение узнает о том, что посетитель использовал HTTPS, из X-Forwarded-Proto — четвертого из четырех заголовков.
Не прописывайте пути к сертификатам вручную. Направьте DNS-запись на сервер, откройте брандмауэр и позвольте Certbot отредактировать этот же server block: он добавит строку listen 443 ssl с путями ssl_certificate, а также редирект с 80 порта. В статье Выпуск сертификата Let's Encrypt для Nginx с помощью Certbot описаны процесс выпуска и таймер автоматического обновления.
sudo ufw allow 'Nginx Full'
sudo ufw statusNginx Full — это профиль приложения, который устанавливается вместе с пакетом Nginx; он открывает порты 80 и 443 одновременно. Порт 80 должен оставаться открытым для прохождения проверки HTTP-01 при обновлении сертификата, даже после того, как все посетители будут перенаправлены на HTTPS.
Проверка конфигурации и перезагрузка
sudo nginx -t
sudo systemctl reload nginxnginx -t анализирует все включенные файлы и либо сообщает об успешном прохождении теста, либо выводит имя файла и номер строки, на которой произошла ошибка. Изучите этот вывод перед перезагрузкой. Перезагрузка с некорректной конфигурацией не применяется: Nginx продолжает работать с предыдущей конфигурацией, поэтому сайт остается доступным, а ваши изменения игнорируются. systemctl restart ведет себя иначе и хуже, так как перезапуск сначала останавливает работающий сервер, поэтому ошибка в конфигурации приведет к тому, что Nginx вообще не запустится. По умолчанию используйте перезагрузку, а перезапуск оставьте для редких случаев, когда это действительно необходимо.
sudo tail -f /var/log/nginx/error.log
sudo ss -lntp | grep -E ':(80|443|3000)'Строка ss показывает, какой процесс занимает каждый порт, поэтому вы можете подтвердить, что приложение действительно ожидает соединений там, куда указывает proxy_pass.
Типичные ошибки, с которыми вы столкнетесь
502 Bad Gateway, в журнале ошибок connect() failed (111: Connection refused) while connecting to upstream. По адресу в proxy_pass никто не ожидает соединений. Приложение остановлено, привязано к другому порту или к внутреннему адресу контейнера, недоступному для хоста.
502 с no live upstreams while connecting to upstream. Все серверы в блоке upstream в данный момент помечены max_fails как нерабочие. Восстановите работу бэкендов. nginx повторит попытку после истечения fail_timeout.
504 Gateway Time-out, с upstream timed out (110: Connection timed out) while reading response header from upstream. Бэкенд принял соединение, но не передал данные в течение proxy_read_timeout секунд. Увеличение таймаута оправдано для действительно медленных отчетов, но является ошибкой, если приложение зависло.
Все пути возвращают 404 от приложения. Правило обработки завершающего слэша изменило путь. Сравните путь, который фиксирует приложение, с тем, который вы запрашивали.
Отвечает другой сайт. server_name не совпадает с заголовком Host, поэтому запрос был обработан блоком default_server.
Страница загружается, но интерфейс зависает примерно через минуту. Это случай с WebSocket: отсутствует обработка Upgrade или значение proxy_read_timeout по-прежнему составляет 60 секунд.
FAQ
Почему nginx возвращает 502 Bad Gateway после добавления proxy_pass?
nginx не смог установить соединение с адресом, указанным в proxy_pass. Лог ошибок по пути /var/log/nginx/error.log содержит причину: connect() failed (111: Connection refused) while connecting to upstream означает, что по этому адресу никто не слушает порт, а no live upstreams означает, что все серверы в блоке upstream помечены как недоступные. Выполните sudo ss -lntp | grep 3000, чтобы увидеть, какой процесс занимает порт и к какому адресу он привязан. Приложение, привязанное к внутреннему адресу контейнера или к другому порту, отличному от указанного, всегда будет вызывать эту ошибку.
Почему мое приложение разрывает соединение примерно через минуту работы через nginx?
Соединение является WebSocket, а значение proxy_read_timeout по-прежнему установлено по умолчанию на 60 секунд, что определяет интервал между двумя операциями чтения из бэкенда. Неактивный сокет закрывается nginx, и консоль браузера сообщает о коде закрытия 1006. Установите proxy_http_version 1.1 (значение по умолчанию, начиная с nginx 1.29.7, но отсутствующее в пакете 1.24.0, который поставляется с Ubuntu 24.04), передавайте заголовки Upgrade и Connection с помощью map в блоке $http_upgrade, а также увеличьте proxy_read_timeout до значения вроде 3600s. Без заголовка Upgrade обновление соединения не происходит, поэтому приложение переключается на поллинг или не отображает обновления в реальном времени.
Имеет ли значение косая черта в конце proxy_pass?
Да, она меняет путь, который получает бэкенд. При использовании location /app/ и proxy_pass http://127.0.0.1:3000/ запрос к /app/status доходит до бэкенда как /status, так как любой URI после хоста и порта заменяет собой совпавший префикс location. Уберите этот завершающий слэш, и тот же запрос дойдет как /app/status. Удаление префикса часто нарушает работу ссылок на статические файлы в самом приложении, так как они остаются абсолютными и выдают 404 в корне сайта, поэтому для приложения с настройкой базового пути лучше использовать вариант, который передает путь целиком.
Почему мое приложение записывает 127.0.0.1 как IP-адрес каждого посетителя?
Потому что соединение, которое получает приложение, действительно исходит от nginx через loopback-интерфейс. Адрес посетителя доходит до приложения только в заголовке, который вы задаете: proxy_set_header X-Real-IP $remote_addr; для одного значения и proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; для добавления в цепочку. Приложение должно быть настроено на доверие этим заголовкам. Помните, что клиент может отправить свой собственный заголовок X-Forwarded-For, поэтому, если nginx является пограничным сервером, перезаписывайте его с помощью $remote_addr вместо добавления.
Нужен ли TLS для соединения между nginx и моим приложением?
Нет, если приложение запущено на том же сервере и привязано к 127.0.0.1, так как этот трафик не покидает пределы машины. Завершайте TLS на nginx, используйте proxy_pass по обычному HTTP через loopback и отправляйте X-Forwarded-Proto $scheme, чтобы приложение знало, что посетитель использовал HTTPS. Если бэкенд находится на другом хосте в сети, которую вы не контролируете, этот сегмент требует собственной защиты: либо HTTPS до бэкенда, либо создание частного туннеля между двумя машинами.