Guía · curl

Uso de un proxy con curl

curl es la forma más rápida de verificar si un proxy funciona, con total independencia de cualquier navegador o extensión. El comando curl viene integrado en Linux, macOS y Windows 10, 11. Esta guía incluye ejemplos de comandos, cómo interpretar la salida para solucionar errores y cómo definir un proxy predeterminado para todos los comandos.

Autor: Bùi Toàn · Actualizado: 19/11/2026

Comandos básicos

  • A partir del formato ip:puerto:usuario:contraseña, ejecute: curl -x http://IP:PORT -U user:pass https://api.ipify.org
  • O combínelo en una sola cadena: curl -x http://user:pass@IP:PORT https://api.ipify.org
  • La salida debe ser la IP del proxy. Si aparece la IP de su ISP, significa que la solicitud no pasó a través del proxy.
  • Para verificar también el país: reemplace la URL de destino por https://ipinfo.io/json.
  • Si el proxy opera en modo SOCKS5 o HTTP + SOCKS5: curl -x socks5h://user:pass@IP:PORT https://api.ipify.org (socks5h permite que el proxy resuelva nombres de dominio), o curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org.

En Windows

En PowerShell 5.1, "curl" es un alias de Invoke-WebRequest, no el curl real. Use curl.exe en lugar de curl: curl.exe -x http://IP:PORT -U user:pass https://api.ipify.org. En el Símbolo del sistema (cmd) y en PowerShell 7 o superior, curl es el curl real.

¿Cómo usar curl con caracteres especiales en la contraseña del proxy?

Al usar el formato user:pass@IP, los caracteres especiales como @ : / # % en la contraseña deben codificarse en URL; por ejemplo, @ se convierte en %40 y # en %23. Usar -U "user:pass" (entre comillas dobles) no requiere codificación y reduce errores. En Linux y macOS, use comillas simples si la contraseña contiene $ o !.

¿Cómo leer la salida de curl para diagnosticar errores de proxy?

Añade -v para inspeccionar cada paso: la línea "200 Connection established" indica que el proxy aceptó la conexión, mientras que los mensajes de error inferiores muestran si el problema proviene de las credenciales, los puertos, la red o el sitio de destino.

Añada -v para ver información detallada

Para sitios HTTPS, curl envía una solicitud CONNECT al proxy. La línea "< HTTP/1.1 200 Connection established" significa que el proxy aceptó la conexión. La línea "407 Proxy Authentication Required" indica un usuario o contraseña incorrectos.

Failed to connect … Connection refused

La conexión a IP:puerto se rechazó de inmediato: puerto incorrecto, proxy caducado o inactivo. Consulte la guía sobre errores de conexión rechazada.

Connection timed out

No se recibió respuesta: IP incorrecta, problemas de red o un firewall bloqueando el puerto. Añada --connect-timeout 10 para evitar esperas prolongadas.

CONNECT tunnel failed, response 502 or 503

El proxy está activo pero no pudo establecer la conexión con el sitio de destino. Pruebe con otro sitio web para determinar si el problema reside en la página de destino o en el proxy.

Establecer un proxy predeterminado

Configure variables de entorno para que todos los comandos curl (y muchas otras herramientas) utilicen automáticamente el proxy: export https_proxy="http://user:pass@IP:PORT" y export http_proxy="$https_proxy" en Linux y macOS. Omita el proxy para un único comando usando --noproxy "*". Como alternativa, agregue la línea proxy = "http://user:pass@IP:PORT" a su archivo ~/.curlrc.

¿Aún no tiene proxy? Compre proxies dedicados con activación automática

Proxies IPv4 dedicados en 9 países desde 20.000₫/IP/mes al comprar a partir de 2.000 IPs (39.000₫ por 1 IP), además de proxies ISP estáticos de Vietnam y EE. UU. HTTP(S) y SOCKS5 con usuario y contraseña, ancho de banda ilimitado, aprovisionados automáticamente tras el pago. Actualmente, los proxies de Vietnam utilizan el protocolo HTTP(S); SOCKS5 aún no está disponible.

Comprar proxies ahora

Preguntas frecuentes

¿Por qué el valor de https_proxy sigue comenzando con http://?+

El prefijo especifica cómo se conecta curl al proxy, no al sitio de destino. Al comunicarse con el proxy de ONET mediante HTTP, aún es posible acceder a sitios HTTPS a través del método CONNECT. Con SOCKS5, el valor comienza con socks5h://.

¿Puedo usar --socks5 con los proxies de ONET?+

Sí, cuando el proxy funciona en modo SOCKS5 o HTTP + SOCKS5: curl --socks5-hostname IP:PORT -U user:pass https://api.ipify.org, o -x socks5h://user:pass@IP:PORT. Utilice socks5h o --socks5-hostname para que los nombres de dominio se resuelvan del lado del proxy. Tenga en cuenta que los proxies de Vietnam actualmente solo utilizan el protocolo HTTP(S); SOCKS5 aún no está disponible.