Сайт не открывается, и первая мысль — открыть логи приложения. Иногда это полчаса впустую: запрос до приложения даже не дошёл, потому что имя не превратилось в адрес или истёк сертификат. Отладка начинается не с вопроса «что сломалось», а с вопроса «где искать».
Ответ на него даёт карта слоёв. Запрос пользователя — не одно действие, а цепочка: имя превращается в адрес, открывается соединение, договаривается шифрование, nginx принимает запрос, передаёт приложению, а оно идёт в базу. Каждое звено ты уже собирал руками в своих разделах курса. Карта раскладывает эту цепочку по порядку, с одной командой проверки на каждое звено, и каждая проверка отсекает всё, что выше или ниже.
Шесть слоёв
На стенде запрос проходит шесть слоёв. Порядок тот же, что в уроке про порядок диагностики из раздела про сети, только теперь к нему добавились nginx, контейнеры и база.
| Слой | Вопрос | Проверка одной командой |
|---|---|---|
| DNS | имя превращается в адрес? | getent hosts stand.provision.internal |
| Сеть и порт | порт открыт и отвечает? | nc -zv stand.provision.internal 8443 |
| TLS | сертификат подходит и не истёк? | curl -sSI по https |
| nginx | прокси принял запрос? | логи прокси |
| Приложение | контейнер жив и отвечает? | docker compose ps, логи app |
| База | база принимает соединения? | pg_isready |
Возьмём вторую строку. nc (netcat) пробует открыть соединение с портом и ничего не отправляет. Флаг -z значит «только проверить, без данных», -v — печатать результат. Ответ succeeded значит, что сеть и порт в порядке, и дальше искать надо выше — в TLS или nginx.
Идут по таблице обычно сверху вниз, но часто можно сразу прыгнуть в середину — если ошибка сама называет слой.
Ошибка называет слой
У curl текст ошибки почти всегда говорит, на каком слое запрос остановился. Научись читать его — и половина разборов закончится, не начавшись.
| Что пишет curl | Слой | Что это значит |
|---|---|---|
| Could not resolve host | DNS | имя не превратилось в адрес |
| Connection timed out | сеть | ответа нет: файрвол, маршрут, машина выключена |
| Connection refused | порт | машина жива, но на порту никто не слушает |
| SSL certificate problem | TLS | сертификат истёк или ему не доверяют |
| HTTP 502 или 504 | nginx → приложение | прокси жив, приложение не ответило |
| HTTP 503 | приложение → база | приложение живо, но не достало то, от чего зависит |
| HTTP 500 | приложение | приложение ответило, но упало внутри |
Посмотри на разницу третьей и второй строки. Refused приходит мгновенно — живая машина вежливо говорит «здесь никого нет». Timed out ждёт десятки секунд и не получает ничего: пакеты теряются по дороге. Первое ведёт к службе на машине, второе — к сети и файрволу.
И обрати внимание на три последние строки. Если пришёл любой HTTP-код, значит, DNS, сеть, порт и TLS уже работают — их можно не проверять вовсе. Код 503 (Service Unavailable, «сервис недоступен») на стенде отдаёт само приложение: адрес /items из раздела про Docker так отвечает, когда не может подключиться к базе.
Одна оговорка про сам curl. Флаг -s убирает полоску загрузки, но заодно глушит и текст ошибки: на экране пусто, и таблицу выше читать не по чему. Поэтому в отладке к нему всегда добавляют -S — «ошибки всё-таки показывай». Пишут слитно: curl -sS.
Как читать ответ
Чтобы увидеть код ответа, у curl есть флаг -I: он запрашивает только заголовки, без тела страницы. Флаги -sS — без полоски загрузки, но с текстом ошибки, если она будет.
curl -sSI https://example.ru/api/health HTTP/2 502 server: nginx date: Thu, 01 Oct 2026 11:05:12 GMT content-type: text/html
Первая строка — версия протокола и код, здесь 502. Строка server: nginx говорит, кто ответил: именно nginx, а не приложение. Значит, DNS, порт, TLS и nginx живы, и поиск сужается до одного места — связи между прокси и приложением. Этому коду посвящён отдельный урок.
Сверху вниз или снизу вверх
Если ошибка ничего не подсказывает — например, страница грузится бесконечно, — идут по таблице слоёв по порядку, начиная с DNS. Каждая успешная проверка исключает свой слой. Первая неуспешная — это место поломки.
Бывает и обратный путь: жалоба на конкретную страницу, а сайт в целом открывается. Тогда начинают снизу — с логов приложения и базы, потому что верхние слои, очевидно, работают. Выбор направления — тоже часть методики: смотри, какие слои симптом уже исключил.
Словарь урока
Что спросят на собеседовании
- Пользователь пишет, что сайт не открывается. С чего начнёшь?Посмотрю, что отвечает curl. По тексту ошибки пойму слой: имя, сеть, порт, сертификат, прокси или приложение — и проверю его одной командой.
- В чём разница между refused и timeout?Refused — машина ответила, что порт закрыт. Timeout — ответа нет вовсе: файрвол, маршрут или машина недоступна.
- Если пришёл HTTP 502, нужно ли проверять DNS?Нет. Ответ пришёл от nginx, значит, имя, сеть, порт и TLS работают. Искать между прокси и приложением.
Что дальше
В практике пройдём весь путь запроса на своём стенде — по одной команде на слой — и составим карту стенда для дежурного.