Verkko- ja etäkäyttö

Komento curl

Lähetä HTTP-pyyntöjä ja lataa tietoja

Linux · Bash-esimerkkejä · komennot suoritetaan valitulla palvelimella

Milloin käyttää curl

Käytä curl:tä HTTP-vastausten tarkistamiseen, resurssin lataamiseen tai API:n soittamiseen palvelimelta. Erottele kuljetuksen onnistuminen sovellusten onnistumisesta, aseta järkevät aikakatkaisut ja pidä todennustunnisteet poissa tallennetuista komento-esimerkeistä.

Syntaksi

curl [PARAMETERS] URL

Hakasulkeet merkitsevät valinnaisia argumentteja; ellipsi tarkoittaa toistoa. Korvaa esimerkkitiedostojen nimet, käyttäjänimet ja palvelinosoitteet omilla arvoillasi.

Yleisiä vaihtoehtoja ja argumentteja

-I
Pyydä vain HTTP-otsikot käyttämällä HEAD-menetelmää.
-f
Palauttaa virheilmoituksen HTTP-tilakoodille 400 tai sitä uudemmalle.
-L
Seuraa uudelleenohjauksia; -o määrittää tulostiedoston.

Käyttöesimerkkejä

Tarkista sivuston otsikot

curl -I https://example.com

Vain otsikkoa koskeva pyyntö tehdään; Jotkut palvelut käsittelevät tämän eri tavalla kuin tavalliset sisältöpyynnöt.

Lataa tiedosto, jossa käsitellään HTTP-virheitä

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

Uudelleenohjauksia seurataan ja vastauksen runko korvaa nimetyn paikallisen tiedoston; HTTP-virhetilat aiheuttavat virheen.

Pyydä JSON aikarajoituksella

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

JSON-vastausta pyydetään rajoitetulla kokonaiskestolla; päätepisteen on itse asiassa annettava, että API.

Huomautuksia ja rajoituksia

  • HTTPS:lla varmenne varmistetaan oletusarvoisesti; älä poista käytöstä -k:n kautta tapahtuvaa tarkistusta ilman erillistä syytä.
  • Älä sijoita oikeita tunnuksia tai salasanoja komentohistoriaan äläkä suorita ladattuja komentosarjoja ilman vahvistusta.

Yleisiä kysymyksiä ja vianetsintä

Miksi curl onnistuu, kun palvelin palauttaa virhesivun?

Ilman epäonnistumisvaihtoehtoa HTTP-virhevastauksen saaminen voidaan silti laskea onnistuneeksi siirroksi. Tarkista sekä HTTP-tila että komennon poistumistila.

Pitäisikö minun poistaa varmenteen vahvistus käytöstä korjataksesi HTTPS?

Älä ohita luottamusta rutiinikorjauksena. Tarkista sen sijaan isäntänimi, järjestelmän aika, palvelimen varmenneketju ja luotettava CA-määritys.

Lisäapua

Vaihtoehdot vaihtelevat version ja jakelun mukaan. Tarkista asennettu dokumentaatio tällä komennolla: man curl.