curl y wget: errores de red resueltos capa por capa

Los errores de curl y wget son la fricción diaria de la integración de APIs, los pipelines de CI y los scripts de despliegue en 2026. “Could not resolve host” en un contenedor que funcionaba hace cinco minutos. “SSL certificate problem” en una VM recién creada. “Connection refused” desde cron pero no desde la shell. “HTTP/2 stream was reset” de forma intermitente. Los mensajes recorren toda la pila de red y el arreglo correcto depende de qué capa se rompió. Esta guía gratuita es el manual completo de diagnóstico y reparación.

Escrita para quien tiene una llamada a API que funciona en local pero falla en CI, diagnostica un contenedor sin salida a internet, sufre un proxy corporativo que rompe cada petición HTTPS o integra por primera vez una API protegida con OAuth.

Lo que aprenderás

• Cómo funcionan curl y wget: el ciclo de vida de una petición
• El triaje de 60 segundos y los problemas de instalación y “command not found”
• Fallos de resolución de DNS y cómo confirmar si de verdad es DNS
• Connection refused, timeouts y problemas de enrutamiento
• Errores de TLS y de certificados SSL
• Códigos de estado HTTP: 401, 403, 404, 429 y 5xx
• Redirecciones y bucles de redirección infinitos
• Errores de autenticación: Basic, Bearer y OAuth
• Proxies y redes corporativas que interceptan el tráfico
• Descargas grandes, reanudación y transferencias parciales
• Errores específicos de HTTP/2 y HTTP/3
• Depuración en modo verbose, la receta de recuperación y cómo scriptear curl de forma fiable

Cada comando fue verificado para 2026. curl es más capaz para trabajar con protocolos; wget sigue siendo mejor para descargas reanudables. Es gratis: sin registro y sin correo. En AI Learning Guides publicamos estas guías porque librarte de una sesión frustrante depurando HTTP vale la pena, compres o no una de nuestras guías de pago.