Provision
—— XP

Конфиг nginx: сайт, location и проверка

теория~7 минут+140 XP

У nginx нет ни веб-панели, ни базы настроек: всё, что он знает о своих сайтах, написано в текстовых файлах в /etc/nginx. Это и есть конфиг nginx — на каком порту слушать, какие сайты обслуживать и что делать с каждым запросом. Любая работа с nginx сводится к трём действиям: поправить файл, проверить его командой nginx -t и применить командой reload.

Конфиг похож на табличку у входа в бизнес-центр: посетитель называет, к кому пришёл, а охранник по табличке показывает дорогу. Только здесь табличка написана для запросов — по какому имени пришли и какой путь просят. Цель урока — чтобы по любому запросу ты мог сам сказать, в какой блок конфига он попадёт и откуда возьмётся ответ.

Где лежат настройки

В Ubuntu пакет nginx раскладывает файлы так, чтобы каждый сайт жил в своём файле и его можно было включать и выключать, не трогая остальные.

Дерево каталога /etc/nginx: главный файл, conf.d, sites-available со всеми описаниями сайтов, sites-enabled с симлинками на включённые, snippets. Подсвечены enabled и симлинк.
Склад описаний и включённые ссылки на них — два разных каталога.

Главный файл nginx.conf ты почти никогда не правишь: он задаёт общие вещи и подключает остальные каталоги. Описания сайтов лежат в sites-available, но читает nginx только sites-enabled. Включить сайт — значит положить в sites-enabled символическую ссылку, то есть ярлык на файл из sites-available. Выключить — удалить ярлык, сам файл останется.

Каталог conf.d — для общих настроек, которые касаются всех сайтов сразу. А в snippets лежат готовые кусочки, которые подключают в сайт одной строкой; один из них пригодится в уроке про HTTPS. Найти нужный файл — половина дела: что сайт делает с запросами, решает то, что написано у него внутри.

Из чего состоит сайт

Описание одного сайта — это блок server в фигурных скобках. Начинается он с того, где принимать запросы и на какое имя откликаться.

/etc/nginx/sites-available/provision, начало
server {
    listen 80;                       # порт, на котором слушать
    server_name stand.provision.internal;  # имя сайта
    root /var/www/provision;         # каталог с файлами
    index index.html;                # файл по умолчанию

Строки внутри называются директивами: имя, значение и точка с запятой в конце. Забытая точка с запятой — самая частая опечатка, и nginx -t укажет на неё с номером строки. Директива root говорит, где на диске искать файлы: запрос /about.html превратится в файл /var/www/provision/about.html.

Дальше внутри server идут блоки location — правила для разных путей.

продолжение того же файла
    location = /health {             # ровно этот путь
        return 200 "ok";             # ответить, не трогая диск
    }

    location / {                     # всё остальное
        try_files $uri $uri/ =404;   # файл, каталог или 404
    }
}

Знак = означает точное совпадение: блок сработает только на /health. Директива return отвечает прямо из конфига, это удобно для проверки «жив ли сервер». А try_files пробует по очереди файл по пути запроса ($uri — так nginx называет путь), потом каталог, и если ничего нет — честно отдаёт 404. Целиком такой файл ты соберёшь в практике, а пока разберёмся, как nginx выбирает, какой блок сработает.

Как nginx выбирает сайт и location

На одном сервере обычно несколько сайтов, и все слушают один порт 80. nginx выбирает нужный за три шага.

Три шага сверху вниз: отобрать блоки по совпадению listen, среди них найти server_name по четырём видам совпадения от точного до регулярного выражения, и если совпадения нет — взять блок с пометкой default_server.
Сначала порт, потом имя, и только если имя не совпало — сервер по умолчанию.

Сначала nginx отбирает блоки, которые слушают порт запроса. Среди них ищет тот, чей server_name совпадает с именем из запроса: браузер присылает его в заголовке Host. Если совпадения нет, отвечает блок с пометкой default_server в строке listen. Именно поэтому после установки на любой адрес отвечает страница «Welcome to nginx»: у стандартного сайта default стоит эта пометка.

