curl

Передать данные по URL: HTTP, HTTPS, FTP, SOCKS и др.

Готовые примеры · man page

Флаги

Abstract unix-сокет (Linux) вместо пути в файловой системе.

Включить поддержку Alt-Svc: переподключение к h3-эндпоинту.

Выбрать самый сильный метод авторизации из предложенных сервером.

Дописывать в существующий файл на сервере вместо перезаписи (FTP/SMTP).

Подпись запроса по схеме AWS Signature V4 (service и регион).

Принудительно Basic-авторизация.

(TLS) Использовать для проверки сертификатов встроенное хранилище CA операционной системы, дополнительно к другим заданным местам поиска CA.

Файл CA-сертификатов для проверки подлинности сервера.

Директория хешированных CA-сертификатов.

Клиентский сертификат (PEM или PKCS12 вместе с -E).

(TLS) Проверять статус сертификата сервера расширением Certificate Status Request (OCSP stapling); при невалидном ответе соединение прерывается.

Формат клиентского сертификата: PEM, DER или P12.

Список допустимых шифрокомплектов в формате OpenSSL/GnuTLS.

(SCP SFTP) Включить сжатие SSH — это просьба, а не приказ: сервер может её не выполнить; данные идут по каналу сжатыми и распаковываются на приёмной стороне.

Прочитать опции curl из указанного файла, по одной на строку.

Лимит времени на установку соединения, секунды.

Для запроса, предназначенного паре «HOST1:PORT1», устанавливать сетевое соединение с «HOST2:PORT2»; на имя и порт, используемые в TLS/SSL и заголовках Host, не влияет.

Полное имя -C.

Полное имя -b.

Полное имя -c.

Создать недостающие директории для файла из -o.

Права на создаваемые файлы в восьмеричной записи.

(FTP SMTP) Конвертировать переводы строки LF в CR+LF при загрузке; полезно для MVS (OS/390), отключается ключом --no-crlf.

Список отзыва сертификатов (CRL) для проверки пира.

Список допустимых эллиптических кривых TLS.

Полное имя -d.

Тело запроса с конвертацией переводов строк в LF.

(HTTP) Отправлять POST-данные как --data, но без специального понимания символа @ в значении.

URL-кодировать указанную строку или содержимое файла.

(GSS/kerberos) Задать LEVEL разрешения делегирования учётных данных пользователя: none, policy, full или forwardable.

HTTP Digest-авторизация.

Если указан первым параметром командной строки, конфигурационный файл curlrc не читается и не используется.

(FTP) Запретить команды EPRT и LPRT при активной передаче FTP, сразу используя PORT.

(FTP) Запретить команду EPSV при пассивной передаче FTP, не пробуя её перед PASV; вернуть обратно можно через --epsv.

Завершаться ошибкой, если переданный URL содержит имя пользователя; применимо, когда URL приходит извне во время выполнения.

(DNS) Посылать исходящие DNS-запросы через указанный сетевой интерфейс (имя, а не адрес); аналог --interface, но касающийся только DNS.

(DNS) Привязываться к указанному IPv4-адресу при отправке IPv4 DNS-запросов, чтобы они исходили именно с него.

(DNS) Привязываться к указанному IPv6-адресу при отправке IPv6 DNS-запросов, чтобы они исходили именно с него.

Использовать указанные DNS-серверы вместо системных.

(DNS) То же, что --cert-status, но для DoH (DNS-over-HTTPS): проверять сертификат сервера DoH через OCSP stapling.

(DNS) Пропускать проверку безопасности соединений с сервером DoH; по умолчанию каждое такое соединение проверяется перед передачей.

DNS over HTTPS: эндпоинт для резолвинга имён.

(TLS) Вывести связку CA, встроенную в curl, в стандартный поток и завершиться; если сборка собрана без встроенной связки, вывод пуст.

Полное имя -D.

(HTTPS) Задать способ обработки ECH (Encrypted Client Hello): false (по умолчанию), grease, true, force или name.<config>.

Сокет EGD-демона для сбора энтропии (legacy).

