Короткий ответ: где лежит конфиг Nginx
В пакетной установке Debian и Ubuntu главный файл конфигурации Nginx — /etc/nginx/nginx.conf. Это подтверждается и выводом проверки: nginx: the configuration file /etc/nginx/nginx.conf syntax is ok. Для RHEL, Rocky Linux, AlmaLinux, Fedora и Alpine в рамках этого материала путь /etc/nginx/nginx.conf не подтверждён первичными источниками, поэтому перед правкой проверяйте фактический файл командами ниже.
В Debian и Ubuntu стандартный /etc/nginx/nginx.conf содержит директивы include, из-за которых сайты включаются и отключаются через sites-enabled и conf.d. Обычно подключаются /etc/nginx/conf.d/*.conf и /etc/nginx/sites-enabled/*. Утверждение, что в RHEL, CentOS, Rocky Linux и AlmaLinux каталога sites-available нет, в рамках этого материала не подтверждено источниками — проверяйте состав каталога на конкретном сервере.
Если Nginx собран из исходников, путь задаёт флаг --prefix при ./configure. По умолчанию префикс — /usr/local/nginx, а файл конфигурации называется prefix/conf/nginx.conf, то есть /usr/local/nginx/conf/nginx.conf. Отдельно путь к конфигу переопределяет --conf-path.
Проверить фактический путь на своей машине быстрее, чем сверяться со статьёй:
sudo nginx -t nginx -V 2>&1 | tr ' ' '\n' | grep -- --conf-path
Первая команда печатает файл, который проверяет бинарник из PATH. Вторая показывает путь, зашитый при сборке. Редактируйте только тот файл, который подтвердился одной из проверок, иначе получите типовую ситуацию «правлю, а результата нет».
Первоисточники по параметрам сборки и командной строки: Building nginx from Sources и Command-line parameters.
Как найти актуальный путь к конфигу на работающем сервере
Разные способы отвечают на разные вопросы. nginx -t говорит, какой файл проверяет конкретный бинарник. nginx -V показывает, что зашито при сборке. На нестандартной установке ответы могут расходиться, и это нормально.
Начните с того, какой бинарник вызывается из оболочки:
which nginx type -a nginx
Если в выводе два пути, например /usr/sbin/nginx и /usr/local/nginx/sbin/nginx, разбираться придётся с каждым отдельно.
nginx -t: проверка синтаксиса и заодно путь к файлу
Команда проверяет конфигурацию на корректность синтаксиса и пытается открыть указанные в ней файлы, при этом не перезагружает сервер. Вывод выглядит примерно так:
sudo nginx -t nginx: the configuration file /etc/nginx/nginx.conf syntax is ok nginx: configuration file /etc/nginx/nginx.conf test is successful
Строка «configuration file ... test is successful» и есть адрес файла, который читает этот бинарник. Если он не совпадает с тем, что вы правите, дальше можно не искать причину: правка ушла в файл, который сервер не открывает.
Полезное дополнение: nginx -T делает то же, что -t, и дополнительно выводит конфигурационные файлы в стандартный вывод. Именно этот вывод показывает, какие файлы реально попали в конфиг и в каком порядке.
sudo nginx -T | less sudo nginx -T | grep -n server_name
На сервере с десятком сайтов последний вариант экономит минуты: видно каждый server_name и файл, откуда он пришёл. Поведение флагов -t и -T зафиксировано в официальной документации по параметрам командной строки.
nginx -V: что показывает бинарник
nginx -V печатает версию nginx, версию компилятора и параметры конфигурации, включая --prefix и --conf-path. Это данные времени сборки, к текущему запущенному процессу они относятся только косвенно.
nginx -V 2>&1 | tr ' ' '\n' | grep -E -- '--conf-path|--prefix'
Пример вывода с параметрами сборки: --prefix=/usr/share/nginx и --conf-path=/etc/nginx/nginx.conf. У самосборной версии значения другие, например --prefix=/usr/local/nginx.
Если в аргументах запуска есть флаг -c, он перекрывает значение --conf-path из сборки: nginx -c /srv/myapp/nginx.conf читает именно указанный файл. Проверить аргументы запуска можно через systemd-юнит: sudo systemctl cat nginx — в строке ExecStart может стоять свой путь.
- Несколько бинарников: пакетный Nginx и самосборный в /usr/local/nginx могут жить одновременно и слушать разные порты.
- systemd-юнит с параметром -c: проверьте sudo systemctl cat nginx, в строке ExecStart может стоять свой путь.
- Alias в оболочке: type -a nginx показывает, что на самом деле вызывается.
Структура каталога /etc/nginx: что где лежит
Карта типового каталога после установки пакета в Debian и Ubuntu:
/etc/nginx/ nginx.conf conf.d/ sites-available/ Debian и Ubuntu sites-enabled/ Debian и Ubuntu snippets/ Debian, Ubuntu и часть других сборок mime.types fastcgi_params uwsgi_params scgi_params koi-utf, koi-win, win-utf
- nginx.conf: главный файл с блоками events и http, глобальными директивами и строками include.
- conf.d/: дополнительные файлы *.conf, подключаемые на уровне http. Здесь держат server-блоки и общие настройки.
- sites-available/: хранилище доступных конфигов сайтов в Debian и Ubuntu. Файлы отсюда не читаются, пока на них нет симлинка.
- sites-enabled/: каталог с симлинками на включённые конфиги из sites-available.
- snippets/: переиспользуемые фрагменты, например ssl-параметры или общие заголовки, подключаемые через include внутри server.
- mime.types: таблица соответствия расширений и MIME-типов, подключается директивой include mime.types.
- fastcgi_params, uwsgi_params, scgi_params: наборы параметров для соответствующих бэкендов, их подключают в location с fastcgi_pass, uwsgi_pass, scgi_pass.
- koi-utf, koi-win, win-utf: таблицы перекодировки. Исторические файлы, трогать их нужно редко.
MIME-типы влияют на то, как браузер обработает файл, а неверный тип даёт скачивание вместо отображения или блокировку стилей. Практика настройки статики с корректными типами, expires и Cache-Control разобрана в материале раздача статического контента через Nginx.
nginx.conf, conf.d и include: как файлы связываются между собой
Связь задаёт директива include с маской. В Debian и Ubuntu в nginx.conf обычно стоят строки:
include /etc/nginx/conf.d/*.conf; include /etc/nginx/sites-enabled/*;
Маска работает буквально. Файл /etc/nginx/conf.d/my.conf подключится, а /etc/nginx/conf.d/my.conf.bak, /etc/nginx/conf.d/my.conf.disabled и /etc/nginx/conf.d/backup/my.conf не попадут под шаблон *.conf и останутся мёртвым грузом. Отсюда половина случаев «создал конфиг, а сайт не появился».
include допустим на любом уровне: в http, в server, в location. Файл, подключённый внутри конкретного server, не влияет на остальные. Конфиг читается сверху вниз, содержимое подставляется в точке include, поэтому порядок файлов и блоков определяет, какой server-блок сработает при совпадении server_name.
sites-available и sites-enabled: механика симлинков
Схема из двух каталогов пришла из Debian и перешла в Ubuntu. Редактируют файл в sites-available, а включает его симлинк:
sudo ln -s /etc/nginx/sites-available/example.conf /etc/nginx/sites-enabled/example.conf ls -la /etc/nginx/sites-enabled/
Отключение делают удалением симлинка, а не самого файла: sudo rm /etc/nginx/sites-enabled/example.conf. Конфиг остаётся в sites-available и включается обратно одной командой. Если конфиг лежит в conf.d, отключить его можно переименованием файла так, чтобы он перестал оканчиваться на .conf. При переносе конфигов между дистрибутивами файл копируют, include не добавляют, и сайт молчит: конфиг лежит на диске и никем не прочитан.
Пути к конфигу по дистрибутивам: Debian/Ubuntu, RHEL/CentOS, Alpine, исходники
| Окружение | Главный конфиг | Дополнительные конфиги | Особенность |
|---|---|---|---|
| Debian, Ubuntu | /etc/nginx/nginx.conf | conf.d/, sites-enabled/ | sites-available плюс симлинки, пакет apt, юнит nginx.service |
| RHEL, CentOS, Rocky, Alma | проверяйте на сервере | проверяйте на сервере | пакет dnf или yum |
| Alpine | проверяйте на сервере | проверяйте на сервере | пакет apk, часто внутри контейнера |
| Сборка из исходников | задаётся --prefix, по умолчанию /usr/local/nginx/conf/nginx.conf | зависит от nginx.conf | --conf-path переопределяет путь отдельно |
| Контейнер | проверяйте внутри образа | проверяйте внутри образа | может быть перекрыт bind mount или ConfigMap |
Инвентаризация файлов пакета закрывает вопрос, какие файлы вообще поставил менеджер пакетов:
dpkg -L nginx | grep -E 'nginx.conf|conf.d' rpm -ql nginx | grep nginx.conf apk info -L nginx | grep nginx.conf
Вывод покажет полный список путей из пакета. Всё, чего в нём нет, добавлено руками, конфигурационным менеджером или другим пакетом.
Сборка из исходников: как --prefix определяет путь
При компиляции ./configure --prefix=/usr/local/nginx задаёт префикс пути nginx, то есть каталог, в котором находятся файлы сервера. По умолчанию файл конфигурации называется prefix/conf/nginx.conf. Флаг --conf-path задаёт имя файла конфигурации отдельно, тогда конфиг может оказаться вне префикса. Проверка всегда одна и та же:
/usr/local/nginx/sbin/nginx -V 2>&1 | tr ' ' '\n' | grep -E -- '--prefix|--conf-path'
Пакетный и самосборный Nginx часто соседствуют на одной машине. systemctl reload nginx в такой ситуации перезагружает юнит из systemd, то есть пакетную сборку, а вы можете править конфиг самосборной. Проверьте unit и путь к бинарнику в ExecStart, прежде чем искать ошибку в конфиге. Значения по умолчанию для --prefix и --conf-path описаны в документации по сборке Nginx.
Контейнеры и Kubernetes: где искать конфиг внутри пода
В Docker конфиг лежит внутри образа, на хосте его может не быть вовсе.
docker exec -it nginx nginx -t
docker exec -it nginx nginx -T | head -50
docker inspect nginx --format '{{ range .Mounts }}{{ .Source }} -> {{ .Destination }}{{ println }}{{ end }}'
В Kubernetes путь тот же, но источник файла другой: слой образа, ConfigMap, Secret или emptyDir. Проверяем изнутри пода и смотрим монтирования:
kubectl exec -it deploy/web -- nginx -T | head -50 kubectl describe pod web-0 | grep -A10 Mounts kubectl get configmap -o name
Если ConfigMap примонтирован через subPath, обновление объекта не меняет файл в контейнере до перезапуска пода. Правки, сделанные на хосте, на контейнер не влияют, пока файл не примонтирован явно.
Почему правки в конфиге не дают эффекта
Причин конечное число, и каждая проверяется одной-двумя командами. Начните с дампа итогового конфига и поиска своей директивы в нём: если директивы в nginx -T нет, сервер её не видел.
- Правится не тот файл. Проверка: sudo nginx -t и сверка пути с вашим редактором, затем sudo nginx -T | grep -n server_name.
- Файл не подключён. Нет строки include или имя не подпадает под маску *.conf. Проверка: sudo nginx -T | grep -n 'include' и список файлов в каталоге.
- Симлинк в sites-enabled отсутствует или битый. Проверка: ls -la /etc/nginx/sites-enabled/ и nginx -t, который сообщит о несуществующем файле.
- Конфликт server_name или default_server. Два блока с одинаковым именем: срабатывает первый по порядку включения. Проверка: sudo nginx -T | grep -n -E 'server_name|listen'.
- Не выполнен reload. Мастер-процесс держит старый конфиг до сигнала. Проверка: sudo nginx -s reload или sudo systemctl reload nginx, затем tail журнала.
- Кэш браузера, CDN или прокси между клиентом и Nginx. Проверка: curl -I с уникальным query-параметром и сравнение заголовков с ожидаемыми.
- Файл перезаписывается менеджером конфигурации. Ansible, Puppet или CI при следующем запуске вернут исходное содержимое. Проверка: git status в репозитории с шаблонами и история изменений файла.
Порядок диагностики простой: nginx -t, затем nginx -T, затем сверка путей и монтирований, затем reload, затем проверка ответа и журнала. Такой разбор экономит время и снижает риск слепой правки на проде. Схема резервного копирования каталога /etc/nginx и восстановления за пару минут описана в чек-листе обновление Nginx: бэкап и быстрое восстановление.
Порядок безопасного применения изменений
- Сохраните копию: sudo cp -a /etc/nginx /etc/nginx.bak-$(date +%F) или закоммитьте правку в git.
- Проверьте синтаксис: sudo nginx -t.
- Выгрузите итоговый конфиг и просмотрите его глазами: sudo nginx -T > /tmp/nginx-effective.conf.
- Перезагрузите без разрыва соединений: sudo systemctl reload nginx.
- Проверьте результат: curl -I на нужный домен и хвост /var/log/nginx/error.log.
Reload отправляет мастер-процессу сигнал SIGHUP: запускается новый рабочий процесс с новой конфигурацией, а старые рабочие процессы плавно завершаются, поэтому активные соединения не рвутся. Тот же эффект даёт nginx -s reload. Если конфиг битый, nginx -t отсечёт ошибку до применения, поэтому проверяйте синтаксис до reload. Механика graceful shutdown и откат при неудачном reload разобраны в руководстве безопасное обновление конфигурации Nginx через reload. Описание сигнала SIGHUP и параметра -s приведено в документации по параметрам командной строки Nginx.
Команды для просмотра дерева и проверки результата
Готовый набор для инвентаризации на сервере. Если tree не установлен, используйте find.
tree -L 2 /etc/nginx find /etc/nginx -maxdepth 2 \( -type f -o -type l \) -printf '%y %p -> %l\n' ls -la /etc/nginx /etc/nginx/conf.d /etc/nginx/sites-enabled sudo nginx -t sudo nginx -T | less ps -o pid,cmd -C nginx sudo tail -n 50 /var/log/nginx/error.log
После reload проверьте три вещи: код ответа через curl -I на нужный домен, наличие своего server_name в выводе nginx -T и отсутствие свежих ошибок в error_log. Такой набор закрывает и поиск файла, и подтверждение того, что изменение дошло до рабочего процесса.
Итоговый маршрут: нашли путь через nginx -t или nginx -V, убедились, что файл виден в nginx -T, внесли правку, прогнали nginx -t, сделали reload, проверили curl и журнал. Если на каком-то шаге появилось расхождение, причина уже локализована, и следующая команда указывает на конкретный файл или процесс.