Начало работы
Базовые запросы
curl выполняет HTTP-запросы из командной строки. По умолчанию используется GET. -v показывает подробный вывод, -o сохраняет в указанный файл, -O сохраняет удалённое имя файла, -L следует перенаправлениям, -I запрашивает только заголовки (HEAD-запрос).
# GET request (default)
curl https://example.com
# with verbose output
curl -v https://example.com
# save output to file
curl -o output.html https://example.com
curl -O https://example.com/file.zip # keep remote filename
# follow redirects
curl -L https://example.com/redirect
# show only headers
curl -I https://example.com
curl --head https://example.comВывод и сохранение
-o записывает тело в указанный файл; -O использует удалённое имя файла. --output-dir задаёт каталог назначения. -s (silent) скрывает индикатор прогресса и ошибки — добавьте -S, чтобы ошибки всё же показывались. Используйте -D для дампа заголовков в файл, отбрасывая тело через -o /dev/null.
# print body to stdout (default)
curl https://example.com
# save body to file
curl -o page.html https://example.com
# save with remote filename
curl -O https://example.com/file.zip
# save to specific dir with remote name
curl -O --output-dir /tmp https://example.com/file.zip
# append to file
curl https://example.com >> log.txt
# discard body, keep headers
curl -o /dev/null -D headers.txt https://example.com
# silent (no progress, no errors)
curl -s https://example.comПодробный режим и заголовки
-v (verbose) печатает весь диалог: '>' — запрос, '<' — ответ, '*' — служебная информация curl; всё идёт в stderr, поэтому stdout остаётся чистым для тела. -I отправляет HEAD-запрос и печатает заголовки. -D дампит заголовки в файл или '-' в stdout; в сочетании с -o /dev/null можно изучать заголовки, не сохраняя тело.
# verbose: shows request + response, sent to stderr
curl -v https://example.com
# > lines are the request, < lines are the response
# * lines are curl's internal info
# headers only (HEAD request)
curl -I https://example.com
# dump response headers to file
curl -D headers.txt -o body.html https://example.com
# dump headers to stdout, body to file
curl -D - -o body.html https://example.com
# show only response headers (no HEAD)
curl -s -o /dev/null -D - https://example.comСледование перенаправлениям
-L следует HTTP-перенаправлениям 3xx; по умолчанию curl проходит до 50 переходов (ограничьте через --max-redirs). RFC 301/302 обычно превращает POST в GET — используйте --post301/--post302, чтобы сохранить метод. По умолчанию учётные данные не отправляются перенаправленным хостам; --location-trusted отправляет их везде (риск безопасности).
# follow 3xx redirects
curl -L https://example.com/old
# limit number of redirects
curl -L --max-redirs 5 https://example.com
# treat redirects as POST (default resends as GET)
curl -L --post301 --post302 https://example.com
# show each hop in a redirect chain
curl -L -v https://short.url/abc 2>&1 | grep -i location
# follow only http/https redirects
curl -L --proto-redir http,https https://example.com
# send credentials only on first request
curl -L --location-trusted -u user:pass https://example.comСинтаксис URL и globbing
curl раскрывает шаблоны «globbing» в URL: диапазоны [1-10], списки {a,b,c}, с необязательным :step. Каждое раскрытие — отдельный запрос. Используйте -g (--globoff), чтобы трактовать скобки буквально — важно для URL с JSON-массивами или IPv6-адресами вроде http://[::1]:8080/.
# range glob: requests file1, file2, file3
curl -O https://example.com/file[1-3].zip
# range with step
curl -O https://example.com/file[1-10:2].zip # 1,3,5,7,9
# list glob: a, b, c
curl -O https://example.com/{a,b,c}.zip
# combined globs
curl -O https://example.com/{v1,v2}/file[1-2].txt
# output each URL as it is fetched
curl -O https://example.com/file[1-3].zip --write-out "%{url} -> %{filename}\n"
# disable globbing (literal brackets/braces)
curl -g "https://example.com/file[1].zip"Справка и версия
--version показывает версию curl, поддерживаемые протоколы (HTTP, HTTPS, FTP и др.) и скомпилированные возможности (HTTP2, SSL, brotli). --help all перечисляет все опции — удобно, когда помните лишь часть имени флага. Возможности зависят от сборки curl (например, HTTP/3 нужна специальная сборка).
# version and supported features
curl --version
# short help (one-line per option)
curl --help
# long help (all options with details)
curl --help all
# search help for a keyword
curl --help all | grep -i cookie
# list supported protocols
curl --version | head -1
# check if a feature is built in
curl --version | grep -i http2HTTP-методы
GET-запросы
GET — метод по умолчанию. Всегда берите URL с & или ? в кавычки, чтобы оболочка не отправила его в фон и не раскрыла. -X явно задаёт метод, но для GET обычно не нужен. Для API задайте Accept для согласования формата ответа.
# simple GET (default method)
curl https://api.example.com/data
# GET with query string
curl "https://api.example.com/search?q=curl&page=2"
# explicit method
curl -X GET https://example.com
# GET with headers
curl -H "Accept: application/json" https://api.example.com/data
# GET with auth
curl -u user:pass https://api.example.com/secretPOST-запросы
Отправка -d автоматически переключает метод на POST, поэтому -X POST избыточен (но безвреден и проясняет намерение). Чтобы отправить POST-ом файл, используйте -d @filename (@ читает файл). Content-Type по умолчанию для -d — application/x-www-form-urlencoded; переопределите через -H для JSON.
# POST with form data (application/x-www-form-urlencoded)
curl -X POST -d "name=Alice&age=30" https://api.example.com/users
# -d implies POST, so -X is optional
curl -d "name=Alice" https://api.example.com/users
# POST with no body
curl -X POST https://api.example.com/trigger
# POST JSON
curl -X POST -H "Content-Type: application/json" \
-d '{"name":"Alice"}' https://api.example.com/users
# POST with data from a file
curl -X POST -d @form.txt https://api.example.com/usersPUT и PATCH
PUT заменяет ресурс целиком; PATCH применяет частичное обновление. Оба требуют -X, потому что у curl нет для них -d-сокращения. -T (upload-file) передаёт файл как тело запроса и идеален для PUT-загрузок. Используйте --data-binary вместо -d, чтобы не терять переводы строк при отправке сырых файлов.
# PUT (replace entire resource)
curl -X PUT -H "Content-Type: application/json" \
-d '{"name":"Alice","age":31}' \
https://api.example.com/users/1
# PATCH (partial update)
curl -X PATCH -H "Content-Type: application/json" \
-d '{"age":32}' \
https://api.example.com/users/1
# PUT a file as body
curl -X PUT --data-binary @config.json \
-H "Content-Type: application/json" \
https://api.example.com/config
# PUT with upload file
curl -X PUT -T localfile.txt https://example.com/remote.txtDELETE
DELETE удаляет ресурс. Большинство API требуют аутентификации, поэтому добавьте -u или заголовок Authorization. Некоторые API принимают тело (причина, флаги каскада) — добавьте -d и заголовок Content-Type. Используйте -w '%{http_code}' для проверки результата: 204 (No Content) и 200 — типичные успешные ответы.
# delete a resource
curl -X DELETE https://api.example.com/users/1
# delete with auth
curl -X DELETE -H "Authorization: Bearer TOKEN" \
https://api.example.com/users/1
# delete with confirmation check
curl -X DELETE -w "%{http_code}" -o /dev/null -s \
https://api.example.com/users/1
# delete with request body (some APIs require it)
curl -X DELETE -H "Content-Type: application/json" \
-d '{"reason":"spam"}' \
https://api.example.com/users/1HEAD и OPTIONS
-I отправляет HEAD-запрос (только заголовки, без тела) — полезно проверить размер (Content-Length), тип (Content-Type) и дату изменения, ничего не скачивая. OPTIONS раскрывает разрешённые методы (заголовок Allow) и используется браузерами для CORS-preflight. Добавьте заголовки Origin и Access-Control-Request-Method, чтобы сымитировать настоящий preflight.
# HEAD: headers only, no body
curl -I https://example.com
curl --head https://example.com
# OPTIONS: discover allowed methods
curl -X OPTIONS https://api.example.com/users
# OPTIONS with CORS preflight headers
curl -X OPTIONS \
-H "Origin: https://mysite.com" \
-H "Access-Control-Request-Method: POST" \
https://api.example.com/users
# check allowed methods from Allow header
curl -X OPTIONS -s -D - -o /dev/null https://api.example.com | grep -i allowЗаголовки
Установка заголовков (-H)
-H (--header) добавляет заголовок запроса. Повторяйте -H для нескольких заголовков. Завершающая точка с запятой (X-Empty;) отправляет пуст ое значение. @headers.txt читает заголовки из файла (по строке «Name: value») — удобно держать токены Authorization вне истории команд.
# single header
curl -H "Accept: application/json" https://api.example.com/data
# multiple headers
curl -H "Accept: application/json" \
-H "Authorization: Bearer TOKEN" \
-H "X-Custom: value" \
https://api.example.com/data
# header with empty value
curl -H "X-Empty;" https://example.com
# headers from a file (one per line)
curl -H @headers.txt https://example.com
# Content-Type for POST
curl -X POST -H "Content-Type: application/json" \
-d '{"a":1}' https://api.example.comЧастые заголовки
Самые частые заголовки: Accept сообщает серверу нужный формат; Content-Type описывает тело запроса; Authorization несёт учётные данные. --compressed просит curl запросить сжатые ответы (gzip, br) и автоматически их распаковать, поэтому кодировку не нужно обрабатывать вручную.