Использовать криптографический движок OpenSSL (pkcs11, tpm…).

Отправить If-None-Match с ETag из файла (условный запрос).

Сохранить полученный ETag в файл.

Раскрыть переменные и функции вида {{fix:trim:url}} в отправляемых данных, например «"{{fix:trim:url}}"».

Раскрыть переменные вида {{NAME}} в указанном URL, например «= "https://example.com/api/{{USER}}/method"».

Раскрыть переменные вида {{NAME}} в значении, взятом из файла, например «@{{HOME}}/.secret».

Сколько ждать Continue-100 перед отправкой тела запроса.

Полное имя -f.

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

Как -f, но тело ошибки всё равно сохраняется/печатается.

(TLS) Использовать false start при TLS-рукопожатии: клиент начинает отправлять данные приложения до проверки сообщения Finished от сервера; поддержки в бэкендах нет.

(HTTP) Следовать HTTP-редиректам и при переходе использовать метод, заданный --request, как то говорит спецификация HTTP.

Полное имя -F.

(HTTP IMAP SMTP) Передавать имена полей и файлов multipart-формы с backslash-экранированием вместо percent-encoding.

Как -F, но значение передаётся литералом, файл не читается.

(FTP) Посылать данные ответа на запрос «account data» командой ACCT после предоставления имени пользователя и пароля.

(FTP) Если аутентификация командами USER и PASS не удалась, послать эту команду; например «SITE AUTH» для Secure Transport сервера Tumbleweed по клиентскому сертификату.

Создавать недостающие директории на FTP по пути.

Стратегия доступа к файлам на FTP: default, multicwd, nocwd, singlecwd.

Пассивный FTP-режим (поведение по умолчанию).

Активный FTP-режим: адрес, куда сервер откроет data-соединение.

(FTP) Посылать команду PRET перед PASV (и EPSV); некоторые серверы, главным образом drftpd, требуют её для листингов и закачек в пассивном режиме.

Игнорировать IP из PASV-ответа (полезно за NAT).

(FTP) Использовать CCC (Clear Command Channel): закрыть слой SSL/TLS после аутентификации, оставив дальнейший control-канал открытым, чтобы NAT-маршрутизаторы видели транзакцию FTP.

(FTP) Задать режим CCC: passive ждёт завершения со стороны сервера и не отвечает на него, active инициирует закрытие и ждёт подтверждения сервера.

(FTP) Требовать SSL/TLS для входа в FTP, оставляя передачу данных незашифрованной: безопасная аутентификация при эффективности; передача падает, если сервер SSL/TLS не поддерживает.

Отправить данные из -d/--data-* как query-строку методом GET.

Полное имя -g.

Задать таймаут алгоритма Happy Eyeballs в миллисекундах: IPv6 получает фору перед IPv4 при соединении с dual-stack хостами.

Передавать HAProxy-заголовок с клиентским IP-адресом.

Посылать заголовок протокола HAProxy v1/v2 на соединение.

Полное имя -I.

Полное имя -H.

Справка по использованию и выход.

(SFTP SCP) Передать 32 шестнадцатеричные цифры — MD5-хеш открытого ключа удалённого хоста; curl откажет в соединении, если хеши не совпадают.

(SFTP SCP) Передать Base64-кодированный SHA256-хеш открытого ключа удалённого хоста; curl откажет в соединении при несовпадении хешей.

(HTTPS) Включить HSTS для передачи: использовать существующий кэш-файл HSTS и пересохранить его после завершения, если он изменился.

Использовать HTTP/2 для поддерживающих его схем.

HTTP/2 без upgrade-рукопожатия (h2c напрямую).

Экспериментальный HTTP/3 (QUIC), если сборка поддерживает.

Только HTTP/3, без отката на более старые версии.

(HTTP) Экспериментально подписывать исходящие HTTP-запросы по RFC 9421 HTTP Message Signatures, указывая используемый алгоритм подписи (не применять в проде).

