Dostęp sieciowy i zdalny

Komenda curl

Wysyłaj żądania HTTP i pobieraj dane

Linux · Przykłady Bash · Komendy uruchamiane na wybranym serwerze

Kiedy stosować curl

Użyj curl, aby sprawdzić odpowiedzi HTTP, pobrać zasób lub wywołać API z serwera. Oddziel sukces transportu od sukcesu aplikacji, ustaw rozsądne limity czasu i nie umieszczaj tokenów uwierzytelniających w zapisanych przykładach poleceń.

Składnia

curl [PARAMETERS] URL

Nawiasy kwadratowe oznaczają argumenty opcjonalne; wielokropek oznacza powtórzenie. Zastąp przykładowe nazwy plików, nazwy użytkowników i adresy serwerów własnymi wartościami.

Typowe opcje i argumenty

-I
Żądaj tylko nagłówków HTTP, używając metody HEAD.
-f
Zwróć błąd dla kodów stanu HTTP 400 i wyższych.
-L
Śledź przekierowania; -o określa plik wynikowy.

Przykłady użycia

Sprawdź nagłówki witryn

curl -I https://example.com

Wysyłane jest żądanie zawierające wyłącznie nagłówek; niektóre usługi obsługują to inaczej niż zwykłe żądanie treści.

Pobierz plik z przetwarzaniem błędów HTTP

curl --fail --location --output ./page.html https://example.com

Następują przekierowania, a treść odpowiedzi zastępuje nazwany plik lokalny; Stany błędów HTTP powodują awarię.

Zapytanie JSON z ograniczeniem czasowym

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

Żądana jest odpowiedź JSON z ograniczonym całkowitym czasem trwania; punkt końcowy musi faktycznie zapewniać, że API.

Uwagi i ograniczenia

  • W przypadku HTTPS certyfikat jest domyślnie weryfikowany; nie wyłączaj sprawdzania przez -k bez osobnego powodu.
  • Nie umieszczaj prawdziwych tokenów ani haseł w historii poleceń i nie uruchamiaj pobranych skryptów bez weryfikacji.

Często zadawane pytania i rozwiązywanie problemów

Dlaczego curl kończy się sukcesem, gdy serwer zwraca stronę błędu?

Bez opcji niepowodzenia otrzymanie odpowiedzi na błąd HTTP nadal może być liczone jako udany transfer. Sprawdź zarówno status HTTP, jak i status wyjścia polecenia.

Czy powinienem wyłączyć weryfikację certyfikatu, aby naprawić HTTPS?

Nie omijaj zaufania w ramach rutynowej naprawy. Zamiast tego sprawdź nazwę hosta, czas systemowy, łańcuch certyfikatów serwera i konfigurację zaufanego urzędu certyfikacji.

Dalsza pomoc

Opcje różnią się w zależności od wersji i dystrybucji. Sprawdź zainstalowaną dokumentację za pomocą tego polecenia: man curl.