nginx error log: как читать и исправлять ошибки
Файл /var/log/nginx/error.log хранит сообщения об ошибках, которые nginx не отдал в браузер. По записи в нём видно, на каком этапе сломалось: проверка прав, подключение к PHP-FPM или таймаут бэкенда. Начните с sudo tail -n 50 /var/log/nginx/error.log и найдите строку с кодом ответа, который увидел пользователь.
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). Владельца всего сайта менять не нужно.
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;.
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.
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. Если служба не запущена, запустите её и повторите запрос.
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. Верните стандартные значения и перезапустите службу.
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 и убедитесь, что нужный процесс активен.
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 или превышении времени выполнения.
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.
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 Ошибка 502 Bad Gateway в nginx: причины и исправление Разбираем ошибку 502 Bad Gateway в nginx: почему PHP-FPM не отвечает, как читать error.log, проверять сокет и права, чинить таймауты и буферы.
- Ошибка · Nginx Ошибка 403 Forbidden в nginx: причины и исправление Разбираем ошибку 403 Forbidden в nginx: как найти причину по error.log, проверить права через namei и sudo -u www-data, исправить chmod и deny. Команды для Ubuntu…
- Ошибка · Nginx Ошибка nginx 499: что значит и как исправить Разбираем код 499 в nginx: что значит Client Closed Request, как найти причину в логах, настроить таймауты и проверить, что ошибка ушла.
- Ошибка · Nginx Ошибка 500 Internal Server Error в nginx: поиск причины и исправление Разбираем ошибку 500 в nginx: как найти причину в error.log, проверить PHP-FPM, права и конфиг, исправить и убедиться, что ошибка ушла.
- Руководство · Nginx Docker nginx: установка и настройка обратного прокси Пошагово: установка nginx в Docker на Ubuntu 24.04, конфиг обратного прокси, проверка через curl и разбор частых ошибок с логами.
- Руководство · Nginx Установка nginx на Ubuntu 24.04 и настройка сайта с PHP Пошаговая установка nginx на Ubuntu 24.04: apt, настройка PHP 8.3 через php-fpm, конфиг сайта, логи и проверка через nginx -t и systemctl status.
Настройка nginx на сервере: от установки до рабочего конфига: все материалы темы