Главная
» WINDOWS
»
Как использовать cURL в Windows 10: основные команды
Как использовать cURL в Windows 10: основные команды
В Windows 10 есть curl.exe , поэтому вы можете отправлять веб-запросы из PowerShell или командной строки без установки отдельного инструмента. Откройте терминал, убедитесь, что он запущен, затем используйте cURL с URL-адресом для получения страницы, проверки заголовков ответа, загрузки файла или отправки данных в API. В Windows PowerShell 5.1 введите curl.exeвместо , curlчтобы PowerShell запускал настоящую программу cURL.
Перед использованием параметров cURL проверьте установленную версию.
1. Откройте терминал и проверьте cURL.
Откройте меню «Пуск», найдите PowerShell или «Командная строка» и запустите их обычным способом. Для обычных запросов или загрузок в папки пользователя права администратора не требуются.
curl.exe --version
В выходных данных указывается установленная версия, а также протоколы и функции, доступные в этой сборке. В Windows PowerShell 5.1 есть встроенный псевдоним curlдля отдельной Invoke-WebRequestкоманды, поэтому команды, скопированные из руководств по Linux, могут вести себя по-разному, если вы не используете curl.exe. В PowerShell 7 этот псевдоним не определен. Microsoft описывает это различие в своем руководстве по cURL в Windows .
2. Сформулируйте простой запрос.
После команды укажите URL-адрес. cURL по умолчанию использует HTTP GET и выводит тело ответа в терминал:
curl.exe "https://example.com"
Для веб-страницы ответ представляет собой HTML; API может возвращать JSON или другой формат. Команда передает ответ как есть, а не отображает его, как в браузере. Если URL содержит такие символы, как &или ?, заключите полный URL в кавычки, чтобы оболочка передала его в качестве одного аргумента.
Обычный запрос cURL выводит ответ сервера в терминал.
3. Проверьте заголовки ответа.
Используйте заглавные буквы -Iдля отправки HEAD-запроса и отображения заголовков ответа без загрузки тела запроса:
curl.exe -I "https://example.com"
Заголовки могут отображать HTTP-статус, тип контента, сведения о кэшировании и другие метаданные сервера. Некоторые сервисы не поддерживают HEAD или возвращают для него результат, отличный от GET. Чтобы включить заголовки в обычный ответ GET, используйте `<header>` в нижнем регистре -i. Используйте ` <header>`, -Lкогда сервер перенаправляет запрос, и вы хотите, чтобы cURL следовал этому перенаправлению.
Опция -I запрашивает у сервера только заголовки ответа.
4. Сохраните ответ в файл.
По умолчанию cURL выводит данные ответа в терминал. Используйте -oдля выбора имени файла и его расположения. Этот пример PowerShell записывает HTML-ответ в папку «Загрузки»:
-LКоманда следует перенаправлениям, а -oимя выходного файла задаётся автоматически. Команда перезаписывает файл с тем же именем, поэтому тщательно выбирайте место назначения. Чтобы сохранить файл в текущей папке, используйте curl.exe -L -o "example.html" "https://example.com". -OОпция (заглавная буква O) вместо этого использует имя файла из URL:
Второй URL-адрес — это пример формата; замените его прямым URL-адресом существующего файла, на загрузку которого у вас есть разрешение.
Опция -o записывает ответ в указанный файл.
5. Отправка JSON в API
Для JSON POST-запроса укажите метод, тип содержимого и тело запроса. Замените пример конечной точки на URL-адрес вашего собственного API:
curl.exe -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d '{"name":"widget"}'
-X POSTВыбирает метод HTTP, -Hдобавляет заголовок и -dпредоставляет тело запроса. Сервер должен принимать POST-запросы, а поля JSON должны соответствовать его API. Не вставляйте пароли, закрытые токены или другие секреты в команду, если история терминала или общие журналы могут их раскрыть. В официальном руководстве по cURL перечислены эти параметры и требования к их версиям.
Исправьте распространённые проблемы
«curl не распознан». Запустите where.exe curlв PowerShell или командной строке. В Windows 10 копия от Microsoft обычно доступна по адресу C:\Windows\System32\curl.exe. Если исполняемый файл отсутствует в пользовательской установке, загрузите сборку для Windows с официальной страницы cURL для Windows , выберите пакет для вашей системы и запустите curl.exeиз извлеченной папки. Добавьте эту папку в PATH только в том случае, если вы хотите запускать его из любого каталога.
PowerShell сообщает о недопустимом параметре. Убедитесь, что команда начинается с curl.exe. В Windows PowerShell 5.1 вместо этого curlможно использовать обычный вызов Invoke-WebRequest.
Запрос завершается с ошибкой сертификата HTTPS. Проверьте дату и время на компьютере, обновите Windows и убедитесь, что рабочий прокси-сервер или продукт безопасности не требует наличия доверенного сертификата. Избегайте использования этого метода -kв качестве стандартного решения, поскольку он отключает проверку сертификатов.
В Windows 10 по-прежнему используется cURL, но Microsoft прекратила поддержку Windows 10 14 октября 2025 года. Устройства, не участвующие в соответствующей программе обновления безопасности, больше не получают регулярных исправлений безопасности; см. уведомление Microsoft о поддержке Windows 10 .