Ошибка nginx 404 not found: причины и исправление
Код 404 nginx возвращает, когда не нашёл файл по пути из запроса: чаще всего не совпадает root, отсутствует index или запрос уходит не в тот location. Сначала смотрите error_log и access_log: там виден точный путь, который nginx пытался открыть.
01Неверный root или index в конфиге сайта
Самая частая причина: в server указан root, не совпадающий с каталогом сайта, или запрос идёт на /, а файла из index там нет. Проверьте блок server для вашего домена и путь в root. Убедитесь, что файл index.php или index.html лежит именно в этом каталоге.
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.
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.
location / {
try_files $uri $uri/ /index.php?$query_string;
}
04Файл лежит не там или не создан
Проверьте, что запрошенный путь существует на диске. Сравните путь из access_log с реальным расположением файла. Если сайт развёрнут из репозитория, убедитесь, что каталог public или web скопирован полностью.
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.
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.
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.
Ещё по теме
- Ошибка · Сервер Ошибка SSH: host key verification failed Почему SSH выдаёт host key verification failed, как проверить отпечаток ключа хоста, обновить known_hosts и безопасно переподключиться к серверу.
- Ошибка · Сервер Сервис не запускается в Ubuntu: как найти причину и исправить Почему в Ubuntu сервис не стартует: разбор status=203/EXEC, 200/CHDIR, 209/STDOUT, проверка юнита через systemctl status и journalctl, рабочие команды для…
- Ошибка · Сервер Ubuntu не работает сеть после перезагрузки: причины и исправление Почему на Ubuntu 24.04 после перезагрузки не поднимается сеть: проверка netplan, networkd и DHCP, команды для восстановления интернета на VPS.
- Руководство · Сервер Настройка VPS на Ubuntu 24.04: команды systemctl и проверка Пошаговая настройка VPS на Ubuntu 24.04: пользователь deploy, часовой пояс, swap, обновления. Команды systemctl status, restart, enable и проверка.
- Руководство · Сервер Настройка VPS на Ubuntu Server 24.04 LTS Пошаговая настройка VPS на Ubuntu Server 24.04 LTS: пользователь deploy, SSH-ключ, часовой пояс, swap, обновления и проверка команд. С командами и проверкой.
- Руководство · Сервер Настройка htop на Ubuntu 24.04: пошаговое руководство Как установить и настроить htop на Ubuntu 24.04: команды запуска, горячие клавиши, настройка отображения и проверка, что утилита работает.