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

nginx error log: как читать и исправлять ошибки

Файл /var/log/nginx/error.log хранит сообщения об ошибках, которые nginx не отдал в браузер. По записи в нём видно, на каком этапе сломалось: проверка прав, подключение к PHP-FPM или таймаут бэкенда. Начните с sudo tail -n 50 /var/log/nginx/error.log и найдите строку с кодом ответа, который увидел пользователь.

Ошибка Nginx 3 мин чтения

01403 Forbidden: open() failed (13: Permission denied)

В логе есть open() "/var/www/example.com/public/index.php" failed (13: Permission denied). Это значит, что пользователь www-data не может прочитать файл или войти в один из каталогов на пути к нему. Проверьте права по всему пути командой namei -l и попробуйте прочитать файл от имени www-data. Исправьте права на каталог без права входа (chmod 755) или на файл (chmod 644). Владельца всего сайта менять не нужно.

bash
namei -l /var/www/example.com/public/index.php
sudo -u www-data cat /var/www/example.com/public/index.php
sudo chmod 755 /var/www/example.com/public
sudo chmod 644 /var/www/example.com/public/index.php

02403 Forbidden: directory index is forbidden

Сообщение directory index of "/var/www/example.com/" is forbidden появляется, когда запрос пришёл на каталог, в нём нет файла из директивы index, а autoindex выключен. У Laravel так бывает, если root указывает на корень проекта, а не на public. Проверьте директиву root в конфиге сайта и при необходимости добавьте index index.php index.html;.

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

03403 Forbidden: access forbidden by rule

Запись access forbidden by rule означает, что запрос закрыт директивой deny в конфиге сайта или в подключённом файле. Найдите все вхождения deny командой sudo grep -rn "deny" /etc/nginx/. Уберите или измените правило, которое перекрывает нужный адрес, затем проверьте конфиг и перезагрузите nginx.

bash
sudo grep -rn "deny" /etc/nginx/
sudo nginx -t
sudo systemctl reload nginx

04502 Bad Gateway: connect() to unix:/run/php/php8.3-fpm.sock failed (2: No such file or directory)

Файла сокета нет: PHP-FPM версии 8.3 не запущен или не установлен, либо в fastcgi_pass указана другая версия PHP. Проверьте содержимое каталога /run/php/ и статус службы php8.3-fpm. Если служба не запущена, запустите её и повторите запрос.

bash
ls /run/php/
sudo systemctl status php8.3-fpm
sudo systemctl start php8.3-fpm

05502 Bad Gateway: connect() to unix:/run/php/php8.3-fpm.sock failed (13: Permission denied)

Сокет существует, но www-data не может к нему подключиться. Причина в настройках пула: изменены listen.owner, listen.group или listen.mode в /etc/php/8.3/fpm/pool.d/www.conf. Права сокета задаются в этом файле, ручной chown сбросится при перезапуске PHP-FPM. Верните стандартные значения и перезапустите службу.

bash
sudo grep -E "listen\.(owner|group|mode)" /etc/php/8.3/fpm/pool.d/www.conf
sudo systemctl restart php8.3-fpm

06502 Bad Gateway: connect() failed (111: Connection refused) while connecting to upstream

По адресу из proxy_pass или fastcgi_pass никто не слушает. Приложение не запущено или слушает другой порт. Для unix-сокета это значит, что файл остался, а процесса нет. Проверьте список слушающих портов командой sudo ss -ltnp и убедитесь, что нужный процесс активен.

bash
sudo ss -ltnp

07502 Bad Gateway: recv() failed (104: Connection reset by peer) или upstream prematurely closed connection

PHP-FPM оборвал запрос: скрипт упал с фатальной ошибкой или его остановил request_terminate_timeout. Причина в /var/log/php8.3-fpm.log и логе приложения. Просмотрите оба файла, чтобы найти сообщение об ошибке PHP или превышении времени выполнения.

bash
sudo tail -n 50 /var/log/php8.3-fpm.log

08502 Bad Gateway: upstream sent too big header while reading response header from upstream

Заголовки ответа, чаще всего большие cookie, не помещаются в буфер. Увеличьте fastcgi_buffer_size и fastcgi_buffers в блоке location ~ \.php$. Для прокси используйте proxy_buffer_size и proxy_buffers.

nginx
location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    fastcgi_buffer_size 32k;
    fastcgi_buffers 8 16k;
}

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

  • Сразу выполнить chmod 777 на файлы или каталоги сайта.

    Это открывает запись всем пользователям и не устраняет причину. Достаточно chmod 755 на каталоги и chmod 644 на файлы.

  • Сменить владельца всего сайта на www-data командой chown -R www-data.

    PHP сможет переписывать собственный код, чем пользуются при взломе. www-data нужно только чтение, а запись лишь в каталоги, куда пишет само приложение.

  • Вручную менять права сокета PHP-FPM командой chown или chmod.

    При перезапуске PHP-FPM права сбросятся. Настройте listen.owner, listen.group и listen.mode в /etc/php/8.3/fpm/pool.d/www.conf.

Deploykin

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

В Deploykin логи nginx, PHP-FPM и приложения читаются в панели, без SSH. Конфиг nginx правится в редакторе: перед сохранением панель проверяет его на сервере, а прежняя версия уходит в резервную копию. Если nginx или PHP-FPM упадёт, придёт оповещение в Telegram.

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

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

Где находится error.log у nginx в Ubuntu 24.04?

По умолчанию /var/log/nginx/error.log. Если в конфиге сайта задана своя директива error_log, запись идёт в указанный там файл.

Как посмотреть только ошибки за последние минуты?

Используйте sudo tail -n 50 /var/log/nginx/error.log для последних строк или journalctl -u nginx --since "5 minutes ago" для записей службы.

Почему после sudo nginx -t ошибка в логе остаётся?

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

Что означает upstream prematurely closed connection?

PHP-FPM или другое приложение оборвало соединение до отправки ответа. Смотрите /var/log/php8.3-fpm.log и лог приложения: там будет причина, например фатальная ошибка скрипта.

Ещё по теме

Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы

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