Příznaky curlu vysvětleny

Příznaky curlu používané každý den, seskupené podle úkolu: tvarovat požadavek, nastavovat hlavičky, ověřovat se, představovat identitu, řídit výstup, následovat přesměrování, vyladit připojení a ladit chyby. Každý řádek spojuje příznak s realistickým voláním.

curl odešle HTTP požadavek a vypíše tělo odpovědi. Většina jeho síly je v příznacích: vybírají metodu, připojují hlavičky a data, řeší ověření a rozhodují o tom, co se vypíše. Dlouhá forma se ukazuje tam, kde je jasnější; krátká forma je jediné písmeno. Dávejte URL do uvozovek, aby shell query string nesnědl.

Referenční tabulka · 54 položek

54 of 54 rows


Tvar požadavku
	Nastaví HTTP metodu.	curl -X POST https://api.test
	Přidá hlavičku požadavku.	curl -H "Accept: application/json" URL
	Odešle tělo (nastaví POST a výchozí typ obsahu).	curl -d "name=Ada" URL
	Připojí hodnoty -d jako parametry dotazu k GET.	curl -G -d "q=hi" URL
	Odešle multipart data formuláře (nahrávání souborů).	curl -F "file=@photo.png" URL
	Odešle data formuláře s použitým URL kódováním.	curl --data-urlencode "name=Ada Lovelace" URL
	Nahraje soubor metodou PUT.	curl -T big.zip URL
	Připojí nahrání ke vzdálenému souboru místo jeho nahrazení.	curl -a -T log.txt ftp://server.test/logs/log.txt
JSON a API
	Odešle JSON se správným typem obsahu.	curl -H "Content-Type: application/json" -d '{"a":1}' URL
	Odešle obsah souboru jako tělo.	curl -d @body.json URL
	Odešle JSON bez ručního nastavování hlaviček (curl 7.82+).	curl --json '{"a":1}' URL
Ověřování
	HTTP Basic ověření s uživatelem a heslem.	curl -u ada:s3cr3t URL
	Odešle OAuth bearer token.	curl --oauth2-bearer TOKEN URL
	Odešle ručně libovolné schéma tokenu.	curl -H "Authorization: Bearer TOKEN" URL
	Předloží klientský certifikát a jeho klíč pro mutual TLS.	curl --cert client.pem --key key.pem URL
	Ověří server proti jednomu souboru CA bundlu.	curl --cacert ca.pem URL
	Ověří server proti adresáři CA.	curl --capath /etc/ssl/certs URL
	Odešle požadavek přes proxy.	curl -x http://proxy.test:8080 URL
	Přeskočí TLS ověření jen pro skok k proxy.	curl -x https://proxy.test:8443 --proxy-insecure URL
	Vyžaduje TLS 1.3 jako minimální verzi.	curl --tlsv1.3 URL
Identita
	Odešle vlastní řetězec User-Agent.	curl -A "Mozilla/5.0" URL
	Odešle hlavičku Referer.	curl -e https://example.com/page URL
	Odešle cookies s požadavkem.	curl -b "session=abc123" URL
	Uloží cookies odpovědi do souboru.	curl -c cookies.txt URL
Výstup
	Zapíše tělo do souboru.	curl -o page.html URL
	Uloží tělo pod názvem vzdáleného souboru.	curl -O https://site/file.tgz
	Vypíše hlavičky odpovědi nad tělem.	curl -i URL
	Získá jen hlavičky (odešle HEAD).	curl -I URL
	Skryje měřič průběhu a chyby.	curl -s URL
	Vypíše po těle formátovací řetězec (časování, stav).	curl -w "%{http_code}\n" -o /dev/null URL
	Ukončí se nenulovým kódem při HTTP chybách a přeskočí tělo chyby.	curl -f URL
	Ukončí se nenulovým kódem při HTTP chybách, ale tělo stále vypíše.	curl --fail-with-body URL
	Pojmenuje uložený soubor podle hlavičky Content-Disposition.	curl -OJ URL
	Obnoví přerušený přenos od místa, kde se zastavil.	curl -C - -O URL
	Zobrazí ukazatel průběhu místo výchozího měřiče.	curl -# -O URL
	Vypíše chyby i v tichém režimu.	curl -sS URL
	Zapíše hlavičky odpovědi do souboru.	curl -D headers.txt URL
	Vyžádá komprimovanou odpověď a dekóduje ji.	curl --compressed URL
	Vytvoří chybějící adresáře v cestě -o.	curl -o cache/api/data.json --create-dirs URL
Přesměrování a připojení
	Následuje přesměrování 3xx.	curl -L URL
	Maximální počet sekund čekání na TCP připojení.	curl --connect-timeout 5 URL
	Maximální počet sekund pro celý požadavek.	curl --max-time 30 URL
	Přeskočí ověření TLS certifikátu.	curl -k https://self-signed.test
	Opakuje přechodné chyby až N krát.	curl --retry 3 URL
	Opakuje při každé chybě, ne jen při přechodných.	curl --retry 3 --retry-all-errors URL
	Vynutí připojení přes IPv4 nebo IPv6.	curl -4 URL
	Mapuje hostitele a port na adresu bez DNS.	curl --resolve api.test:443:127.0.0.1 https://api.test
	Sváže přenos se síťovým rozhraním nebo adresou.	curl --interface eth0 URL
	Přenáší více URL současně.	curl -Z URL1 URL2
	Použije HTTP/2 nebo HTTP/3 pro přenos.	curl --http3 URL
	Streamuje tělo podle příchodu místo ukládání do vyrovnávací paměti.	curl -N URL
	Přečte další příznaky z konfiguračního souboru.	curl -K flags.cfg URL
Ladění
	Vypíše celou výměnu požadavku a odpovědi.	curl -v URL
	Hex-dump všeho odeslaného a přijatého.	curl --trace - URL