Настройки nginx: где лежат и как их менять

Как устроены файлы

Править файл сайта нужно в sites-available: в sites-enabled лежит только ссылка на него. Как создать файл сайта и включить его ссылкой — раздел «4. Опишите сайт в настройках nginx» инструкции по размещению сайта.

Блоки http, server и location

Настройки состоят из директив. Простая директива — имя, значения и точка с запятой в конце: worker_processes auto;. Блочная вместо точки с запятой содержит фигурные скобки, а в них — другие директивы. Всё, что стоит после знака # до конца строки, — комментарий: nginx его не читает.

Так устроен nginx.conf в Ubuntu 24.04, если оставить главные строки:

user www-data;
worker_processes auto;

events {
    worker_connections 768;
}

http {
    sendfile on;
    access_log /var/log/nginx/access.log;
    gzip on;

    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-enabled/*;
}

Последняя строка подставляет файлы сайтов внутрь блока http. Поэтому в файле сайта блока http нет — он начинается сразу с server:

server {
    listen 80;
    server_name example.com www.example.com;
    root /var/www/example.com;
    index index.html;

    # все адреса сайта
    location / {
        try_files $uri $uri/ =404;
    }

    # только адреса, которые начинаются с /images/
    location /images/ {
        expires 30d;
    }
}

Блок server описывает один сайт: на каком порту он принимает запросы — listen — и на какие имена отвечает — server_name. Блоки location внутри задают правила для части адресов сайта.

Где какую директиву можно писать

В справке nginx у каждой директивы есть строка «Контекст» — список блоков, где её можно писать. У gzip, например, это http, server, location и if в location. Если поставить директиву в другой блок, sudo nginx -t ответит directive is not allowed here — разбор ошибки.

Как наследуются настройки

Директива, заданная в http, действует во всех блоках server, а заданная в server — во всех его location. Если во внутреннем блоке написать ту же директиву, для этого блока действует она:

http {
    gzip on;              # сжатие для всех сайтов

    server {
        location /download/ {
            gzip off;     # здесь сжатия нет
        }
    }
}

Ловушка — директивы, которые пишут по нескольку строк подряд: add_header и proxy_set_header. Внешние строки работают во внутреннем блоке, только если в нём нет ни одной своей такой строки. Добавили в location один свой add_header — заголовки из server для этого location пропали. Как с этим быть — add_header в nginx.

Главные директивы

Как посмотреть все настройки сразу

Настройки разбросаны по нескольким файлам. Эта команда проверяет их и печатает все подряд — каждый файл начинается строкой # configuration file и путём к нему:

sudo nginx -T | less

Листать — стрелками и пробелом. Искать — клавиша /, затем слово и Enter. Выйти — клавиша Q.

Найти директиву сразу во всех сайтах:

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

В ответе — файл, номер строки и сама строка. Ключ -R нужен потому, что в sites-enabled лежат ссылки: с ключом -r grep в них не заходит и ничего не находит. Подробнее — команда grep.

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