Где находятся конфигурационные файлы Nginx

Быстрые ссылки

• Обычные расположения
• Как найти папку конфигурации вручную
• Расположение Document Root

Nginx использует текстовые файлы конфигурации для управления поведением сервера. По умолчанию конфиги обычно находятся в каталоге /etc/nginx/, но путь может отличаться в зависимости от способа установки.

Обычные расположения

Стандартное расположение папки с конфигурацией Nginx:

/etc/nginx/

Это — наиболее вероятное место при установке через менеджер пакетов дистрибутива. Внутри этой директории обычно присутствуют несколько файлов и директорий, независимо от того, где расположен главный каталог:

• nginx.conf — основной файл конфигурации Nginx.
• sites-available/ — папка, содержащая конфигурации для отдельных сайтов (например, sites-available/example.com).
• sites-enabled/ — папка со символьными ссылками на файлы в sites-available, используется как переключатель включения/выключения сайтов.

Если /etc/nginx/ отсутствует, Nginx мог быть установлен в другом месте, особенно если вы компилировали из исходников. Возможные пути:

• /usr/local/nginx/ — часто при сборке из исходников.
• /usr/local/nginx/conf/
• /usr/local/etc/nginx/

Если и этих мест нет, возможно, Nginx работает в контейнере или установка прошла некорректно. В таких случаях папку нужно найти вручную.

Как найти папку конфигурации вручную

Nginx предоставляет команду для проверки синтаксиса конфигурации перед перезапуском. Эта команда полезна не только для проверки, но и для определения того, какой файл конфигурации используется текущим бинарником.

Запустите:

nginx -t

Во время теста Nginx выведет полный путь к проверяемому файлу, например:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok

Или в другой форме:

nginx: configuration file /etc/nginx/nginx.conf test is successful

Важно: если команда не запускается, возможно, nginx не установлен или не находится в системном PATH.

Дополнительные полезные команды для поиска конфигурации и префикса установки:

• Узнать префикс и параметры сборки (покажет –prefix и другие флаги):

nginx -V

Обратите внимание, что nginx -V выводит на stderr, поэтому в некоторых оболочках нужно перенаправить вывод, например nginx -V 2>&1 | grep -- --prefix.

• Найти процесс и путь к бинарнику:

ps aux | grep nginx
systemctl status nginx

• Если Nginx в контейнере, зайдите в контейнер и проверьте /etc/nginx/ или используйте docker exec -it nginx -t.

Важно: вывод команды nginx -t всегда указывает файл, который использует текущий бинарник, а не обязательно «по умолчанию» дистрибутива.

Расположение Document Root

Document root (корень сайта) задают в конфигурации серверных блоков (server blocks). По умолчанию это обычно:

• /var/www/html/ на Debian-подобных системах (Ubuntu и др.)
• /usr/share/nginx/html/ на RHEL-подобных системах (CentOS и др.)

Document root можно изменить на любой путь. Поэтому самый надёжный способ найти его — посмотреть соответствующий root внутри файлов в sites-available/, sites-enabled/ или в nginx.conf.

Когда стандартные способы не помогают

• Если Nginx запущен внутри контейнера, локальные пути хоста не отражают пути внутри контейнера.
• Если вы используете нестандартный пакетный менеджер или кастомную сборку, конфиги могут быть в /opt/ или в домашнем каталоге сборки.
• На системах с SELinux или AppArmor доступны дополнительные ограничения доступа; даже найдя файл, вы можете не иметь прав на его чтение.

Если nginx -t не доступна и вы не можете найти процесс nginx, проверьте, установлен ли пакет: на Debian/Ubuntu apt list --installed | grep nginx, на CentOS rpm -qa | grep nginx.

Быстрая методика поиска (мини-методология)

1. Попробуйте стандартный путь: /etc/nginx/.
2. Выполните nginx -t и nginx -V для точного определения.
3. Проверьте процессы: ps aux | grep nginx и systemctl status nginx.
4. Если контейнеры — войдите в контейнер и повторите шаги внутри него.
5. Найдите директиву root в server-блоках для определения document root.

Сниппеты команд (чистая шпаргалка)

nginx -t
nginx -V 2>&1 | grep -- --prefix
ps aux | grep nginx
systemctl status nginx
docker ps
docker exec -it  nginx -t

Чек-лист по ролям

• Системному администратору:

  • Убедиться, что nginx -t возвращает OK.
  • Проверить права доступа и SELinux/AppArmor.
  • Найти и сохранить копию nginx.conf и каталогов sites-available/sites-enabled.

• Разработчику:

  • Найти root в server-блоке для отладки статических файлов.
  • Проверить переадресации и правила location.
  • Локально воспроизвести конфигурацию при возможности.

Краткий словарь

• nginx.conf — основной конфигурационный файл.
• sites-available — хранилище конфигов сайтов.
• sites-enabled — включённые сайты (символьные ссылки).
• Document root — корневая папка для отдаваемых файлов.

Итог

Nginx обычно использует /etc/nginx/, но сборка из исходников, контейнеры и нестандартные пакеты меняют расположение. Команды nginx -t и nginx -V, а также проверка процессов и контейнеров — надёжный способ найти активный конфиг и document root. Всегда проверяйте конфигурацию перед перезапуском, чтобы избежать простоев.

Ключевые шаги: проверьте /etc/nginx/, выполните nginx -t, просмотрите nginx -V и смотрите server-блоки для директивы root.