Материалы с тегом «proxy» ⋆ Clip-Clap Практические инструкции по Windows, Linux, 1С, сетям, серверам, смартфонам и технике: диагностика ошибок, настройка и безопасные решения. Fri, 02 Oct 2026 16:08:57 +0000 ru-RU hourly 1 https://wordpress.org/?v=7.1.4 https://clip-clap.ru/wp-content/uploads/2026/10/cropped-clip-clap-mark-512x512-1-32x32.png Материалы с тегом «proxy» ⋆ Clip-Clap 32 32 Reverse proxy на Nginx: базовая настройка, HTTPS и заголовки https://clip-clap.ru/it/%d1%81%d0%be%d1%84%d1%82-%d0%b8-%d0%be%d1%81/linux/%d0%bd%d0%b0%d1%81%d1%82%d1%80%d0%be%d0%b9%d0%ba%d0%b0-%d0%bf%d1%80%d0%be%d0%ba%d1%81%d0%b8-nginx/ https://clip-clap.ru/it/%d1%81%d0%be%d1%84%d1%82-%d0%b8-%d0%be%d1%81/linux/%d0%bd%d0%b0%d1%81%d1%82%d1%80%d0%be%d0%b9%d0%ba%d0%b0-%d0%bf%d1%80%d0%be%d0%ba%d1%81%d0%b8-nginx/#respond Sat, 05 Dec 2020 22:57:28 +0000 https://clip-clap.ru/?p=3135 Практическая настройка reverse proxy на Nginx: proxy_pass, Host, X-Forwarded-For, HTTPS, WebSocket и проверка конфигурации перед reload.

Сообщение Reverse proxy на Nginx: базовая настройка, HTTPS и заголовки появились сначала на Clip-Clap.

]]>
Nginx часто используют как reverse proxy: клиент подключается к Nginx, а тот передаёт запрос внутреннему приложению — например, панели управления, контейнеру или веб-сервису на другом порту.

Минимальный server block

server {
    listen 80;
    server_name app.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        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;
    }
}

Адрес в proxy_pass должен указывать на реальный backend. Не публикуйте внутренний сервис наружу отдельным портом, если доступ к нему должен идти только через прокси.

Архивный пример: Nginx перед Apache

В исходной статье Nginx ставился перед Apache, который слушал внутренний порт 8080. Сегодня backend может быть чем угодно — контейнером, Node.js, PHP-FPM или другой службой — но сама идея reverse proxy остаётся той же. Скриншоты ниже сохраняю как исторический практический пример, а не как обязательную современную схему.

Архивный пример Apache backend на внутреннем порту перед Nginx
Архивная конфигурация Nginx proxy_pass и proxy headers
Проверка работы Nginx reverse proxy перед Apache в старом примере

Проверяйте конфигурацию перед применением

sudo nginx -t
sudo systemctl reload nginx

Сначала nginx -t. Reload выполняйте только после успешной проверки синтаксиса — это снижает риск положить уже работающие сайты из-за опечатки.

HTTPS

Для публичного сайта используйте TLS-сертификат и перенаправление HTTP на HTTPS. Сертификат должен соответствовать имени, по которому пользователи открывают сервис. Автоматизируйте продление и контролируйте срок действия.

WebSocket

Некоторым приложениям нужны дополнительные заголовки Upgrade/Connection. Добавляйте их только там, где backend действительно использует WebSocket, а не копируйте огромный универсальный конфиг без понимания.

Если получаете 502 Bad Gateway

  • проверьте, запущен ли backend;
  • проверьте адрес и порт proxy_pass;
  • выполните запрос к backend локально через curl;
  • посмотрите error log Nginx;
  • проверьте firewall, SELinux/AppArmor и контейнерную сеть, если они используются.

Reverse proxy лучше строить от простого рабочего конфига и добавлять кэширование, лимиты, WebSocket и дополнительные политики только по необходимости.

Сообщение Reverse proxy на Nginx: базовая настройка, HTTPS и заголовки появились сначала на Clip-Clap.

]]>
https://clip-clap.ru/it/%d1%81%d0%be%d1%84%d1%82-%d0%b8-%d0%be%d1%81/linux/%d0%bd%d0%b0%d1%81%d1%82%d1%80%d0%be%d0%b9%d0%ba%d0%b0-%d0%bf%d1%80%d0%be%d0%ba%d1%81%d0%b8-nginx/feed/ 0
Nginx proxy_pass: правильное проксирование, URI, заголовки и WebSocket https://clip-clap.ru/it/%d1%81%d0%be%d1%84%d1%82-%d0%b8-%d0%be%d1%81/linux/%d0%bf%d1%80%d0%be%d0%ba%d1%81%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d0%b5-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%be%d0%b2-%d0%b2-nginx-%d1%81-%d0%bf%d0%be%d0%bc%d0%be%d1%89%d1%8c%d1%8e-proxy_pas/ https://clip-clap.ru/it/%d1%81%d0%be%d1%84%d1%82-%d0%b8-%d0%be%d1%81/linux/%d0%bf%d1%80%d0%be%d0%ba%d1%81%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d0%b5-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%be%d0%b2-%d0%b2-nginx-%d1%81-%d0%bf%d0%be%d0%bc%d0%be%d1%89%d1%8c%d1%8e-proxy_pas/#respond Fri, 17 Jul 2020 22:28:24 +0000 https://clip-clap.ru/?p=1088 Как работает proxy_pass в Nginx, чем отличается адрес с завершающим слешем, как передавать реальный IP, HTTPS-схему и WebSocket.

Сообщение Nginx proxy_pass: правильное проксирование, URI, заголовки и WebSocket появились сначала на Clip-Clap.

]]>
proxy_pass выглядит просто, но одна из самых частых ошибок Nginx — неверное понимание того, как меняется URI при наличии или отсутствии завершающего слеша.

Простой reverse proxy

location /api/ {
    proxy_pass http://127.0.0.1:8080;
}

В таком варианте исходный URI передаётся backend почти как есть.

proxy_pass с URI

location /api/ {
    proxy_pass http://127.0.0.1:8080/;
}

Здесь часть URI, совпавшая с location, заменяется URI из proxy_pass. Именно из-за этой разницы часто появляются двойные или потерянные префиксы.

Передаём исходный Host и IP

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;

Backend должен доверять этим заголовкам только от вашего reverse proxy, иначе клиент сможет подделать исходный IP.

WebSocket

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

location /socket/ {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_pass http://127.0.0.1:3000;
}

HTTPS до backend

Если upstream использует HTTPS, не отключайте проверку сертификата просто ради устранения ошибки. Настройте доверенный CA и SNI, если backend ожидает имя хоста.

Таймауты

Не увеличивайте proxy_read_timeout до огромных значений как универсальное решение. Сначала выясните, почему backend отвечает долго.

Проверка

nginx -t
systemctl reload nginx
curl -I https://example.com/api/

Сообщение Nginx proxy_pass: правильное проксирование, URI, заголовки и WebSocket появились сначала на Clip-Clap.

]]>
https://clip-clap.ru/it/%d1%81%d0%be%d1%84%d1%82-%d0%b8-%d0%be%d1%81/linux/%d0%bf%d1%80%d0%be%d0%ba%d1%81%d0%b8%d1%80%d0%be%d0%b2%d0%b0%d0%bd%d0%b8%d0%b5-%d0%b7%d0%b0%d0%bf%d1%80%d0%be%d1%81%d0%be%d0%b2-%d0%b2-nginx-%d1%81-%d0%bf%d0%be%d0%bc%d0%be%d1%89%d1%8c%d1%8e-proxy_pas/feed/ 0