curl –connect-timeout – Setarea limitei de timp pentru conectare în Comenzi cURL

Stabilește numărul maxim de secunde permise exclusiv pentru stabilirea conexiunii TCP către server.

Sintaxă
curl --connect-timeout 5 <url>
curl --connect-timeout 3.5 <url>

Ce face curl --connect-timeout - Setarea limitei de timp pentru conectare

Dacă un server este offline sau un firewall blochează silențios pachetele SYN (fără răspuns RST), conexiunea TCP standard a sistemului de operare poate rămâne blocată timp de până la 2-3 minute.

Opțiunea --connect-timeout forțează curl să renunțe dacă conexiunea la nivel de socket nu s-a realizat în intervalul de secunde specificat.

Acceptă valori zecimale (de exemplu `2.5` secunde) pentru reacție ultra-rapidă în microservicii.

Exemple

Exemplul 1: Interogarea unui server cu timeout rapid de conectare de 3 secunde

Evită blocarea scriptului dacă serverul este inaccesibil.

curl --connect-timeout 3 https://192.0.2.1/status

Ieșire în terminal

curl: (28) Failed to connect to 192.0.2.1 port 443 after 3001 ms: Couldn't connect to server

Greșeli frecvente

  • Confuzia între –connect-timeout (doar handshake TCP) și -m / –max-time (întreaga operațiune de transfer); dacă conexiunea se realizează dar descărcarea durează ore, –connect-timeout nu o va opri.

Comenzi înrudite