Где находится конфиг Nginx: путь к nginx.conf и структура /etc/nginx в 2026 году | AdminWiki

Где находится конфиг Nginx: путь к nginx.conf и структура /etc/nginx в 2026 году

08 ноября 2026 10 мин. чтения

Короткий ответ: где лежит конфиг 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.confconf.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: бэкап и быстрое восстановление.

Порядок безопасного применения изменений

  1. Сохраните копию: sudo cp -a /etc/nginx /etc/nginx.bak-$(date +%F) или закоммитьте правку в git.
  2. Проверьте синтаксис: sudo nginx -t.
  3. Выгрузите итоговый конфиг и просмотрите его глазами: sudo nginx -T > /tmp/nginx-effective.conf.
  4. Перезагрузите без разрыва соединений: sudo systemctl reload nginx.
  5. Проверьте результат: 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 и журнал. Если на каком-то шаге появилось расхождение, причина уже локализована, и следующая команда указывает на конкретный файл или процесс.

Поделиться: