Skip to content

curl jelzők elmagyarázva

A hétköznapokban használt curl jelzők, feladat szerint csoportosítva: a kérés formálása, fejlécek beállítása, hitelesítés, identitás bemutatása, kimenet szabályozása, átirányítások követése, kapcsolat hangolása és hibakeresés. Minden sor egy jelzőt párosít egy valós hívással.

A curl HTTP-kérést küld, és kiírja a válasz törzsét. Ereje nagy részben a jelzőkben van: ezek választják meg a metódust, csatolják a fejléceket és az adatokat, kezelik a hitelesítést, és eldöntik, mi kerül kiírásra. A hosszú alak ott szerepel, ahol világosabb; a rövid alak az egyetlen betű. Tedd az URL-eket idézőjelbe, hogy a shell ne tegye tönkre a query stringet.

Referenciatáblázat · 54 bejegyzés
54 of 54 rows
A kérés formája
A HTTP-metódus beállítása.curl -X POST https://api.test
Kérelemfejléc hozzáadása.curl -H "Accept: application/json" URL
Törzs küldése (POST-ot és alapértelmezett tartalomtípust állít be).curl -d "name=Ada" URL
A -d értékek query paraméterekként fűzése egy GET-hez.curl -G -d "q=hi" URL
Multipart űrlapadat küldése (fájlfeltöltés).curl -F "file=@photo.png" URL
Űrlapadat küldése alkalmazott URL-kódolással.curl --data-urlencode "name=Ada Lovelace" URL
Fájl feltöltése PUT-tal.curl -T big.zip URL
Feltöltés hozzáfűzése a távoli fájlhoz, felülírás helyett.curl -a -T log.txt ftp://server.test/logs/log.txt
JSON és API-k
JSON küldése a helyes tartalomtípussal.curl -H "Content-Type: application/json" -d '{"a":1}' URL
Egy fájl tartalmának küldése törzsként.curl -d @body.json URL
JSON küldése kézi fejlécbeállítás nélkül (curl 7.82+).curl --json '{"a":1}' URL
Hitelesítés
HTTP Basic hitelesítés felhasználónévvel és jelszóval.curl -u ada:s3cr3t URL
OAuth bearer token küldése.curl --oauth2-bearer TOKEN URL
Bármilyen token-séma kézi küldése.curl -H "Authorization: Bearer TOKEN" URL
Kliens-tanúsítvány és kulcsának bemutatása kölcsönös TLS-hez.curl --cert client.pem --key key.pem URL
A kiszolgáló ellenőrzése egyetlen CA-csomagfájl alapján.curl --cacert ca.pem URL
A kiszolgáló ellenőrzése CA-k egy könyvtára alapján.curl --capath /etc/ssl/certs URL
A kérés küldése proxyn keresztül.curl -x http://proxy.test:8080 URL
A TLS-ellenőrzés kihagyása csak a proxy ugrásánál.curl -x https://proxy.test:8443 --proxy-insecure URL
TLS 1.3 megkövetelése minimális verzióként.curl --tlsv1.3 URL
Identitás
Egyéni User-Agent karakterlánc küldése.curl -A "Mozilla/5.0" URL
Referer fejléc küldése.curl -e https://example.com/page URL
Sütik küldése a kéréssel.curl -b "session=abc123" URL
A válasz sütinek fájlba mentése.curl -c cookies.txt URL
Kimenet
A törzs fájlba írása.curl -o page.html URL
A törzs mentése a távoli fájlnév használatával.curl -O https://site/file.tgz
A válaszfejlécek kiírása a törzs fölé.curl -i URL
Csak fejlécek lekérése (HEAD-et küld).curl -I URL
A folyamatjelző és a hibák elrejtése.curl -s URL
Formátumkarakterlánc kiírása a törzs után (időzítés, állapot).curl -w "%{http_code}\n" -o /dev/null URL
Nem nulla kilépési kód HTTP-hibáknál, a hibatörzs kihagyása.curl -f URL
Nem nulla kilépési kód HTTP-hibáknál, de a törzs kiírása.curl --fail-with-body URL
A mentett fájl elnevezése a Content-Disposition fejlécből.curl -OJ URL
Megszakadt átvitel folytatása onnan, ahol megállt.curl -C - -O URL
Folyamatjelző sáv megjelenítése az alapértelmezett mérő helyett.curl -# -O URL
Hibák kiírása csendes futás közben is.curl -sS URL
A válaszfejlécek fájlba írása.curl -D headers.txt URL
Tömörített válasz kérése és dekódolása.curl --compressed URL
Hiányzó könyvtárak létrehozása a -o útvonalban.curl -o cache/api/data.json --create-dirs URL
Átirányítás és kapcsolat
3xx átirányítások követése.curl -L URL
A TCP-kapcsolódásra várakozás maximális másodperce.curl --connect-timeout 5 URL
A teljes kérésre fordítható maximális másodperc.curl --max-time 30 URL
A TLS-tanúsítvány ellenőrzésének kihagyása.curl -k https://self-signed.test
Átmeneti hibák újrapróbálása legfeljebb N alkalommal.curl --retry 3 URL
Újrapróbálás bármilyen hibánál, nem csak átmenetieknél.curl --retry 3 --retry-all-errors URL
A kapcsolat kényszerítése IPv4 vagy IPv6 használatára.curl -4 URL
Egy gépnév és port hozzárendelése címhez, a DNS megkerülésével.curl --resolve api.test:443:127.0.0.1 https://api.test
Az átvitel kötése hálózati interfészhez vagy címhez.curl --interface eth0 URL
Több URL átvitele egyszerre.curl -Z URL1 URL2
HTTP/2 vagy HTTP/3 használata az átvitelhez.curl --http3 URL
A törzs streamelése érkezéskor, pufferelés helyett.curl -N URL
További jelzők beolvasása konfigurációs fájlból.curl -K flags.cfg URL
Hibakeresés
A teljes kérés-válasz csere kiírása.curl -v URL
Hex-dump minden küldött és fogadott bájtról.curl --trace - URL