Сеть и удалённый доступ

Команда curl

Отправлять HTTP-запросы и скачивать данные

Linux · примеры для Bash · команда выполняется на выбранном сервере

Когда использовать curl

Команда curl проверяет ответы HTTP, скачивает ресурсы и обращается к API с сервера. Различайте успешную передачу и успешный ответ приложения, задавайте тайм-аут и не сохраняйте токены аутентификации в общедоступных примерах.

Синтаксис

curl [ПАРАМЕТРЫ] URL

Квадратные скобки обозначают необязательные аргументы, многоточие — повторение. Замените условные имена файлов, пользователей и серверов своими значениями.

Основные параметры и аргументы

-I
Запросить только HTTP-заголовки методом HEAD.
-f
Завершиться с ошибкой для HTTP-кодов 400 и выше.
-L
Следовать перенаправлениям; -o задаёт файл результата.

Примеры использования

Проверить заголовки сайта

curl -I https://example.com

Выполняется запрос только заголовка; некоторые службы обрабатывают это иначе, чем обычный запрос контента.

Скачать файл с обработкой HTTP-ошибок

curl --fail --location --output ./page.html https://example.com

Выполняются перенаправления, и тело ответа заменяет указанный локальный файл; Состояния ошибок HTTP приводят к сбою.

Запросить JSON с ограничением времени

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

Запрашивается ответ JSON с ограниченной общей продолжительностью; конечная точка должна фактически предоставить этот API.

Особенности и ограничения

  • При HTTPS сертификат проверяется по умолчанию; не отключайте проверку через -k без отдельной причины.
  • Не помещайте реальные токены или пароли в историю команд и не запускайте скачанные скрипты без проверки.

Частые вопросы и решение проблем

Почему curl завершается успешно, когда сервер возвращает страницу с ошибкой?

Без опции сбоя получение ответа об ошибке HTTP все равно может считаться успешной передачей. Проверьте статус HTTP и статус завершения команды.

Должен ли я отключить проверку сертификата, чтобы исправить HTTPS?

Не игнорируйте доверие как обычное решение. Вместо этого проверьте имя хоста, системное время, цепочку сертификатов сервера и конфигурацию доверенного центра сертификации.

Подробная справка

Параметры могут зависеть от установленной версии и дистрибутива. Проверьте справку с помощью следующей команды: man curl.