(HTTP) Экспериментально задать список компонентов через пробел, включаемых в подпись сообщения по RFC 9421: производные компоненты даются простыми именами method, authority, path, query, поля заголовков указываются с двоеточием (не применять в проде).

(HTTP) Экспериментально задать ключ для подписей по RFC 9421: как есть либо через «@filename», где остаток трактуется как имя файла (не применять в проде).

(HTTP) Экспериментально задать идентификатор ключа, включаемый в параметр «keyid» заголовка Signature-Input при подписях по RFC 9421.

Игнорировать Content-Length: читать до закрытия соединения.

Полное имя -k.

Привязать соединения к указанному сетевому интерфейсу или IP.

Задать Type of Service для IPv4 или Traffic Class для IPv6: числом от 1 до 255 либо одним из имён вроде CS0..CS7, AF11..AF43, EF или DF.

Gateway для работы с IPFS-URL вида ipfs://CID.

Использовать только IPv4-адреса.

Использовать только IPv6-адреса.

POST JSON с автоматическими заголовками Content-Type и Accept.

Сохранять сессионные куки в файл (-c) для воспроизводимости.

Задать максимальное число keepalive-зондов TCP, которые отправляются без ответа перед разрывом соединения; обычно применяется с --keepalive-time.

Задать время простоя соединения перед отправкой keepalive-зондов и интервал между ними; действует на ОС с TCP_KEEPIDLE и TCP_KEEPINTVL.

Приватный ключ, соответствующий --cert.

Формат приватного ключа: PEM, DER, ENG или P12.

(SCP SFTP) Указать файл известных хостов, по которому curl проверяет, что подключаемый хост идентичен ранее виденному.

(FTP) Устаревший ключ (добавлен в 8.17.0), более ничего не делает: включал Kerberos-аутентификацию с уровнем clear, safe, confidential или private.

Дописать к обычной командной строке curl — и в файл будет выведен C-исходник, использующий libcurl и делающий эквивалент того, что выполняет ваша команда.

Ограничить скорость передачи, например 20k или 2M.

Только листинг директории FTP, без скачивания содержимого файлов.

Диапазон локальных портов, например 60000-65000.

Полное имя -L.

Следовать редиректам и передавать учётные данные доверенным хостам.

(IMAP LDAP POP3 SMTP) Задать параметры входа, используемые при аутентификации на сервере; протокол-специфичные опции поддерживают пока IMAP, POP3 и SMTP.

Адрес для AUTH в SMTP (отличается от конверта отправителя).

Отправитель для SMTP-транзакции.

Получатель SMTP-сообщения (повторяется для нескольких адресов).

(SMTP) Не прерывать SMTP-беседу, если хотя бы один получатель вызывает ошибку RCPT TO при рассылке данным нескольким адресатам.

Показать большой справочный текст руководства; пример: curl --manual. См. также --verbose, --libcurl и --trace.

Отказаться скачивать файл, превышающий указанный размер в байтах.

Лимит числа редиректов до остановки с ошибкой.

Общий лимит времени на всю операцию, секунды.

Скачать по metalink-описанию с зеркалами и проверкой контрольных сумм.

Включить Multipath TCP (MPTCP) для соединений. MPTCP — расширениестандартного TCP, повышающее устойчивость при нескольких сетевых путях.

SPNEGO/Kerberos-авторизация.

Использовать ~/.netrc для подстановки учётных данных по имени хоста.

Задать используемый netrc-файл по пути (абсолютному или относительному); похоже на --netrc, но с явным указанием файла, и подчиняется --netrc-optional.

Использовать .netrc, но не падать при отсутствии записи.

Отключить ALPN-переговоры TLS.

Полное имя -N.

Не перезаписывать уже существующий локальный файл.

Отключить keepalive-сообщения на TCP-соединении; по умолчанию curl их включает, вернуть можно через --keepalive.

Отключить устаревшие NPN-переговоры.

Не рисовать прогресс-метр даже в интерактивном терминале.

(TLS) Отключить кэширование SSL session-ID в curl; по умолчанию все передачи используют кэш, а повторное использование ID ломает некоторые реализации SSL.

Список хостов, для которых прокси не используется.

Авторизация Microsoft NTLM.

(HTTP) Устаревший ключ (добавлен в 8.8.0): включал NTLM в стиле --ntlm, но передавал аутентификацию отдельному исполняемому файлу, запускаемому по мере надобности.

(IMAP LDAP POP3 SMTP HTTP) Задать Bearer Token для OAUTH 2.0 аутентификации на сервере; токен используется вместе с именем пользователя из --url или --user.

Молча отбрасывать весь вывод ответа передачи: эффективная и переносимая замена «-o /dev/null» — передача выполняется полностью, данные принимаются и проверяются.

Полное имя -o.

Каталог-приставка для сохраняемых файлов (-o/-O).

При параллельных передачах предпочитать открытие большего числа соединений сразу, не дожидаясь возможности мультиплексировать новые передачи на существующем.

Пароль к приватному ключу или keystore.

Не схлопывать ../ и ./ в пути URL (строгая семантика сервера).

Public key pinning: base64 SHA256-хэш ожидаемого ключа сервера.

Сохранять метод POST при редиректах 301.

Сохранять метод POST при редиректах 302.

Сохранять POST даже при редиректе 303.

Первый прокси в цепочке (например socks5 перед HTTP-прокси).

Разрешить только указанные протоколы для первоначального запроса.

Использовать protocol для любого переданного URL без схемы; имя регистронезависимо и без суффикса «://», неизвестный протокол даёт ошибку CURLE_UNSUPPORTED_PROTOCOL.

Разрешённые протоколы после редиректа (защита от понижения схемы).

Прокси для всех протоколов в формате host:port.

Выбрать метод авторизации прокси автоматически.

Использовать Basic-аутентификацию при общении с данным прокси (метод по умолчанию для прокси); для удалённого хоста служит --basic.

(TLS) Использовать встроенное хранилище CA операционной системы для проверки сертификата HTTPS-прокси, дополнительно к другим заданным местам поиска CA.

Использовать указанный файл сертификата для проверки HTTPS-прокси; файл может содержать несколько CA-сертификатов в формате PEM, задавая иное доверие к прокси.

То же, что --capath, но в контексте HTTPS-прокси: указать каталог (или несколько через двоеточие «path1:path2:path3») с сертификатами CA для проверки прокси.

Использовать указанный файл клиентского сертификата при общении с HTTPS-прокси; сертификат обязан быть в PEM, пароль при отсутствии запрашивается в терминале, ключ задаётся через --proxy-key.

Задать тип предоставленного клиентского сертификата для HTTPS-прокси: PEM, DER, ENG, PROV или P12; по умолчанию PEM, а для Schannel — P12.

(TLS) То же, что --ciphers, но в контексте HTTPS-прокси: список наборов шифров, используемых при согласовании TLS 1.2 (1.1, 1.0) с прокси.

Указать PEM-файл со списком отзыва сертификатов (CRL), считающих пира отозванным при общении с HTTPS-прокси; аналог --crlfile только для прокси.

Использовать Digest-аутентификацию при общении с данным прокси; для удалённого хоста служит --digest.

Добавить заголовок именно к CONNECT-запросу прокси.

(HTTP) Согласовать HTTP/2 с HTTPS-прокси; если прокси предлагает лишь HTTP/1, curl остаётся на нём; на другие виды прокси влияния нет.

(HTTP) Согласовать HTTP/3 с HTTPS-прокси; передача завершается ошибкой, если данный прокси HTTP/3 не поддерживает; на другие виды прокси влияния нет.

То же, что --insecure, но в контексте HTTPS-прокси: пропустить проверку безопасности соединения с прокси и продолжить без неё.

Указать имя файла закрытого ключа для клиентских сертификатов при работе с HTTPS-прокси; аналог --key в контексте прокси.

Задать тип файла закрытого ключа, предоставленного --proxy-key: DER, PEM или ENG; по умолчанию предполагается PEM (аналог --key-type для прокси).

Использовать Negotiate (SPNEGO)-аутентификацию при общении с данным прокси; для удалённого хоста служит --negotiate.

