Шпаргалка з cURL
Доступний для пошуку та друку довідник з curl — методи HTTP, заголовки, дані та форми, автентифікація, завантаження, cookie, TLS, проксі та налагодження. Безкоштовно.
Основи
12curl https://api.example.com
Надіслати GET-запит та вивести тіло
curl -o page.html https://example.com
Зберегти відповідь у вказаний файл
curl -O https://example.com/file.zip
Зберегти з іменем віддаленого файлу
curl -i https://example.com
Показати заголовки відповіді разом із тілом
curl -I https://example.com
Отримати лише заголовки відповіді (HEAD)
curl -v https://example.com
Докладний вивід запиту/відповіді
curl -s https://example.com
Тихий режим, приховати прогрес та помилки
curl -sS https://example.com
Тихо, але показувати помилки
curl -L https://example.com
Слідувати за HTTP-перенаправленнями (3xx)
curl https://a.com https://b.com
Запитати кілька URL за один виклик
curl 'https://x.com/p?[1-5]'
Використати числовий діапазон для перебору URL
curl --version
Вивести версію та можливості curl
Методи HTTP
9curl -X GET https://api.example.com
Явно надіслати GET-запит
curl -X POST https://api.example.com
Надіслати POST-запит
curl -X PUT https://api.example.com/1
Надіслати PUT-запит для заміни ресурсу
curl -X PATCH https://api.example.com/1
Надіслати PATCH-запит для оновлення полів
curl -X DELETE https://api.example.com/1
Надіслати DELETE-запит
curl -I https://api.example.com
Надіслати HEAD-запит лише для заголовків
curl -X OPTIONS https://api.example.com
Надіслати OPTIONS preflight-запит
curl --head https://api.example.com
Повна форма -I для HEAD-запиту
curl --request POST https://x.com
Повна форма -X для встановлення методу
Заголовки
10curl -H 'Accept: application/json' https://x.com
Додати один заголовок запиту
curl -H 'X-Token: abc' -H 'X-Env: dev' https://x.com
Додати кілька заголовків
curl -H 'Content-Type: application/json' https://x.com
Вказати тип вмісту тіла запиту
curl -H 'Authorization: Bearer TOKEN' https://x.com
Надіслати заголовок авторизації bearer
curl -H 'Host: example.com' https://1.2.3.4
Перевизначити заголовок Host
curl -H 'Accept-Encoding: gzip' https://x.com
Запросити відповідь, стиснуту gzip
curl -A 'MyAgent/1.0' https://x.com
Встановити рядок User-Agent
curl -e 'https://ref.com' https://x.com
Встановити заголовок Referer
curl -H 'X-Debug:' https://x.com
Видалити стандартний заголовок, залишивши порожнім
curl --compressed https://x.com
Запросити та автоматично розпакувати відповідь
Надсилання даних
11curl -d 'name=Jane&age=30' https://x.com
POST дані форми у форматі URL-encoded
curl -d '@payload.json' https://x.com
POST даних, прочитаних з файлу
curl --data-urlencode 'q=hello world' https://x.com
POST одного URL-encoded поля
curl --data-binary '@file.bin' https://x.com
POST сирих байтів без обробки
curl -G --data-urlencode 'q=cats' https://x.com
Додати дані як рядок GET-запиту
curl -X POST -H 'Content-Type: application/json' -d '{"name":"Jane"}' https://x.com
POST тіла JSON
curl --json '{"name":"Jane"}' https://x.com
POST JSON з автоматичним встановленням заголовків JSON
curl -F 'name=Jane' https://x.com
Надіслати поле multipart-форми
curl -F 'file=@photo.png' https://x.com
Завантажити файл як multipart form-data
curl -F 'file=@a.pdf;type=application/pdf' https://x.com
Завантажити файл з явним MIME-типом
curl -d '' https://x.com
POST з порожнім тілом
Автентифікація
9curl -u user:pass https://x.com
Базова HTTP-автентифікація
curl -u user https://x.com
Базова автентифікація, запит пароля
curl -H 'Authorization: Bearer TOKEN' https://x.com
Надіслати заголовок bearer-токена
curl --oauth2-bearer TOKEN https://x.com
Надіслати bearer-токен OAuth 2.0
curl --digest -u user:pass https://x.com
Використати HTTP digest-автентифікацію
curl --ntlm -u user:pass https://x.com
Використати NTLM-автентифікацію
curl --netrc https://x.com
Прочитати облікові дані з ~/.netrc
curl --netrc-file creds https://x.com
Прочитати облікові дані зі свого netrc-файлу
curl -H 'X-Api-Key: KEY' https://x.com
Надіслати заголовок з API-ключем
Завантаження та вивантаження
11curl -O https://x.com/file.zip
Завантажити з іменем віддаленого файлу
curl -o out.zip https://x.com/file.zip
Завантажити у вибране ім'я файлу
curl -OL https://x.com/file.zip
Завантажити та слідувати перенаправленням
curl -C - -O https://x.com/file.zip
Відновити часткове завантаження
curl --limit-rate 200k -O https://x.com/f
Обмежити швидкість передачі
curl -r 0-1023 -o part https://x.com/f
Завантажити лише діапазон байтів
curl --retry 3 -O https://x.com/f
Повторити завантаження при невдачі
curl -T file.txt ftp://x.com/
Вивантажити файл через PUT/FTP
curl -T file.txt https://x.com/up
Вивантажити файл через HTTP PUT
curl --create-dirs -o a/b/f.txt https://x.com
Створити відсутні каталоги для виводу
curl -# -O https://x.com/file.zip
Показати простий індикатор прогресу
Cookies
8curl -b 'session=abc123' https://x.com
Надіслати cookie вбудовано
curl -b cookies.txt https://x.com
Надіслати cookies з файлу
curl -c cookies.txt https://x.com
Записати отримані cookies у jar
curl -b jar.txt -c jar.txt https://x.com
Читати та оновлювати той самий cookie jar
curl -b 'a=1; b=2' https://x.com
Надіслати кілька cookies одразу
curl -c - https://x.com
Вивести отримані cookies у stdout
curl --junk-session-cookies -b jar.txt https://x.com
Ігнорувати сесійні cookies з jar
curl -L -c jar.txt -b jar.txt https://x.com/login
Зберегти сесію через перенаправлення
TLS / SSL
10curl -k https://x.com
Дозволити небезпечне (пропустити перевірку сертифіката)
curl --cacert ca.pem https://x.com
Перевірити власним CA-пакетом
curl --capath /etc/ssl/certs https://x.com
Використати каталог CA-сертифікатів
curl --cert client.pem https://x.com
Надіслати клієнтський сертифікат
curl --cert client.pem --key client.key https://x.com
Використати клієнтський сертифікат та приватний ключ
curl --tlsv1.2 https://x.com
Вимагати щонайменше TLS 1.2
curl --tlsv1.3 https://x.com
Вимагати щонайменше TLS 1.3
curl --tls-max 1.2 https://x.com
Обмежити максимальну версію TLS
curl --ciphers ECDHE-RSA-AES128-GCM-SHA256 https://x.com
Обмежити дозволені шифри TLS
curl -vI https://x.com
Переглянути деталі TLS-рукостискання
Проксі
9curl -x http://proxy:8080 https://x.com
Спрямувати запит через HTTP-проксі
curl --proxy http://proxy:8080 https://x.com
Повна форма -x для встановлення проксі
curl -x proxy:8080 -U user:pass https://x.com
Автентифікуватися на проксі
curl --proxy-user user:pass -x proxy:8080 https://x.com
Повна форма облікових даних проксі
curl --socks5 127.0.0.1:1080 https://x.com
Використати проксі SOCKS5
curl --socks5-hostname 127.0.0.1:1080 https://x.com
Проксі SOCKS5 з віддаленим розв'язанням DNS
curl --socks4 127.0.0.1:1080 https://x.com
Використати проксі SOCKS4
curl --noproxy example.com https://x.com
Обійти проксі для вказаних хостів
curl -x '' https://x.com
Вимкнути будь-який налаштований проксі
Налагодження та вивід
11curl -w '%{http_code}\n' -o /dev/null -s https://x.com
Вивести лише HTTP-код стану
curl -w '%{time_total}\n' -o /dev/null -s https://x.com
Вивести загальний час передачі
curl -w '@format.txt' https://x.com
Прочитати формат write-out з файлу
curl -D headers.txt https://x.com
Зберегти заголовки відповіді у файл
curl -D - -o body.txt https://x.com
Заголовки у stdout, тіло у файл
curl --trace trace.txt https://x.com
Повне hex-трасування передачі
curl --trace-ascii - https://x.com
ASCII-трасування у stdout
curl --trace-time -v https://x.com
Додати позначки часу до докладного виводу
curl -v https://x.com 2>&1 | less
Гортати докладний лог посторінково
curl -sS -o /dev/null -w '%{size_download}\n' https://x.com
Вивести кількість завантажених байтів
curl --libcurl out.c https://x.com
Згенерувати еквівалентний C-код libcurl
Тайм-аути та повтори
10curl --connect-timeout 5 https://x.com
Обмежити фазу з'єднання в секундах
curl --max-time 30 https://x.com
Обмежити час усієї операції
curl --retry 3 https://x.com
Повторити при тимчасових помилках
curl --retry 3 --retry-delay 2 https://x.com
Очікувати між спробами повтору
curl --retry 5 --retry-max-time 60 https://x.com
Обмежити загальний час повторів
curl --retry-connrefused https://x.com
Також повторювати при відмові у з'єднанні
curl --retry-all-errors https://x.com
Повторювати при будь-якій помилці, не лише тимчасовій
curl --speed-limit 100 --speed-time 10 https://x.com
Перервати, якщо надто повільно протягом часу
curl --keepalive-time 60 https://x.com
Встановити інтервал TCP keep-alive
curl --expect100-timeout 1 https://x.com
Обмежити очікування 100-continue
Жоден запис не відповідає “:q”.
Потрібна допомога?
Виникла проблема з цим інструментом? Повідомте нас.