Provision
—— XP

curl: что отвечает приложение

теория~5 минут+130 XP

Программа curl стоит на серверах, в контейнерах, в телефонах, в автомобилях и даже на марсианском вертолёте Ingenuity из миссии Mars 2020. Её написал Даниэль Стенберг в 1998 году, и делает она одну вещь: отправляет запрос по адресу и печатает ответ. Для DevOps это главный способ спросить сайт или API «как ты?» без браузера — с сервера, из контейнера, из шага CI.

Браузер прячет детали за красивой страницей ошибки, а curl показывает всё как есть: код ответа, заголовки, перенаправления и место, где разговор оборвался. В порядке диагностики из прошлого урока он закрывает пятую ступень, «приложение»: машина доступна, порт открыт — что отвечает сама служба? По её ответу уже видно, работает она, переехала по другому адресу или сломалась.

curl -I: только заголовки

Флаг -I (заглавная i) просит у сервера только заголовки ответа — служебные строки перед содержимым страницы. Для проверки этого достаточно, а страница на сто килобайт в терминале не нужна.

ubuntu@stand:~$
curl -I https://example.com
HTTP/2 200
content-type: text/html; charset=utf-8
server: cloudflare
date: Thu, 01 Oct 2026 16:45:29 GMT

Самое важное — первая строка: версия протокола и код ответа. 200 — всё хорошо. Остальные строки — заголовки: content-type говорит, что пришла HTML-страница, server — кто ответил.

Код ответа — трёхзначное число, и его первая цифра сразу говорит, чья это проблема.

Коды ответа

Запомнить нужно не все коды, а четыре группы и пару частых представителей. Есть и пятая, 1xx, — служебные промежуточные ответы, в работе их почти не видно.

кодсмыслчто делать
2xx200 OK — всё хорошоничего
3xx301, 302 — ищи по другому адресусмотреть заголовок Location
4xx404 — нет такой страницы, 403 — нельзяпроблема в запросе: адрес, права
5xx500 — ошибка в приложении, 502 — прокси не достучался до приложения, 504 — прокси не дождался ответалоги приложения и nginx

Читать так: 502 Bad Gateway пришёл — значит, сеть, DNS и nginx в порядке, а приложение за ним не принимает соединения: не запущено или слушает другой порт. 504 Gateway Timeout — прокси достучаться пытался, но ответа не дождался: приложение зависло или пакеты к нему молча выбрасывает файрвол. Оба кода экономят час поисков «в сети»: до прокси сеть точно работает.

Код 3xx встречается так часто, что для него в curl есть свой флаг.

Перенаправления

Многие сайты отвечают на http:// перенаправлением на https://. curl по умолчанию не идёт за ним, а показывает, куда его послали.

ubuntu@stand:~$
curl -I http://github.com
HTTP/1.1 301 Moved Permanently
Location: https://github.com/

301 — «переехали навсегда», Location — куда. Флаг -L велит curl пройти по перенаправлениям до конца:

ubuntu@stand:~$
curl -IL http://github.com      # -I заголовки, -L идти дальше
HTTP/1.1 301 Moved Permanently
Location: https://github.com/
HTTP/2 200

Два ответа подряд: перенаправление и конечная страница с 200.

Когда ответа нет вовсе, нужен подробный режим.

curl -v: где оборвалось

Флаг -v (verbose) заставляет curl рассказывать о каждом шаге. Строки с * — комментарии самого curl, с > — что он отправил, с < — что получил.

ubuntu@stand:~$
curl -v http://192.168.1.50:8080/
* Trying 192.168.1.50:8080...
* Connected to 192.168.1.50 port 8080
> GET / HTTP/1.1
> Host: 192.168.1.50:8080
< HTTP/1.1 200 OK

Ценность -v в том, где останавливается вывод. Зависло на Trying — соединение не открывается: файрвол или маршрут. Сразу после Trying пришло Connection refused — порт никто не слушает. Есть Connected, но ошибка про сертификат — проблема с HTTPS, ей посвящён раздел про nginx. Есть < HTTP/1.1 500 — сеть в порядке, падает приложение.

Ещё два приёма, которые пригодятся очень скоро. Запрос с сервера к самому себе, curl -I http://localhost:8000, отделяет «приложение не работает» от «приложение не видно снаружи». А флаг -H подставляет заголовок: curl -I -H "Host: site.ru" http://192.168.1.50 спрашивает сервер так, будто ты пришёл по имени site.ru, — без него не проверить nginx, на котором живёт несколько сайтов. Флаг -k разрешает самоподписанный сертификат, им пользуются только на тестовых стендах.

Словарь урока

curl
Программа, которая отправляет запрос по адресу и печатает ответ. ↩ к тексту
заголовки
Служебные строки ответа перед содержимым: код, тип, сервер, перенаправление. ↩ к тексту
код ответа
Трёхзначное число в первой строке ответа: 2xx успех, 3xx перенаправление, 4xx ошибка запроса, 5xx ошибка сервера. ↩ к тексту
перенаправление
Ответ 301 или 302 с заголовком Location: иди по другому адресу. ↩ к тексту

Что спросят на собеседовании

  • Чем отличаются ошибки 4xx и 5xx?
    4xx — проблема в запросе клиента: нет страницы, нет прав. 5xx — проблема на сервере: упало приложение или прокси его не дождался.
  • Как понять по curl, на каком этапе не открывается сайт?
    curl -v: видно, разрешилось ли имя, открылось ли соединение, прошёл ли TLS и какой код вернуло приложение.
  • Чем 502 Bad Gateway отличается от 504 Gateway Timeout?
    Оба возвращает прокси, например nginx. 502 — до приложения не достучался или получил негодный ответ: оно упало или слушает не тот порт. 504 — не дождался ответа за отведённое время: приложение зависло или соединение не устанавливается.

Что дальше

В практике ты нарочно поломаешь простую службу на стенде тремя способами и научишься узнавать каждую поломку по ответу nc и curl со своей машины.

Проверь себя+130 XPдве попытки
1
Коды ответа
curl -I вернул HTTP/1.1 502 Bad Gateway. Где искать проблему?
2
Перенаправления
curl -I показал 301 и строку Location. Как увидеть конечную страницу?
3
curl -v
В выводе curl -v последняя строка «* Trying 192.168.1.50:80...», дальше тишина. На каком слое проблема?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.