К содержимому

Ошибка nginx 404 not found: причины и исправление

Код 404 nginx возвращает, когда не нашёл файл по пути из запроса: чаще всего не совпадает root, отсутствует index или запрос уходит не в тот location. Сначала смотрите error_log и access_log: там виден точный путь, который nginx пытался открыть.

Ошибка Сервер 3 мин чтения

01Неверный root или index в конфиге сайта

Самая частая причина: в server указан root, не совпадающий с каталогом сайта, или запрос идёт на /, а файла из index там нет. Проверьте блок server для вашего домена и путь в root. Убедитесь, что файл index.php или index.html лежит именно в этом каталоге.

nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/example.com;
    index index.php index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

02Запрос не попадает в нужный location

Если в конфиге несколько location, запрос может обрабатываться блоком, у которого другой root или нет try_files. Проверьте, какой блок срабатывает: временно добавьте return 200 в подозрительный location и посмотрите ответ. Убедитесь, что location / содержит try_files $uri $uri/ =404.

nginx
location / {
    try_files $uri $uri/ =404;
}

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

03Ошибка в rewrite или try_files

Неправильное правило rewrite или try_files перенаправляет запрос на несуществующий путь. Проверьте правила через nginx -T и найдите все rewrite и try_files для вашего домена. Для SPA и ЧПУ последний аргумент try_files должен вести на существующий файл, например /index.php.

nginx
location / {
    try_files $uri $uri/ /index.php?$query_string;
}

04Файл лежит не там или не создан

Проверьте, что запрошенный путь существует на диске. Сравните путь из access_log с реальным расположением файла. Если сайт развёрнут из репозитория, убедитесь, что каталог public или web скопирован полностью.

bash
ls -la /var/www/example.com
sudo tail -n 20 /var/log/nginx/access.log
sudo tail -n 20 /var/log/nginx/error.log

05Права на чтение каталога

При нехватке прав на чтение каталога или файла nginx возвращает 403 Forbidden, а не 404. Если в логах виден 403, проверьте права: владельцем каталога должен оставаться deploy, а nginx достаточно чтения. Каталоги 755, файлы 644.

bash
sudo chown -R deploy:deploy /var/www/example.com
sudo find /var/www/example.com -type d -exec chmod 755 {} \;
sudo find /var/www/example.com -type f -exec chmod 644 {} \;

06Проверка, что 404 больше нет

После правки конфига проверьте синтаксис и перезагрузите nginx. Запросите страницу через curl и посмотрите код ответа. В access_log не должно оставаться 404 на рабочие URL.

bash
sudo nginx -t
sudo systemctl reload nginx
curl -I http://example.com/
sudo tail -n 20 /var/log/nginx/access.log

Что не помогает

  • Сменить владельца всего каталога сайта на www-data через sudo chown -R www-data:www-data /var/www/example.com.

    Это открывает запись процессу nginx и любому коду PHP. Владельцем оставьте deploy, nginx достаточно прав на чтение: каталоги 755, файлы 644.

  • Считать, что 404 появляется из-за прав на файлы.

    Нехватка прав на чтение даёт 403 Forbidden. 404 означает, что файл не найден: проверяйте root, index и try_files.

  • Править конфиг и сразу выполнять systemctl reload nginx без проверки.

    При ошибке в конфиге nginx -t завершается с ошибкой, а systemctl reload nginx не перезагружает nginx, и старый конфиг продолжает работать. Сначала sudo nginx -t, потом reload.

Deploykin

Как это делается в Deploykin

В Deploykin VPS любого хостинга подключается из панели или через MCP. Уже работающий сервер можно взять под управление: панель просканирует сайты, SSL, cron и демоны и ничего не сломает в конфигах.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Где nginx пишет причину 404?

В error_log и access_log, по умолчанию /var/log/nginx/error.log и /var/log/nginx/access.log. В error_log виден путь, который nginx пытался открыть.

Почему 404 появляется только для PHP-страниц?

Скорее всего, запрос не попадает в location ~ \.php$ или в нём неверный fastcgi_pass. Проверьте сокет PHP-FPM: для PHP 8.3 на Ubuntu 24.04 это /run/php/php8.3-fpm.sock.

Может ли 404 возникать из-за прав на файлы?

Нет. При нехватке прав на чтение nginx возвращает 403 Forbidden. 404 означает, что файл не найден.

Что делать, если 404 отдаёт только главная страница?

Проверьте директиву index и наличие файла из неё в каталоге root. Для PHP добавьте index.php первым в список index.

Ещё по теме

Настройка VPS сервера на Ubuntu 24.04: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.