Конфігурація reverse proxy nginx: proxy_pass і WebSocket
Налаштуйте reverse proxy nginx в Ubuntu 24.04: розберіть proxy_pass, 4 заголовки, WebSocket, кінцеві слеші та ліміти завантаження файлів.
Конфігурація reverse proxy nginx
Reverse proxy nginx приймає запити на портах 80 і 443 та передає кожен із них застосунку, який уже прослуховує локальний порт. Потім він повертає відповідь цього застосунку браузеру. Конфігурація складається з одного блоку server і є короткою. Майже вся складність міститься в п’яти або шести рядках. Вони повідомляють застосунку, хто був фактичним клієнтом і який протокол використав цей клієнт.
Усе нижче налаштовується з нуля на Ubuntu 24.04 з використанням пакета nginx із репозиторію дистрибутива. Вихідна умова — застосунок, який уже відповідає на 127.0.0.1:3000. Якщо ви ще не обрали reverse proxy, спочатку прочитайте порівняння 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, потім увімкніть цей block і завантажте конфігурацію.
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; прив’язує nginx до IPv4, а listen [::]:80; — до IPv6. Якщо вилучити другий рядок, усі IPv6-з’єднання із сервером буде відхилено. Браузер із підтримкою dual-stack, DNS (domain name system) якого повертає запис AAAA, зазвичай переходить на IPv4 і приховує проблему. Проте відвідувач із доступом лише до IPv6 або клієнт, який перевіряє тільки першу отриману адресу, бачить відмову в з’єднанні, тоді як для всіх користувачів IPv4 сайт працює. У повідомленні про помилку буде написано: "у мене працює".
server_name порівнюється із заголовком Host, який надсилає браузер. Можна вказати кілька імен, розділивши їх пробілами. Якщо жоден block не підходить, nginx використовує block, який є 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 із самого сервера, тому block можна перевірити ще до того, як DNS почне вказувати на нього.
Що nginx передає upstream, якщо більше нічого не вказати
proxy_pass окремо приховує від застосунку чотири параметри.
Пакет nginx 1.24.0, який постачається в Ubuntu 24.04, за замовчуванням використовує HTTP/1.0 для підключення до бекенду та надсилає Connection: close. Тому кожен запит відкриває нове upstream-з’єднання, а оновлення протоколу неможливе. У nginx 1.29.7, випущеному в March 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 прийняв з’єднання. Застосунки читають його для власних журналів доступу та власного обмеження швидкості запитів.
X-Forwarded-For містить список. $proxy_add_x_forwarded_for додає $remote_addr до значення, яке клієнт уже передав у цьому заголовку. Тому значення розділене комами, а запис, доданий вашим nginx, є останнім. Це визначає, чи можна довіряти заголовку. Клієнт може надіслати будь-яке X-Forwarded-For, тому застосунку, який читає перший запис, можна повідомити будь-яку адресу. Якщо nginx є edge-сервером, натомість запишіть $remote_addr і відкиньте версію клієнта. Якщо перед nginx розташовано CDN або інший проксі, використовуйте set_real_ip_from і real_ip_header з модуля realip, щоб $remote_addr містив справжню адресу клієнта.
X-Forwarded-Proto містить http або https. Фреймворки читають його, щоб визначити, чи потрібно позначати cookie як Secure і чи слід примусово перенаправляти на HTTPS. Якщо не передати його на сайті з TLS, застосунок, налаштований на примусове використання HTTPS, бачить http, відповідає перенаправленням на HTTPS-адресу, отримує наступний запит через nginx, знову бачить http і знову виконує перенаправлення. Браузер припиняє спроби та показує ERR_TOO_MANY_REDIRECTS.
Повторення цих чотирьох рядків у кожному location призводить до розбіжностей між ними. Розмістіть їх в одному файлі та підключіть його.
# /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 block, лише якщо в цьому location не визначено жодної власної директиви. Додайте один proxy_set_header усередині location — і всі заголовки, визначені на рівні server, буде вилучено для цього location. Тому зберігайте їх на одному рівні або include фрагмент у кожному location, який прокситиме запити.
Чому мій WebSocket-застосунок підключається, а потім розриває з’єднання?
Тому що значення за замовчуванням забороняють upgrade, а стандартний timeout читання закриває неактивний тунель через 60 секунд. WebSocket починає роботу як HTTP-запит із заголовками Upgrade: websocket і Connection: Upgrade. Це hop-by-hop заголовки. Проксі має обробити їх, а не передати далі. Крім того, у nginx 1.24.0 з Ubuntu 24.04 протокол upstream за замовчуванням — HTTP/1.0, який взагалі не підтримує механізм upgrade. Обидва параметри потрібно додати вручну.
Блок 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;
}Блок map потрібен, щоб один location обробляв обидва типи трафіку. Для звичайного запиту $http_upgrade порожній, тому $connection_upgrade отримує значення close. Для запиту upgrade він містить 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 частіше ніж раз на хвилину, цього не помічають. Застосунки без heartbeat припиняють роботу рівно через хвилину. Найчастіше це помітно в live-редакторах і dashboard-застосунках; поширений приклад — self-hosted n8n instance за 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.
Потрібна форма залежить від застосунку. Застосунок із налаштуванням base-path або sub-folder потребує другої форми; у цьому налаштуванні потрібно вказати /app. Застосунку, який нічого не знає про префікси, потрібна перша форма. Її недолік видно одразу: HTML, який повертає застосунок, усе ще містить абсолютні шляхи, наприклад /static/main.css, тому браузер запитує їх у корені сайту, жоден location не відповідає цим запитам, і сторінка відображається без стилів. На вкладці мережевих запитів у браузері такі запити до ресурсів мають статус 404. Виправленням є власне налаштування base-path у застосунку або другий 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 неактивних з’єднань із бекендами відкритими для кожного worker process. Це усуває TCP handshake для більшості запитів. В Ubuntu 24.04 з версією 1.24.0 саме цей рядок вмикає кеш. Починаючи з nginx 1.29.7, кеш увімкнено за замовчуванням, але задокументоване значення за замовчуванням — keepalive 32 local;, а параметр local забороняє спільне використання кешованих з’єднань між різними location. Тому в nginx 1.29.7 і новіших версіях окремий keepalive 32; не просто повторює значення за замовчуванням: якщо не вказати local, будь-який location, що проксує запити на той самий upstream server, зможе повторно використовувати з’єднання з пулу. Це відрізняється від поведінки за замовчуванням. У цих версіях залиште цей рядок без змін або вкажіть keepalive 32 local;, щоб зберегти значення за замовчуванням. Записуйте його без параметрів лише тоді, коли потрібне таке спільне використання. Параметр local з’явився в nginx 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 map, замініть порожнє значення 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 network пошук можна виконувати під час обробки запиту за допомогою вбудованого resolver.
resolver 127.0.0.11 valid=10s;
set $backend http://app:3000;
proxy_pass $backend;Якщо контейнери достатньо часто запускаються та зупиняються, і вам доводиться постійно редагувати nginx, краще використати proxy, який читає labels контейнерів. Traefik перед кількома застосунками Docker Compose будує маршрути на основі самих контейнерів.
Чому завантаження завершуються помилкою 413 Request Entity Too Large?
client_max_body_size за замовчуванням становить 1 megabyte. nginx відхиляє більший body запиту з помилкою 413, а в журналі помилок записує client intended to send too large body. Збільште це значення в server block або в location, де виконуються завантаження.
client_max_body_size 512m;Значення 0 повністю вимикає перевірку. Якщо задано 512m, nginx усе одно відхиляє body запиту, розмір якого перевищує цей ліміт. Тому помилка 413, яка зберігається після цієї зміни, не вказує на backend як на джерело проблеми. Перевірте фактичне значення client_max_body_size у location, що обробляє завантаження, і журнал помилок nginx, перш ніж перевіряти власний ліміт завантаження застосунку.
За замовчуванням nginx зчитує весь body запиту до відкриття upstream-з’єднання. Великі дані спочатку записуються в тимчасовий файл на диску. Це захищає застосунок від повільних клієнтів, оскільки backend отримує завантаження з повною локальною швидкістю. Для дуже великих завантажень можна використовувати потокову передачу.
proxy_request_buffering off;Для chunked-завантажень через HTTP/1.1 у пакеті 1.24.0 також задайте proxy_http_version 1.1; у цьому location. Інакше nginx і далі буферизуватиме body. Backend отримує body у міру надходження і має вміти його обробляти. Після початку передавання body до upstream nginx не може повторити запит до іншого upstream.
client_body_timeout, що за замовчуванням становить 60 seconds, застосовується до інтервалу між двома послідовними зчитуваннями body, а не до всього завантаження. Повільне, але безперервне завантаження не переривається. Якщо передавання зупиняється, з’єднання розривається.
Буферизація відповіді та параметр, який порушує виведення в реальному часі
proxy_buffering увімкнено за замовчуванням, і зазвичай це саме те, що потрібно. nginx читає відповідь від застосунку з максимально можливою для нього швидкістю, зберігає її та передає повільному клієнту з темпом, який відповідає цьому клієнту. Worker застосунку завершує роботу раніше, замість того щоб залишатися зайнятим протягом усього повільного завантаження.
Це порушує потокову передачу відповідей. Server-sent events і виведення журналу в реальному часі нічого не показують читачеві, доки буфер не заповниться. Вимикайте буферизацію лише в цій location.
proxy_buffering off;Якщо ви керуєте застосунком, краще додавати заголовок X-Accel-Buffering: no лише до потокових відповідей. nginx читає цей заголовок для кожної відповіді та вимикає буферизацію тільки для неї, тому звичайні сторінки зберігають переваги буферизації.
Якщо в журналі помилок з’являється upstream sent too big header while reading response header from upstream, заголовки відповіді не вмістилися в один буфер. proxy_buffer_size за замовчуванням дорівнює одній сторінці пам’яті — 4 або 8 кілобайт залежно від платформи, — а довгі cookies або великі заголовки автентифікації можуть переповнити цей буфер. Збільште обидва значення.
proxy_buffer_size 16k;
proxy_buffers 8 16k;Де в цій конфігурації має бути TLS?
У nginx, перед усіма описаними вище компонентами. TLS (захист транспортного рівня) завершується на проксі, а з’єднання від nginx до застосунку залишається звичайним HTTP через loopback-адресу. Інші пристрої в мережі не можуть його прочитати. Застосунок дізнається, що відвідувач використовував HTTPS, із X-Forwarded-Proto — четвертого з чотирьох заголовків.
Не вказуйте шляхи до сертифікатів вручну. Спрямуйте DNS-запис на сервер, відкрийте порт у firewall і дозвольте 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 upgrade взагалі не відбудеться, тому застосунок перейде на polling або не показуватиме оновлення в реальному часі.
Чи має значення кінцевий слеш у proxy_pass?
Так. Він змінює шлях, який отримує бекенд. За наявності location /app/ і proxy_pass http://127.0.0.1:3000/ запит до /app/status надходить на бекенд як /status, оскільки будь-який URI після хоста й порту замінює префікс location, що збігся. Якщо прибрати кінцевий слеш, той самий запит надходить як /app/status. Видалення префікса часто порушує власні посилання застосунку на ресурси. Вони залишаються абсолютними, а потім повертають 404 у корені сайту. Тому для застосунку з налаштуванням base-path краще використовувати форму, яка передає шлях без змін.
Чому мій застосунок записує 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 є edge-сервером, замінюйте його значення на $remote_addr, а не додавайте нове.
Чи потрібен TLS для з’єднання між nginx і моїм застосунком?
Ні, якщо застосунок працює на тому самому сервері та прив’язаний до 127.0.0.1, оскільки такий трафік не залишає машину. Завершуйте TLS на nginx, використовуйте proxy_pass через звичайний HTTP по loopback і передавайте X-Forwarded-Proto $scheme, щоб застосунок знав, що відвідувач використовував HTTPS. Якщо бекенд розташований на іншому хості, а мережа між ними не перебуває під вашим контролем, цей сегмент потрібно окремо захистити: використовуйте HTTPS до бекенду або приватний тунель між двома машинами.