CURL

Învață Comenzi cURL: comenzi explicate cu exemple

66 de comenzi 21 de categorii Comunitate & Q&A

cURL (Client URL Library) este cel mai răspândit și robust instrument în linia de comandă pentru transferul de date utilizând protocoale de rețea. Creat de Daniel Stenberg în 1997, cURL se găsește pe miliarde de dispozitive din lume, de la servere de producție, containere Docker și mașini de dezvoltare, până la televizoare și echipamente IoT.

În activitatea zilnică a unui dezvoltator software sau inginer DevOps, cURL este instrumentul de referință pentru interacțiunea cu API-uri REST și GraphQL, testarea securității SSL/TLS, diagnosticarea latenței de rețea și automatizarea proceselor de deployment.

Mai jos găsești cele 50 de comenzi și opțiuni esențiale cURL organizate pe categorii: cereri fundamentale și metode HTTP, trimitere de date și încărcare fișiere/JSON, gestiunea antetelor și a sesiunilor/cookie-urilor, securitate și certificate SSL, optimizare viteză și salvare fișiere, precum și diagnosticare avansată de rețea și proxy-uri.

macOS • Windows • Linux

Ghid de verificare și instalare cURL pe fiecare sistem de operare

cURL vine preinstalat pe majoritatea sistemelor de operare moderne. Iată comenzile de verificare și actualizare la ultima versiune.

Cerințe de sistem: Disponibil nativ pe Windows 10/11, macOS și aproape toate distribuțiile Linux.

Terminal macOS (Homebrew / zsh)

# Verificare versiune nativă macOS:
curl --version

# Instalare / actualizare la ultima versiune prin Homebrew:
brew install curl

Windows 10 / 11 (PowerShell / Winget / WSL2)

# Verificare versiune nativă (Command Prompt sau PowerShell):
curl.exe --version

# Actualizare prin Windows Package Manager (Winget):
winget install curl.curl

Linux (Ubuntu / Debian / Bash)

# Ubuntu / Debian:
sudo apt update && sudo apt install -y curl

# RHEL / CentOS / Rocky / AlmaLinux / Fedora:
sudo dnf install -y curl

# Verificare protocoale și versiune:
curl --version

Autentificare Bearer Token și HTTP Basic Auth în cURL

# 1. Trimitere cerere cu Bearer Token (OAuth2 / JWT):
curl -H "Authorization: Bearer <TOKEN_SECRET>" https://api.exemplu.ro/date

# 2. Autentificare Basic (utilizator:parolă):
curl -u "utilizator:parola" https://api.exemplu.ro/profil

Autentificare și Securitate 1 comandă

curl –anyauth – Negocierea Automată a Autentificării HTTP curl --anyauth -u user:parola <URL> Opțiunea --anyauth instruiește cURL să trimită inițial o cerere fără antet de autorizare, să analizeze provocarea (challenge-ul) 401 Unauthorized returnată de server cu antetul WWW-Authenticate, și să aleagă automat cea mai sigură metodă de autentificare suportată de gazdă (preferând Digest sau NTLM în locul clasicului Basic Auth nesecurizat). # Negociază automat cel mai sigur mecanism […]

Cloud și Autentificare 1 comandă

curl –aws-sigv4 – Semnarea Automată a Cererilor AWS Signature v4 curl --aws-sigv4 <provider:regiune:serviciu> -u <ACCESS_KEY:SECRET_KEY> <URL> Parametrul --aws-sigv4 activează generarea nativă a semnăturilor criptografice conforme cu standardul AWS Signature Version 4. Permite efectuarea de cereri autentificate către AWS S3, API Gateway sau servicii cloud compatibile (MinIO, Wasabi, Cloudflare R2) fără a fi nevoie de scripturi Python complexe sau de binarul aws-cli. # Descarcă un fișier dintr-un bucket privat Amazon S3 curl […]

Securitate și Certificate 1 comandă

