В девяти случаях из десяти ответ на жалобу «сайт не работает» уже записан в логах nginx простым текстом — нужно только знать, куда смотреть. Логов два, оба в /var/log/nginx. В access.log одна строка на каждый запрос: кто пришёл, что просил, какой код получил. В error.log — только неприятности, от упавшего приложения до нехватки прав на файл.
Первый файл отвечает на вопрос «что случилось с этим запросом», второй — «почему». Чтобы разобраться с конкретной жалобой, смотрят оба, а код ответа подсказывает, в какую сторону копать. Цель урока — за пару минут понять, кто виноват: nginx, права на файлы или приложение за ним.
Строка access.log
Формат по умолчанию называется combined. Посмотрим на одну строку целиком: флаг -n 1 у tail показывает последнюю.
sudo tail -n 1 /var/log/nginx/access.log203.0.113.7 - - [01/Oct/2026:12:04:11 +0300] "GET /api/items HTTP/1.1" 502 157 "-" "curl/8.5.0"Главное поле — код ответа. Чтобы следить за запросами в реальном времени, пока воспроизводишь ошибку, у tail есть флаг -f: он не выходит, а печатает новые строки по мере появления, остановить — Ctrl+C. А чтобы найти все ответы с ошибкой, хватает grep из раздела про Linux.
sudo grep '" 502 ' /var/log/nginx/access.log203.0.113.7 - - [01/Oct/2026:12:04:11 +0300] "GET /api/items HTTP/1.1" 502 157 "-" "curl/8.5.0"Кавычка и пробелы вокруг кода нужны, чтобы не поймать число 502 в размере ответа или в пути. Access.log отвечает на вопрос «что случилось», а «почему» — в соседнем файле.
error.log: причина простым текстом
В журнале ошибок одна строка на одно происшествие. Длинные строки удобнее читать по одной, снова флаг -n.
sudo tail -n 1 /var/log/nginx/error.log2026/10/01 12:04:11 [error] 1202#1202: *31 connect() failed (111: Connection refused) while connecting to upstream, client: 203.0.113.7, server: stand.provision.internal, request: "GET /api/items HTTP/1.1", upstream: "http://127.0.0.1:8000/items"Читать её стоит по частям. [error] — уровень важности. Дальше суть: connect() failed (111: Connection refused) — подключиться к приложению не вышло, порт никто не слушает. Потом подробности: какой клиент, какой сайт, какой запрос и, главное, upstream — точный адрес, куда nginx стучался. С таким адресом проверка занимает минуту: sudo ss -tlnp | grep 8000 покажет, слушает ли кто-нибудь порт. Без sudo колонка с процессом останется пустой.
Журнал растёт бесконечно, поэтому раз в сутки его переименовывает и сжимает системная программа logrotate: вчерашние строки лежат в access.log.1, более старые — в файлах .gz. Если в access.log пусто, загляни туда. Зная, где лежат оба журнала, остаётся научиться узнавать в них знакомые строки: у частых ошибок они повторяются слово в слово.
Типовые ошибки и где их причина
У каждого частого кода своя строка в error.log. Узнав её, ты сразу знаешь, что чинить.
| Код | Что пишет error.log | Что чинить |
|---|---|---|
| 403 | Permission denied или directory index is forbidden | Права на файлы для www-data или нет index.html в каталоге |
| 404 | open() … failed (2: No such file or directory) — или ничего, если 404 отдал try_files | Путь в root не совпадает с диском |
| 413 | client intended to send too large body | Поднять client_max_body_size, по умолчанию 1 МБ |
| 502 | connect() failed (111: Connection refused) | Приложение не запущено или слушает другой порт |
| 504 | upstream timed out (110: Connection timed out) | while reading — приложение думает дольше proxy_read_timeout; while connecting — пакеты до приложения не доходят |
У 404 есть оговорка. Если путь не нашёл try_files … =404, как в нашем сайте, nginx считает это штатным ответом и в error.log ничего не пишет: запрос виден только в access.log. Строку open() failed дают только location без try_files.
Возьмём для примера строку про 403. В журнале написано open() "/var/www/provision/index.html" failed (13: Permission denied): файл есть, но пользователь www-data, от которого работают worker-процессы, не может его прочитать. Значит, чинить права на файл или на один из каталогов по пути, а не конфиг nginx. Для 403 бывает и вторая причина — directory index of "/var/www/provision/" is forbidden: в каталоге нет index.html, а показывать список файлов nginx по умолчанию не станет.
Отдельно стоит ошибка, при которой nginx вовсе не запускается: bind() to 0.0.0.0:80 failed (98: Address already in use). Порт уже занят другой программой — обычно вторым веб-сервером, например Apache. Её видно не в error.log, а в systemctl status nginx. Когда код неизвестен вовсе, помогает порядок действий.
Порядок поиска причины
Когда сайт «не открывается», не нужно гадать: проверяй снизу вверх, и каждый шаг отсекает половину вариантов. Это та же лестница, что в разделе про сети, только для nginx.
Сначала жив ли сам nginx: systemctl status nginx. Потом цел ли конфиг: sudo nginx -t. Затем слушает ли он нужный порт: sudo ss -tlnp | grep nginx (без sudo имени процесса не видно, и grep ничего не найдёт). Дальше что отвечает сайт: curl -I на адрес. И наконец почему: sudo tail -n 20 /var/log/nginx/error.log. Эти пять команд собраны в шпаргалку в последнем уроке раздела, а в практике ты сам сломаешь сайт тремя способами и найдёшь причину по ним.
Словарь урока
Что спросят на собеседовании
- Сайт отдаёт 502. Ваши действия?Открыть error.log nginx и найти строку с upstream: там адрес приложения и причина. При Connection refused проверить, запущено ли приложение и слушает ли порт, через systemctl status и ss -tlnp.
- Чем 502 отличается от 504?502 — до приложения не достучались или получили некорректный ответ. 504 — подключились, но не дождались ответа за proxy_read_timeout.
- Откуда берётся 403 на свежем сайте?Обычно у www-data нет прав прочитать файлы или войти в каталог по пути, либо в каталоге нет index-файла. Причина и полный путь — в error.log.
Что дальше
В практике ты нарочно сломаешь сайт тремя способами — права, остановленное приложение и зависшее приложение — и найдёшь каждую причину по журналу.