Поиск
Справочник

index и autoindex в nginx: главная страница папки и список файлов

Когда адрес заканчивается на «/», nginx ищет в папке индексный файл — тот, что назван в директиве index, и показывает его. Если такого файла нет, nginx отвечает ошибкой 403, а директива autoindex может показать вместо неё список файлов папки.

≈ 7 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
  2. Посмотрите, что лежит в папке сайта — той, что в строке root: ls /var/www/example.com/. Для главной страницы там нужен index.html, а у сайта на PHP — index.php.
  3. Откройте файл сайта: sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажет ls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter.
  4. Найдите строку index: Ctrl+W, слово index, Enter. Файл из папки должен быть в этой строке — как она устроена.
  5. Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки: sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их: sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены.
  6. Проверьте — как проверить.

Если проверка нашла ошибку, nginx назовёт файл и номер строки, а сайт продолжит работать на старых настройках. Что значит сообщение — Все ошибки nginx.

Как устроена строка index

index index.html index.htm;

В строке перечислены имена файлов. Когда адрес заканчивается на «/», nginx проверяет их по порядку в папке этого адреса и берёт первый найденный. Если строки index нет нигде, nginx ищет только index.html.

Где написана строкаНа что действует
в блоке http в /etc/nginx/nginx.confна все сайты сервера
в блоке serverна один сайт
в блоке locationна адреса этого блока

Строка из внутреннего блока заменяет строку из внешнего целиком, а не дописывает к ней файлы. В файле default из пакета nginx в Ubuntu стоит index index.html index.htm index.nginx-debian.html; — последний файл и есть страница Welcome to nginx! в папке /var/www/html/.

Последним в списке можно поставить файл с полным путём от корня сайта, например index index.html /index.html; — тогда для папки без своего index.html nginx покажет главную страницу сайта.

index.php и сайт на PHP

Для сайта на PHP поставьте index.php первым:

index index.php index.html;

Найдя индексный файл, nginx не отдаёт его сразу, а заново ищет блок location для нового адреса. Адрес «/» превращается в «/index.php», и его забирает блок location ~ \.php$, который передаёт запрос PHP-FPM. Если такого блока нет, браузер скачает index.php вместо страницы. Как написать блок — nginx и PHP-FPM.

По той же причине строка index из блока location = / может не сработать так, как ждёте: адрес «/index.html» уйдёт уже в другой блок. Пишите index в блоке server.

CMS вроде WordPress обрабатывают через index.php и адреса страниц, которых нет на диске. Для этого кроме index нужна строка try_files — try_files в nginx.

Если индексного файла нет

Тогда nginx ответит 403, а в журнале ошибок будет запись:

directory index of "/var/www/example.com/" is forbidden

Для папок с картинками или файлами это нормально: их адреса открывать не нужно. Если так отвечает главная или другая страница, в папке нет файла из строки index или он лежит во вложенной папке — разбор в статье ошибка 403.

Список файлов: autoindex

Директива autoindex показывает вместо 403 страницу со списком файлов и папок. По умолчанию она выключена. Включайте её только для отдельной папки, где нет ничего, кроме файлов для скачивания:

location /files/ {
    autoindex on;
    autoindex_exact_size off;
    autoindex_localtime on;
}

Здесь /files/ — папка внутри папки сайта, например /var/www/example.com/files/. Если включить autoindex в блоке server, посетители увидят все файлы сайта, у которых нет своего index.html: копии, выгрузки, файлы настроек. Чтобы список видели только свои, закройте папку паролем — пароль на одну папку.

ДирективаПо умолчаниюЧто меняет
autoindexoffon — показывать список файлов
autoindex_exact_sizeonразмер в байтах. off — округлить до КБ, МБ и ГБ
autoindex_localtimeoffвремя в UTC. on — время сервера
autoindex_formathtmlформат списка: html, xml, json или jsonp — для программ

Файлы, имя которых начинается с точки, например .htpasswd, в список не попадают, но открыть их по прямому адресу можно. Если в папке лежит index.html, nginx покажет его, а не список.

Как проверить

Запросите адрес папки:

curl -I https://example.com/

Если индексный файл нашёлся, будет код 200 и Content-Type: text/html. Код 403 — файла нет или его не видно nginx, причина в журнале ошибок: sudo tail -n 20 /var/log/nginx/error.log. curl может показать имена заголовков маленькими буквами — это то же самое.

Адрес без «/» в конце, например /files, nginx переадресует на /files/ с кодом 301, если такая папка есть — что происходит, если нашлась папка.

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

Что видитеЧто делать
403, в журнале directory index of "…" is forbiddenв папке нет файла из строки index — разбор
403, в журнале "…/index.html" is forbidden (13: Permission denied)nginx не может прочитать файл — права на файлы
404, в журнале "…/index.html" is not found (2: No such file or directory)такой папки нет: проверьте строку root — root и alias
браузер скачивает index.phpнет блока для PHP или не выполнен reload — блок для PHP
вместо сайта Welcome to nginx!запрос попал в сайт по умолчанию — как nginx выбирает сайт
список файлов виден там, где не нуженуберите autoindex on из блока server или положите в папку index.html

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше