Curl выполнение запроса на сервер для передачи данных.
Для создания справки для программы / команды CURL использованы информационные возможности онлайн источников ...
...
...
Более 250 опций и параметров ... Это, похоже - на собственную операционную систему интернета ))) ... Поскольку, техническое соответствие - зависимо подробно изложено в руководстве / согласно версии, этот документ имеет - более - обще / образовательный статус обзорного знакомства с возможностями командной утилиты CURL, перекрывающей большинство потребностей сетевого взаимодействия, и поэтому может содержать - неявные неточности ... Копирайтерам следует с осторожностью воровать этот документ, чтобы не прослыть - компьютерными ламерами, лузерами и чайниками ))) ...
... Ну, хотя бы, потому-что утилита curl - является функционально законченным изделием, поддерживает криптографические преобразования и протоколы на основе ГОСТ и предоставляет возможность использования TLS с использованием российских криптонаборов, определённых рекомендациями ТК26, в различных сетевых соединениях прикладного уровня ...
... Возможно, в Windows консоли и локали, текстовая графика будет отображается - не так красиво, как на сайте ... Но, всё равно, это - прикольный пример применения curl ... Автор плагина wego / приложение погоды для терминала - в частности, указывает : зависимости, в том числе - моноширинный шрифт, содержащий все необходимые руны, например dejavu sans mono ... Используя системные шрифты командной строки Consolas или Lucida Console - можно предположить, что таблицы кодировки символов - не совпадают, от того и - такой, неожиданно неопрятный результат ))) ...
Введение в Curl.
Общая конструкция команды : curl -- параметры URL-адрес ... Curl - это командно-строчная утилита, программный инструмент для передачи данных с сервера или на сервер с использованием URL-адресов ... Утилита поддерживает протоколы : DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPS, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS ...
Curl использует библиотеку libcurl для всех функций, связанных с передачей данных ... Синтаксис URL-адреса зависит от протокола ... Если URL-адрес - без ведущей схемы протокол://, Curl - сам угадает, какой нужен протокол ... По умолчанию используется HTTP, но предполагается, что другие параметры - основаны на часто используемых префиксах имен хостов ...
Можно указать любое количество URL-адресов в командной строке - они извлекаются последовательно в указанном порядке, кроме случая опции -Z, --parallel (параллельная обработка всех URL в любом порядке) ... Curl пытается повторно использовать соединения с сервером - чтобы предотвратить установлений рукопожатий и создание новых подключений - в течении текущего сеанса - для ускорения работы (времени и скорости) ...
Curl поддерживает переменные командной строки (добавлены в версии 8.3.0) ... Задать переменные с помощью --variable name=content или --variable name@file (где файл - может быть стандартным вводом, если установлено одно тире (-)) ... Содержимое переменной можно расширить в параметрах опции / префикс --expand- ... Получить доступ к переменным среды, сначала импортировав их ...
Протоколы, параметры, обработка и вывод данных ...
... # ... Если не указано иное, Curl записывает полученные данные в стандартный вывод ... Можно указать сохранить эти данные в локальный / сетевой файл ; а если задано несколько URL - потребуется указать несколько мест сохранения ...
... # ... Curl - не понимает и специально - не анализирует содержимое пересылаемых данных ... Curl не выполняет кодирование или декодирование, если только это явно не задано с помощью специальных параметров командной строки ...
... # ... Curl поддерживает множество протоколов или и URL схем, но ваша конкретная сборка ОС - может не поддерживать их все ... FTP операция не передает на терминал никаких ответных данных ...
... # ... Из-за изменения версий эта страница руководства - лишь примерно документирует curl (см. подробности на официальном сайте) ...
... # ... Опции начинаются с одной или двух тире ... Многие параметры требуют дополнительного значения рядом с ними ... Если текст начинается не с тире - предполагается, что это URL адрес ...
... # ... Короткая форма параметров с одним тире, и пробел - является рекомендуемым разделителем от значения (если оно применяется) ... Опции короткой версии, которые не требуют каких-либо дополнительных значений - могут использоваться сразу рядом друг с другом, например : -O -L -v можно сразу одновременно указать, как : -OLv ...
... # ... Длинная форма двойное тире - требует пробела между параметром и его значением ...
... # ... Все логические параметры отключаются или принимают противоположное значение указанием префикса : no- (не перечислено в этом списке) ...
... # ... --next Сбрасывает состояние синтаксического анализатора и работа начинается заново с чистым состоянием параметров, за исключением параметров, которые являются глобальными (глобальные параметры сохраняют свои значения - и даже после -: , --next) ...
... # ... Глобальные параметры : --fail-early , --libcurl , --parallel-immediate , -Z , --parallel , -# , --progress-bar , --rate , -S , --show-error. , --stderr , --styled-output , --trace-ascii , --trace-config , --trace-ids , --trace-time , --trace , -v , --verbose ...
- Вот список всех категорий параметров и опций curl :
- auth - Different types of authentication methods / Различные типы методов аутентификации ...
- connection - Low level networking operations / Низкоуровневые сетевые операции ...
- curl - The command line tool itself / Собственно сам инструмент командной строки ...
- dns - General DNS options / Общие параметры DNS ... Domain Name System, система преобразования доменных имен в соответствующие IP-адреса, используемые для идентификации и обмена данными между компьютерами в сети Интернет ...
- file - FILE protocol options / Параметры файловых протоколов ... Файловые объекты, типы данных, потоки и обеспечения операций чтения и записи файлов ...
- ftp - FTP protocol options / Параметры протокола FTP ... File Transfer Protocol, консольный протокол передачи файлов между серверами и клиентами сети ...
- http - HTTP and HTTPS protocol options / Варианты протоколов HTTP и HTTPS ... Hypertext Transfer Protocol / Secure, браузерные протоколы обмена информацией между клиентом и сервером в сети Интернет ...
- imap - IMAP protocol options / Параметры протокола IMAP ... Internet Message Access Protocol, протокол доступа к электронной почте на удаленном сервере, синхронизируемый все изменения при одновременной работе на нескольких устройствах ...
- misc - Options that don't fit into any other category / Варианты, которые не попадают ни в одну другую категорию ...
- output - Filesystem output / Вывод файловой системы ...
- pop3 - POP3 protocol options / Параметры протокола POP3 ... Post Office Protocol 3, протокол получения электронной почты с удаленного сервера на клиентское устройство ... По умолчанию, после получения - удаляет письмо с сервера ... Есть опция сохранения копий сообщений на сервере, но синхронизация между устройствами, как IMAP - не выполняется ...
- post - HTTP Post specific options / Специфические HTTP POST параметры и опции ... Метод POST помогает управлять данными на сервере и более безопасно отправлять, как - малые, так и - большие объемы информации - в теле сообщения (а не в заголовке) ...
- proxy - All options related to proxies / Все опции, связанные с прокси ... Это промежуточный сервер, который действует от имени клиента и выполняет запросы к другим серверам ... Преследуя цели ... Анонимность ... Обход ограничений и блокировок ... Кэширование ... Фильтрация и контроль доступа ... Отладка и мониторинг сетевого взаимодействия для анализа производительности и контроля проблем ...
- scp - SCP protocol options / Опции протокола SCP ... Secure Copy Protocol, протокол для безопасной передачи файлов между компьютерами в сети и основан на протоколе SSH / Secure Shell ...
- sftp - SFTP protocol options / Параметры протокола SFTP ... SSH FTP File Transfer Protocol, протокол для безопасной передачи файлов между компьютерами в сети, на основе протокола SSH ...
- smtp - SMTP protocol options / Параметры протокола SMTP ... Simple Mail Transfer Protocol, протокол для отправки электронной почты по сети ...
- ssh - SSH protocol options / Параметры протокола SSH ... Secure Shell, протокол обеспечивает безопасное удаленное подключение к компьютерам и передачу данных по сети ... Включая ... Аутентификация ... Безопасная передача файлов ... Удаленное выполнение команд ... Туннелирование ... Безопасность ненадежных сетей и общественных точек Wi-Fi ...
- telnet - TELNET protocol options / Опции протокола TELNET ... Протокол для удаленного управления и установки соединения с удаленными компьютерами через сеть ... Администрирование ... Конфигурация сетевых устройств ... Тестирование и отладка сетевых соединений ... Интеграция с другими приложениями ... Не обеспечивает шифрование данных - не рекомендуется для использования в незащищенных сетях или при передаче конфиденциальной информации ...
- tftp - TFTP protocol options / Параметры протокола TFTP ... Trivial File Transfer Protocol, протокол для простой передачи файлов между компьютерами в сети ... Загрузка программного обеспечения ... Установка операционных систем ... Отладка и тестирование сетевых соединений ... Не обеспечивает шифрование данных и аутентификацию - не рекомендуется для использования в незащищенных сетях или при передаче конфиденциальной информации ...
- tls - All TLS / SSL related options / Все параметры, связанные с TLS / SSL ... Transport Layer Security / Secure Sockets Layer - протоколы безопасной передачи данных по сети Обеспечивают ... Шифрование данных ... Аутентификация ... Защита от подделки ... Целостность данных ... Защита от хакерских атак ...
- upload - All options for uploads / Все варианты выгрузки ...
- verbose - Options related to any kind of command line output of curl / Параметры, относящиеся к любому выводу командной строки Curl ... Параметр и режим управления уровнем подробности вывода и сообщений при работе программы / команды ... Дополнительная информация о состоянии процесса выполнения задач ... Отладка ... Получение подробной информации ... Проверка состояния ... Обучение и понимание ...
Список опций и параметров curl.
Сначала указана длинная форма опции (с двумя тире) , затем (если применимо) - краткий символ параметра (с одним тире) ... Внимание : формат регистр Заглавных / Прописных и малых / строчных букв - различается ... Базовая версия опций команд curl v8.3.0 Release-Date : 2023-09-13 ...
(!) Обратите внимание, что поддержка опций - может варьироваться в зависимости от версии curl и конфигурации ... Рекомендуется обратиться к документации или руководству - для получения более подробной информации о возможностях и ограничениях исполнения команд ...
(!) Важно отметить, что опции расширенного вывода вместе с обычным - увеличивают общий размер ответа ... Если объем памяти - ограничен или идёт работа - с большим количеством данных, избыточный размер ответа - может привести к проблемам ...
--abstract-unix-socket <path>
... Connect via abstract Unix domain socket ... Подключение через абстрактный сокет домена Unix ... Абстрактные доменные сокеты не связаны с файловой системой и не имеют соответствующего файла в файловой системе ... Они используются для обмена данными между процессами на одной машине ...
--alt-svc <file name>
... Enable alt-svc with this cache file ... Включите alt-svc для этого файла кэша ... Для указания альтернативного сервиса (Alternative Service) ... Альтернативный сервис представляет собой механизм, который позволяет серверу предложить клиенту использовать альтернативный набор протоколов или адресов для доступа к ресурсу ... Для перенаправления клиента на другой сервер или для использования другого протокола для обмена данными ...
--anyauth
... Pick any authentication method ... Выберите любой метод аутентификации ... curl должен использовать любую доступную аутентификацию при выполнении HTTP-запроса ... Это включает в себя базовую аутентификацию ... аутентификацию с помощью токена ... аутентификацию с использованием прокси-сервера ... и другие методы аутентификации, поддерживаемые сервером ...
--append -a
... Append to target file when uploading ... Добавить в целевой файл при загрузке ... Для добавления данных к существующему файлу при загрузке или отправке данных ... Когда эта опция указана - curl будет добавлять полученные данные в конец файла, вместо его перезаписи ...
--aws-sigv4 <provider1[:provider2[:region[:service]]]>
... Use AWS V4 signature authentication ... Используйте аутентификацию по подписи AWS V4 ... Для включения аутентификации AWS Signature Version 4 при выполнении HTTP-запросов к сервисам AWS (Amazon Web Services) ... AWS Signature Version 4 - это метод аутентификации, который используется для обеспечения безопасности и целостности запросов к сервисам AWS ...
--basic
... Use HTTP Basic Authentication ... Используйте базовую аутентификацию HTTP ... Указывает на использование базовой аутентификации при выполнении HTTP-запросов ... Базовая аутентификация предполагает отправку учетных данных (имени пользователя и пароля) в заголовке запроса для аутентификации на сервере ... Когда требуется аутентификация для доступа к защищенным ресурсам ...
--cacert <file>
... CA certificate to verify peer against ... Сертификат CA для проверки однорангового узла ... Опция используется для указания пути к файлу, содержащему сертификаты удостоверяющих центров (Certificate Authority, CA) ... Этот файл используется для проверки подлинности сервера при выполнении HTTPS-запросов ... Если сервер использует сертификат, подписанный удостоверяющим центром, представленным в указанном файле, то `curl` будет считать соединение - безопасным ...
--ca-native
... Use CA certificates from the native OS ... Используйте сертификаты CA из собственной ОС ... (TLS) сообщает Curl использовать хранилище CA из собственной операционной системы для проверки узла ... По умолчанию / в противном случае - используется хранилище CA, предоставленное в одном файле или каталоге, но при использовании этой опции curl взаимодействует с собственным хранилищем операционной системы ... Этот параметр работает только для Curl в Windows, если он создан для использования OpenSSL ... Когда Curl в Windows создан для использования Schannel, эта функция подразумевается, и тогда Curl использует только собственное хранилище CA ... Curl, созданный с помощью wolfSSL, также поддерживает эту опцию (добавленную в версии 8.3.0) ... Использование --ca-native несколько раз не дает дополнительного эффекта ... Отключите его снова с помощью --no-ca-native ...
--capath <dir>
... CA directory to verify peer against ... Каталог CA для проверки однорангового узла ... Указание пути к директории, содержащей набор сертификатов удостоверяющих центров (Certificate Authorities, CA) ... Эта опция позволяет curl проверять сертификаты серверов, с которыми устанавливается SSL / TLS соединение ... Валидность сертификата сервера проверяется из набора сертификатов CA, которые обычно хранятся в определенной директории на компьютере ... Опция позволяет указать путь к этой директории ...
--cert <certificate[:password]> -E
... Client certificate file and password ... Файл сертификата клиента и пароль ... Указание пути к клиентскому сертификату, который будет использоваться при установлении SSL / TLS соединения с сервером ... Можно использовать клиентский сертификат в формате PEM для аутентификации себя перед сервером ... Когда сервер требует проверки клиентского сертификата для разрешения доступа ...
--cert-status
... Verify the status of the server cert via OCSP-staple ... Проверьте статус сертификата сервера через OCSP-staple. ... Опция добавлена для проверки статуса сертификата сервера с помощью метода OCSP stapling расширения TLS ...
--cert-type <type>
... Certificate type ( DER / PEM / ENG / P12 ) ... Тип сертификата ( DER / PEM / ENG / P12 ) ... Указание типа предоставленного сертификата ... Сообщает в каком формате представлен сертификат ... В curl поддерживаются типы сертификатов : ...
- PEM (Privacy-Enhanced Mail) - это формат сертификата, который использует ASCII-кодирование для представления данных сертификата ... Он часто используется в Unix-подобных системах ...
- DER (Distinguished Encoding Rules) - это бинарный формат сертификата, который используется в Windows и других системах ...
- ENG (Engine) - это тип сертификата, который используется для интеграции с криптографическими движками, такими как OpenSSL ...
- P12 / PFX - обычно используются на компьютерах с Windows и macOS для импорта и экспорта сертификатов и закрытых ключей ...
Дополнительно к --cert-type потребуется указать --cert путь к сертификату ...
--ciphers <list of ciphers>
... SSL ciphers to use ... SSL-шифры для использования ... Указание списка шифров, которые могут быть использованы при установлении защищенного соединения с сервером ... Шифры - это алгоритмы, которые используются для шифрования данных при передаче через сеть ... Когда curl устанавливает SSL / TLS соединение с сервером, он использует список шифров, чтобы определить, какие алгоритмы шифрования могут быть использованы для обеспечения безопасности соединения ... Позволяет указать список шифров, разделенных запятыми ... Обратите внимание, что поддерживаемые шифры могут различаться в зависимости от версии curl и используемой библиотеки SSL / TLS (например, OpenSSL) ...
--compressed
... Request compressed response ... Запросить сжатый ответ ... Указание отправлять запросы с использованием сжатия данных ... Когда сервер поддерживает сжатие, curl может отправлять запросы с заголовком "Accept-Encoding: gzip, deflate", указывая, что он готов принять сжатые данные в ответе ... Это позволяет сократить размер передаваемых данных и улучшить производительность при передаче больших объемов информации ... Обратите внимание, что сервер должен поддерживать сжатие и возвращать сжатые данные в ответе, чтобы использование опции --compressed имело эффект ...
--compressed-ssh
... Enable SSH compression ... Включить SSH-сжатие ... SSH (Secure Shell) - это шифрованный протокол сетевой безопасности с аутентификацией, который обеспечивает защищенное соединение между клиентом и сервером ... Используется для удаленного управления и передачи данных между компьютерами через незащищенные сети, такие как Интернет ... SSH является широко используемым протоколом в области системного администрирования и разработки программного обеспечения на Linux, macOS и Windows, работая в клиентских программах OpenSSH, PuTTY, WinSCP и других ... Он заменяет небезопасные протоколы, такие как Telnet и FTP, и предоставляет безопасный способ удаленного доступа к серверам и передачи файлов ... Для настройки сжатия SSH - необходимо (? важно создать резервную копию ?) изменить конфигурационный файл SSH на сервере, сохранить изменения и перезапустить службу ... После включения сжатия SSH, данные, передаваемые между клиентом и сервером, будут сжиматься, что может уменьшить объем передаваемых данных и улучшить производительность в случае медленного соединения или при передаче больших файлов ... Однако, стоит отметить, что сжатие SSH может повлечь некоторую нагрузку на процессоры сервера и клиента, и имея высокопроизводительное соединение или мощное ПК оборудование - можно не заметить значительного улучшения производительности ... Также, сжатие SSH - может быть небезопасным в некоторых ситуациях, особенно для передачи конфиденциальных данных (рекомендуется юзать другие методы шифрования и сжатия данных, такие как VPN или SSL / TLS) ...
--config <file> -K
... Read config from a file ... Читать конфигурацию из файла ... Указать файл конфигурации, содержащий параметры для выполнения запроса ... Использование файла конфигурации может быть полезным, если нужно выполнить несколько запросов - с одними и теми же параметрами или если нужно сохранить настройки запроса - для повторного использования ... Обратите внимание, что формат файла конфигурации должен соответствовать синтаксису curl и содержать один параметр на строку ... Вместо указания каждого параметра в командной строке - можно создать файл конфигурации и передать его в curl с помощью этой опции ... Файл конфигурации может содержать следующие параметры : URL-адрес, Заголовки и Метод запроса, Данные для отправки, Другие настройки (таймаут, пользовательский агент и прочие параметры curl) ...
# Пример файла конфигурации curl
# Установка URL-адреса запроса
url = "https://api.site.web/"
# Установка заголовков запроса
header = "Content-Type: application/json"
header = "Authorization: Bearer your_token"
# Установка метода запроса
request = "POST"
# Установка данных для отправки
data = '{"key": "value"}'
# Прочие параметры
verbose = true
output = "response.json"
--connect-timeout <fractional seconds>
... Maximum time allowed for connection ... Максимальное время, разрешенное для подключения ... Устанавливает максимальное время ожидания для установки соединения с сервером ... Если соединение не устанавливается в течение указанного времени, curl прерывает попытку и возвращает ошибку ... Это полезно, когда нужно ограничить время ожидания для установки соединения, чтобы избежать длительных задержек при неудачных попытках соединения ...
--connect-to <HOST1:PORT1:HOST2:PORT2>
... Connect to host ... Подключиться к хосту ... Установить альтернативный адрес и порт для подключения к серверу - новый адрес и порт, которые будут использоваться вместо тех, которые указаны в URL-адресе запроса ... Когда нужно перенаправить запрос на другой сервер или порт, например, для тестирования или отладки ... Однако, эта опция доступна - только в некоторых версиях curl и может поддерживаться - не во всех ситуациях ...
--continue-at <offset> -C
... Resumed transfer offset ... Возобновление передачи с позиции смещения ... Опция позволяет продолжить загрузку файла с определенной позиции ... При передаче файла с помощью curl, иногда может возникнуть необходимость продолжить загрузку - с определенной позиции, особенно если загрузка - была прервана или если нужно - загрузить только часть файла ... Указать позицию - будет полезно, когда нужно продолжить загрузку файла с определенной позиции, особенно при работе с большими файлами или при возникновении проблем с соединением, которые могут прервать загрузку ...
--cookie <data|filename> -b
... Send cookies from string/file ... Отправлять файлы cookie из строки / файла ... Позволяет отправлять и принимать файлы cookie при выполнении HTTP-запросов ... Используется для указания файла / или значения cookie, которые должны быть отправлены вместе с запросом ... Когда веб-сервер требует аутентификации или когда нужно передать определенные данные, хранящиеся в cookie ...
--cookie-jar <filename> -c
... Write cookies to <filename> after operation ... Записывать файлы cookie в <имя файла> после операции ... Сохраняет полученные cookie в файл после выполнения HTTP-запросов ... Когда в ответе сервер отправляет cookie - эти данные можно сохранить в файл - что полезно для последующих запросов, чтобы поддерживать состояние сеанса или передавать аутентификационные данные ...
--create-dirs
... Create necessary local directory hierarchy ... Создать необходимую иерархию локальных каталогов - необходимую иерархию локальных директорий ... При загрузке файлов, иногда может потребоваться создать необходимую структуру директорий на локальном компьютере, чтобы сохранить загружаемые файлы - в нужном месте ... Опция позволяет автоматически создавать все необходимые директории, если они - не существуют ... Особенно полезно, когда файлы загружаются в сложные директории или - когда нужно сохранить файлы в определенной структуре каталогов ... Это позволяет упростить процесс создания директорий при загрузке файлов с помощью curl ...
--create-file-mode <mode>
... File mode for created files ... Файловый режим для созданных файлов ... Позволяет задать права доступа для файлов, сохраняемых на удалённом сервере (для протоколов, поддерживающих подобное сохранение) ...
--crlf
... Convert LF to CRLF in upload ... Преобразование LF в CRLF при загрузке ... Для преобразования символов новой строки при загрузке или отправке данных ... Символы новой строки могут иметь различные форматы в разных ОС ... Например, в Windows используется символ новой строки CRLF (Carriage Return + Line Feed), а в Unix-подобных системах используется символ новой строки LF (Line Feed) ... Опция позволяет curl автоматически преобразовывать символы новой строки в соответствующий формат для целевой операционной системы ... При загрузке данных с символами новой строки в формате CRLF на Unix-подобную систему, curl - автоматически преобразует их в формат LF, чтобы сохранить совместимость ...
--crlfile <file>
... Use this CRL list ... Используйте этот список CRL ... Список CRL (Certificate Revocation List) представляет собой список отозванных сертификатов, который используется для проверки действительности сертификатов в сетевых коммуникациях ... При взаимодействии с защищенными сетевыми ресурсами, такими как веб-сайты или серверы электронной почты - браузер или клиентское приложение может проверять действительность сертификата, чтобы убедиться, что он не был отозван и все еще действителен ... Для этого - и используется список CRL ... Список CRL содержит информацию о сертификатах, которые были отозваны из-за компрометации, утраты доверия или других причин ... Обычно - он поддерживается и публикуется центром сертификации (CA), который выпустил сертификаты ... Клиентское приложение может использовать эту информацию для принятия решения о доверии сертификату и продолжении безопасного взаимодействия ... Список CRL - важный инструмент для обеспечения безопасности в сетевых коммуникациях и помогает предотвратить использование недействительных или скомпрометированных сертификатов ...
--curves <algorithm list>
... (EC) TLS key exchange algorithm(s) to request ... (EC) Алгоритмы обмена ключами TLS для запроса ... Задать список эллиптических кривых, которые могут быть использованы при установлении соединения по протоколу TLS 1.3 ... При работе по российским криптоалгоритмам необходимо использовать кривые из списка GC256 / GC512 ...
--data <data> -d
... HTTP POST data ... Данные HTTP POST ... Для отправки данных в теле HTTP-запроса, которые будут отправлены на сервер ... Эти данные могут быть в формате строки или файле @data.txt ... Опция позволяет передавать данные на сервер в различных форматах, таких как URL-кодирование или JSON - указать тип контента с помощью опции -H (--header) ...
--data-ascii <data>
... HTTP POST ASCII data ... Данные HTTP POST ASCII ... Используется для отправки данных в теле HTTP-запроса в ASCII-кодировке ... Это может быть полезно, если сервер ожидает данные в определенной кодировке, например, при работе с устаревшими системами, которые не поддерживают другие кодировки ... Опция позволяет явно указать, что данные должны быть отправлены в ASCII-кодировке, даже если они содержат символы, которые не являются частью стандартного набора ASCII - когда требуется точное соответствие ASCII-кодировке при взаимодействии с сервером ...
--data-binary <data>
... HTTP POST binary data ... Двоичные данные HTTP POST ... Для отправки данных в теле HTTP-запроса - в бинарном формате ... Это может быть полезно, когда данные содержат символы, которые не должны быть автоматически обработаны или изменены, например, при отправке изображений, аудиофайлов или других бинарных данных ... Данные будут отправлены в их исходном бинарном формате - без изменений ... Позволяет явно указать, что данные - должны избежать автоматической обработки или изменения - сервером или клиентом и не должны быть автоматически обработаны ...
--data-raw <data>
... HTTP POST data, '@' allowed ... Данные HTTP POST, допускается '@' ... Для отправки сырых данных в теле HTTP-запроса - без автоматической обработки или изменения ... Для указания данных, которые будут отправлены на сервер в их исходном виде - без изменений, когда данные - содержат специальные символы или форматы, которые не должны быть автоматически обработаны или изменены ... Полезно, когда требуется точное соответствие данных при взаимодействии с сервером ...
--data-urlencode <data>
... HTTP POST data URL encoded ... URL-адрес данных HTTP POST закодирован ... Используется для URL-кодирования данных, которые будут отправлены в теле HTTP-запроса ... URL-кодирование используется для преобразования специальных символов в формат, который может быть безопасно передан в URL ... Полезно при передаче через URL пар данных & параметр = значение, с использованием специальных символов ...
--delegation <LEVEL>
... GSS-API delegation permission ... Разрешение делегирования GSS-API ... Используется для установки уровня делегирования GSS-API при выполнении запросов с использованием протокола Kerberos ... Указать уровень делегирования GSS-API, который позволяет передавать учетные данные между клиентом и сервером при использовании протокола Kerberos ... Делегирование позволяет клиенту передавать свои учетные данные серверу, чтобы сервер мог использовать их для выполнения дополнительных запросов от имени клиента ... Уровень делегирования может быть различным, что - позволяет управлять им и указывать, какие действия может выполнять сервер от имени клиента ... Требует наличия поддержки GSS-API и настройки Kerberos на ПК ...
--digest
... Use HTTP Digest Authentication ... Использовать Digest метод аутентификации HTTP ... Для выполнения аутентификации с использованием алгоритма хэширования Digest ... Позволяет указать, что запрос должен быть аутентифицирован с использованием алгоритма хэширования Digest ... Аутентификация Digest предоставляет более безопасный способ аутентификации по сравнению с базовой аутентификацией, так как пароль не передается в открытом виде, а используется хэш-значение ... Сервер - также должен поддерживать аутентификацию Digest для успешного выполнения запроса с использованием этой опции ...
--disable -q
... Disable .curlrc ... Отключить .curlrc ... В зависимости от версий опция используется для отключения определенных функций или протоколов при выполнении запросов, то есть может иметь - различное поведение ... Скорее всего, в данной версии, это относится к отключению файла .curlrc - это конфигурационный файл для утилиты curl ... Когда curl запускается, он проверяет наличие файла .curlrc и использует его, если он найден ... Файл .curlrc содержит набор настроек и параметров, которые будут применяться при выполнении запросов с помощью curl ... Конфигурационный файл настраивает поведение curl в соответствии с потребностями и предпочтениями ... Может быть полезно, если часто приходится выполнять запросы с одними и теми же настройками ... Это позволяет сохранить настройки в файле и использовать их при каждом запуске curl, вместо того, чтобы указывать их каждый раз в командной строке ... Расположение файла .curlrc может различаться - в зависимости от ОС ...
--disable-eprt
... Inhibit using EPRT or LPRT ... Запретить с помощью EPRT или LPRT ... Отключение протокола расширенной передачи данных (EPRT) при выполнении FTP-запросов ... Протокол EPRT используется в FTP для установки соединения с сервером и передачи данных ... Однако, в некоторых случаях, особенно при работе с устаревшими или несовместимыми серверами FTP, использование протокола EPRT - может вызывать проблемы ... Отключение позволяет использовать альтернативные методы передачи данных при выполнении FTP-запросов с помощью curl, если возникают проблемы или сервер - не поддерживает этот протокол ...
--disable-epsv
... Inhibit using EPSV ... Запретить с помощью EPSV ... Для отключения использования команды EPSV (Extended Passive) при выполнении FTP-передачи данных ... Команда EPSV используется в протоколе FTP для установки пассивного режима передачи данных ... Однако, в некоторых случаях, особенно при работе с устаревшими или несовместимыми серверами FTP, использование команды EPSV может вызывать проблемы ... Отключение позволяет использовать альтернативные методы передачи данных при выполнении FTP-запросов с помощью curl, если это создаёт проблемы при выполнении FTP-запросов с использованием команды EPSV или сервер - не поддерживает эту команду ...
--disallow-username-in-url
... Disallow username in URL ... Запретить имя пользователя в URL ... По умолчанию, при использовании протокола HTTP или FTP, curl позволяет включать имя пользователя в URL - для аутентификации на сервере ... Однако, в некоторых случаях - можно запретить включение имени пользователя в URL - по соображениям безопасности или иных требований ... Отключение - может быть полезным, если не нужно отображать имя пользователя в URL или требуется использовать - другие методы аутентификации, такие как заголовки авторизации ...
--dns-interface <interface>
... Interface to use for DNS requests ... Интерфейс для использования DNS-запросов ... При выполнении DNS-запросов, curl по умолчанию - использует системный интерфейс по умолчанию ... Указание конкретного интерфейса для DNS-запросов может быть полезным, если есть - несколько сетевых интерфейсов и нужно контролировать - через какой интерфейс curl будет выполнять DNS-запросы ...
--dns-ipv4-addr <address>
... IPv4 address to use for DNS requests ... IPv4-адрес, используемый для DNS-запросов ... По умолчанию, curl использует системные настройки DNS для выполнения DNS-запросов ... Указание конкретного IPv4-адреса для DNS-запросов может быть полезным, если нужно явно указать, какой DNS-сервер должен использоваться для выполнения запросов - вместо использования системных настроек DNS ...
--dns-ipv6-addr <address>
... IPv6 address to use for DNS requests ... IPv6-адрес, используемый для DNS-запросов ... По умолчанию, curl использует системные настройки DNS для выполнения DNS-запросов ... Указание конкретного IPv6-адреса для DNS-запросов может быть полезным, если нужно явно указать, какой DNS-сервер должен использоваться для выполнения запросов - вместо использования системных настроек DNS ...
--dns-servers <addresses>
... DNS server address to use ... Адреса DNS-серверов для использования ... По умолчанию, curl использует системные настройки DNS для выполнения DNS-запросов. Однако - можно явно указать список DNS-серверов, которые должны использоваться для выполнения запросов, через запятую, несколько - вместо использования системных настроек DNS ...
--doh-cert-status
... Verify the status of the DoH server cert via OCSP-staple ... Проверить статус сертификата сервера DoH с помощью OCSP-staple ... Используется для включения проверки статуса сертификата - при использовании DNS-over-HTTPS (DoH) ... DoH - это протокол, который позволяет выполнять DNS-запросы через HTTPS-соединение, обеспечивая шифрование и повышенную конфиденциальность ... При использовании DoH, DNS-запросы отправляются через HTTPS-соединение к серверу, поддерживающему DoH, вместо использования традиционного DNS-протокола ... Если сертификат недействителен или не прошел проверку, curl может выдать предупреждение или отказаться от выполнения запроса ...
--doh-insecure
... Allow insecure DoH server connections ... Разрешить небезопасные подключения к серверу DoH ... Отключение проверки безопасности сертификата при использовании DNS-over-HTTPS (DoH) ... DoH - это протокол, который позволяет выполнить DNS-запросы через HTTPS-соединение, обеспечивая шифрование и повышенную конфиденциальность ... По умолчанию, curl выполняет проверку действительности сертификата сервера при выполнении DoH-запросов ... Однако - можно отключить эту проверку и разрешить использование - недействительных или самоподписанных сертификатов ... Обратите внимание, что отключение проверки безопасности сертификата может представлять риск для безопасности данных, так как это может открыть возможность для атак посредника (man-in-the-middle) ... Рекомендуется использовать опцию - только в тех случаях, когда есть - полная уверенность в безопасности соединения или - при тестировании внутренних сетей ...
--doh-url <URL>
... Resolve host names over DoH ... Разрешение имен хостов через DoH ... Явно указать URL-адреса сервера DNS-over-HTTPS (DoH), который будет использоваться для выполнения DNS-запросов ... DoH - это протокол, который позволяет выполнить DNS-запросы через HTTPS-соединение, обеспечивая шифрование и повышенную конфиденциальность ... Указание конкретного URL-адреса сервера DoH может быть полезным, если нужно использовать определенный сервер DoH - вместо использования системных настроек DNS или серверов по умолчанию ...
--dump-header <filename> -D
... Write the received headers to <filename> ... Записать полученные заголовки в <имя файла> ... Используется для сохранения заголовков ответа сервера в указанный файл - вместо их вывода на экран ... Файл будет содержать заголовки ответа сервера, которые можно просмотреть или использовать для дальнейшего анализа ... Обратите внимание, что если нужно сохранить как заголовки, так и тело ответа - совместно можно использовать опцию --output ...
--egd-file <file>
... EGD socket path for random data ... Путь к сокету EGD для случайных данных ... Для указания пути к сокету Entropy Gathering Daemon (EGD) ... EGD - это демон, который собирает случайные данные, которые могут использоваться для улучшения криптографической безопасности - для операций, связанных с SSL (Secure Sockets Layer) ...
--engine <name>
... Crypto engine to use ... Крипто-движок для использования TLS SSL ... Выбрать криптографический механизм OpenSSL, который будет использоваться для операций шифрования ... Смотреть --engine list, чтобы распечатать список движков, поддерживаемых во время сборки ... Обратите внимание, что не все (а возможно, и - ни один) из механизмов движков - могут быть доступны во время выполнения (то есть, не быть доступны - вообще) ... Если опция указана несколько раз - будет использовано последнее заданное значение ...
--etag-compare <file>
... Pass an ETag from a file as a custom header ... Передать ETag из файла в качестве пользовательского заголовка ... ETag (Entity Tag) - это метка сущности, которая используется в протоколе HTTP для идентификации конкретной версии ресурса ... Она представляет собой строку символов, которая ассоциируется с определенной версией файла или документа на сервере ... ETag может быть использован для определения, изменился ли ресурс с момента последнего запроса клиента ... Когда клиент делает запрос к серверу, он может отправить ETag в заголовке If-None-Match ... Если ETag клиента совпадает с текущим ETag ресурса на сервере, сервер может вернуть код состояния 304 Not Modified, что означает, что ресурс - не изменился с момента последнего запроса, и клиент может использовать закешированную версию ресурса ... ETag может быть вычислен различными способами, включая хеширование содержимого файла или использование других алгоритмов, определенных сервером ... Каждый раз, когда ресурс изменяется, ETag также должен измениться, чтобы отразить новую версию ресурса ... ETag может быть полезен для оптимизации кэширования и уменьшения объема передаваемых данных между клиентом и сервером ... Он также может быть использован для обеспечения целостности данных и предотвращения одновременного изменения ресурса несколькими клиентами ... Обратите внимание, что ETag не является обязательным заголовком в HTTP-ответе сервера, и его наличие зависит от конфигурации сервера и типа ресурса ...
--etag-save <file>
... Parse ETag from a request and save it to a file ... Разобрать ETag из запроса и сохранить его в файл ... Получить ETag из заголовка ответа и сохранить его в файл ...
--expect100-timeout <миллисекунд>
... How long to wait for 100-continue ... Сколько ждать до продолжения / таймаут 100-continue ... Установки таймаута ожидания ответа 100-continue от сервера при отправке запроса HTTP с заголовком "Expect: 100-continue" ... Когда клиент отправляет запрос с таймаутом - он ожидает, что сервер ответит с кодом состояния 100 Continue, что указывает на то, что сервер - готов принять тело запроса ... Однако, если сервер не отправляет такой ответ в течение определенного времени - клиент может решить продолжить отправку запроса - без ожидания ответа ...
--fail -f
... Fail fast with no output on HTTP errors ... Быстрый сбой без вывода ошибок HTTP ... Используется для обработки ошибок при выполнении запроса ... Если при выполнении запроса происходит ошибка, curl завершает выполнение с кодом состояния отличным от 0 и выводит сообщение об ошибке ... Полезно, когда нужно обрабатывать ошибки запросов в автоматическом режиме или в скриптах ...
--fail-early
... Fail on first transfer error, do not continue ... Сбой при первой ошибке передачи, не продолжать ... Отказ на первой ошибке передачи, прервать работу - без продолжения ...
--fail-with-body
... Fail on HTTP errors but save the body ... Сбой при ошибках HTTP, но сохранение тела ответа ... Указание того, что если запрашиваемая операция - не выполнится успешно, то тело ответа - должно быть включено в вывод ... Важно отметить, что опция - может увеличить размер вывода команды, поскольку она включает тело ответа - вместе с обычным выводом ... Если объем памяти ограничен или идет работа с большим количеством данных, это - может привести к проблемам ...
--false-start
... Enable TLS False Start ... Включить ложный старт TLS ... Указывает, что curl должен начинать выполнение запроса - только после получения полного тела ответа ... Если сервер отправляет тело ответа, которое меньше ожидаемого размера, curl продолжит чтение - до тех пор, пока не получит полный размер тела ответа ... Эта опция полезна, когда ожидается получить большой объем данных в ответ на запрос ... Например, при ответе с веб-страницы, которая содержит много изображений или видео, опция гарантирует, что все данные будут считаны - прежде, чем начать их передачу ... Если опция не включена - тело ответа будет считано только до тех пор, пока не достигнет максимального размера буфера, установленного с помощью опции --max-length ... Это может привести к тому, что некоторые части тела ответа - будут потеряны, особенно если они - превышают максимальный размер буфера ...
--form <name=content> -F
... Specify multipart MIME data ... Укажите составные данные MIME ... Используется для передачи данных формы в запросе ... Данные формы могут включать поля ... Создаётся форма с указанными полями и значениями, а затем отправляется на сервер ... Полезно, как заполнение онлайн-формы или отправка информации на веб-сайт ... Сочетается с указанием URL-адреса и желаемого метода запроса ... MIME (Multipurpose Internet Mail Extensions) - это стандарт, используемый для определения форматов данных, которые могут быть отправлены через Интернет ... MIME определяет набор правил и рекомендаций для кодирования, декодирования и передачи различных типов данных, таких как текстовые документы, изображения, аудиофайлы и видеофайлы ... MIME состоит из двух частей : содержания и заголовков ... Содержание представляет собой данные, которые отправляются через Интернет, а заголовки содержат метаданные, такие как тип содержимого, заголовок контента и т.д. ...
--form-escape
... Escape multipart form field / file names using backslash ... Экранирование имен полей / файлов многочастной формы с помощью обратной косой черты ... Используется для экранирования специальных символов в данных формы перед их отправкой на сервер ... Это может быть полезно, когда отправляются данные формы, которые содержат специальные символы, такие как амперсанд (&), апостроф (') или дефис (-) ... Опция экранирует специальные символы в данных формы, используя последовательность символов - для каждого специального символа ... Это позволяет серверу правильно интерпретировать данные формы и предотвращает возможные проблемы с безопасностью или неправильным форматированием данных ...
--form-string <name=string>
... Specify multipart MIME data ... Укажите составные данные MIME ... Используется для передачи строковых данных формы в запросе ... Данные формы могут включать поля ... Опция создает строку данных формы с указанными полями и значениями, а затем отправляет ее на сервер ... Это может быть полезно при заполнении онлайн-формы или отправки информации на веб-сайт ... Сочетается с указанием URL-адреса и желаемого метода запроса ... MIME (Multipurpose Internet Mail Extensions) - это стандарт, используемый для определения форматов данных, которые могут быть отправлены через Интернет ... MIME определяет набор правил и рекомендаций для кодирования, декодирования и передачи различных типов данных, таких как текстовые документы, изображения, аудиофайлы и видеофайлы ... MIME состоит из двух частей : содержания и заголовков ... Содержание представляет собой данные, которые отправляются через Интернет, а заголовки содержат метаданные, такие как тип содержимого, заголовок контента и т.д. ...
--ftp-account <data>
... Account data string ... Строка данных учетной записи ... Используется для указания учетных данных для доступа к FTP-серверу ... Эти учетные данные включают имя пользователя и пароль, которые используются для аутентификации на сервере ...
--ftp-alternative-to-user <command>
... String to replace USER [name] ... Строка для замены USER [имя] ... Используется для указания альтернативного имени пользователя, которое может использоваться вместо имени пользователя и пароля, указанного в качестве основного ...
--ftp-create-dirs
... Create the remote dirs if not present ... Создайте удаленные каталоги, если они отсутствуют ... Используется для создания директорий на FTP-сервере, если они - не существуют ...
--ftp-method <method>
... Control CWD usage ... Контролируйте использование CWD ... Используется для указания метода, который следует использовать для выполнения операции на FTP-сервере ... Методы, доступные с помощью этой опции, включают FTP, SFTP, FTPS ... Важно отметить, что опция - может влиять на производительность и безопасность операции на FTP-сервере ... Некоторые методы могут быть быстрее или медленнее, чем другие, и некоторые методы могут иметь более высокий уровень безопасности, чем другие ... Важно выбрать метод, который лучше всего подходит для конкретной задачи и соответствует потребностям ... Команда CWD в протоколе FTP используется для изменения текущего каталога на сервере ... Важно отметить, что в зависимости от версии FTP-сервера, некоторые - могут не поддерживать команду CWD и следует использовать команду PASV для изменения текущего каталога на сервере ...
--ftp-pasv
... Use PASV/EPSV instead of PORT ... Используйте PASV/EPSV вместо PORT ... Для указания использования пассивного - вместо активного FTP-соединения ... Пассивное FTP-соединение использует порт, отличный от стандартного порта FTP (обычно 20 и 21), для передачи данных между клиентом и сервером ... Это может быть полезно, когда требуется обойти ограничения скорости или другие проблемы, связанные с активным FTP-соединением ... Пассивное FTP-соединение может быть полезно, когда идёт подключение к FTP-серверу, находящемуся за брандмауэром или другим сетевым устройством, которое может блокировать или ограничивать соединение ...
Различие между FTP командами PASV, EPSV и PORT ... PASV - для передачи данных через промежуточное устройство / прокси-сервер ; этот процесс позволяет обойти ограничения скорости или другие проблемы, связанные с прямым соединением между клиентом и сервером ... EPSV - для передачи данных напрямую между клиентом и сервером, без использования промежуточного устройства ; когда нужно обеспечить лучшую производительность или избежать использования прокси-сервера ... PORT - используется для указания порта, который будет использоваться для передачи данных между клиентом и сервером (если не поддерживается - заменяется на PASV) ...
--ftp-port <address> -P
... Use PORT instead of PASV ... Используйте PORT вместо PASV ... Используется для указания порта, который будет использоваться для передачи данных между клиентом и сервером при подключении к FTP-серверу ... Важно выбрать порт, который лучше всего подходит для конкретной задачи и соответствует потребностям ...
--ftp-pret
... Send PRET before PASV ... Отправьте PRET перед PASV ... Выбор предварительного протокола FTP перед подключением к FTP-серверу ... Сначала отправляет запрос HTTP на указанный URL-адрес, а затем использует полученный ответ для определения того, какой протокол FTP использовать для подключения к серверу ...
--ftp-skip-pasv-ip
... Skip the IP address for PASV ... Пропустить IP-адрес для PASV ... Указание не использовать IP-адрес, который был получен в ответ на команду PASV (Passive mode FTP) - в случае, если IP-адрес - недоступен для curl ...
--ftp-ssl-ccc
... Send CCC after authenticating ... Отправьте CCC после аутентификации ... Указание использовать CCC (Clear Command Channel) в режиме FTPS (FTP over SSL / TLS) ... CCC позволяет переключиться с защищенного режима передачи данных на незащищенный режим передачи команд ... Это может быть полезно в некоторых сценариях, когда требуется выполнить определенные команды, которые не поддерживаются в защищенном режиме ... Отключает уровень TLS после аутентификации ... Остальная часть связи по каналу управления будет незашифрованной ... Это позволяет маршрутизаторам NAT следить за транзакцией FTP ... Режим по умолчанию - пассивный ...
--ftp-ssl-ccc-mode <active/passive>
... Set CCC mode ... Установить режим CCC ... Устанавливает режим CCC FTP ... Пассивный (passive) режим - не инициирует завершение работы, а вместо этого ждет, пока это сделает сервер, и не будет отвечать на завершение работы с сервера ... Активный (active) режим - инициирует завершение работы и ожидает ответа от сервера ...
--ftp-ssl-control
... Require SSL / TLS for FTP login, clear for transfer ... Требовать SSL / TLS для входа в FTP, снимите флажок для передачи ... Для указания уровня шифрования при использовании FTPS (FTP over SSL / TLS) ... Эта опция позволяет установить требуемый уровень шифрования для защищенного соединения FTP ... Требовать TLS для входа на FTP ... Обеспечивает безопасную аутентификацию, но - не зашифрованную передачу данных - для повышения эффективности ... Если сервер не поддерживает TLS, то передача завершится с ошибкой ...
--get -G
... Put the post data in the URL and use GET ... Поместите данные публикации в URL-адрес и используйте GET ... Используется для выполнения HTTP-запроса методом GET ... Все данные операторов данных поменяют метод с POST на GET ... В сочетании с -I, --head данные POST вместо этого будут добавлены к URL-адресу с запросом HEAD ...
--globoff -g
... Disable URL sequences and ranges using {} and [] ... Отключите последовательности и диапазоны URL-адресов, используя {} и [] ... Для отключения глобального преобразования символов в URL-адресе ... Сurl - не будет распознавать и преобразовывать специальные символы, такие как фигурные {} или квадратные скобки [] в URL-адресе ...
--happy-eyeballs-timeout-ms <milliseconds>
... Time for IPv6 before trying IPv4 ... Время использовать IPv6, прежде чем пробовать IPv4 ... Механизм Happy Eyeballs используется для установки таймаута ожидания при подключении к IPv6- и IPv4-серверам ... Happy Eyeballs - это алгоритм, который позволяет клиенту быстро выбрать наилучший доступный протокол (IPv6 или IPv4) для подключения к серверу и предпочитая сначала IPv6, с рекомендуемой паузой 150 - 300 мс ...
--haproxy-clientip
... Sets client IP in HAProxy PROXY protocol v1 header ... Устанавливает IP-адрес клиента в заголовке протокола HAProxy PROXY v1 ... Для указания IP-адреса клиента при отправке запросов через HAProxy ... HAProxy - это программное обеспечение балансировки нагрузки и проксирования, которое может использоваться для распределения запросов между несколькими серверами ... В первую очередь полезен при отправке тестовых запросов в службу, которая ожидает этот заголовок ...
--haproxy-protocol
... Send HAProxy PROXY protocol v1 header ... Отправка заголовка протокола HAProxy PROXY v1 ... Для включения протокола HAProxy в заголовок запроса ... Это используется некоторыми балансировщиками нагрузки и обратными прокси-серверами для указания истинного IP-адреса и порта клиента ...
--head -I
... Show document info only ... Показать только информацию о документе ... Выполнение HTTP-запроса методом HEAD и получения только заголовков ответа, без тела ответа ... Это полезно, когда нужна - только информация о заголовках ответа сервера, а не само содержимое ...
--header <header/@file> -H
... Pass custom header(s) to server ... Передача пользовательских заголовков на сервер ... Используется для добавления заголовков к HTTP-запросу ... С помощью этой опции можно указать различные заголовки (Content-Type , Authorization , User-Agent и другие), которые могут быть необходимы для правильной обработки запроса сервером ...
--help <category> -h
... Get help for commands ... Получить справку по командам ...
--hostpubmd5 <md5>
... Acceptable MD5 hash of the host public key ... Приемлемый MD5-хеш открытого ключа хоста ... Для передачи MD5-хеша открытого ключа хоста в контексте SSH-соединений ... MD5-хеш открытого ключа хоста в виде строки, содержащей 32 шестнадцатеричных символа ...
--hostpubsha256 <sha256>
... Acceptable SHA256 hash of the host public key ... Приемлемый хэш SHA256 открытого ключа хоста ... Для передачи SHA-256 хеша открытого ключа хоста в контексте SSH-соединений ... SHA-256 хеш открытого ключа хоста в виде строки, содержащей 64 шестнадцатеричных символа ...
--hsts <file name>
... Enable HSTS with this cache file ... Включите HSTS с этим файлом кэша ... Для включения поддержки HTTP Strict Transport Security (HSTS) в запросах ... HSTS - это механизм безопасности, который заставляет браузеры использовать только защищенное соединение HTTPS при взаимодействии с веб-сайтом ... Он отправляет заголовок Strict-Transport-Security в запросе, чтобы указать серверу, что он должен использовать только HTTPS для всех последующих запросов на этот домен ...
--http0.9
... Allow HTTP 0.9 responses ... Разрешить ответы HTTP 0.9 ... Указывает на использование протокола HTTP 0.9 при выполнении запроса ... Протокол HTTP 0.9 является устаревшим, имеет более простую структуру и поддерживает только несколько основных команд ... Этот протокол не поддерживает заголовки, статусы ответов и другие функции, которые присутствуют в более новых версиях протокола HTTP ... Протокол HTTP 0.9 устарел и редко используется в современных веб-приложениях ...
--http1.0 -0
... Use HTTP 1.0 ... Используйте HTTP 1.0 ... Указывает на использование протокола HTTP 1.0 , одной из более ранних версий протокола HTTP ... Протокол HTTP 1.0 поддерживает заголовки запросов и ответов, но не поддерживает некоторые функции, которые присутствуют в более новых версиях протокола (постоянное соединение keep-alive ; поддержка пайплайнинга) ... Протокол HTTP 1.0 устарел и редко используется в современных веб-приложениях ...
--http1.1
... Use HTTP 1.1 ... Используйте HTTP 1.1 ... Указывает на использование протокола HTTP 1.1 , одной из более поздних версий протокола HTTP ... Протокол HTTP 1.1 поддерживает различные функции и другие улучшения ... Протокол HTTP 1.1 является широко используемым веб-протоколом и поддерживается большинством веб-серверов и клиентов ...
--http2
... Use HTTP/2 ... Используйте HTTP/2 ... Указывает на использование протокола HTTP/2 при выполнении запроса ... Протокол HTTP/2 является более новой версией протокола HTTP и предоставляет улучшенную производительность и эффективность по сравнению с предыдущей версией, поддерживает множество функций, таких как мультиплексирование, сжатие заголовков, приоритизация запросов и другие оптимизации, которые позволяют более эффективно передавать данные между клиентом и сервером ... Поддержка протокола HTTP/2 требует, чтобы как клиент, так и сервер - поддерживали эту версию протокола ...
--http2-prior-knowledge
... Use HTTP 2 without HTTP/1.1 Upgrade ... Используйте HTTP 2 без обновления HTTP/1.1 ... Указывает на использование протокола HTTP/2 с предварительным знанием (prior knowledge) при выполнении запроса ... Это означает, что curl будет использовать протокол HTTP/2 - без выполнения предварительного обмена настройками с сервером ... Вместо этого, curl будет предполагать, что сервер поддерживает протокол HTTP/2 и будет немедленно использовать его для отправки запросов ... Поддержка протокола HTTP/2 с предварительным знанием требует, чтобы как клиент, так и сервер - поддерживали эту версию протокола ...
--http3
... Use HTTP v3 ... Используйте HTTP версии 3 ... Указывает на использование протокола HTTP/3 при выполнении запроса ... Протокол HTTP/3 является самой новой версией протокола HTTP и предоставляет улучшенную производительность и надежность по сравнению с предыдущими версиями ... Однако, на данный момент, поддержка протокола HTTP/3 в curl все еще находится в экспериментальной стадии и требует дополнительной настройки и зависимостей ; соответствующей версии, скомпилированной с поддержкой протокола HTTP/3, а также - настроенный сервер ... Обратите внимание, что поддержка протокола HTTP/3 все еще развивается, и не все серверы и клиенты поддерживают эту версию протокола ...
--http3-only
... Use HTTP v3 only ... Используйте только HTTP v3 ... Указывает использовать только протокол HTTP/3, самой новой версии ... Обратите внимание, что поддержка протокола HTTP/3 все еще развивается, и не все серверы и клиенты поддерживают эту версию протокола, а также потребуются дополнительные настройки и согласование зависимостей ...
--ignore-content-length
... Ignore the size of the remote resource ... Игнорировать размер удаленного ресурса ... Игнорирование заголовка Content-Length о размере тела запроса или ответа ... Вместо этого, curl будет продолжать получать данные, пока соединение не будет закрыто ... Игнорирование заголовка Content-Length может привести к некорректной обработке данных, особенно если сервер - не закрывает соединение после передачи всех данных ...
--include -i
... Include protocol response headers in the output ... Включить заголовки ответа протокола в выходные данные ... Включает заголовки ответа сервера в вывод запроса ... Это может быть полезно для отладки и анализа ответов сервера ...
--insecure -k
... Allow insecure server connections ... Разрешить небезопасные подключения к серверу ... Указывает на игнорирование проверки сертификата SSL / TLS при выполнении запроса и будет продолжаться выполнение запроса, даже если сертификат сервера не может быть проверен или не является доверенным ... Это может быть полезно в ситуациях, когда сервер использует самоподписанный сертификат или сертификат, который не был выпущен доверенным удостоверяющим центром ... Однако, использование опции - может представлять риск безопасности, так как она отключает проверку подлинности сервера и может позволить злоумышленникам перехватывать и изменять данные ...
--interface <name>
... Use network INTERFACE (or address) ... Использовать сетевой ИНТЕРФЕЙС (или адрес) ... Полезно в случаях, когда в системе есть несколько сетевых интерфейсов, и нужное явно указать, через какой интерфейс отправить запрос ...
--ipv4 -4
... Resolve names to IPv4 addresses ... Преобразование имен в адреса IPv4 ... Использование только протокола IPv4 ... IPv4 (Internet Protocol version 4) является стандартной версией протокола интернета и используется для идентификации и маршрутизации пакетов данных в сети ... Обратите внимание, что IPv4 является более старой версией протокола и постепенно заменяется на IPv6 (Internet Protocol version 6), который предлагает больше IP-адресов и другие улучшения ... Однако, использование опции может быть полезным - для совместимости с устаревшим оборудованием и ПО ...
--ipv6 -6
... Resolve names to IPv6 addresses ... Преобразование имен в адреса IPv6 ... Использование только протокола IPv6, включая многие полезности и другие улучшения, если система и сеть - поддерживают IPv6 ...
--json <data>
... Запрос HTTP метод POST включая данные в формате JSON ... Указывает на отправку данных в формате JSON при выполнении запроса - в теле запроса ( --json -d '{"key1": "value1", "key2": "value2"} ) ... JSON (JavaScript Object Notation) - это легкий формат обмена данными, основанный на синтаксисе объектов JavaScript ... Это может быть полезно при взаимодействии с API, которые ожидают данные в формате JSON ... Обратите внимание, что это - нестандартная опция curl, и ее доступность и поведение - могут зависеть от версии и используемой библиотеки ...
--junk-session-cookies -j
... Ignore session cookies read from file ... Игнорировать сеансовые файлы cookie, считанные из файла ... Игнорирование сохраненных cookie-файлов текущей сессии, без их перезаписи ... Запрос без cookie или - не требуется поддержка сессий (если это не повлияет на работу сценариев) ...
--keepalive-time <seconds>
... Interval time for keepalive probes ... Интервал для проверки активности ... Время ожидания (в секундах) между последовательными запросами при использовании keep-alive соединения ... Keep-alive позволяет повторно использовать одно и то же TCP-соединение для отправки нескольких HTTP-запросов, что может улучшить производительность при работе с веб-серверами ... Доступность и поведение опции - могут зависеть от версии curl и используемой библиотеки ...
--key <key>
... Private key file name ... Имя файла закрытого ключа ... Путь к файлу с закрытым ключом (private key) при выполнении запроса через протокол HTTPS для установления безопасного соединения с сервером и обеспечения шифрования данных ... Необходимо при работе с серверами, которые требуют аутентификации с использованием SSL / TLS ...
--key-type <type>
... Private key file type (DER/PEM/ENG) ... Тип файла закрытого ключа DER / ENG и по умолчанию PEM ...
--krb <level>
... Enable Kerberos with security <level> ... Включить Kerberos с безопасностью <уровень> ... Включение поддержки Kerberos, протокол аутентификации, обеспечивает безопасность при обмене данными между клиентом и сервером ...
--libcurl <file>
... Dump libcurl equivalent code of this command line ... Дамп эквивалентного кода libcurl этой командной строки ... Добавив этот параметр в любую обычную командную строку curl - получить исходный код libcurl на языке C, записанный в файл, который делает эквивалент того, что делает заданная операция командной строки ...
--limit-rate <speed>
... Limit transfer speed to RATE ... Ограничить скорость передачи значением RATE ... Ограничение максимальной скорости передачи данных при выполнении запросов ...
--list-only -l
... List only mode ... Режим только списка ... Только вывод списка файлов и директорий на удаленном сервере без скачивания или выполнения каких-либо действий с ними ... Просто просмотреть содержимое удаленного каталога или получить список файлов ... (!) В зависимости от настроек - выведет содержимое, назначенной сервером - веб страницы ...
--local-port <num/range>
... Force use of RANGE for local port numbers ... Принудительное использование RANGE для номеров локальных портов ... Явно указать конкретный порт, который будет использоваться для исходящих соединений - для работы с определенными сетевыми настройками или для отладки ...
--location -L
... Follow redirects ... Следуйте перенаправлениям ... Для автоматического повторения запросов и перенаправления на другие URL-адреса - при ответе с кодом состояния переадресации 3xx - по новому URL-адресу, указанному в заголовке Location ответа сервера ...
--location-trusted
... Like --location, and send auth to other hosts ... Подобно --location и отправляем авторизацию другим хостам ... Позволит повторно отправить имя + пароль всем хостам, на которые сайт - может перенаправить ... Это может привести / или не привести - к нарушению безопасности, при отправке авторизации (которая является открытым текстом в случае базовой аутентификации HTTP) ...
--login-options <options>
... Server login options ... Варианты входа на сервер ... Указать параметры входа в систему, которые будут использоваться при проверке подлинности сервера для протоколов IMAP, POP3 и SMTP ...
--mail-auth <address>
... Originator address of the original email ... Адрес отправителя исходного электронного письма ... Указать имя пользователя и пароль для аутентификации при отправке письма электронной почты через протокол SMTP ...
--mail-from <address>
... Mail from this address ... Письмо с этого адреса ... Указать адрес электронной почты, от имени которого будет отправлено письмо через протокол SMTP ...
--mail-rcpt <address>
... Mail to this address ... Почта на этот адрес ... Указать адрес электронной почты получателя, на который будет отправлено письмо электронной почты, при отправке письма через протокол SMTP ...
--mail-rcpt-allowfails
... Allow RCPT TO command to fail for some recipients ... Разрешить сбой команды RCPT TO для некоторых получателей ... Если письмо отправлено нескольким получателям и чтобы неудачная доставка до одного получателя - не останавливала процесс отправки почты через протокол SMTP - остальным / другим адресатам ...
--manual -M
... Display the full manual ... Показать полное руководство ... Печатает полный текст справки (лучше - выводить в файл) ... help - более кратко печатает сгруппированные справки - по командам и категориям ...
--max-filesize <bytes>
... Maximum file size to download ... Максимальный размер файла для загрузки ... Указание максимального размера загрузки файла, чтобы ограничить размер и избежать скачивания слишком больших объёмов данных ...
--max-redirs <num>
... Maximum number of redirects allowed ... Максимально разрешенное количество перенаправлений ... Указание максимального количества перенаправлений - следовать при выполнении запроса на ответ 3xx, указанному в заголовке Location URL - чтобы избежать бесконечных циклов перенаправления ...
--max-time <fractional seconds> -m
... Maximum time allowed for transfer ... Максимальное время, разрешенное для перевода ... Указания максимального времени ожидания ответа от сервера для выполнения операции ...
--metalink
... Process given URLs as metalink XML file ... Обработать заданные URL-адреса как XML-файл Metallink ... URL-адрес metalink-файла ... Metalink - это XML-файл, который содержит информацию о различных источниках загрузки файла, включая URL-адреса, хэши, размеры и другие метаданные ... Полезно, когда требуется загрузить файл из разных источников, указанных в metalink-файле ...
--negotiate
... Use HTTP Negotiate (SPNEGO) authentication ... Использовать аутентификацию HTTP Negotiate (SPNEGO) ... Для выполнения аутентификации с использованием протокола SPNEGO (Simple and Protected GSSAPI Negotiation Mechanism) ... SPNEGO - это механизм, который позволяет клиенту и серверу взаимодействовать и выбрать наиболее подходящий протокол аутентификации, такой как Kerberos, NTLM или другие, в зависимости от возможностей и настроек - аутентифицироваться с использованием протокола, поддерживаемого сервером ...
--netrc -n
... Must read .netrc for user name and password ... Необходимо прочитать .netrc для имени пользователя и пароля ... Путь к файлу .netrc, в домашнем каталоге пользователя, который содержит информацию об учетных данных для аутентификации на сервере : пары логин-пароль для различных хостов ...
--netrc-file <filename>
... Specify FILE for netrc ... Укажите ФАЙЛ для netrc ... Путь к файлу .netrc, в любой папке ПК, который содержит информацию об учетных данных для аутентификации на сервере : пары логин-пароль для различных хостов ...
--netrc-optional
... Use either .netrc or URL ... Используйте либо .netrc, либо URL-адрес ... Указывает, что файл .netrc является необязательным для аутентификации на сервере и curl продолжит выполнение запроса, даже если файл .netrc отсутствует или не содержит необходимых учетных данных и это состояние - не приводило бы к ошибке выполнения запроса ...
--next -:
... Make next URL use its separate set of options ... Сделать следующий URL-адрес использованием отдельного набора параметров ... Указывает curl использовать отдельную операцию для следующего URL-адреса и связанных с ним параметров ... Это позволяет отправлять несколько запросов URL-адресов, каждый из которых - имеет свои собственные параметры (различные имена пользователей ; запросы ; методы GET и POST) - для каждого из адресов - в одной командной строке ... Опция - сбросит все локальные параметры, и только глобальные сохранят свои значения (-v, --verbose, --trace, --trace-ascii, --fail-early ) ...
--no-alpn
... Disable the ALPN TLS extension ... Отключите расширение ALPN TLS ... Используется для отключения протокола ALPN (Application-Layer Protocol Negotiation) при установке защищенного соединения с сервером ... ALPN - это механизм, который позволяет клиенту и серверу выбрать наиболее подходящий протокол связи, такой как HTTP/1.1 или HTTP/2, во время установки защищенного соединения ... По умолчанию, curl использует ALPN для выбора наиболее эффективного протокола связи ... Опция отключает протокол ALPN и не предлагает список поддерживаемых протоколов клиенту, вместо этого - используя стандартный протокол по умолчанию - в зависимости от конфигурации сервера ...
--no-buffer -N
... Disable buffering of the output stream ... Отключить буферизацию выходного потока ... По умолчанию, вывод данных - буферизируется, чтобы улучшить производительность и оптимизировать передачу данных ... Опция - отключает буферизацию и выводит данные немедленно, по мере их получения ... Это полезно, чтобы не ждать, пока весь вывод - будет полностью скачан (просмотр потокового видео или обработка данных) ...
--no-clobber
... Do not overwrite files that already exist ... Не перезаписывайте уже существующие файлы ... Используется для предотвращения перезаписи существующих файлов при скачивании ... Для защиты от случайной перезаписи файлов при скачивании ...
--no-keepalive
... Disable TCP keepalive on the connection ... Отключить поддержку активности TCP для соединения ... Отключает использование keep-alive соединений при выполнении запросов ... Keep-alive соединения позволяют повторно использовать одно и то же TCP-соединение для выполнения нескольких запросов, что может улучшить производительность при работе с HTTP-серверами ...
--no-npn
... Disable the NPN TLS extension ... Отключите расширение NPN TLS ... Отключает использование расширения NPN (Next Protocol Negotiation) для TLS (Transport Layer Security) ... Расширение NPN позволяет клиенту и серверу договориться о протоколе, который будет использоваться для обмена данными после установки защищенного соединения TLS ... Однако, расширение NPN - устарело и было заменено на расширение ALPN (Application-Layer Protocol Negotiation) ...
--no-progress-meter
... Do not show the progress meter ... Не показывать индикатор прогресса ... Отключает отображение индикатора при выполнении запросов ... По умолчанию, curl выводит индикатор, показывая текущий прогресс выполнения запроса, включая информацию о скорости передачи данных, оставшемся времени и объеме загруженных или загружаемых данных ... Отключение индикатора делает более чистый вывод ...
--noproxy <no-proxy-list>
... List of hosts which do not use proxy ... Список хостов, которые не используют прокси ... Позволяет указать список хостов или доменов, для которых не следует использовать прокси-сервер при выполнении запросов ... curl будет обращаться к указанным хостам или доменам напрямую, чтобы обойти прокси-сервер для определенных запросов или если прокси-сервер - не требуется ...
--no-sessionid
... Disable SSL session-ID reusing ... Отключить повторное использование идентификатора сеанса SSL ... Отключает использование кэширования идентификаторов сеансов SSL (SSL session-ID caching) при выполнении запросов ... Это означает, что при каждом новом запросе - будет устанавливаться новое SSL-соединение, даже если предыдущее соединение - было установлено с тем же сервером ...
--ntlm
... Use HTTP NTLM authentication ... Использовать аутентификацию HTTP NTLM (Windows NT LAN Manager) при выполнении запросов ... Аутентификация NTLM является протоколом аутентификации, который используется в среде Windows для проверки подлинности пользователей ...
--ntlm-wb
... Use HTTP NTLM authentication with winbind ... Использовать аутентификацию HTTP NTLM с winbind ... NTLM (Windows NT LAN Manager) с помощью winbind - является методом аутентификации, который используется в среде Windows для проверки подлинности пользователей ...
--oauth2-bearer <token>
... OAuth 2 Bearer Token ... Токен носителя OAuth 2 ... Указать токен аутентификации OAuth 2.0 Bearer при выполнении запросов ... OAuth 2.0 Bearer токен используется для аутентификации и авторизации при доступе к защищенным ресурсам ...
--output <file> -o
... Write to file instead of stdout ... Запись в файл вместо стандартного вывода ... Указать имя файла, в который будет сохранен результат выполнения запроса ... Сохраняет полученные данные в указанный файл вместо вывода их в стандартный вывод (stdout) ...
--output-dir <dir>
... Directory to save files in ... Каталог для сохранения файлов ... Указать директорию, в которую будут сохранены файлы, полученные при выполнении запросов ... Если вместо этой опции используется --output / -o, то файлы сохраняются в указанном пути с указанным именем файла ...
--parallel -Z
... Perform transfers in parallel ... Выполнять переводы параллельно ... Выполнять запросы параллельно - в нескольких потоках ... Разделяет запросы на несколько потоков и выполняет их параллельно ... Это может ускорить процесс выполнения запросов, особенно если запросы направлены к разным серверам или ресурсам ...
--parallel-immediate
... Do not wait for multiplexing (with --parallel) ... Не ждите мультиплексирования (совместно с --parallel) ... В общем, мультиплексирование при параллельном выполнении запросов к серверу - это процесс объединения нескольких запросов в одном соединении - для увеличения эффективности и уменьшения задержек ... При параллельном выполнении запросов к серверу, каждый запрос обычно - требует установления отдельного соединения с сервером ... Это может привести к накладным расходам на установление и разрыв соединений, а также к задержкам - из-за ожидания ответов от сервера ... Мультиплексирование - позволяет объединить несколько запросов в одном соединении ... Это достигается путем отправки запросов через одно соединение и получения ответов на них в том же порядке, в котором запросы - были отправлены ... Это позволяет уменьшить накладные расходы на установление и разрыв соединений, а также снизить задержки, связанные с ожиданием ответов ... Мультиплексирование может быть осуществлено различными способами, включая использование протоколов HTTP / 2 или специальных библиотек и инструментов ...
--parallel-max <num>
... Maximum concurrency for parallel transfers ... Максимальный параллелизм для параллельных передач ... Ограничивает количество одновременных запросов, которые могут быть выполнены параллельно - когда требуется избежать перегрузки сервера или сети ...
--pass <phrase>
... Pass phrase for the private key ... Парольная фраза для закрытого ключа SSH TLS ...
--path-as-is
... Do not squash .. sequences in URL path ... Не сжимайте последовательности .. в пути URL ... Позволяет передавать путь к файлу : как есть - без изменений или нормализации ... По умолчанию curl нормализует путь к файлу, удаляя лишние символы и приводя его к стандартному формату ...
--pinnedpubkey <hashes>
... FILE / HASHES Public key to verify peer against ... ФАЙЛ / ХЭШИ Открытый ключ для проверки однорангового узла ... Указать открытый ключ для проверки подлинности сервера при установлении защищенного соединения или хэш открытого ключа ... Если открытый ключ сервера не соответствует указанному, соединение - будет считаться недействительным ...
--post301
... Do not switch to GET after following a 301 ... Не переключайтесь на GET после 301 ... Указывает следовать стандарту RFC 2616/10.3.2 и использовать метод POST при перенаправлении HTTP-кода 301 ... Когда сервер возвращает HTTP-код 301 (перемещено навсегда) в ответ на запрос, клиент обычно выполняет повторный запрос с использованием метода GET ... Однако, опция изменяет метод на POST - при повторном запросе ...
--post302
... Do not switch to GET after following a 302 ... Не переключайтесь на GET после 302 ... Указывает следовать стандарту RFC 2616/10.3.2 и использовать метод POST при перенаправлении HTTP-кода 302 ... Когда сервер возвращает HTTP-код 302 (временное перенаправление) в ответ на запрос, клиент обычно выполняет повторный запрос с использованием метода GET ... Однако, опция изменяет метод на POST - при повторном запросе ...
--post303
... Do not switch to GET after following a 303 ... Не переключайтесь на GET после 303 ... Указывает следовать стандарту RFC 2616/10.3.2 и использовать метод POST при перенаправлении HTTP-кода 303 ... Когда сервер возвращает HTTP-код 303 (смотреть - другое) в ответ на запрос, клиент обычно выполняет повторный запрос с использованием метода GET ... Однако, опция изменяет метод на POST - при повторном запросе ...
--preproxy [protocol://]host[:port]
... Use this proxy first ... Сначала используйте этот прокси ... Указать прокси-сервер, который будет использоваться перед основным прокси-сервером при выполнении запросов ... Это позволяет направлять запросы через промежуточный прокси-сервер - перед достижением основного прокси-сервера ...
--progress-bar -#
... Display transfer progress as a bar ... Отображать ход передачи в виде полосы ... Отображает полосу прогресса загрузки или передачи данных во время выполнения запроса ... Выводить полосу прогресса может быть полезно для отслеживания выполнения запроса, особенно при загрузке или передаче больших файлов ...
--proto <protocols>
... Enable / disable PROTOCOLS ... Включить / отключить ПРОТОКОЛЫ ... Позволяет указать протоколы, которые должны быть использованы при выполнении запроса ... Команда --proto=http,https разрешает только одни, а --proto=-ftp исключает выбранный ...
--proto-default <protocol>
... Use PROTOCOL for any URL missing a scheme ... Используйте ПРОТОКОЛ для любого URL-адреса, в котором отсутствует схема ... Назначает выбранный протокол - для любого URL-адреса, в котором отсутствует имя схемы ...
--proto-redir <protocols>
... Enable / disable PROTOCOLS on redirect ... Включить / отключить ПРОТОКОЛЫ при перенаправлении ... Указать протоколы, которые должны быть использованы при перенаправлении запросов : назначить или исключить определённые ...
--pubkey <key>
... SSH Public key file name ... Имя файла открытого ключа SSH ... Указание публичного ключа при выполнении запросов с использованием протокола SSH - для аутентификации ...
--quote <command> -Q
... Send command(s) to server before transfer ... Отправьте команду(ы) на сервер перед передачей ... Используется для отправки одной или нескольких предварительных команд на сервер - в рамках одного сеанса, но - перед выполнением основного запроса ...
--random-file <file>
... File for reading random data from ... Файл для чтения случайных данных из ... Для указания пути к файлу, который будет использоваться в качестве источника случайных данных при выполнении запросов - при работе с протоколами, требующими генерации случайных данных, такими как SSL / TLS ...
--range <range> -r
... Retrieve only the bytes within RANGE ... Получить только байты в пределах Диапазона ... Для указания диапазона байтов, который требуется получить при загрузке файла или ресурса с сервера ... Полезно при загрузке только определенной части файла : 0-99 первых 100 байт или диапазона байтов с / по 200-500 ...
--rate <max request rate>
... Request rate for serial transfers ... Скорость запроса для последовательных переводов ... Для ограничения скорости загрузки или передачи данных при выполнении запросов - установить максимальную скорость передачи данных в байтах в секунду 100К ; 1М ...
--raw ; эквивалент -i
... Do HTTP "raw"; no transfer decoding ... Делать HTTP - сырым ; нет декодирования передачи ... Для вывода ответа сервера в необработанном (сыром) формате - без изменений, включая заголовки и содержимое, особенно - при работе с протоколами HTTP ...
--referer <URL> -e
... Referrer URL ... URL-адрес реферера ... Для указания заголовка Referer (отправителя) в HTTP-запросе ... Указывает на URL-адрес, с которого был сделан текущий запрос ... Полезно - для отслеживания источника запросов или для реализации логики, однако, некоторые серверы - могут игнорировать или не использовать этот заголовок - в зависимости от настроек сервера ...
--remote-header-name -J
... Use the header-provided filename ... Используйте имя файла, указанное в заголовке ... Использовать имя файла - из заголовка Content-Disposition, вместо имени файла из URL-адреса ...
# Если файл уже существует, он - не будет перезаписан и возникнет ошибка ...
# Перекодировка % символов в имени - не выполняется, поэтому имя выходного файла, может быть - неожиданным ...
# Осторожно в ОС Windows - опция используется злоумышленниками ...
--remote-name -O
... Write output to a file named as the remote file ... Записать вывод в файл, названный удаленным файлом ... Использовать имя файла, указанное в заголовке ответа сервера Content-Disposition - в качестве имени файла для сохранения при загрузке с опцией -O ... Однако, не все серверы предоставляют имя файла в заголовке Content-Disposition ...
--remote-name-all
... Use the remote file name for all URLs ... Используйте имя удаленного файла для всех URL-адресов ... Для сохранения всех загруженных файлов с именами, указанными в заголовках ответа сервера Content-Disposition или с использованием имени файла из URL-адреса ... Полезно, когда сервер предоставляет имена файлов в заголовках ответа или это необходимо сделать - именно так ...
--remote-time -R
... Set the remote file's time on the local output ... Установите время удаленного файла на локальном выходе ... Для установки времени модификации загруженного файла - в соответствии со временем сервера ... Требуется, чтобы сервер предоставлял соответствующие заголовки Last-Modified и Content-Disposition в ответе ...
--remove-on-error
... Remove output file on errors ... Удалить выходной файл при ошибках ... Для удаления загруженного файла в случае возникновения ошибки при выполнении запроса ... Полезно при автоматическом скачивании файлов в скриптах или автоматизированных процессах - чтобы избежать накопления нежелательных или неполных файлов в случае ошибки загрузки ...
--request <method> -X
... Specify request method to use ... Укажите метод запроса для использования ... Для явного указания метода HTTP-запроса, который будет использоваться при выполнении запроса : GET, POST, PUT, DELETE и другие ... Например, при тестировании API или взаимодействии с веб-серверами - требующими определенного метода запроса ...
--request-target <path>
... Specify the target for this request ... Укажите цель для этого запроса ... Указать альтернативный путь - вместо URL-адреса, когда требуется выдавать HTTP запросы без ведущей косой черты или других - не соответствующих обычному шаблону URL ...
--resolve <[+]host:port:addr[,addr] ... >
... Resolve the host+port to this address ... Разрешите хост+порт этому адресу ... Явно указать IP-адрес для заданного хоста при выполнении запроса ... Это позволяет обойти стандартное разрешение DNS и направить запрос на указанный IP-адрес ... Полезно, когда нужно отправить запрос на определенный IP-адрес, не используя стандартное разрешение DNS ... Эквивалентно записи в host / etc, когда модификация системного файла - запрещена антивирусом ...
--retry <num>
... Retry request if transient problems occur ... Повторите запрос, если возникнут временные проблемы ... Для повторной попытки выполнения запроса в случае возникновения ошибки или неудачного ответа от сервера ... По умолчанию - до 10 повторных попыток ...
--retry-all-errors
... Retry all errors (use with --retry) ... Повторить все ошибки (используйте с --retry) ... Повторять попытку запроса - при любой ошибке ...
# Не использовать по умолчанию - могут возникнуть непредвиденные последствия, такие как отправка или получение дубликатов данных ...
# Не использовать с перенаправленным входом или выходом ... При неудачной попытке, данные - удаляются, однако это не относится к данным, записанным в файл через конвейер = | или перенаправление = >, которые - не будут сброшены и появятся дубликаты ...
# Ответ с кодом 404 - не считается ошибкой ... Если нужны ответы на ошибки HTTP 4xx / 5xx - дополнительно указать опции -f, --fail ...
--retry-connrefused
... Retry on connection refused (use with --retry) ... Повторная попытка соединения отклонена (используйте с --retry) ... Для автоматической повторной попытки - в случае отказа соединения (connection refused) - при обработке временных проблем сети или сервера ...
--retry-delay <seconds>
... Wait time between retries ... Время ожидания между повторными попытками ... Для задания задержки между повторными попытками выполнения запроса - в 5 секундах ...
--retry-max-time <seconds>
... Retry only within this period ... Повторить попытку только в течение этого периода ... Для ограничения общего времени, выделенного на повторные попытки выполнения запроса - повторяя запрос до тех пор, пока общее время повторов - не превысит указанное значение ... Полезно - чтобы избежать бесконечных повторов в случае, когда сервер недоступен или запрос занимает слишком много времени ...
--sasl-authzid <identity>
... Identity for SASL PLAIN authentication ... Идентификация для аутентификации SASL PLAIN ... Для указания идентификатора авторизации (authzid) при использовании механизма аутентификации SASL (Simple Authentication and Security Layer) ... SASL - это протокол аутентификации, который позволяет клиенту и серверу взаимодействовать для проверки подлинности и установки безопасного соединения ... При работе с протоколами, которые требуют дополнительной информации для проверки подлинности ...
--sasl-ir
... Enable initial response in SASL authentication ... Включить первоначальный ответ при аутентификации SASL ... Для включения начального ответа (initial response) при аутентификации SASL (Simple Authentication and Security Layer) ... SASL - это протокол аутентификации, который позволяет клиенту и серверу взаимодействовать для проверки подлинности и установки безопасного соединения ... При работе с протоколами, которые требуют начального ответа для успешной аутентификации ...
--service-name <name>
... SPNEGO service name ... Название службы SPNEGO ... Для указания или изменения имени сервиса при выполнении запроса ... Опция - не является стандартной и не имеет документированного значения или функциональности ...
--show-error -S
... Show error even when -s is used ... Показывать ошибку, даже если используется -s ... Для отображения подробных сообщений об ошибках при выполнении запроса ... Дополнительные детали об ошибке, такие как код / описание и другая отладочная информация - при отладке или для технического анализа проблем ...
--silent -s
... Silent mode ... Бесшумный режим ... Для отключения вывода прогресса и сообщений об ошибках при выполнении запроса, в тихом режиме ... Не будет выводить никаких сообщений на экран, кроме результата запроса ... При автоматическом выполнении запросов или работе с большим количеством запросов, где вывод - может быть нежелательным или даже - мешает ...
--socks4 <host[:port]>
... SOCKS4 proxy on given host + port ... Прокси SOCKS4 на данном хосте + порт ... Для указания SOCKS4-прокси сервера при выполнении запроса ... SOCKS (Socket Secure) - это протокол, который позволяет клиентскому приложению проксировать свои сетевые запросы - через прокси-сервер, указывая адрес и порт ... Для обхода ограничений доступа или обеспечения анонимности ...
--socks4a <host[:port]>
... SOCKS4a proxy on given host + port ... Прокси SOCKS4a на заданном хосте + порт ... SOCKS4a - это расширение протокола SOCKS4, которое добавляет поддержку проксирования DNS-имен ... В отличие от SOCKS4, SOCKS4a позволяет клиенту отправлять запросы через прокси, указывая DNS-имя вместо IP-адреса ... Прокси-сервер SOCKS4a самостоятельно разрешает DNS-имена в IP-адреса и выполняет запросы от имени клиента ...
--socks5 <host[:port]>
... SOCKS5 proxy on given host + port ... Прокси SOCKS5 на данном хосте + порт ... SOCKS5 является более продвинутой версией протокола SOCKS и поддерживает различные функции, такие как аутентификация и проксирование DNS-имен ...
--socks5-basic
... Enable username/password auth for SOCKS5 proxies ... Включить аутентификацию по имени пользователя и паролю для прокси SOCKS5 ... Включает аутентификацию с использованием имени пользователя и пароля при подключении к SOCKS5-прокси серверу и порт 1080 по умолчанию ...
--socks5-gssapi
... Enable GSS-API auth for SOCKS5 proxies ... Включить аутентификацию GSS-API для прокси SOCKS5 ... Для указания аутентификации при подключении, когда SOCKS5-прокси сервер - требует аутентификации GSSAPI для доступа к ресурсам ... GSSAPI (Generic Security Services Application Programming Interface) - это стандартный интерфейс безопасности, который позволяет клиентским приложениям аутентифицироваться и устанавливать безопасное соединение с серверами ...
--socks5-gssapi-nec
... Compatibility with NEC SOCKS5 server ... Совместимость с сервером NEC SOCKS5 ... Для указания аутентификации GSSAPI с использованием режима защиты nec - при подключении к SOCKS5-прокси серверу ...
--socks5-gssapi-service <name>
... SOCKS5 proxy service name for GSS-API ... Имя прокси-службы SOCKS5 для GSS-API ... Для указания имени службы GSSAPI при аутентификации при подключении к SOCKS5-прокси серверу ...
--socks5-hostname <host[:port]>
... SOCKS5 proxy, pass host name to proxy ... Прокси SOCKS5, передайте имя хоста прокси ... Для указания использования SOCKS5-прокси сервера с поддержкой проксирования DNS-имен при выполнении запроса ... Использовать указанный SOCKS5-прокси сервер для маршрутизации запросов, включая разрешение DNS-имен через прокси ... Это означает, что DNS-запросы будут отправляться через SOCKS5-прокси сервер, а не напрямую ...
--speed-limit <speed> -Y
... Stop transfers slower than this ... Остановить передачу медленнее, чем эта ... Для ограничения скорости загрузки файлов при выполнении запросов - указать максимальную скорость загрузки файлов в байтах в секунду, 100K , 1M ... Если загрузка происходит медленнее, чем эта заданная скорость - в течение нескольких секунд, она - неявно прерывается опцией -y, --speed-time 30 (секунд до прерывания, по умолчанию) ...
--speed-time <seconds> -y
... Trigger 'speed-limit' abort after this time ... Запустить отмену ограничения скорости по истечении этого времени ... Для указания времени, по истечении которого скорость загрузки файлов - должна быть ограничена ... При явном указании --speed-time без времени = 1 секунда до прерывания, по умолчанию ...
--ssl
... Try SSL/TLS ... Попробуйте SSL/TLS ... Для указания использования SSL / TLS при выполнении защищенного соединения с сервером, чтобы обеспечить шифрование и безопасность передаваемых данных ...
--ssl-allow-beast
... Allow security flaw to improve interop ... Разрешить уязвимости безопасности для улучшения взаимодействия ... Для разрешения уязвимости BEAST (Browser Exploit Against SSL / TLS) при выполнении защищенного соединения с сервером ... Уязвимость BEAST была обнаружена в протоколе SSL / TLS и позволяла злоумышленнику расшифровывать защищенный трафик между клиентом и сервером ... Опция обеспечит совместимость с устаревшими клиентами или серверами, которые могут быть уязвимы к атаке BEAST ... Однако, следует отметить, что это - может повысить риск безопасности, поскольку она отключает некоторые современные безопасные шифры ... Рекомендуется использовать более безопасные настройки SSL / TLS и избегать использования уязвимых шифров ...
--ssl-auto-client-cert
... Use auto client certificate (Schannel) ... Использовать автоматический сертификат клиента (Schannel) ... Для автоматического выбора и отправки доступного клиентского сертификата - при установлении защищенного соединения с сервером ...
--ssl-no-revoke
... Disable cert revocation checks (Schannel) ... Отключить проверки отзыва сертификатов (Schannel) ... Для отключения проверки отзыва сертификатов при установлении защищенного соединения с сервером ... По умолчанию - проверяется отзыв сертификатов, чтобы убедиться, что сертификаты не были отозваны и остаются действительными ...
--ssl-reqd
... Require SSL/TLS ... Требовать SSL/TLS ... Для требования использования SSL / TLS при установлении защищенного соединения с сервером ... Если сервер не поддерживает SSL / TLS, соединение - не будет установлено ...
--ssl-revoke-best-effort
... Ignore missing / offline cert CRL dist points (Schannel) ... Игнорировать отсутствующие / автономные точки распространения CRL сертификата (Schannel) ... Предназначено только для Windows ... Использование локального действующего сертификата - не всегда является решением, поскольку проверки отзыва без подключения к Интернету - завершаются неудачно и с действительным сертификатом ... Альтернативы : вообще отключить проверку сертификатов ( --insecure - это значительно снизит безопасность, поскольку самоподписанные сертификаты будут приниматься так же, как и отозванные) ... ; иметь действительный сертификат ; ... или, не использовать SSL - вообще ...
--sslv2 -2
... Use SSLv2 ... Используйте SSLv2 ... SSL v2 (Secure Sockets Layer version 2) - является устаревшим протоколом безопасности, считается - небезопасным и уязвимым к различным атакам ... Был заменен на SSL v3 и более поздние версии TLS (Transport Layer Security) ... Однако, некоторые старые серверы или клиенты - могут продолжать использовать SSL v2 ...
--sslv3 -3
... Use SSLv3 ... Используйте SSLv3 ... SSL v3 (Secure Sockets Layer version 3) - является устаревшим протоколом безопасности, считается уязвимым к различным атакам и не рекомендуется для использования ... Был заменен более безопасным TLS (Transport Layer Security) ... Однако, некоторые старые серверы или клиенты - могут продолжать использовать SSL v3 ...
--stderr <file>
... Where to redirect stderr ... Куда перенаправить stderr ... Для перенаправления вывода ошибок (stderr) в указанный файл или устройство ... По умолчанию, curl выводит ошибки в стандартный поток ошибок (stderr) ... Однако, с помощью опции - можно перенаправить вывод ошибок - в файл или другое устройство ...
--styled-output
... Enable styled output for HTTP headers ... Включить стилизованный вывод для HTTP-заголовков ... Включает автоматическое использование стилей полужирного шрифта при выводе заголовков HTTP в терминал ... --no-style-output - отключает выделение заголовков ...
--suppress-connect-headers
... Suppress proxy CONNECT response headers ... Подавить заголовки ответа прокси-сервера CONNECT ... Для подавления вывода заголовков ответа при установлении соединения через прокси-сервер ... По умолчанию, при использовании прокси-сервера - заголовки включены в ответ ...
--tcp-fastopen
... Use TCP Fast Open ... Использовать TCP Fast Open ... Для включения поддержки TCP Fast Open - при установлении соединения с сервером ... TCP Fast Open - это механизм, который позволяет установить соединение с сервером и передать данные - в первом пакете TCP, минуя дополнительный раунд-трип времени (RTT) ... Это может ускорить установление соединения и улучшить производительность приложений, особенно при работе с множеством коротких соединений ... Поддержка TCP Fast Open должна быть включена, как - на стороне клиента, так и - на стороне сервера ...
--tcp-nodelay
... Use the TCP_NODELAY option ... Используйте опцию TCP_NODELAY ... Отключает алгоритм накопления данных (Nagle's algorithm) и позволяет отправлять данные - немедленно, без задержек ... Когда требуется минимизировать задержку передачи данных, особенно для интерактивных приложений или передачи небольших пакетов данных ...
--telnet-option <opt=val> -t
... Set telnet option ... Установить опцию Telnet ... Для передачи опций по протоколу Telnet при установлении соединения с сервером ...
--tftp-blksize <value>
... Set TFTP BLKSIZE option ... Установите параметр TFTP BLKSIZE ... Для установки значения BLKSIZE (размер блока данных, передаваемых в каждом пакете, от 512 байт) протокола TFTP (Trivial File Transfer Protocol) ...
--tftp-no-options
... Do not send any TFTP options ... Не отправлять никаких параметров TFTP ... Для отключения передачи опций протокола TFTP (Trivial File Transfer Protocol), содержащих информацию о блоке размера, таймаутах и других параметрах передачи данных ...
--time-cond <time> -z
... Transfer based on a time condition ... Передача в зависимости от временных условий ... Для выполнения условной передачи файлов на основе времени ... Если время модификации удаленного файла - более раннее или совпадает с указанным временем - файл будет передан на сервер ...
--tls13-ciphers <ciphersuite list>
... TLS 1.3 cipher suites to use ... Используемые наборы шифров TLS 1.3 ... Для указания списка шифров, которые могут быть использованы при установлении защищенного соединения с использованием протокола TLS 1.3 ...
--tlsauthtype <type>
... TLS authentication type ... Тип аутентификации TLS ... Для указания типа аутентификации при установлении защищенного соединения с использованием протокола TLS (Transport Layer Security), включая Basic, Digest, NTLM и другие ...
--tls-max <VERSION>
... Set maximum allowed TLS version ... Установить максимально допустимую версию TLS ... Для выбора и ограничения максимальной версии протокола TLS, из 1.0, 1.1, 1.2, 1.3 ...
--tlspassword <string>
... TLS password ... TLS-пароль ... Для указания пароля при установлении защищенного соединения с использованием протокола TLS, при доступе к защищенным ресурсам ...
--tlsuser <name>
... TLS user name ... Имя пользователя TLS ... Для указания имени пользователя (логина) при установлении защищенного соединения с использованием протокола TLS ...
--tlsv1 -1
... Use TLSv1.0 or greater ... Используйте TLSv1.0 или более позднюю версию ... Версия 1 TLS включает 1.0 и 1.1 ...
--tlsv1.0
... Use TLSv1.0 or greater ... Используйте TLSv1.0 или более позднюю версию ... TLS 1.0 - является первой версией протокола защиты передачи данных, но может быть уязвим к некоторым атакам ; считается устаревшим и небезопасным ...
--tlsv1.1
... Use TLSv1.1 or greater ... Используйте TLSv1.1 или более позднюю версию ... TLS 1.1 представляет собой улучшенную версию, но считается - устаревшим и небезопасным ...
--tlsv1.2
... Use TLSv1.2 or greater ... Используйте TLSv1.2 или более позднюю версию ... TLS 1.2 представляет собой улучшенную версию и широко используется в различных приложениях и сервисах для обеспечения безопасной передачи данных через интернет ...
--tlsv1.3
... Use TLSv1.3 or greater ... Используйте TLSv1.3 или более позднюю версию ... Протокол TLS 1.3 основан на спецификации TLS 1.2, включая отличия : ... Разделение рукопожатия и обмена данными, что улучшает производительность и безопасность ... Улучшенная криптография и алгоритмы шифрования ... Поддержка нулевого раунда / 0-RTT - для ускорения установления соединения ... Улучшенная защита от атак, включая шифрование и обмен ключами ... TLS 1.3 представляет собой более современную и безопасную версию протокола безопасной передачи данных через интернет ...
--trace <file>
... Write a debug trace to FILE ... Записать трассировку отладки в FILE ... Для записи отладочной информации о выполнении запроса - в файл, для отладки и анализа сетевых проблем ...
--trace-ascii <file>
... Like --trace, but without hex output ... Как --trace, но без шестнадцатеричного вывода ... Для записи отладочной информации о выполнении запроса - в ASCII формате ...
--trace-config
... Configure which details to log in trace / verbose output ... Настройте, какие данные следует регистрировать в трассировочном / подробном выводе ... Для указания файла конфигурации, который содержит параметры отладки ...
# Вымышленный пример файла конфигурации для отладки ...
# Уровень подробности отладочной информации
debug_level = 2 ... [ 1 ... 3 (более подробно) ] ...
# Путь к файлу журнала ...
log_file = /path/to/debug.log ...
# Дополнительные настройки ...
option1 = value1 ...
proxy = http://proxy.var ...
timeout = 30 ...
--trace-ids
... Add transfer and connection identifiers to trace / verbose output ... Добавьте идентификаторы передачи и соединения в трассировочный / подробный вывод ... Это глобальная опция, начиная с версии v8.2.0 ... Добавляет идентификаторы передачи и соединения к каждой трассировке, или подробную строку, отображаемую завитком ...
--trace-time
... Add time stamps to trace / verbose output ... Добавление меток времени для трассировки / подробного вывода ... Для добавления временных меток к отладочному выводу при использовании опции --trace / --verbose - чтобы показать точное время, когда происходят определенные события в процессе выполнения ...
--tr-encoding
... Request compressed transfer encoding ... Запросить сжатое кодирование передачи ... Запрашивает сжатый ответ Transfer-Encoding / HTTP, используя один из поддерживаемых алгоритмов и распаковывает данные во время их получения ...
--unix-socket <path>
... Connect through this Unix domain socket ... Подключиться через этот доменный сокет Unix ... Для указания пути к сокету Unix - вместо использования сетевого соединения TCP / IP ... Полезно при работе с локальными серверами или использовании протоколов, основанных на сокетах Unix ...
--upload-file <file> -T
... Transfer local FILE to destination ... Перенос локального ФАЙЛА в пункт назначения ... Для загрузки файла на удаленный сервер ...
--url <url>
... URL to work with ... URL-адрес для работы ... Для указания URL-адреса, к которому будет выполнен запрос ...
--url-query <data>
... Add a URL query part ... Добавьте часть URL-запроса ... Этот параметр добавляет фрагмент данных, обычно пару : имя + значение, в конец части запроса URL-адреса ... Синтаксис идентичен используемому для --data-urlencode с одним расширением : если аргумент начинается с + / плюс - остальная часть строки
представляется в незакодированном виде ... Запросная часть URL-адреса - это часть, следующая за вопросительным знаком - на правом конце ...
Например : ... --url-query =encodethis http://site.var/foo ... и --url-query "+name=%20foo" https://site.var ... Один и тот же адрес ...
--use-ascii -B
... Use ASCII / text transfer ... Использовать ASCII / передачу текста ... Для указания, что при загрузке данных с сервера - использовать только символы ASCII и игнорировать любые символы, которые - не являются частью набора ASCII ... Чтобы получить только текстовую информацию - без каких-либо специальных символов или форматирования ...
--user <user:password> -u
... Server user and password ... Пользователь и пароль сервера ... Для указания имени пользователя и пароля при выполнении HTTP-аутентификации ... При запросе - передавать учетные данные для доступа к защищенным ресурсам ...
--user-agent <name> -A
... Send User-Agent <name> to server ... Отправить User-Agent <имя> на сервер ... Задать пользовательский агент (User-Agent) в HTTP-запросе ... User-Agent - это строка, которую веб-браузер или другое приложение - отправляет на сервер, чтобы идентифицировать себя и сообщить серверу о своих возможностях и предпочтениях ... По возможности, сервер - должен адекватно реагировать на предложенную конфигурацию ...
--variable <name=text/@file>
... Set variable ... Установить переменную ... Переменные и расширения командной строки были добавлены в версии 8.3.0 ... Curl поддерживает переменные командной строки ... Задайте переменные с помощью
--variable name=content ...
или --variable name@file , где файл - может быть стандартным вводом, если установлено одно тире (-) ...
Содержимое переменной можно расширить в параметрах опции, используя
{{name}} (без кавычек) , если имя опции имеет префикс --expand- ... При этом будет вставлено содержимое переменной {name} или пусто, если имя - не существует как переменная ... Вставить {{ дословно в строку / экранировать, добавив обратную косую черту, например \{{ ...
Можно получить доступ и расширить переменные среды, сначала - импортировав их ... Прочитать установки переменной среды, либо указать значение по умолчанию, если оно еще - не установлено ... Простой текст --variable %name импортирует переменную с именем name, но - завершает работу с ошибкой, если эта переменная среды - еще не установлена ... Чтобы указать значение по умолчанию, если оно не установлено, использовать --variable %name=content или --variable %name@content ...
Пример ... Если переменная USER - не установлена, произойдет - сбой ...
Нужно предварительно объявить переменную среды USER и добавить её в URL-адрес запроса - расширив его ...
--variable '%USER' ...
--expand-url = "https://example.com/api/{{USER}}/method" ...
При расширении переменных Curl поддерживает набор функций, которые могут сделать содержимое переменных - более удобным в использовании ... Доступные функции обработки переменных ...
trim - обрезать начальные и конечные пробелы с помощью обрезки ...
json - выводит содержимое, используя правила цитирование строк JSON ...
url - кодирует URL-адрес ресурса с символом процентов ...
b64 - расширяет переменную, закодированную в base64 ...
* - Применяя функцию к расширению переменной - добавить ее через двоеточие в правую часть переменной ...
* - Содержимое переменной, содержащее нулевые байты, которые не кодируются при расширении - вызывает ошибку ...
Пример ... Задать содержимое файла с именем .secret в папке $HOME/ - в переменную с именем fix, где @ это будет - файл ... Преобразование данных - производится методом расширения переменных среды ...
--variable %HOME ...
--expand-variable fix@{{HOME}}/.secret ...
--expand-data "{{fix:trim:url}}" ... Дополнительное расширение данных : добавление содержимого файла - через доступную функцию обрезки пробелов - в адрес URL ...
--verbose -v
... Make the operation more talkative ... Сделайте операцию более разговорчивой ... Для включения подробного вывода (verbose output) при выполнении запроса ... curl будет выводить дополнительную информацию о процессе выполнения запроса, включая отправленные и полученные заголовки HTTP, коды состояния, информацию о соединении и другие детали ...
--version -V
... Show version number and quit ... Показать номер версии и выйти ... Используется для вывода информации о версии curl, которая установлена в системе ... Выводит информацию о версии ... Включая номер версии утилиты, версию libcurl (библиотеки, на которой основан curl), поддерживаемые протоколы и другую связанную информацию ...
--write-out <format> -w
... Use output FORMAT after completion ... Использовать выходной формат FORMAT после завершения ... Форматированная информация по завершению операции - на стандартном выводе / экране ПК ... Формат представляет собой - простой текст, смешанный с любым количеством переменных ...
... как - буквальная строка ...
... читать формат из файла - оператор @filename ...
... читать формат из стандартного ввода - оператор @- ...
... Переменные - заменяются подходящим значением или текстом ...
... Все переменные указаны как %{имя_переменной} , большинство - с подчеркиванием, но некоторые - без подчёркивания ...
... % - экранируется сам собой (удвоением) %% ...
... \n - продолжить с новой строки ...
... \r - возврат каретки ...
... \t - символ табуляции / отступа ...
... По умолчанию вывод записывается в стандартный вывод, но его можно изменить с помощью %{stderr} и %output{} ... Выводятся только самые последние изменённые значения переменных ...
... %output{name} - указать файл для записи выходных данных, где name - это полное имя файла ... Вывод начинается - со следующей инструкции ... Можно указать более одной инструкции %output{} ... Если новое имя файла - не может быть создано - вывод продолжается в предыдущее место назначения ...
... %output{>>name} - команда перенаправление с добавлением - для добавления данных в существующий файл ...
... Примечание ... В Windows символ % - это специальный символ, используемый для раскрытия переменных среды ... В пакетных файлах все вхождения % - должны быть удвоены при использовании этой опции для правильного экранирования ... Если этот параметр используется в командной строке, то % нельзя экранировать и возможно - непреднамеренное расширение ...
- Доступные переменные форматирования вывода curl : ...
- certs - Вывод цепочки сертификатов с подробными сведениями ... Поддерживается только серверными модулями OpenSSL, GnuTLS, Schannel и Secure Transport ...
- content_type - Content-Type запрошенного документа, если таковой имеется ...
- errormsg - Сообщение об ошибке ...
- exitcode - Числовой код завершения операции / выхода ... Смотреть коды ошибок - в справке ...
- filename_effective - Окончательное имя файла, в которое Curl записывает ... Это имеет смысл только в том случае, если Curl сообщает о записи в файл с параметром -O, --remote-name или -o, --output ... Это наиболее полезно в сочетании с опцией -J, --remote-header-name ...
- ftp_entry_path - Первоначальный путь, по которому оказался curl при входе на удаленный FTP-сервер ...
- header_json - Объект JSON со всеми заголовками HTTP-ответов из последней передачи ... Значения предоставляются в виде массивов, поскольку в случае нескольких заголовков может быть несколько значений ... Имена заголовков указаны в нижнем регистре и перечислены в порядке появления ... За исключением дублированных заголовков ... Они группируются по первому вхождению этого заголовка, каждое значение представлено в массиве JSON ...
- http_code - Числовой код ответа, который был найден при последней полученной передаче HTTP(S) или FTP(s) ...
- http_connect - Числовой код, который был найден в последнем ответе (от прокси) на запрос Curl CONNECT ...
- http_version - http-версия, которая эффективно использовалась ...
- json - Объект JSON со всеми доступными ключами ...
- local_ip - IP-адрес локального конца последнего установленного соединения - может быть IPv4 или IPv6 ...
- local_port - Номер локального порта последнего установленного соединения ...
- method - Метод http, использованный в последнем HTTP-запросе ...
- num_certs - Количество сертификатов сервера, полученных при подтверждении TLS ... Поддерживается только серверными модулями OpenSSL, GnuTLS, Schannel и Secure Transport ...
- num_connects - Количество новых подключений, сделанных в ходе недавней передачи ...
- num_headers - Количество заголовков ответа в самом последнем запросе (перезапускается при каждом перенаправлении) ... Обратите внимание, что строка состояния НЕ ЯВЛЯЕТСЯ заголовком ...
- num_redirects - Количество редиректов, которые были выполнены в запросе ...
- onerror - Остальная часть вывода отображается только в том случае, если передача - вернула ненулевую ошибку ...
- proxy_ssl_verify_result - Результат запрошенной проверки SSL-сертификата прокси-сервера HTTPS ... 0 - означает, что проверка прошла успешно ...
- redirect_url - Когда HTTP-запрос был сделан без -L, --location для следования за перенаправлениями (или когда встречается --max-redirs), эта переменная - показывает фактический URL-адрес, на который могло бы пойти перенаправление ...
- referer - Заголовок Referer, если он был ...
- remote_ip - Удаленный IP-адрес последнего установленного соединения - может быть IPv4 или IPv6 ...
- remote_port - Номер удаленного порта последнего установленного соединения ...
- response_code - Числовой код ответа, который был найден при последней передаче (ранее известный как http_code) ...
- scheme - Схема URL (иногда называемая протоколом), которая эффективно использовалась ...
- size_download - Общее количество загруженных байтов ... Это размер переданного тела / данных, исключая заголовки ...
- size_header - Общий объем загруженных заголовков в байтах ...
- size_request - Общее количество байт, отправленное в HTTP-запросе ...
- size_upload - Общее количество отправленных байтов ... Это размер переданного тела / данных, исключая заголовки ...
- speed_download - Средняя скорость загрузки, измеренная Curl для полной загрузки ... Байтов в секунду ...
- speed_upload - Средняя скорость выгрузки, измеренная Curl для полной выгрузки ... Байтов в секунду ...
- ssl_verify_result - Результат запрошенной проверки сертификата узла SSL ... 0 - означает, что проверка прошла успешно ...
- stderr - С этого момента вывод -w, --write-out записывается в стандартную ошибку ...
- stdout - С этого момента вывод -w, --write-out записывается в стандартный вывод ... Это значение по умолчанию, но его можно использовать для обратного переключения после переключения на stderr ...
- time_appconnect - Время в секундах, которое прошло от начала до завершения подключения / квитирования SSL/SSH/etc к удаленному хосту ...
- time_connect - Время в секундах, которое прошло от начала до завершения TCP-подключения к удаленному хосту (или прокси-серверу) ...
- time_namelookup - Время в секундах, которое прошло с начала до завершения разрешения имени ...
- time_pretransfer - Время в секундах, которое прошло от начала до начала передачи файла ... Сюда входят все команды и согласования перед передачей, специфичные для конкретного протокола(ов) ...
- time_redirect - Время в секундах, которое потребовалось для всех шагов перенаправления, включая поиск имени, подключение, предварительную передачу и передачу, прежде чем была запущена финальная транзакция ... time_redirect показывает полное время выполнения нескольких перенаправлений ...
- time_starttransfer - Время в секундах, которое прошло от начала до получения первого байта ... Сюда входит time_pretransfer, а также время, необходимое серверу для вычисления результата ...
- time_total - Общее время в секундах, в течение которого длилась полная операция ...
- URL-адрес и URLE эффективный (последний) адрес ... Практически - то же самое описание ...
- url - Адрес, который был получен ... url_effective - URL-адрес, который был получен последним ... Это наиболее значимо, если Curl - указано следовать location : headers ...
- url.scheme - Часть схемы ... urle.scheme ...
- url.user - Пользователь ... urle.user ...
- url.password - Пароль ... urle.password ...
- url.options - Опции и параметры ... urle.options ...
- url.host - Хост ... urle.host ...
- url.port - Порт ... Если номер порта не указан, но схема URL-адреса известна, отображается номер порта по умолчанию для этой схемы ... urle.port ...
- url.path - Путь ... urle.path ...
- url.query - Запрос ... urle.query ...
- url.fragment - Фрагмент адреса ... urle.fragment ...
- url.zoneid - Идентификатор зоны ... urle.zoneid ...
- urlnum - Индексный номер URL-адреса этой передачи, индексированный с 0 ... Незаблокированные URL-адреса имеют тот же индексный номер, что и исходный общий URL-адрес ...
--xattr
... Store metadata in extended file attributes ... Храните метаданные в расширенных атрибутах файла ... Для сохранения метаданных - в расширенных атрибутах файла ... Расширенные атрибуты (extended attributes) - позволяют хранить дополнительную информацию о файле, которая не входит в стандартные атрибуты, такие как права доступа или время модификации ...
Прокси. Повторюша Баба Хрюша.
* Большинство прокси команд - повторяет основные команды соединения с сервером, но - с приставкой и для proxy HTTP / S соединений ...
--proxy [protocol://]host[:port] -x
... Use this proxy ... Используйте этот прокси ... Явно указать протокол, хост и порт прокси-сервера, который будет использоваться для выполнения запроса - когда нужно обеспечить анонимность, обойти ограничения или защитить свою частную сеть ...
--proxy1.0 <host[:port]>
... Use HTTP/1.0 proxy on given port ... Использовать прокси-сервер HTTP/1.0 на заданном порту ... Вместо HTTP 1.1 по умолчанию - протокол HTTP 1.0 и заданный номер порта (по умолчанию = 1080) ...
--proxy-anyauth
... Pick any proxy authentication method ... Выберите любой метод аутентификации прокси ... Выбрать любой доступный метод аутентификации прокси-сервера, включая Basic, Digest, NTLM и другие ... То же, см. * ...
--proxy-basic
... Use Basic authentication on the proxy ... Используйте базовую аутентификацию на прокси-сервере ... Использовать базовую аутентификацию HTTP при подключении к прокси-серверу, предполагая кодирование имени пользователя и пароля - в заголовке Authorization запроса ... То же, см. * ...
--proxy-cacert <file>
... CA certificate to verify peer against for proxy ... Сертификат CA для проверки однорангового узла для прокси ... Указать путь к файлу, содержащему сертификаты удостоверяющих центров (CA), которые будут использоваться при установлении безопасного соединения через прокси-сервер - для проверки подлинности сертификатов прокси-сервера ... То же, см. * ...
--proxy-ca-native
... Use CA certificates from the native OS for proxy ... Используйте сертификаты CA из собственной ОС для прокси ... Для TLS - сообщает использовать собственное хранилище CA для проверки прокси-сервера HTTPS ... По умолчанию используется хранилище CA, расположенное в одном файле или каталоге ОС ... Этот параметр работает только для Curl в Windows, если он создан для использования OpenSSL или созданный с помощью wolfSSL ... То же, см. * ...
--proxy-capath <dir>
... CA directory to verify peer against for proxy ... Каталог CA для проверки однорангового узла на наличие прокси ... Указать путь к каталогу, содержащему сертификаты удостоверяющих центров (CA), которые будут использоваться при установлении безопасного соединения через прокси-сервер ... То же, см. * ...
--proxy-cert <cert[:passwd]>
... Set client certificate for proxy ... Установить сертификат клиента для прокси ... То же, см. * ...
--proxy-cert-type <type>
... Client certificate type for HTTPS proxy ... Тип сертификата клиента для HTTPS-прокси ... То же, см. * ...
--proxy-ciphers <list>
... SSL ciphers to use for proxy ... SSL-шифры для использования в качестве прокси ... То же, см. * ...
--proxy-crlfile <file>
... Set a CRL list for proxy ... Установите список CRL для прокси ... То же, см. * ...
--proxy-digest
... Use Digest authentication on the proxy ... Использовать дайджест-аутентификацию на прокси-сервере ... То же, см. * ...
--proxy-header <header/@file>
... Pass custom header(s) to proxy ... Передача пользовательских заголовков прокси ... То же самое, что и --header, но используется для прокси-сервера HTTPS ... То же, см. * ...
* Не добавлять вручную символы новой строки и возврата каретки - за этим следит curl ...
* Для аргументов в стиле @имя-файла - каждая строка будет добавлена, как - заголовок ...
* Для аргументов в стиле @- curl будет читать файл заголовка из stdin ...
--proxy-http2
... Use HTTP/2 with HTTPS proxy ... Используйте HTTP/2 с HTTPS-прокси ... То же, см. * ...
--proxy-insecure
... Do HTTPS proxy connections without verifying the proxy ... Выполнять прокси-подключения HTTPS без проверки прокси ... То же, см. * ...
--proxy-key <key>
... Private key for HTTPS proxy ... Закрытый ключ для HTTPS-прокси ... То же, см. * ...
--proxy-key-type <type>
... Private key file type for proxy ... Тип файла закрытого ключа для прокси ... То же, см. * ...
--proxy-negotiate
... Use HTTP Negotiate (SPNEGO) authentication on the proxy ... Используйте аутентификацию HTTP Negotiate (SPNEGO) на прокси-сервере ... То же, см. * ...
--proxy-ntlm
... Use NTLM authentication on the proxy ... Используйте аутентификацию NTLM на прокси-сервере ... То же, см. * ...
--proxy-pass <phrase>
... Pass phrase for the private key for HTTPS proxy ... Парольная фраза для закрытого ключа для HTTPS-прокси ... То же, см. * ...
--proxy-pinnedpubkey <hashes>
... FILE / HASHES public key to verify proxy with ... Открытый ключ Файл / Хеш для проверки прокси-сервера ... То же, см. * ...
--proxy-service-name <name>
... SPNEGO proxy service name ... Название прокси-сервиса SPNEGO ... То же, см. * ...
--proxy-ssl-allow-beast
... Allow security flaw for interop for HTTPS proxy ... Разрешить уязвимость безопасности для взаимодействия с HTTPS-прокси ... То же, см. * ...
--proxy-ssl-auto-client-cert
... Use auto client certificate for proxy (Schannel) ... Использовать автоматический сертификат клиента для прокси (Schannel) ... То же, см. * ...
--proxy-tls13-ciphers <ciphersuite list>
... TLS 1.3 proxy cipher suites ... Наборы прокси-шифров TLS 1.3 ... То же, см. * ...
--proxy-tlsauthtype <type>
... TLS authentication type for HTTPS proxy ... Тип аутентификации TLS для HTTPS-прокси ... То же, см. * ...
--proxy-tlspassword <string>
... TLS password for HTTPS proxy ... Пароль TLS для HTTPS-прокси ... То же, см. * ...
--proxy-tlsuser <name>
... TLS username for HTTPS proxy ... Имя пользователя TLS для HTTPS-прокси ... То же, см. * ...
--proxy-tlsv1
... Use TLSv1 for HTTPS proxy ... Используйте TLSv1 для HTTPS-прокси ... То же, см. * ...
--proxytunnel -p
... Operate through an HTTP proxy tunnel (using CONNECT) ... Работа через туннель HTTP-прокси (с использованием CONNECT) ... Создает туннель через прокси-сервер, который позволяет установить прямое соединение с целевым сервером, где туннель - требуется для обхода ограничений или фильтров ...
--proxy-user <user:password> -U
... Proxy user and password ... Пользователь и пароль прокси ... То же, см. * ...
Раздел computer : список всех страниц ...