Зворотний проксі: кілька застосунків на одній адресі
Як розділити одну публічну адресу VDS між кількома застосунками за доменами та шляхами, правильно передавати заголовки й не зламати WebSocket.
Оновлено 23 серпня 2026 р.
Одна машина має одну публічну IPv4-адресу, але зазвичай запускає кілька застосунків. Реверс-проксі приймає всі запити на портах 80 і 443 та спрямовує їх до внутрішніх сервісів за доменним іменем або шляхом. Він також зберігає єдиний сертифікат і спільні логи.
Схема
Кожен застосунок слухає власний локальний порт і лише на 127.0.0.1:
- фронтенд-сайт —
127.0.0.1:3000; - API —
127.0.0.1:8000; - панель моніторингу —
127.0.0.1:9090.
Назовні відкритий лише Nginx. Щоб перевірити, чи не відкритий застосунок напряму:
ss -tulpn | grep LISTEN
Рядки на кшталт 0.0.0.0:3000 означають, що сервіс доступний з інтернету, оминаючи проксі та без шифрування.
За доменом
server {
listen 80;
server_name app.example.ru;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
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;
}
}
server {
listen 80;
server_name api.example.ru;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Без X-Forwarded-For застосунок бачить кожен запит як такий, що надійшов з 127.0.0.1, і будь-які обмеження за IP перестають працювати.
За шляхом
location /api/ {
proxy_pass http://127.0.0.1:8000/;
}
Завершальний слеш у proxy_pass тут має значення: з ним префікс /api відкидається і застосунок отримує /users; без нього він отримує /api/users. Половина всіх «загадкових 404» на проксі виникає саме через це.
WebSocket і довгі відповіді
location /ws/ {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 3600s;
}
Без пари Upgrade/Connection з'єднання розривається одразу після рукостискання; без збільшеного таймауту воно розривається після хвилини тиші.
Типові помилки
| Симптом | Причина |
|---|---|
502 Bad Gateway | Застосунок не запущений або слухає інший порт |
504 Gateway Time-out | Застосунок відповідає довше, ніж proxy_read_timeout |
| Нескінченне перенаправлення | Застосунок не знає про HTTPS — передайте X-Forwarded-Proto |
| Завантаження файлів ламається | client_max_body_size замалий; типове значення — 1 MB |
| Та сама IP у логах застосунку | X-Forwarded-For не передається |
Далі: кілька сайтів, сертифікат, Caddy з автоматичним HTTPS.
Один сертифікат на проксі покриває всі застосунки за ним. Внутрішні з'єднання через
127.0.0.1не потребують шифрування — вони ніколи не залишають машину.