Jak korzystać z cURL w systemie Windows 10: podstawowe polecenia

System Windows 10 zawiera plik curl.exe , dzięki czemu można wysyłać żądania internetowe z programu PowerShell lub wiersza poleceń bez konieczności instalowania osobnego narzędzia. Otwórz terminal, sprawdź, czy działa, a następnie użyj polecenia cURL z adresem URL, aby pobrać stronę, sprawdzić nagłówki odpowiedzi, pobrać plik lub wysłać dane do interfejsu API. W programie Windows PowerShell 5.1 wpisz curl.exezamiast , curlaby program PowerShell uruchomił prawdziwy program cURL.

1. Otwórz terminal i sprawdź cURL

Otwórz Start, wyszukaj PowerShell lub Wiersz polecenia i uruchom program normalnie. Uprawnienia administratora nie są wymagane do wykonywania zwykłych żądań ani pobierania plików do folderów użytkownika.

curl.exe --version

Dane wyjściowe zawierają zainstalowaną wersję oraz protokoły i funkcje dostępne w tej kompilacji. Program Windows PowerShell 5.1 ma wbudowany alias nazwany curldla osobnego Invoke-WebRequestpolecenia, więc polecenia skopiowane z samouczków Linuksa mogą zachowywać się inaczej, chyba że użyjesz curl.exe. Program PowerShell 7 nie definiuje tego aliasu. Firma Microsoft dokumentuje tę różnicę w swoim przewodniku cURL dla systemu Windows .

2. Złóż podstawową prośbę

Po poleceniu należy podać adres URL. cURL domyślnie używa protokołu HTTP GET i zapisuje treść odpowiedzi w terminalu:

curl.exe "https://example.com"

W przypadku strony internetowej odpowiedzią jest HTML; API może zwrócić JSON lub inny format. Polecenie przesyła odpowiedź w postaci niezmienionej, zamiast renderować ją jak przeglądarka. Jeśli adres URL zawiera znaki takie jak &lub ?, należy umieścić cały adres URL w cudzysłowie, aby powłoka przekazała go jako jeden argument.

3. Sprawdź nagłówki odpowiedzi

Użyj wielkich liter -I, aby wysłać żądanie HEAD i wyświetlić nagłówki odpowiedzi bez pobierania treści:

curl.exe -I "https://example.com"

Nagłówki mogą pokazywać status HTTP, typ zawartości, szczegóły buforowania i inne metadane serwera. Niektóre usługi nie obsługują HEAD lub zwracają inny wynik niż w przypadku GET. Aby dołączyć nagłówki do standardowej odpowiedzi GET, należy używać małych liter -i. Używaj ich, -Lgdy serwer przekierowuje żądanie i chcesz, aby cURL podążał za tym przekierowaniem.

4. Zapisz odpowiedź do pliku

Domyślnie cURL drukuje dane odpowiedzi w terminalu. Użyj tego przycisku -o, aby wybrać nazwę pliku i lokalizację. Ten przykład programu PowerShell zapisuje odpowiedź HTML w folderze Pobrane:

curl.exe -L -o "$env:USERPROFILE\Downloads\example.html" "https://example.com"

-LNastępuje przekierowanie, a jednocześnie -onazwa pliku wyjściowego. Polecenie nadpisuje plik o tej samej nazwie, dlatego należy ostrożnie wybierać miejsce docelowe. Aby zapisać plik w bieżącym folderze, należy użyć curl.exe -L -o "example.html" "https://example.com". -OOpcja (wielka litera O) zamiast tego używa nazwy pliku z adresu URL:

curl.exe -L -O "https://example.com/files/archive.zip"

Drugi adres URL jest formatem przykładowym; zastąp go bezpośrednim adresem URL pliku, który istnieje i który możesz pobrać.

5. Wyślij JSON do API

W przypadku żądania JSON POST określ metodę, typ zawartości i treść żądania. Zastąp przykładowy punkt końcowy adresem URL własnego interfejsu API:

curl.exe -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d '{"name":"widget"}'

-X POSTWybiera metodę HTTP, -Hdodaje nagłówek i -ddostarcza treść. Serwer musi akceptować żądania POST, a pola JSON muszą być zgodne z jego API. Nie wklejaj haseł, prywatnych tokenów ani innych poufnych informacji do polecenia, jeśli historia terminala lub współdzielone logi mogą je ujawnić. Oficjalny podręcznik cURL zawiera listę tych opcji i ich wymagania dotyczące wersji.

Rozwiązywanie typowych problemów

• „curl nie jest rozpoznawany”. Uruchom where.exe curlw programie PowerShell lub w wierszu poleceń. W systemie Windows 10 kopia Microsoft jest zazwyczaj dostępna jako C:\Windows\System32\curl.exe. Jeśli plik wykonywalny nie jest dostępny w instalacji niestandardowej, pobierz kompilację systemu Windows z oficjalnej strony cURL dla systemu Windows , wybierz pakiet odpowiedni dla swojego systemu i uruchom program curl.exez wyodrębnionego folderu. Dodaj ten folder do zmiennej PATH tylko wtedy, gdy chcesz uruchomić program z dowolnego katalogu.
• PowerShell informuje, że parametr jest nieprawidłowy. Upewnij się, że polecenie zaczyna się od curl.exe. W programie Windows PowerShell 5.1 zamiast tego curlmoże zostać wywołane polecenie plain Invoke-WebRequest.
• Żądanie kończy się niepowodzeniem z błędem certyfikatu HTTPS. Sprawdź datę i godzinę na komputerze, zaktualizuj system Windows i sprawdź, czy serwer proxy lub produkt zabezpieczający wymaga zaufanego certyfikatu. Unikaj stosowania tej opcji -kjako rutynowej naprawy, ponieważ wyłącza ona weryfikację certyfikatu.

W systemie Windows 10 nadal działa cURL, ale firma Microsoft zakończyła wsparcie techniczne systemu Windows 10 14 października 2025 r. Urządzenia nieobjęte obowiązującym programem aktualizacji zabezpieczeń nie będą już otrzymywać regularnych poprawek zabezpieczeń; zapoznaj się z powiadomieniem firmy Microsoft dotyczącym wsparcia technicznego systemu Windows 10 .