index и autoindex в nginx: главная страница папки и список файлов
Когда адрес заканчивается на «/», nginx ищет в папке индексный файл — тот, что назван в директиве index, и показывает его. Если такого файла нет, nginx отвечает ошибкой 403, а директива autoindex может показать вместо неё список файлов папки.
Содержание 9
Что сделать прямо сейчас
- Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Посмотрите, что лежит в папке сайта — той, что в строке root:
ls /var/www/example.com/. Для главной страницы там нужен index.html, а у сайта на PHP — index.php. - Откройте файл сайта:
sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажетls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter. - Найдите строку index: Ctrl+W, слово
index, Enter. Файл из папки должен быть в этой строке — как она устроена. - Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их:sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены. - Проверьте — как проверить.
Если проверка нашла ошибку, 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: копии, выгрузки, файлы настроек. Чтобы список видели только свои, закройте папку паролем — пароль на одну папку.
| Директива | По умолчанию | Что меняет |
|---|---|---|
autoindex | off | on — показывать список файлов |
autoindex_exact_size | on | размер в байтах. off — округлить до КБ, МБ и ГБ |
autoindex_localtime | off | время в UTC. on — время сервера |
autoindex_format | html | формат списка: 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 |
Источники
- Документация nginx: модуль ngx_http_index_module — index, порядок проверки файлов, внутреннее перенаправление.
- Документация nginx: модуль ngx_http_autoindex_module — autoindex, autoindex_exact_size, autoindex_format и autoindex_localtime.
- Исходный код nginx 1.24.0: ngx_http_core_module.c — запись directory index of … is forbidden и ответ 403, если в папке нет индексного файла.
- Исходный код nginx 1.24.0: ngx_http_index_module.c — записи "…" is forbidden (403), если нет прав на файл, и "…" is not found (404), если нет папки.
- Исходный код nginx 1.24.0: ngx_http_autoindex_module.c — файлы, имя которых начинается с точки, в список не попадают.
- Файл sites-available/default из пакета nginx в Ubuntu 24.04 — сайт по умолчанию:
listen 80 default_server,server_name _, try_files.
Сверено 23 октября 2026 года.
Что почитать дальше
- nginx и PHP-FPMблок для PHP и fastcgi_pass.
- try_files в nginxфайлы с диска, остальное — CMS.
- Ошибка 403 Forbiddenвсе причины по строкам журнала.
- Пароль на сайт или папкуauth_basic.
- Настройки nginxкак устроены файлы и блоки, главные директивы.