Программа curl стоит на серверах, в контейнерах, в телефонах, в автомобилях и даже на марсианском вертолёте Ingenuity из миссии Mars 2020. Её написал Даниэль Стенберг в 1998 году, и делает она одну вещь: отправляет запрос по адресу и печатает ответ. Для DevOps это главный способ спросить сайт или API «как ты?» без браузера — с сервера, из контейнера, из шага CI.
Браузер прячет детали за красивой страницей ошибки, а curl показывает всё как есть: код ответа, заголовки, перенаправления и место, где разговор оборвался. В порядке диагностики из прошлого урока он закрывает пятую ступень, «приложение»: машина доступна, порт открыт — что отвечает сама служба? По её ответу уже видно, работает она, переехала по другому адресу или сломалась.
curl -I: только заголовки
Флаг -I (заглавная i) просит у сервера только заголовки ответа — служебные строки перед содержимым страницы. Для проверки этого достаточно, а страница на сто килобайт в терминале не нужна.
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, — служебные промежуточные ответы, в работе их почти не видно.
| код | смысл | что делать |
|---|---|---|
| 2xx | 200 OK — всё хорошо | ничего |
| 3xx | 301, 302 — ищи по другому адресу | смотреть заголовок Location |
| 4xx | 404 — нет такой страницы, 403 — нельзя | проблема в запросе: адрес, права |
| 5xx | 500 — ошибка в приложении, 502 — прокси не достучался до приложения, 504 — прокси не дождался ответа | логи приложения и nginx |
Читать так: 502 Bad Gateway пришёл — значит, сеть, DNS и nginx в порядке, а приложение за ним не принимает соединения: не запущено или слушает другой порт. 504 Gateway Timeout — прокси достучаться пытался, но ответа не дождался: приложение зависло или пакеты к нему молча выбрасывает файрвол. Оба кода экономят час поисков «в сети»: до прокси сеть точно работает.
Код 3xx встречается так часто, что для него в curl есть свой флаг.
Перенаправления
Многие сайты отвечают на http:// перенаправлением на https://. curl по умолчанию не идёт за ним, а показывает, куда его послали.
curl -I http://github.com HTTP/1.1 301 Moved Permanently Location: https://github.com/
301 — «переехали навсегда», Location — куда. Флаг -L велит curl пройти по перенаправлениям до конца:
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, с > — что он отправил, с < — что получил.
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 разрешает самоподписанный сертификат, им пользуются только на тестовых стендах.
Словарь урока
Что спросят на собеседовании
- Чем отличаются ошибки 4xx и 5xx?4xx — проблема в запросе клиента: нет страницы, нет прав. 5xx — проблема на сервере: упало приложение или прокси его не дождался.
- Как понять по curl, на каком этапе не открывается сайт?curl -v: видно, разрешилось ли имя, открылось ли соединение, прошёл ли TLS и какой код вернуло приложение.
- Чем 502 Bad Gateway отличается от 504 Gateway Timeout?Оба возвращает прокси, например nginx. 502 — до приложения не достучался или получил негодный ответ: оно упало или слушает не тот порт. 504 — не дождался ответа за отведённое время: приложение зависло или соединение не устанавливается.
Что дальше
В практике ты нарочно поломаешь простую службу на стенде тремя способами и научишься узнавать каждую поломку по ответу nc и curl со своей машины.