Xarxa i accés remot

Comandament curl

Envieu sol·licituds HTTP i descarregueu dades

Linux · Exemples de Bash · ordres executades al servidor seleccionat

Quan utilitzar curl

Utilitzeu curl per inspeccionar les respostes HTTP, descarregar un recurs o trucar a un API des del servidor. Separeu l'èxit del transport de l'aplicació, establiu temps d'espera raonables i manteniu els testimonis d'autenticació fora dels exemples d'ordres desats.

Sintaxi

curl [PARAMETERS] URL

Els claudàtors marquen arguments opcionals; una el·lipsi significa repetició. Substituïu els noms de fitxer d'exemple, els noms d'usuari i les adreces de servidor pels vostres propis valors.

Opcions i arguments comuns

-I
Sol·liciteu només capçaleres HTTP, utilitzant el mètode HEAD.
-f
Retorna un error per als codis d'estat HTTP 400 i superiors.
-L
Seguiu les redireccions; -o especifica el fitxer de resultats.

Exemples d'ús

Comproveu les capçaleres del lloc

curl -I https://example.com

Es fa una sol·licitud només de capçalera; alguns serveis ho gestionen de manera diferent a una sol·licitud de contingut normal.

Descarrega el fitxer amb el processament d'errors HTTP

curl --fail --location --output ./page.html https://example.com

Se segueixen les redireccions i el cos de la resposta substitueix el fitxer local anomenat; Els estats d'error HTTP causen errors.

Sol·liciteu JSON amb límit de temps

curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/status

Es demana una resposta JSON amb una durada global limitada; el punt final ha de proporcionar realment aquest API.

Notes i limitacions

  • Amb HTTPS el certificat es verifica per defecte; no desactiveu la comprovació mitjançant -k sense un motiu a part.
  • No col·loqueu fitxes ni contrasenyes reals a l'historial d'ordres i no executeu scripts descarregats sense verificació.

Preguntes habituals i resolució de problemes

Per què curl té èxit quan el servidor retorna una pàgina d'error?

Sense l'opció d'error, rebre una resposta d'error HTTP encara pot comptar com una transferència correcta. Inspeccioneu tant l'estat de HTTP com l'estat de sortida de la comanda.

He de desactivar la verificació del certificat per solucionar HTTPS?

No passeu per alt la confiança com a solució rutinària. Comproveu el nom d'amfitrió, l'hora del sistema, la cadena de certificats del servidor i la configuració de la CA de confiança.

Més ajuda

Les opcions varien segons la versió i la distribució. Comproveu la documentació instal·lada amb aquesta ordre: man curl.