Внутри выбранного сайта так же выбирается location. Точное совпадение со знаком = выигрывает сразу. Среди обычных префиксов побеждает самый длинный: запрос /static/logo.png уйдёт в location /static/, а не в location /, где бы они ни стояли в файле. Есть ещё блоки с регулярными выражениями (~), но в первый месяц они тебе почти не понадобятся. Но правильный конфиг на диске ещё ничего не меняет, а неаккуратное применение может оборвать соединения у всех посетителей сразу.

Проверка и применение

Любая правка конфига проходит одну и ту же дорогу: проверить, затем применить. Проверяет сам nginx, флаг -t значит «test».

ubuntu@stand:~$
sudo nginx -t
ubuntu@stand:~$
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Две строки «syntax is ok» и «test is successful» — можно применять. При ошибке вместо них будет причина и место, например unexpected "}" in /etc/nginx/sites-enabled/provision:12: файл и номер строки. Применяют командой из раздела про systemd.

ubuntu@stand:~$
sudo systemctl reload nginx

Команда молчит, если всё хорошо. reload просит master перечитать конфиг: он запускает новые worker-процессы, а старые спокойно доделывают свои запросы. Пользователи ничего не замечают. restart же останавливает nginx целиком и рвёт все соединения — его оставляют для обновления самого пакета.

Если reload сделали, не проверив конфиг, и в нём ошибка, nginx откажется её применять и продолжит работать на старых настройках. На экране ты увидишь только короткое Job for nginx.service failed и совет заглянуть в systemctl status. Саму ошибку с файлом и строкой покажет журнал: sudo journalctl -u nginx -n 20, как в разделе про systemd. Поэтому привычка «сначала -t, потом reload» экономит время.

Словарь урока

директива
Строка конфига вида «имя значение;». Например, listen 80; или root /var/www;. ↩ к тексту
server
Блок с описанием одного сайта: порт, имя, каталог, правила для путей.
location
Блок внутри server с правилами для путей запроса, например для /static/ или /api/. ↩ к тексту
server_name
Имя, на которое откликается сайт. Сравнивается с заголовком Host из запроса.
default_server
Пометка в listen: этот сайт отвечает, если имя запроса не совпало ни с одним server_name.
символическая ссылка
Ярлык на файл. В sites-enabled лежат ярлыки на файлы из sites-available.
Конфигурация nginx: server и location
подборка на ютубе · ролик не закреплён
Если хочется увидеть, как правят конфиг вживую.

Что спросят на собеседовании

  • Как включить сайт в nginx на Ubuntu?
    Положить файл в sites-available, сделать символическую ссылку на него в sites-enabled, проверить nginx -t и выполнить systemctl reload nginx.
  • Открывается не тот сайт. Где искать?
    В server_name и default_server: если имя запроса не совпало ни с одним сайтом, ответит сервер по умолчанию. Посмотреть все listen и server_name сразу помогает nginx -T.
  • Зачем try_files в location /?
    Он пробует файл, каталог и только потом отдаёт запасной ответ, который выбираешь ты: =404 для обычного сайта или /index.html для приложения в браузере. Без него 404 тоже будет, но каждый такой запрос оставит строку в журнале ошибок.

Что дальше

Теории достаточно, чтобы написать свой сайт. В практике поставишь nginx, создашь страницу и проверишь каждый location по отдельности.

Проверь себя+140 XPдве попытки
1
Где лежат настройки
Файл сайта лежит в sites-available, но сайт не работает. Чего не хватает?
2
Как выбирается сайт
Запрос пришёл с именем, которого нет ни в одном server_name. Кто ответит?
3
location
Есть «location /» и «location /static/». Куда попадёт запрос /static/logo.png?
4
Проверка и применение
Чем reload лучше restart после правки конфига?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.