У nginx нет ни веб-панели, ни базы настроек: всё, что он знает о своих сайтах, написано в текстовых файлах в /etc/nginx. Это и есть конфиг nginx — на каком порту слушать, какие сайты обслуживать и что делать с каждым запросом. Любая работа с nginx сводится к трём действиям: поправить файл, проверить его командой nginx -t и применить командой reload.
Конфиг похож на табличку у входа в бизнес-центр: посетитель называет, к кому пришёл, а охранник по табличке показывает дорогу. Только здесь табличка написана для запросов — по какому имени пришли и какой путь просят. Цель урока — чтобы по любому запросу ты мог сам сказать, в какой блок конфига он попадёт и откуда возьмётся ответ.
Где лежат настройки
В Ubuntu пакет nginx раскладывает файлы так, чтобы каждый сайт жил в своём файле и его можно было включать и выключать, не трогая остальные.
Главный файл nginx.conf ты почти никогда не правишь: он задаёт общие вещи и подключает остальные каталоги. Описания сайтов лежат в sites-available, но читает nginx только sites-enabled. Включить сайт — значит положить в sites-enabled символическую ссылку, то есть ярлык на файл из sites-available. Выключить — удалить ярлык, сам файл останется.
Каталог conf.d — для общих настроек, которые касаются всех сайтов сразу. А в snippets лежат готовые кусочки, которые подключают в сайт одной строкой; один из них пригодится в уроке про HTTPS. Найти нужный файл — половина дела: что сайт делает с запросами, решает то, что написано у него внутри.
Из чего состоит сайт
Описание одного сайта — это блок server в фигурных скобках. Начинается он с того, где принимать запросы и на какое имя откликаться.
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 выбирает нужный за три шага.
Сначала nginx отбирает блоки, которые слушают порт запроса. Среди них ищет тот, чей server_name совпадает с именем из запроса: браузер присылает его в заголовке Host. Если совпадения нет, отвечает блок с пометкой default_server в строке listen. Именно поэтому после установки на любой адрес отвечает страница «Welcome to nginx»: у стандартного сайта default стоит эта пометка.
Внутри выбранного сайта так же выбирается location. Точное совпадение со знаком = выигрывает сразу. Среди обычных префиксов побеждает самый длинный: запрос /static/logo.png уйдёт в location /static/, а не в location /, где бы они ни стояли в файле. Есть ещё блоки с регулярными выражениями (~), но в первый месяц они тебе почти не понадобятся. Но правильный конфиг на диске ещё ничего не меняет, а неаккуратное применение может оборвать соединения у всех посетителей сразу.
Проверка и применение
Любая правка конфига проходит одну и ту же дорогу: проверить, затем применить. Проверяет сам nginx, флаг -t значит «test».
sudo nginx -tnginx: 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.
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» экономит время.
Словарь урока
Что спросят на собеседовании
- Как включить сайт в 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 по отдельности.