Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Nginx для разработчика и админа: статика, reverse proxy, HTTPS и где этому учиться

Nginx — веб-сервер, который принимает HTTP-запросы и по правилам из конфигурационного файла решает, что сделать с каждым из них: отдать файл с диска, передать запрос приложению на другом порту, перенаправить на HTTPS, взять ответ из кеша или распределить запросы между несколькими серверами. Разработчику он нужен, чтобы опубликовать фронтенд и API под одним доменом, администратору — чтобы держать на машине несколько сайтов и делить нагрузку. Освоить предстоит блоки server и location, проксирование, сертификаты, заголовки, сжатие и логи, а проверять работу — командами nginx -t и curl.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Nginx для разработчика и админа: статика, reverse proxy, HTTPS и где этому учиться

Знакомство с Nginx обычно начинается с ошибки. Приложение на React открывается, но после обновления страницы /profile выдаёт 404; API за прокси отвечает 502; после переезда на HTTPS приложение строит ссылки вида http://127.0.0.1:3000. Почти всегда виновата одна строка, скопированная из чужого примера: лишний слеш в proxy_pass, не тот location, забытый заголовок Host. Поэтому Nginx выгоднее изучать через устройство конфигурации — как сервер выбирает блок для запроса и что наследуется между уровнями.

Что делает Nginx и когда нужен другой инструмент

Nginx принимает соединение на порту из директивы listen, по заголовку Host находит блок server (виртуальный хост), внутри него выбирает location по пути запроса и выполняет то, что там написано: ищет файл в каталоге root, передаёт запрос через proxy_pass, возвращает редирект или код ошибки. Каждый запрос попадает в access-лог, проблемы — в error-лог. Фронтенд-разработчик так публикует SPA, бэкенд-разработчик ставит Nginx перед Gunicorn или Node.js, чтобы тот отдавал статику и держал TLS, администратор размещает несколько сайтов на одной машине.

Другой подход нужен не так уж редко. Статический сайт без своего сервера проще отдать через хостинг статики или CDN. В Kubernetes трафик принимает Ingress-контроллер: он может работать на Nginx, но настраивается манифестами, а не привычными файлами. А сервер целиком — пользователи, обновления, службы, резервные копии — это уже администрирование Linux, где Nginx лишь один из сервисов.

Как устроена конфигурация и что наследуется

Конфигурация — дерево вложенных блоков: http с общими настройками, в нём server для отдельных сайтов, в server — location для разных путей. Директивы верхнего уровня действуют и ниже, пока их не переопределили. Итоговую конфигурацию со всеми подключёнными файлами выводит nginx -T. Location выбирается так: сначала точное совпадение (location = /path), затем самый длинный префикс; если у префикса стоит ^~, поиск заканчивается, иначе Nginx проверяет регулярные выражения по порядку в файле. Поэтому блок location ~ .php$ может перехватить запрос, который вы ждали в префиксном блоке.

У наследования есть правило, о котором редко пишут в инструкциях. В документации модуля ngxhttpheaders_module сказано, что директивы addheader наследуются с предыдущего уровня тогда и только тогда, когда на текущем уровне нет ни одной своей addheader. Пример: в блоке server включён заголовок Strict-Transport-Security, а в location /assets/ вы добавили Cache-Control. У файлов из /assets/ HSTS исчезнет, хотя его никто не удалял. Вторая ловушка оттуда же: без параметра always заголовок добавляется только к ответам с кодами 200, 201, 204, 206, 301, 302, 303, 304, 307 и 308, а страницы ошибок уходят без него. В версии 1.29.3 появилась директива addheaderinherit: значение merge дописывает заголовки верхнего уровня к текущим. Она вошла в стабильную ветку 1.30, но в пакетах дистрибутивов часто стоят версии старше, так что сначала проверьте nginx -v. Без неё заголовки повторяют в каждом блоке или выносят в общий файл и подключают через include.

Учебный пример: SPA и API на одном домене

Ситуация учебная. Фронтенд на React собран в /var/www/app, API на Node.js слушает 127.0.0.1:3000, домен — app.example.ru. Адреса /api/ должны уходить в приложение, остальные — открывать интерфейс:

