Sieťový a vzdialený prístup

Príkaz curl

Odosielajte požiadavky HTTP a sťahujte údaje

Linux · Príklady Bash · príkazy spustené na zvolenom serveri

Kedy použiť curl

Použite curl na kontrolu odpovedí HTTP, stiahnutie zdroja alebo zavolanie API zo servera. Oddeľte úspešnosť prenosu od úspechu aplikácie, nastavte rozumné časové limity a držte autentifikačné tokeny mimo uložených príkladov príkazov.

Syntax

curl [PARAMETERS] URL

Hranaté zátvorky označujú voliteľné argumenty; elipsa znamená opakovanie. Nahraďte vzorové názvy súborov, mená používateľov a adresy serverov svojimi vlastnými hodnotami.

Bežné možnosti a argumenty

-I
Požiadajte iba o hlavičky HTTP pomocou metódy HEAD.
-f
Vráti chybu pre stavové kódy HTTP 400 a vyššie.
-L
Sledujte presmerovania; -o určuje výsledný súbor.

Príklady použitia

Skontrolujte hlavičky stránok

curl -I https://example.com

Uskutoční sa požiadavka iba na hlavičku; niektoré služby to riešia odlišne od bežnej požiadavky na obsah.

Stiahnite si súbor so spracovaním chýb HTTP

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

Nasledujú presmerovania a telo odpovede nahradí pomenovaný lokálny súbor; Chybové stavy HTTP spôsobujú poruchu.

Žiadosť JSON s časovým limitom

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

Vyžaduje sa odpoveď JSON s obmedzeným celkovým trvaním; koncový bod musí skutočne poskytovať API.

Poznámky a obmedzenia

  • Pri HTTPS je certifikát štandardne overený; nezakazujte kontrolu cez -k bez osobitného dôvodu.
  • Neumiestňujte skutočné tokeny alebo heslá do histórie príkazov a nespúšťajte stiahnuté skripty bez overenia.

Bežné otázky a riešenie problémov

Prečo je curl úspešný, keď server vráti chybovú stránku?

Bez možnosti zlyhania sa prijatie chybovej odpovede HTTP môže stále považovať za úspešný prenos. Skontrolujte stav HTTP aj stav ukončenia príkazu.

Mám zakázať overenie certifikátu, aby som opravil HTTPS?

Neobchádzajte dôveru ako rutinnú opravu. Namiesto toho skontrolujte názov hostiteľa, systémový čas, reťazec certifikátov servera a konfiguráciu dôveryhodnej CA.

Ďalšia pomoc

Možnosti sa líšia podľa verzie a distribúcie. Skontrolujte nainštalovanú dokumentáciu pomocou tohto príkazu: man curl.