Использовать NTLM-аутентификацию при общении с данным прокси; для удалённого хоста служит --ntlm.

Передать кодовую фразу закрытого ключа клиентского сертификата HTTPS-прокси; аналог --pass в контексте прокси.

(TLS) Проверять прокси по указанному файлу открытого ключа (или набору base64-хешей sha256): PEM/DER-файл с одним ключом либо несколько хешей.

Задать имя службы SPNEGO при аутентификации на прокси; при многократном указании используется последнее значение.

Не защищаться от уязвимости BEAST в протоколе TLS1.0 при общении с HTTPS-прокси; без этого ключа слой TLS может применять обходы, ломающие совместимость со старыми серверами.

То же, что --ssl-auto-client-cert, но в контексте HTTPS-прокси; поддерживается только Schannel.

(TLS) То же, что --tls13-ciphers, но в контексте HTTPS-прокси: наборы шифров, используемые при согласовании TLS 1.3 с прокси.

Устаревший ключ: без функциональности с 8.22.0; задавал тип TLS-аутентификации с HTTPS-прокси, единственный вариант — «SRP» (RFC 5054).

Устаревший ключ: без функциональности с 8.22.0; задавал пароль для метода TLS-аутентификации, указанного --proxy-tlsauthtype, требуя --proxy-tlsuser.

Устаревший ключ: без функциональности с 8.22.0; задавал имя пользователя для HTTPS-прокси с методом TLS-аутентификации из --proxy-tlsauthtype, требуя --proxy-tlspassword.

Требовать при согласовании с HTTPS-прокси не менее TLS версии 1.x, то есть TLS 1.0 или выше; аналог --tlsv1 в контексте прокси.

Отдельные учётные данные для прокси.

При использовании HTTP-прокси (--proxy) туннелировать трафик через прокси запросом CONNECT, требуя, чтобы прокси разрешал прямое соединение с нужным хостом и портом.

(SFTP SCP) Задать имя файла открытого ключа, позволяя предоставить его отдельно; обычно не требуется, так как curl извлекает открытый ключ из файла закрытого.

FTP-команды, выполняемые перед основной передачей.

Файл-источник энтропии для старых сборок OpenSSL.

Полное имя -r.

Отключить прозрачную декомпрессию: печатать сырые байты ответа.

Полное имя -e.

(HTTP) Заставить --remote-name использовать имя файла из заголовка Content-Disposition сервера, а не извлекать его из URL; путь из имени сервера отбрасывается.

Полное имя -O.

Изменить действие по умолчанию для всех заданных URL на такое, как если бы для каждого был указан --remote-name; отключается для конкретного URL через «-o -» или --no-remote-name.

Попытаться узнать время изменения удалённого файла и, если оно доступно, присвоить его локальному файлу.

Удалить выходной файл, если произошла ошибка: частичный файл не остаётся в локальной системе при сбое во время передачи.

Изменить метод, используемый при старте передачи; curl передаёт строку дословно, без фильтров и защит, включая пробелы и управляющие символы.

Подменить request-target строки запроса (для тестов).

Привязать host:port к адресу вручную, минуя DNS.

Повторять также на не-сетевых ошибках (например HTTP 4xx при -f).

Повторять и при отказе в соединении (connection refused).

Пауза между повторами в секундах (0 — экспоненциальная задержка).

Общий бюджет времени на все повторы операции.

(LDAP IMAP POP3 SMTP) Использовать авторизационную идентичность (authzid) при SASL PLAIN-аутентификации в дополнение к аутентификационной из --user.

(LDAP IMAP POP3 SMTP) Включить initial response в SASL-аутентификации: сообщение, которое клиент посылает серверу после выбора механизма аутентификации.

Задать имя службы SPNEGO; при многократном указании используется последнее значение. См. также --negotiate и --proxy-service-name.

Полное имя -S.

(HTTP FTP) Показывать заголовки ответа в выводе: имя сервера, cookies, дату документа, версию HTTP и прочее; для прочих протоколов «заголовками» зовутся прочие ответы сервера.

