Red y acceso remoto

Comando curl

Enviar solicitudes HTTP y descargar datos

Linux · Ejemplos de Bash · Los comandos se ejecutan en el servidor seleccionado.

Cuándo utilizar curl

Utilice curl para inspeccionar las respuestas de HTTP, descargar un recurso o llamar a un API desde el servidor. Separe el éxito del transporte del éxito de la aplicación, establezca tiempos de espera razonables y mantenga los tokens de autenticación fuera de los ejemplos de comandos guardados.

Sintaxis

curl [PARAMETERS] URL

Los corchetes marcan argumentos opcionales; una elipsis significa repetición. Reemplace los nombres de archivos de ejemplo, nombres de usuarios y direcciones de servidores con sus propios valores.

Opciones y argumentos comunes

-I
Solicite únicamente encabezados HTTP, utilizando el método HEAD.
-f
Devuelve un error para los códigos de estado HTTP 400 y superiores.
-L
Siga las redirecciones; -o especifica el archivo de resultados.

Ejemplos de uso

Verifique los encabezados del sitio

curl -I https://example.com

Se realiza una solicitud de solo encabezado; algunos servicios manejan esto de manera diferente a una solicitud de contenido normal.

Descargar archivo con procesamiento de errores HTTP

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

Se siguen las redirecciones y el cuerpo de la respuesta reemplaza el archivo local nombrado; Los estados de error HTTP provocan fallos.

Solicitar JSON con límite de tiempo

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

Se solicita una respuesta JSON con una duración global limitada; el punto final debe proporcionar realmente ese API.

Notas y limitaciones

  • Con HTTPS el certificado se verifica por defecto; No desactive la verificación a través de -k sin un motivo específico.
  • No coloque tokens o contraseñas reales en el historial de comandos y no ejecute scripts descargados sin verificación.

Preguntas comunes y solución de problemas

¿Por qué curl tiene éxito cuando el servidor devuelve una página de error?

Sin la opción de error, recibir una respuesta de error HTTP aún puede contar como una transferencia exitosa. Inspeccione tanto el estado de HTTP como el estado de salida del comando.

¿Debo desactivar la verificación del certificado para solucionar HTTPS?

No pase por alto la confianza como una solución de rutina. En su lugar, verifique el nombre de host, la hora del sistema, la cadena de certificados del servidor y la configuración de CA confiable.

Más ayuda

Las opciones varían según la versión y la distribución. Consulta la documentación instalada con este comando: man curl.