server_name в nginx: имена сайта и сервер по умолчанию

Как записывать имена

Звёздочка ставится только в начале или в конце имени и только у точки: имена вроде w*.example.com некорректны, для них нужно регулярное выражение. Регулярное выражение начинается со знака ~, точки в нём пишут как \.. Первое имя в списке nginx считает основным.

Если строки server_name в блоке нет, у блока пустое имя: он подходит к запросам без имени, например от программ, которые не передают заголовок Host.

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

Браузер передаёт имя сайта в запросе — в заголовке Host. Сначала nginx отбирает блоки server, которые слушают порт запроса, затем сравнивает имя с их server_name в таком порядке:

1. точное имя, например example.com;
2. самая длинная маска со звёздочкой в начале, например *.example.com;
3. самая длинная маска со звёздочкой в конце, например www.example.*;
4. первое подходящее регулярное выражение — по порядку в настройках.

Поиск останавливается на первом совпадении. Поэтому точное www.example.com в одном блоке победит маску *.example.com в другом, где бы эти блоки ни стояли.

Сервер по умолчанию

Если имя не подошло ни к одному блоку — сайт открыли по IP-адресу сервера или на сервер направлен чужой домен, — запрос получает сервер по умолчанию. Это блок, у которого в строке listen стоит default_server. Если такого блока нет, сервером по умолчанию становится первый блок server с этим портом в настройках.

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;
    ...
}

Так начинается стартовый сайт nginx в Ubuntu — файл /etc/nginx/sites-available/default. Пока ссылка на него есть в sites-enabled, на запросы по IP и по чужим именам отвечает стартовая страница nginx. В инструкции по размещению сайта эту ссылку убирают — тогда на такие запросы ответит первый по порядку из ваших сайтов.

default_server — свойство порта, а не имени, поэтому его пишут в строке listen. На одном порту сервер по умолчанию может быть только один: второй nginx не примет — ошибка a duplicate default server. Для порта 443 сервер по умолчанию свой: в Ubuntu его строки в файле default закомментированы, и для HTTPS им становится первый блок с listen 443 ssl.

Чтобы запросы по IP и на чужие имена не попадали в ваши сайты, заведите отдельный сервер по умолчанию с ответом 444 — как отсечь запросы по IP и на чужие имена и то же для HTTPS.

Какой блок сейчас сервер по умолчанию, покажет поиск по всем включённым сайтам:

grep -Rn 'default_server' /etc/nginx/sites-enabled/

Если в ответе пусто, сервер по умолчанию — первый блок server с этим портом. Порядок файлов покажет sudo nginx -T | grep -n '# configuration file'.

Ошибки и как их исправить