Урок 4 из 10Диагностика

12 мин · теория и практика · Основы

nginx: проверить и применить конфиг

Проверь синтаксис, эффективную конфигурацию и поведение после reload.

Сможешь внести одно изменение и убедиться, что оно действительно применилось.

Файл на диске и работающая конфигурация nginx могут различаться. Неприменённая правка ничего не меняет в трафике; синтаксически верная правка может маршрутизировать запросы неправильно. Нужны обе проверки.

Найди нужный server и location

nginx -T проверяет конфигурацию и выводит прочитанные файлы, включая include. Сопоставь listen, server_name, location и путь к upstream или статике с конкретным URL. Вывод может содержать чувствительные настройки.

Команды
sudo nginx -T

root дополняется URI запроса, а alias заменяет соответствующий location префикс. Для ошибки статики сравни итоговый путь с реальным файлом.

Сначала проверь синтаксис

После небольшой правки запусти nginx -t. При ошибке прочитай файл и номер строки, исправь и повтори проверку. Успешный тест не проверяет доступность backend или выполнение JavaScript в браузере.

Команды
sudo nginx -t
Пример вывода
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Сообщения и путь зависят от сборки. Важен успешный код завершения проверки.

Примени и повтори тот же запрос

nginx -s reload просит мастер-процесс перечитать конфигурацию. Новые worker-процессы принимают новые соединения, старые завершают обслуживание текущих. Проверь error.log и воспроизведи исходный запрос с тем же Host.

Команды
sudo nginx -t && sudo nginx -s reload
curl -sS -i --max-time 5 -H 'Host: shop.example.test' http://127.0.0.1/

Если результат неверный, сравни ожидаемое поведение с логами и откати конкретную правку при необходимости. Не меняй несколько несвязанных параметров одновременно.

Раздели проксирование и выдачу статики

Для 502 проверяй адрес upstream и доступность приложения. Для белого экрана со статусом 200 — HTML, URL assets и Content-Type. Одна и та же проверка nginx -t помогает не сломать синтаксис, но причины находятся в разных частях конфигурации.

Вмешательства делай по одной гипотезе: сохрани прежний фрагмент, измени нужный location или путь, проверь и примени. Сравнение до/после на одинаковом URL показывает эффект лучше, чем одновременная перестройка всех server-блоков.

Если nginx уже успешно читает конфигурацию, отсутствие синтаксической ошибки не исключает неверный upstream, root или alias.

От симптома к проверке

НаблюдениеСледующая проверкаКак читать результат
nginx -t failedНазванные файл и строкаСначала устрани ошибку проверки конфигурации.
nginx -t успешен, HTTP 502proxy_pass и прямой backendСинтаксис верен, но адрес или приложение могут быть неверны.
JS получает неверный MIMElocation, alias/root и файлПроверь реальный ресурс вместо отключения проверки браузера.

Типовые ошибки

  • Перезапустить весь сервер вместо небольшого проверенного reload.
  • Удалить include, не понимая, что он настраивает.
  • Считать существование файла доказательством его выдачи по нужному URL.

Как доказать восстановление

  1. Сохрани успешный nginx -t перед применением.
  2. Проверь reload и новые ошибки master/worker.
  3. Повтори одинаковый URL и Host до и после изменения.
  4. Для статики проверь браузер; для прокси — бизнес-запрос backend.

МИНИ-ИНЦИДЕНТ

Файл есть, но браузер его не исполняет

На диске есть новый JS, в HTML старое имя, а location /assets/ смотрит в прошлый релиз. Почему одной правки Content-Type недостаточно?

Данные для разбора
HTML: /assets/app-old.js
files: /srv/www/assets/app-new.js
location: /srv/previous-release/assets/
Разобрать ход диагностики

Нужно согласовать ссылку, путь выдачи и тип содержимого, затем проверить полученный ресурс и интерфейс. MIME-заголовок не создаёт отсутствующий файл и не меняет URL в HTML.

ПРАКТИКУМ

Практикум: объясни данные и выбери действие

Проверка синтаксиса успешна, но путь ассета попадает не в тот обработчик.

Учебные данные
GET /assets/bundle.js → 200 text/html
GET /api/orders       → 200 application/json
nginx -t              → successful
  1. Почему глобальное «nginx работает» слишком широко?

    Сверить рассуждение

    Разные пути обслуживаются разными location и backend. Успех API не проверяет выдачу статики, а синтаксис не устанавливает соответствие URL ожидаемому файлу.

  2. Что искать в effective configuration?

    Сверить рассуждение

    Нужный server по Host, правила location, root/alias, fallback и MIME. Сопоставляй их с точным URL запроса, включая относительный путь после выбранного location.

  3. Какая последовательность подтверждает исправление?

    Сверить рассуждение

    Синтаксис, применение конфигурации и GET нужного ресурса с проверкой тела и типа. Для JavaScript затем нужна загрузка страницы в браузере, потому что curl не исполняет приложение.

ПРОВЕРЬ СЕБЯ

nginx -t прошёл. Это доказывает, что сайт исправен?

Показать объяснение

Нет. Это проверка конфигурации, а не пользовательского сценария. После reload проверь ответ, ресурсы страницы и нужное действие в браузере.

Документация

Гостевой прогресс хранится отдельно в этом браузере.

ТЕПЕРЬ В КОНСОЛЬ

Закрепи на инциденте

Примени проверку конфигурации в кейсе с nginx или исследуй выдачу статики в кейсе с белым экраном.

ПОМОГЛО РАЗОБРАТЬСЯ?

Как тебе материал?

Оцени статью или напиши, где не хватило объяснения. Это поможет улучшить обучение.

Полезно 0 Не помогло 0

Войди, чтобы оценить статью и оставить комментарий.

Обсуждение

0

Войти в обсуждение →

Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.