(TLS) Задать конкретные алгоритмы подписи, используемые при установлении SSL-сеанса согласно RFC 5246, 7.4.1.4.1: пара «алгоритм подписи + хеш» через «+» либо числовая константа.

Полное имя -s.

Пропустить операцию загрузки, если локальный файл уже существует; curl не знает, был ли он скачан полностью или оказался неполным — ему известен лишь факт наличия файла.

SOCKS4-прокси.

SOCKS4a-прокси (резолвинг имени на стороне прокси).

SOCKS5-прокси.

Использовать аутентификацию именем пользователя и паролем при подключении к SOCKS5-прокси; включена по умолчанию, GSS-API навязывается через --socks5-gssapi.

(GSS/kerberos) Использовать GSS-API-аутентификацию при подключении к SOCKS5-прокси; включена по умолчанию при сборке с GSS-API, логин/пароль навязываются через --socks5-basic.

(GSS/kerberos) Защищать согласование режима защиты в GSS-API-переговорах, как требует RFC 1961 (разделы 4.3/4.4), чего не делает реализация NEC; этот ключ подстраивается под NEC.

Задать имя службы socks-сервера; по умолчанию rcmd/server-fqdn. При многократном указании берётся последнее значение.

SOCKS5 с делегированием резолвинга имени серверу.

Прервать передачу, если скорость ниже порога заданное число секунд.

Окно измерения для --speed-limit, секунды.

Включить TLS там, где протокол позволяет поднять его поверх соединения.

(TLS) Не защищаться от известной уязвимости BEAST в протоколе TLS1.0; без ключа слой TLS может применять обходы, создающие проблемы совместимости со старыми серверами.

(TLS) (Schannel) Автоматически найти и использовать клиентский сертификат для аутентификации по требованию сервера; сервер может запросить любой сертификат из хранилища ОС.

(TLS) (Schannel) Отключить проверки отзыва сертификатов; предупреждение: этот ключ ослабляет безопасность SSL намеренно.

Требовать TLS: отказаться работать без шифрования.

(TLS) (Schannel) Игнорировать неудачные проверки отзыва, когда отсутствуют или недоступны точки распространения списков отзыва.

(TLS) Экспериментально: использовать указанный файл для загрузки SSL session tickets в кэш curl перед началом передач и сохранения кэша после успешного запуска.

(SSL) Раньше этот ключ требовал SSLv2, теперь игнорируется (добавлено в 7.77.0): SSLv2 широко считается небезопасным (RFC 6176).

(SSL) Раньше этот ключ требовал SSLv3, теперь игнорируется (добавлено в 7.77.0): SSLv3 широко считается небезопасным (RFC 7568).

Перенаправить все записи в stderr в указанный файл; если имя — простой «-», вывод идёт в стандартный поток. Опция глобальная, не требуется для каждого --next.

Использовать ANSI-стили вывода, если терминал поддерживает.

При использовании --proxytunnel и запросе CONNECT не выводить заголовки ответа CONNECT прокси; применяется вместе с --dump-header или --show-headers.

Включить использование TCP Fast Open (RFC 7413): отправку данных раньше финального ACK рукопожатия, если клиент и сервер уже соединялись ранее.

Отключить алгоритм Нагла: подтверждения уходят сразу.

Передать telnet-опцию (IAC-последовательность) на соединение.

Запросить размер блока TFTP, байты.

(TFTP) Не посылать запросы опций TFTP; улучшает взаимодействие с legacy-серверами, неправильно реализующими опции. При использовании --tftp-blksize игнорируется.

Полное имя -z.

(TLS) Разрешить ранние данные TLSv1.3 (0RTT), где возможно; имеет последствия для безопасности посылаемых так запросов. Доступно для GnuTLS, OpenSSL, quictls и др.

Верхняя граница версии TLS для соединения.

