Skip to content
VDS · Сайти та вебсервери

Зворотний проксі: кілька застосунків на одній адресі

Як розділити одну публічну адресу 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 не потребують шифрування — вони ніколи не залишають машину.