Мережа та віддалений доступ

Команда curl

Надсилайте запити HTTP і завантажуйте дані

Linux · Bash приклади · команди виконуються на вибраному сервері

Коли використовувати curl

Використовуйте curl, щоб перевірити відповіді HTTP, завантажити ресурс або викликати API із сервера. Відокремлюйте успіх транспортування від успіху програми, установлюйте розумні тайм-аути та не використовуйте маркери автентифікації в збережених прикладах команд.

Синтаксис

curl [PARAMETERS] 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.