(TLS) Задать наборы шифров, используемые в соединении при согласовании TLS 1.3; список должен указывать валидные шифры (см. https://curl.se/docs/ssl-ciphers.html).

(TLS) Устаревший ключ: без функциональности с 8.22.0; задавал тип TLS-аутентификации, единственный вариант — «SRP» (RFC 5054), требуя --tlsuser и --tlspassword.

(TLS) Устаревший ключ: без функциональности с 8.22.0; задавал пароль для метода TLS-аутентификации из --tlsauthtype, требуя --tlsuser; с TLS 1.3 не работает.

(TLS) Устаревший ключ: без функциональности с 8.22.0; задавал имя пользователя для метода TLS-аутентификации из --tlsauthtype, требуя --tlspassword; с TLS 1.3 не работает.

(HTTP) Запросить сжатый ответ Transfer-Encoding одним из поддерживаемых алгоритмов и распаковывать данные по мере приёма; когда-то задумывалось как способ автоматического сжатия.

Человекочитаемый ASCII-дамп обмена в файл.

Задать список компонентов, из которых доступен подробный трассировочный вывод (через запятую, регистронезависимо); «all» включает все компоненты.

Добавлять идентификаторы передачи и соединения к каждой выводимой trace- или verbose-строке: уникальные номера позволяют понять, какой transfer/connection породил строку.

Соединяться через unix-сокет по указанному пути.

Полное имя -T.

(IMAP) Задать дополнительное поведение для загружаемых файлов: одно значение флага или список через запятую, регистрозависимый, отрицание — префиксом.

Явно задать URL целиком, включая схему, пользователя, порт, путь и query.

Добавить query-параметры к URL структурно, например 'foo=bar'.

(FTP LDAP TFTP) Включить режим передачи ASCII; для FTP достигается также URL с окончанием «;type=A», для TFTP — «;mode=netascii».

Полное имя -u.

Полное имя -A.

Задать переменную видом «name=content» или «name@file» (где file — stdin при одиночном «-»); имя регистрозависимо и состоит из a-z, A-Z, 0-9 или подчёркивания.

Напечатать версию curl и связанные библиотеки.

Задать VLAN priority по IEEE 802.1Q: поле уровня Ethernet, работающее только внутри локальной сети, диапазон значений 0..7.

Полное имя -w.

Сохранять метаданные в расширенных атрибутах файла.

(TLS) Требовать при согласовании с удалённым TLS-сервером не менее версии TLS 1.x, то есть TLS 1.0 или выше.

(SSL) Раньше этот ключ требовал SSLv2, теперь игнорируется (добавлено в 7.77.0): SSLv2 широко считается небезопасным (RFC 6176).

(SSL) Раньше этот ключ требовал SSLv3, теперь игнорируется (добавлено в 7.77.0): SSLv3 широко считается небезопасным (RFC 7568).

Краткая форма --ipv4.

Краткая форма --ipv6.

Подменить User-Agent на указанную строку.

(FTP LDAP TFTP) Включить режим передачи ASCII; для FTP достигается также URL с окончанием «;type=A», для TFTP — «;mode=netascii».

Продолжить прерванную передачу: смещение или '-' для автоподбора.

Сохранить заголовки ответа в файл (или '-' для stdout).

Клиентский сертификат с ключом в одном PKCS12-файле (CERT:PASSWORD).

Отправить поле как multipart/form-data: name=значение или name=@файл.

(HTTP) Заставить все данные, указанные через --data, --data-binary или --data-urlencode, уйти в HTTP GET вместо POST: curl дописывает их в URL как строку запроса.

(HTTP) Заставить --remote-name использовать имя файла из заголовка Content-Disposition сервера, а не извлекать его из URL; путь из имени сервера отбрасывается.

Читать аргументы curl из текстового файла: найденные там параметры применяются так, будто указаны в командной строке; опция и её значение — на одной строке.

Показать большой справочный текст руководства; пример: curl --manual. См. также --verbose, --libcurl и --trace.

Не буферизовать stdout: печатать по мере поступления данных.

(FTP) Поменять местами роли инициатора и слушателя при соединении с FTP: этот ключ заставляет curl использовать активный режим и командовать серверу соединиться обратно с указанным адресом и портом клиента.

(FTP SFTP) Послать произвольную команду удалённому FTP- или SFTP-серверу; quote-команды отправляются ДО начала передачи (сразу после начального PWD у FTP).

Попытаться узнать время изменения удалённого файла и, если оно доступно, присвоить его локальному файлу.

Загрузить (upload) файл на FTP или по HTTP PUT.

Задать имя пользователя и пароль для аутентификации на прокси; на SSPI-сборке под Windows при Negotiate или NTLM позволяет взять их из окружения.

Вывести сведения о curl и используемой версии libcurl: первая строка — полная версия curl, libcurl и прочих сторонних библиотек, далее списки возможностей и протоколов.

Метод запроса: GET, POST, PUT, DELETE…

Прервать передачу, если она идёт медленнее заданной скорости (в байтах в секунду) в течение указанного числа секунд; период задаётся --speed-time и по умолчанию равен 30.

Выполнять несколько указанных URL параллельно.

(FTP SFTP) При загрузке дописывать данные в конец целевого файла вместо перезаписи; отсутствующий файл создаётся, некоторые SFTP-серверы флаг игнорируют.

Куки строкой 'name=value' или имя файла Netscape-формата для чтения.

Сохранить куки из ответа в указанный файл.

Задать Referer для первого запроса.

HTTP >= 400 считается отказом: статус 22, тело ошибки не печатается.

Отключить glob-шаблоны в URL: символы [] {} * передаются как есть.

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

(HTTP FTP) Показывать заголовки ответа в выводе: имя сервера, cookies, дату документа, версию HTTP и прочее; для прочих протоколов «заголовками» зовутся прочие ответы сервера.

(HTTP) При чтении cookies из указанного файла отбросить все сессионные cookies, эффект тот же, что при начале нового сеанса, как делают браузеры.

(FTP POP3 SFTP FILE) При листинге FTP-каталога принудительно вывести только имена файлов; удобно для машинного разбора содержимого каталога.

Задать максимальное время в секундах, отводимое на каждую передачу, чтобы пакетные задания не висели часами при медленном канале; допускаются десятичные значения.

Заставить curl искать логин и пароль в файле .netrc домашнего каталога пользователя; обычно применяется для FTP, с HTTP включает пользовательскую аутентификацию.

При использовании HTTP-прокси (--proxy) туннелировать трафик через прокси запросом CONNECT, требуя, чтобы прокси разрешал прямое соединение с нужным хостом и портом.

Отключить чтение конфигурационного файла curlrc для этой команды.

Диапазон байт для скачивания, например 0-99.

(TELNET) Передать параметры протоколу telnet: TTYPE=<term> задаёт тип терминала, XDISPLOC=<X display> — расположение X-дисплея, NEW_ENV=<var,val> — переменную окружения.

Подробный режим: протокол рукопожатий и все заголовки.

Формат статистики после запроса: %{http_code}, %{time_total} и другие.

Использовать указанный прокси; строка может иметь префикс «protocol://» — без префикса или с http:// трактруется как HTTP-прокси, socks4://, socks4a://, socks5://, socks5h:// задают прочие.

Прервать передачу, если она идёт медленнее speed-limit байт в секунду в течение speed-time; при указании speed-time лимит по умолчанию равен 1, если не задан --speed-limit.

Условная передача: отправить/скачать только если файл новее указанной даты.

Тело запроса из файла или stdin без изменений.

Заголовок запроса, вида 'Content-Type: application/json'.

Тело запроса (application/x-www-form-urlencoded).

Сохранить с именем из URL.

Сохранить тело ответа в файл.

Только заголовки (HEAD).

Следовать HTTP-редиректам.

Показывать ошибки вместе с -s.

Silent: без прогресс-бара.

Не проверять TLS-сертификат (небезопасно).

Basic-auth в формате user:password.

Запросить gzip/br-сжатие и распаковать автоматически.

Повторить запрос N раз при сетевой ошибке.

curl

Построчное объяснение

curl (command)
Передать данные по URL: HTTP, HTTPS, FTP, SOCKS и др.

История