server {
    listen 443 ssl;
    server_name app.example.ru;
    ssl_certificate     /etc/letsencrypt/live/app.example.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/app.example.ru/privkey.pem;
    root /var/www/app;
    location / { try_files $uri $uri/ /index.html; }
    location /api/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Строка tryfiles снимает проблему 404: если файла нет, Nginx отдаёт index.html, и маршрут разбирает клиентский роутер. Тонкость proxypass описана в документации модуля ngxhttpproxy_module: если в адресе указан URI, хотя бы слеш в конце, совпавшая с location часть пути заменяется им. С http://127.0.0.1:3000/ запрос /api/users придёт в приложение как /users, без слеша — как /api/users. Host задают явно, потому что по умолчанию Nginx подставляет адрес из proxy_pass и приложение начинает строить ссылки на 127.0.0.1:3000.

Порт 80 закрывает отдельный блок server со строкой return 301 https://$host$requesturi;. Сертификат Let’s Encrypt удобно получать утилитой certbot, после чего стоит убедиться, что продление запланировано. Затем включают gzip для текстовых типов и долгий срок кеширования в браузере для файлов сборки с хешем в имени, но не для index.html, иначе после выкладки пользователи увидят старую версию. Если кешировать ответы API через proxycache, учтите правило из той же документации: ответ с заголовком Set-Cookie в кеш не попадает.

Несколько копий приложения перечисляют в блоке upstream. По умолчанию запросы идут по очереди, leastconn отправляет их туда, где меньше соединений, а maxfails и failtimeout временно исключают сервер, который перестал отвечать; активные проверки по расписанию есть только в коммерческой NGINX Plus. По журналу изменений ветки 1.30, с версии 1.29.7 постоянные соединения к бэкендам включены по умолчанию, а proxyhttp_version равен 1.1; в старых версиях это прописывают вручную.

В каком порядке осваивать Nginx

Порядок ниже повторяет путь запроса: сначала сервер должен ответить, потом ответить тем, чем нужно, и только затем безопасно и быстро. Логи стоят в самом начале, потому что без них все следующие ошибки придётся угадывать.

  1. Установка, systemctl, nginx -t и nginx -s reload, расположение логов.
  2. Один server с root, затем два сайта на одном IP с разными server_name.
  3. Выбор location, разница между root и alias, try_files.
  4. Обратный прокси: proxy_pass, заголовки, таймауты, ошибки 502 и 504.
  5. HTTPS, редирект с 80 на 443, HSTS — когда остальное уже работает.
  6. Сжатие, кеширование, наследование заголовков.
  7. Блок upstream и балансировка между двумя копиями приложения.

Упражнения и проверка результата

Для практики хватит виртуальной машины или недорогого VPS. Поднимите два сайта на одном сервере и проверьте каждый без правки DNS: curl --resolve app.example.ru:443:IP-адрес https://app.example.ru/ подставит нужный адрес. Затем запустите два экземпляра простого приложения на портах 3001 и 3002, выводите в ответе номер порта, убедитесь, что балансировка работает, остановите один экземпляр и прочитайте error-лог. Заголовки проверяйте через curl -I — так и обнаруживается пропавший HSTS. Строка connect() failed (111: Connection refused) при ошибке 502 означает, что приложение не слушает порт, а сам Nginx исправен.

Ошибки новичков повторяются. Перезагружают конфигурацию без nginx -t и теряют сайт из-за пропущенной точки с запятой. Путают root и alias: с root путь из location дописывается к каталогу, с alias заменяется им. Кладут файлы в домашний каталог, куда у рабочего процесса нет доступа, и получают 403. Включают HSTS с большим max-age раньше, чем HTTPS заработал на всех поддоменах, а браузеры запоминают это правило на весь срок.

Где учиться и что проверить в программе

Nginx неплохо осваивается самостоятельно; курс нужен, когда требуется наставник, который посмотрит конфигурацию, и стенд, который не жалко сломать. Узкий вариант для фронтенда — онлайн-курс Skillbox «Nginx для фронтенд-разработчика»: 23 часа практики, темы от раздачи статики до reverse proxy, HTTPS, кеширования, сжатия и логов, итоговый проект — SPA или статический сайт, где прямой переход по маршруту не даёт 404. Сведения о сроке обучения расходятся — уточните его у школы.

Открыть курс «Nginx для фронтенд-разработчика»

Перед оплатой любой программы проверьте, правите ли вы настоящие файлы конфигурации на своём стенде, смотрит ли куратор конфигурацию целиком, включая заголовки и логи, и есть ли задание с HTTPS на реальном домене.

Если Nginx нужен как часть администрирования сервера, подойдёт программа шире. На курсе Skillbox «Старт в DevOps: системное администрирование для начинающих» nginx назван среди инструментов, а веб-серверы, HTTPS и сборка окружения LAMP — среди тем; заявлены четыре месяца и 25 модулей. Kubernetes там нет, зато есть Linux, Bash и сети, без которых настройка веб-сервера быстро заходит в тупик.

Открыть курс «DevOps-инженер с нуля»

Разработчикам с опытом полезнее программа, где веб-сервер стоит рядом с контейнерами и оркестрацией, но там Nginx — одна из тем, а не центр.

На курсе Слёрма «Инструменты DevOps-инженера для разработчиков» 36 часов, из них 16 — практика на стендах школы, и один этап посвящён балансировке и оркестрации с Kubernetes, service mesh и Nginx. В описании Nginx упомянут одной строкой, объём темы лучше уточнить у школы. Требуются опыт коммерческой разработки, Git и базовый Linux.

Открыть курс

Как Nginx влияет на доход

Отдельной зарплаты «за Nginx» не бывает: навык входит в требования к DevOps-инженерам, администраторам, бэкенд- и фулстек-разработчикам. Сопоставимой российской статистики по нему в открытых источниках найти не удалось. Для ориентира есть британский IT Jobs Watch: за шесть месяцев до 24 августа 2026 года медиана годовой зарплаты в постоянных вакансиях Великобритании с упоминанием nginx — £66 250. Выборка маленькая, 26 объявлений с зарплатой из 37, поэтому цифра скорее иллюстрирует рынок. Показательнее другое: в 81 % этих вакансий рядом стоит Linux.

На практике навык влияет на доход через задачи, которые можно брать целиком: выложить проект, перевести сайт на HTTPS, разобрать ошибку 502 без администратора. Свой рынок оцените по вакансиям на hh.ru с фильтрами региона и опыта: берите только объявления с суммой, смотрите медиану и различайте зарплату до вычета налога и на руки.

Как выбрать школу и понять, что база есть

Для более широкой программы сравните школы по практике и обратной связи: в рейтинге онлайн-школ по DevOps и инфраструктуре собраны 18 школ всего направления, а не только курсы по Nginx, так что программу конкретного курса придётся читать самому.

Базы хватит, если вы без подсказок объясните, какой location обработает запрос /api/v1/users при трёх разных блоках, почему у части файлов пропал заголовок и что означает отказ в соединении в error-логе. Дальше навык растёт на собственных проектах.