cURL справочник
Търсим, удобен за печат справочник за curl — HTTP методи, заглавки, данни и формуляри, удостоверяване, изтегляния, бисквитки, 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-кодирани данни от форма
curl -d '@payload.json' https://x.com
POST на данни, прочетени от файл
curl --data-urlencode 'q=hello world' https://x.com
POST на едно URL-кодирано поле
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
Изпраща OAuth 2.0 bearer токен
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
Показва проста лента за прогрес
Бисквитки
8curl -b 'session=abc123' https://x.com
Изпраща бисквитка вградено
curl -b cookies.txt https://x.com
Изпраща бисквитки от файл
curl -c cookies.txt https://x.com
Записва получените бисквитки в jar
curl -b jar.txt -c jar.txt https://x.com
Чете и обновява същия cookie jar
curl -b 'a=1; b=2' https://x.com
Изпраща няколко бисквитки наведнъж
curl -c - https://x.com
Отпечатва получените бисквитки в stdout
curl --junk-session-cookies -b jar.txt https://x.com
Игнорира сесийните бисквитки от 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 handshake
Прокси
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
Извежда еквивалентен libcurl C код
Изчаквания и повторни опити
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“.
Нуждаете се от помощ?
Открихте проблем с този инструмент? Кажете ни.