curl –cert-type – Specificarea Formatului Certificatului Client curl --cert <fisier> --cert-type {PEM|DER|ENG|P12} <URL> Opțiunea --cert-type indică tipul și codificarea certificatului digital furnizat prin opțiunea --cert pentru autentificarea mutuală TLS (mTLS). În timp ce formatul implicit este PEM, cURL poate procesa nativ fișiere binare DER sau arhive complete de chei și certificate P12 (PKCS#12 / PFX). # Autentificare mTLS folosind un certificat container PKCS#12 (.p12 / .pfx) curl --cert-type […]

Fișiere și Salvare 1 comandă

curl –create-dirs – Crearea Automată a Directoarelor Locale curl --create-dirs -o <cale/director/fisier> <URL> Opțiunea --create-dirs instruiește cURL să creeze automat toate directoarele locale specificate în calea fișierului de ieșire (dat prin -o sau --output) dacă acestea nu există deja pe disc. Previne eșecul descărcărilor cu erori de tipul No such file or directory. # Creează automat structura de foldere 'descarcari/2026/octombrie' și salvează fișierul curl --create-dirs -o descarcari/2026/octombrie/factura.pdf https://dexblog.ro/docs/factura.pdf […]

Securitate și DNS 1 comandă

curl –doh-url – Rezoluție DNS Securizată prin HTTPS curl --doh-url <URL> <destinație> Opțiunea --doh-url instruiește cURL să rezolve numele de domenii utilizând protocolul DNS-over-HTTPS (DoH). Căutările DNS sunt criptate prin TLS direct către un server DoH securizat, prevenind interceptarea (sniffing), manipularea răspunsurilor (DNS poisoning) sau cenzura aplicată de providerii locali de internet. # Rezolvă domeniul folosind serviciul DoH Cloudflare curl --doh-url https://cloudflare-dns.com/dns-query https://api.dexblog.ro/ # Rezolvă folosind Google […]

Diagnoză și Erori 1 comandă

curl –fail-with-body – Returnare Cod de Eroare Păstrând Răspunsul HTTP curl --fail-with-body <URL> Opțiunea --fail-with-body rezolvă o limitare istorică a parametrului -f / --fail. În timp ce -f oprește cURL cu cod de eroare non-zero dar aruncă complet corpul răspunsului, --fail-with-body emite atât codul de ieșire de eroare (util pentru scripturi CI/CD), cât și corpul de răspuns (conținând detaliile JSON ale erorii trimise de server). # Returnează cod […]

Rețea și Rutare 1 comandă

curl –interface – Forțarea Plăcii de Rețea sau a Adresei IP Locale curl --interface <nume_interfata | ip_local> <URL> Opțiunea --interface forțează cURL să lege (bind) socket-ul de rețea de o placă de rețea specifică, de un adaptor VPN sau de o anumită adresă IP locală. Este indispensabilă pe servere multi-homed (echipate cu multiple plăci fizice sau adrese IP) pentru a testa conexiunile pe rute specifice. # Forțează ieșirea prin interfața Ethernet fizică eth0 […]

Rețea și Conexiuni 1 comandă

curl –keepalive-time – Controlul Pachetelor TCP Keepalive curl --keepalive-time <secunde> [--no-keepalive] <URL> Parametrul --keepalive-time ajustează intervalul în secunde dintre trimiterea pachetelor de test TCP Keep-Alive pe o conexiune activă. Această setare previne deconectarea forțată a conexiunilor lungi de către firewall-uri intermediare, load balancere sau gateway-uri NAT care închid socket-urile inactive după o perioadă de liniște. # Trimite pachete TCP Keepalive la fiecare 30 de secunde curl --keepalive-time […]

Autentificare și Redirecționări 1 comandă

curl –location-trusted – Păstrarea Credențialelor la Redirecționări curl -L --location-trusted -u user:parola <URL> Din motive stricte de securitate, atunci când cURL urmărește o redirecționare HTTP (prin opțiunea -L / --location) către o altă gazdă (alt domeniu sau alt port), acesta suprimă automat transmiterea antetului de autentificare (Basic Auth sau Cookie-uri). Opțiunea --location-trusted forțează cURL să continue trimiterea credențialelor către noul host specificat în antetul Location. # Urmărește redirecționarea […]

Performanță și Transfer 2 comenzi

Fiabilitate și Rețea 1 comandă

curl –retry – Reîncercarea Automată a Cererilor Eșuate curl --retry <numar> [--retry-delay <secunde>] [--retry-max-time <secunde>] <URL> Opțiunea --retry instruiește cURL să reîncerce automat transferul dacă acesta eșuează din cauza unor erori tranzitorii (cum ar fi timeout-uri HTTP, erori de conexiune sau coduri de stare HTTP 408, 429, 500, 502, 503 și 504). Este un parametru esențial în scripturile CI/CD și în mediile cloud pentru asigurarea rezilienței. # Reîncearcă de maximum 5 […]

Performanță și Rețea 1 comandă

curl –tcp-fastopen – Reducerea Latenței prin TCP Fast Open curl --tcp-fastopen <URL> Opțiunea --tcp-fastopen activează utilizarea extensiei TCP Fast Open (RFC 7413). Aceasta permite transmiterea datelor din cererea HTTP direct în interiorul primului pachet de handshake TCP SYN (folosind un cookie criptografic TFO negociat anterior), eliminând un întreg ciclu de așteptare (RTT – Round Trip Time) la reconectare. # Activează TCP Fast Open pentru interogări de latență […]

Antete și Diagnosticare 1 comandă

curl -D / –dump-header – Salvarea Antetelor HTTP într-un Fișier Separat curl -D, --dump-header <nume_fisier> <URL> Opțiunea -D (sau --dump-header) salvează toate antetele de răspuns HTTP primite de la server într-un fișier separat pe disc. Este deosebit de utilă când doriți să analizați etichetele ETag, antetele de cache, token-urile de securitate sau cookie-urile fără a amesteca antetele cu corpul util al răspunsului salvat prin -o. # Salvează corpul în raspuns.json și […]

Streaming și Real-Time 1 comandă

curl -N / –no-buffer – Streaming în Timp Real și Dezactivarea Buffer-ului curl -N, --no-buffer <URL> Opțiunea -N (sau --no-buffer) dezactivează memorarea intermediară (buffering-ul) a fluxului de date de ieșire în cURL. În mod implicit, cURL reține pachetele primite într-un buffer de memorie până când se adună o cantitate suficientă pentru a fi afișată eficient. Dezactivarea buffer-ului este obligatorie la consumul fluxurilor Server-Sent Events (SSE), API-urilor de inteligență artificială cu token […]

Proxy și Rețea 1 comandă

curl -U / –proxy-user – Autentificarea pe Serverul Proxy curl -x <proxy> -U <user:parola> <URL> Opțiunea -U (sau --proxy-user) furnizează credențialele de autentificare necesare pentru accesarea unui server proxy corporativ (HTTP, HTTPS sau SOCKS). Este complet decuplată de opțiunea -u (care autentifică cererea pe serverul web destinație final). # Rutează cererea printr-un proxy protejat cu parolă curl -x http://proxy.companie.ro:8080 -U "corp_user:ParolaComplexa" https://api.dexblog.ro/data # Solicită parola interactiv în consolă pentru a […]

Cereri HTTP fundamentale și Metode 9 comenzi

Trimitere date, formulare și JSON 8 comenzi

Redirecționări, SSL/TLS și Securitate 8 comenzi

Performanță, Descărcare și Salvare fișiere 9 comenzi

Diagnosticare, Proxy și Analiză Rețea 8 comenzi

Toate comenzile și opțiunile cURL

Lista completă a celor 66 de opțiuni și parametri esențiali cURL explicați în această secțiune. Fiecare opțiune beneficiază de o pagină dedicată cu sintaxă clară, exemple practice din producție și recomandări profesionale de securitate și performanță.

Cereri HTTP Fundamentale și Metode REST (7)

Opțiune / Flag	Descriere
`curl`	Efectuarea unei cereri standard HTTP GET și afișarea conținutului primit în consolă
`-I / --head`	Trimiterea unei cereri HTTP HEAD pentru interogarea exclusivă a antetelor fără corp
`-X POST`	Specificarea explicită a metodei HTTP POST pentru crearea resurselor pe server
`-X PUT`	Actualizarea completă a unei resurse existente sau încărcarea acesteia prin HTTP PUT
`-X PATCH`	Modificarea parțială a unei resurse pe server respectând bunele practici REST
`-X DELETE`	Ștergerea unei resurse specificate de pe serverul la distanță
`-X OPTIONS`	Interogarea metodelor HTTP permise de server și verificarea politicilor de securitate CORS

Trimitere Date, Formulare și JSON (7)

Opțiune / Flag	Descriere
`-d / --data`	Trimitere date de formular prin POST cu antetul application/x-www-form-urlencoded
`--data-raw`	Trimitere date brute prin POST fără interpretarea sau expandarea caracterului @
`--data-urlencode`	Codarea automată a caracterelor speciale și spațiilor din parametri în format URL
`--data-binary`	Trimitere date binare neschimbate (păstrând caracterele newline și octeții bruti)
`--json`	Trimitere simplificată de date JSON setând automat antetele Content-Type și Accept
`-F / --form`	Trimitere formulare multipart/form-data utilizate standard pentru încărcarea fișierelor
`-T / --upload-file`	Încărcare directă de fișiere locale către destinație prin HTTP PUT sau FTP

Antete HTTP, Cookie-uri și Sesiuni (7)

Opțiune / Flag	Descriere
`-i / --include`	Includerea antetelor de răspuns HTTP în ieșirea afișată înaintea corpului
`-H / --header`	Adăugarea de antete HTTP personalizate cererii (ex: Content-Type, Accept)
`-A / --user-agent`	Personalizarea șirului User-Agent trimis serverului web pentru identificare
`-e / --referer`	Specificarea antetului Referer indicând adresa URL de unde provine cererea
`-b / --cookie`	Trimiterea cookie-urilor de sesiune către server sub formă de șir sau din fișier
`-c / --cookie-jar`	Salvarea automată a cookie-urilor primite de la server într-un fișier local
`-D / --dump-header`	Salvarea tuturor antetelor HTTP de răspuns într-un fișier text separat pe disc

Redirecționări, Autentificare și Cloud (8)

Opțiune / Flag	Descriere
`-L / --location`	Urmărirea automată a redirecționărilor HTTP (coduri 301, 302, 303, 307, 308)
`--max-redirs`	Limitarea numărului maxim de redirecționări permise pentru a preveni bucle infinite
`--location-trusted`	Păstrează credențialele de autentificare la urmărirea redirecționărilor cross-host
`-u / --user`	Autentificare HTTP Basic sau Digest furnizând utilizatorul și parola
`--oauth2-bearer`	Autentificare modernă furnizând direct token-ul OAuth 2.0 / Bearer
`--netrc`	Preluarea automată și securizată a credențialelor de acces din fișierul ~/.netrc
`--anyauth`	Negocierea automată a celei mai sigure metode de autentificare acceptate de server
`--aws-sigv4`	Semnarea criptografică automată a cererilor compatibile cu AWS Signature Version 4

Securitate SSL/TLS, Criptare și Certificate (7)

Opțiune / Flag	Descriere
`-k / --insecure`	Permite conexiuni HTTPS nesecurizate ignorând verificarea certificatului SSL/TLS
`--cacert`	Specificarea căii către un fișier cu certificate CA de încredere personalizat
`--cert / --key`	Autentificare mutuală mTLS cu certificat digital client și cheie privată
`--cert-type`	Specificarea formatului certificatului client utilizat (PEM, DER, P12/PKCS#12)
`--tlsv1.3`	Forțarea versiunii minime TLS 1.3 pentru cel mai înalt standard criptografic
`--ciphers`	Selectarea explicită a listei de algoritmi de criptare (cipher suites) SSL/TLS
`--pinnedpubkey`	Fixarea cheii publice SSL (Public Key Pinning) prevenind atacurile Man-in-the-Middle

Salvare Fișiere, Descărcări și Transferuri (8)

Opțiune / Flag	Descriere
`-o / --output`	Salvarea conținutului primit de la server într-un fișier local specificat
`-O / --remote-name`	Salvarea automată a fișierului descărcat sub numele său original din URL
`--create-dirs`	Crearea automată a ierarhiei de directoare locale lipsă la salvarea fișierului
`-C / --continue-at`	Reluarea unei descărcări întrerupte de la ultimul octet transferat cu succes
`-g / --globoff`	Dezactivarea interpretării caracterelor de URL globbing (paranteze {} și [])
`-N / --no-buffer`	Dezactivarea buffer-ului intern pentru streaming în timp real și Server-Sent Events
`--limit-rate`	Limitarea vitezei maxime de transfer pentru a nu sufoca lățimea de bandă a rețelei
`--rate`	Controlul frecvenței cererilor (rate limiting) pentru evitarea erorilor HTTP 429

Performanță, Conexiuni și Protocoale (8)

Opțiune / Flag	Descriere
`--http1.1 / --http2 / --http3`	Selectarea explicită a versiunii de protocol HTTP dorite
`--compressed`	Solicitarea transmiterii comprimate (gzip, br, zstd) și decompresia automată
`-Z / --parallel`	Transferul concurent în paralel al mai multor URL-uri utilizând multiplexare
`--tcp-fastopen`	Activarea TCP Fast Open pentru trimiterea de date în primul pachet SYN
`--keepalive-time`	Ajustarea intervalului pachetelor de test TCP Keep-Alive pentru conexiuni lungi
`--interface`	Forțarea legării socket-ului de o interfață de rețea specifică sau un IP local
`-4 / -6`	Forțarea strictă a rezolvării numelor de domenii doar prin IPv4 sau doar prin IPv6
`--doh-url`	Efectuarea rezoluției DNS securizate prin protocolul criptat DNS-over-HTTPS

Control Timp, Diagnoză, Proxy și Erori (14)

Opțiune / Flag	Descriere
`-s / --silent`	Activarea modului silențios ce suprimă bara de progres și mesajele de stare
`-S / --show-error`	Afișarea mesajelor explicative de eroare chiar dacă modul silențios este activ (-sS)
`-v / --verbose`	Activarea modului detaliat de depanare afișând handshake-ul și antetele trimise/primite
`--trace-ascii`	Jurnalizarea completă a întregului trafic de rețea brut într-un fișier text
`-w / --write-out`	Extragerea metricilor de performanță (timp DNS, TCP, TLS, TTFB) și a codurilor de stare
`-f / --fail`	Oprire cu cod de eroare non-zero dacă serverul returnează coduri HTTP 4xx sau 5xx
`--fail-with-body`	Returnează cod de eroare non-zero la erori HTTP, dar păstrează corpul JSON de eroare
`--retry`	Reîncercarea automată a cererilor eșuate la erori tranzitorii de conexiune sau server
`--connect-timeout`	Setarea timpului maxim în secunde alocat exclusiv etapei de conectare TCP
`-m / --max-time`	Setarea timpului maxim în secunde alocat pentru întreaga tranzacție
`-x / --proxy`	Rutarea cererilor de rețea printr-un server Proxy (HTTP, HTTPS sau SOCKS)
`-U / --proxy-user`	Furnizarea credențialelor de acces (utilizator și parolă) pentru serverul proxy
`--socks5-hostname`	Rutarea prin proxy SOCKS5 delegând și rezoluția numelor DNS către serverul proxy
`--resolve`	Maparea manuală a unui domeniu și port către o adresă IP specifică (custom DNS)

Comunitate & Schimb de cunoștințe

Discuții, Întrebări & Coduri Comenzi cURL

Ai o întrebare legată de Comenzi cURL, cauți o soluție sau vrei să împărtășești un fragment util de cod? Trimite mai jos contribuția ta.

💬

Fii primul care pune o întrebare sau distribuie un fragment de cod / prompt!

Nu au fost adăugate încă întrebări sau exemple de cod pentru această pagină. Dacă ai întâlnit o problemă sau ai un snippet util, adaugă-l mai jos pentru a-i ajuta pe ceilalți.

Comunitate Adaugă o întrebare sau distribuie un cod Anulează răspunsul

Alege ce dorești să transmiți:

Titlu scurt (opțional)

Întrebarea ta *

Moderare & Siguranță:

Pentru a menține calitatea și securitatea informațiilor, fiecare întrebare sau fragment de cod/prompt este analizat (manual sau prin moderare asistată de AI) înainte de publicare.

Nume sau Pseudonim *

Adresă de Email * (nu va fi publicată)