Omrežje in oddaljeni dostop

Ukaz curl

Pošljite zahteve HTTP in prenesite podatke

Linux · Bash primeri · ukazi se izvajajo na izbranem strežniku

Kdaj uporabiti curl

Uporabite curl, da pregledate odgovore HTTP, prenesete vir ali pokličete API s strežnika. Ločite uspeh prenosa od uspeha aplikacije, nastavite razumne časovne omejitve in preprečite, da bi bili žetoni za preverjanje pristnosti izven shranjenih primerov ukazov.

Sintaksa

curl [PARAMETERS] URL

Oglati oklepaji označujejo neobvezne argumente; elipsa pomeni ponavljanje. Zamenjajte vzorčna imena datotek, uporabniška imena in naslove strežnikov s svojimi vrednostmi.

Pogoste možnosti in argumenti

-I
Zahtevajte samo glave HTTP z uporabo metode HEAD.
-f
Vrne napako za statusne kode HTTP 400 in več.
-L
Sledite preusmeritvam; -o podaja datoteko rezultatov.

Primeri uporabe

Preverite glave spletnega mesta

curl -I https://example.com

Izdela se zahteva samo za glavo; nekatere storitve to obravnavajo drugače kot običajno zahtevo po vsebini.

Prenesite datoteko z obdelavo napak HTTP

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

Sledijo preusmeritve in telo odgovora nadomesti imenovano lokalno datoteko; Statusi napak HTTP povzročajo napako.

Zahteva JSON s časovno omejitvijo

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

Zahteva se odgovor JSON z omejenim skupnim trajanjem; končna točka mora dejansko zagotavljati, da je API.

Opombe in omejitve

  • Z HTTPS je potrdilo privzeto preverjeno; ne onemogočite preverjanja prek -k brez posebnega razloga.
  • Ne postavljajte pravih žetonov ali gesel v zgodovino ukazov in ne izvajajte prenesenih skriptov brez preverjanja.

Pogosta vprašanja in odpravljanje težav

Zakaj curl uspe, ko strežnik vrne stran z napako?

Brez možnosti neuspeha lahko prejem odgovora o napaki HTTP še vedno šteje za uspešen prenos. Preverite status HTTP in status izhoda ukaza.

Ali naj onemogočim preverjanje potrdila, da popravim HTTPS?

Ne zaobidite zaupanja kot rutinskega popravka. Namesto tega preverite ime gostitelja, sistemski čas, verigo potrdil strežnika in konfiguracijo zaupanja vrednega CA.

Nadaljnja pomoč

Možnosti se razlikujejo glede na različico in distribucijo. Preverite nameščeno dokumentacijo s tem ukazom: man curl.