Skip to content

curl-valitsimet selitetyt

Arkikäytön curl-valitsimet ryhmiteltynä tehtävän mukaan: muotoile pyyntö, aseta otsikot, tunnistaudu, esitä identiteetti, hallitse tulostetta, seuraa uudelleenohjauksia, säädä yhteys ja etsi vikoja. Jokainen rivi parittaa valitsimen realistiseen kutsuun.

curl lähettää HTTP-pyynnön ja tulostaa vastauksen rungon. Suurin osa sen voimasta on valitsimissa: ne valitsevat metodin, liittävät otsikot ja dataa, hoitavat tunnistautumisen ja päättävät mitä tulostetaan. Pitkä muoto näytetään kun se on selvempi; lyhyt muoto on yksittäinen kirjain. Laita URL-osoitteet lainausmerkkeihin, jotta shell ei söi kyselymerkkijonoa.

Viitetaulukko · 54 merkintää
54 of 54 rows
Pyynnön muoto
Asettaa HTTP-metodin.curl -X POST https://api.test
Lisää pyyntöotsikon.curl -H "Accept: application/json" URL
Lähettää rungon (asettaa POSTin ja oletussisältötyypin).curl -d "name=Ada" URL
Liittää -d-arvot kyselyparametreina GET-pyyntöön.curl -G -d "q=hi" URL
Lähettää multipart-lomaketietoa (tiedostojen lataukset).curl -F "file=@photo.png" URL
Lähettää lomaketiedot URL-koodauksen kera.curl --data-urlencode "name=Ada Lovelace" URL
Lataa tiedoston PUTilla.curl -T big.zip URL
Liittää latauksen etäpään tiedostoon korvaamisen sijaan.curl -a -T log.txt ftp://server.test/logs/log.txt
JSON ja API:t
Lähettää JSONin oikealla sisältötyypillä.curl -H "Content-Type: application/json" -d '{"a":1}' URL
Lähettää tiedoston sisällön runkona.curl -d @body.json URL
Lähettää JSONin ilman otsikoiden käsin asettamista (curl 7.82+).curl --json '{"a":1}' URL
Tunnistautuminen
HTTP Basic -tunnistautuminen käyttäjällä ja salasanalla.curl -u ada:s3cr3t URL
Lähettää OAuth-bearer-tokenin.curl --oauth2-bearer TOKEN URL
Lähettää minkä tahansa token-kaavan käsin.curl -H "Authorization: Bearer TOKEN" URL
Esittää asiakasvarmenteen ja sen avaimen molemminpuoliseen TLS:ään.curl --cert client.pem --key key.pem URL
Varmistaa palvelimen yhtä CA-nipputiedostoa vasten.curl --cacert ca.pem URL
Varmistaa palvelimen CA-hakemistoa vasten.curl --capath /etc/ssl/certs URL
Lähettää pyynnön välityspalvelimen kautta.curl -x http://proxy.test:8080 URL
Ohittaa TLS-varmistuksen vain välityspalvelinhypyn osalta.curl -x https://proxy.test:8443 --proxy-insecure URL
Vaatii TLS 1.3:n vähimmäisversioksi.curl --tlsv1.3 URL
Identiteetti
Lähettää mukautetun User-Agent-merkkijonon.curl -A "Mozilla/5.0" URL
Lähettää Referer-otsikon.curl -e https://example.com/page URL
Lähettää evästeitä pyynnön mukana.curl -b "session=abc123" URL
Tallentaa vastausevästeet tiedostoon.curl -c cookies.txt URL
Tuloste
Kirjoittaa rungon tiedostoon.curl -o page.html URL
Tallentaa rungon etäpään tiedostonimellä.curl -O https://site/file.tgz
Tulostaa vastausotsikot rungon yläpuolelle.curl -i URL
Hakee vain otsikot (lähettää HEADin).curl -I URL
Piilottaa edistymismittarin ja virheet.curl -s URL
Tulostaa muotoilumerkkijonon rungon jälkeen (ajoitus, tila).curl -w "%{http_code}\n" -o /dev/null URL
Poistuu nollasta poikkeavalla koodilla HTTP-virheissä ja ohittaa virherungon.curl -f URL
Poistuu nollasta poikkeavalla koodilla HTTP-virheissä mutta tulostaa rungon silti.curl --fail-with-body URL
Nimeää tallennetun tiedoston Content-Disposition-otsikon mukaan.curl -OJ URL
Jatkaa keskeytynyttä siirtoa siitä mihin se jäi.curl -C - -O URL
Näyttää edistymispalkin oletusmittarin sijaan.curl -# -O URL
Tulostaa virheet myös hiljaisessa tilassa.curl -sS URL
Kirjoittaa vastausotsikot tiedostoon.curl -D headers.txt URL
Pyytää pakatun vastauksen ja purkaa sen.curl --compressed URL
Luo puuttuvat hakemistot -o-polkuun.curl -o cache/api/data.json --create-dirs URL
Uudelleenohjaukset ja yhteys
Seuraa 3xx-uudelleenohjauksia.curl -L URL
Enimmäisodotusaika sekunteina TCP-yhteydelle.curl --connect-timeout 5 URL
Enimmäisaika sekunteina koko pyynnölle.curl --max-time 30 URL
Ohittaa TLS-varmennevarmistuksen.curl -k https://self-signed.test
Yrittää uudelleen ohimeneviä virheitä enintään N kertaa.curl --retry 3 URL
Yrittää uudelleen kaikissa virheissä, ei vain ohimenevissä.curl --retry 3 --retry-all-errors URL
Pakottaa yhteyden IPv4:n tai IPv6:n kautta.curl -4 URL
Kytkee isäntänimen ja portin osoitteeseen DNS:n ohittamiseksi.curl --resolve api.test:443:127.0.0.1 https://api.test
Sidoa siirron verkkoliityntään tai osoitteeseen.curl --interface eth0 URL
Siirtää useita URL-osoitteita samanaikaisesti.curl -Z URL1 URL2
Käyttää HTTP/2:ta tai HTTP/3:a siirtoon.curl --http3 URL
Striimaa rungon sitä mukaa kun se saapuu puskuroinnin sijaan.curl -N URL
Lukee lisävalitsimet asetustiedostosta.curl -K flags.cfg URL
Vianetsintä
Tulostaa koko pyyntö- ja vastausvaihdon.curl -v URL
Heksatulostaa kaiken lähetetyn ja vastaanotetun.curl --trace - URL