Uso de cURL con un proxy autenticado: comandos para comprobar que funciona
Por el equipo de ingeniería de ProxyV4 · Updated:
Para ejecutar cURL a través de un proxy, indícale la dirección del proxy con -x y tus credenciales con -U, o incluye ambos en una sola URL http://user:pass@ip:port. Antes de conectar una IP de ProxyV4 a un scraper, perfil de navegador o tarea cron, una sola llamada cURL desde la misma máquina te confirma tres cosas rápidamente: las credenciales son aceptadas, la IP de salida es la que alquilaste y la latencia es razonable.
curl -x http://user:pass@ip:port https://proxyv4.com/api/my-ip- 1 IP1,85 US$
- 3+ IPs1,70 US$
- 10+ IPs1,60 US$
- 25+ IPs1,50 US$
- 50+ IPs1,40 US$
- 100+ IPs1,30 US$
- 200+ IPs1,20 US$
- 500+ IPs1,10 US$
- 1 IP1,85 US$
- 3+ IPs1,70 US$
- 10+ IPs1,60 US$
- 25+ IPs1,50 US$
- 50+ IPs1,40 US$
- 100+ IPs1,30 US$
- 200+ IPs1,20 US$
- 500+ IPs1,10 US$
De la línea del panel a un argumento de cURL
Tu pedido llega en formato ip:port:user:pass. cURL no lee esa estructura directamente, así que debes dividirla: los dos primeros campos van en -x http://ip:port y los dos últimos en -U user:pass. El formato de URL única http://user:pass@ip:port es más corto, pero cualquier @, : o # dentro de la contraseña debe codificarse en porcentaje, por lo que la forma separada es la opción más segura por defecto en scripts.
Mantén el esquema http:// en el proxy incluso cuando el destino sea https://. cURL se comunica en HTTP plano con el proxy, le solicita abrir un túnel con CONNECT y luego ejecuta TLS hacia el sitio web a través de dicho túnel, manteniendo la página cifrada de extremo a extremo.
Referencia de comandos
| Objetivo | Comando | Interpretación del resultado |
|---|---|---|
| Ver qué IP detecta internet | curl -x http://user:pass@ip:port https://proxyv4.com/api/my-ip | La dirección mostrada debe coincidir con la IP del proxy, no con la tuya |
| Pasar las credenciales por separado | curl -x http://ip:port -U "user:pass" https://proxyv4.com/api/my-ip | Mismo resultado; no requiere codificación URL para caracteres especiales en la contraseña |
| Solo línea de estado y encabezados | curl -I -x http://user:pass@ip:port https://example.com | Una línea 2xx o 3xx significa que el destino respondió a través del proxy |
| Tiempo de conexión y tiempo hasta el primer byte | curl -s -o /dev/null -w "Connect:%{time_connect}s TTFB:%{time_starttransfer}s\n" -x http://user:pass@ip:port https://example.com | Dos números en segundos; compáralos entre proxies o ubicaciones |
Depurar una petición fallida con -v
Añade -v y lee las líneas que empiezan con > y <. Una ejecución correcta muestra a cURL enviando CONNECT con un encabezado Proxy-Authorization y al proxy respondiendo HTTP/1.1 200 Connection established, seguido del handshake TLS con el destino.
Si la respuesta es HTTP/1.1 407 Proxy Authentication Required, la conexión con el proxy funcionó y solo el usuario o la contraseña son incorrectos; la guía del error 407 explica las causas habituales. Si cURL no recibe ninguna respuesta, el problema es de accesibilidad, así que comprueba primero la IP y el puerto con el verificador de puertos.
Para ver una correspondencia rápida entre los códigos de salida de curl y sus causas, y las mismas comprobaciones para Docker, Selenium y Puppeteer, consulta proxy no funciona.
Windows, scripts y valores predeterminados
- Windows PowerShell asigna
curlaInvoke-WebRequest, que no admite-x; escribecurl.exepara invocar el binario real - En Windows, sustituye
-o /dev/nullpor-o NULen el comando de medición de tiempos - En tareas cron y scripts de shell añade
--connect-timeout 5 --max-time 15para que un destino lento no bloquee toda la ejecución - Para enrutar cada llamada cURL a través del mismo proxy, añade
proxy = "http://user:pass@ip:port"en~/.curlrcy elimínalo cuando termines las pruebas
Paso a paso
- 1
Abre una terminal
Usa la Terminal en macOS o Linux, o cmd / PowerShell en Windows (donde el comando es
curl.exe). - 2
Consulta tu IP de salida a través del proxy
Ejecuta
curl.exe -x http://user:pass@ip:port https://proxyv4.com/api/my-ipcon los valores de tu pedido de ProxyV4 y comprueba que la dirección mostrada sea la IP del proxy. - 3
Revisa el protocolo de enlace si falla
Repite la llamada con
-vy localiza la respuesta del proxy aCONNECT: 200 significa que el túnel se abrió; 407, que las credenciales fueron rechazadas. - 4
Protege el comando para automatización
Antes de incluir la línea en un script, añade
--connect-timeout 5 --max-time 15.
Preguntas frecuentes
¿Por qué PowerShell rechaza curl -x con un error de parámetro?
En PowerShell, curl es un alias de Invoke-WebRequest, que no cuenta con la opción -x. Ejecuta curl.exe -x http://user:pass@ip:port ... para que Windows use el cURL nativo.
cURL muestra 407 Proxy Authentication Required. ¿El proxy está caído?
No. Un error 407 es una respuesta del proxy, por lo que la IP y el puerto son accesibles. El usuario o la contraseña indicados en -x o -U no coincidían; cópialos de nuevo desde el pedido y presta atención a los caracteres especiales en la contraseña.
¿Tengo que ejecutar cURL en bucle para probar toda una lista de proxies?
No para una comprobación rápida. El verificador de proxies web admite hasta 100 proxies a la vez y no almacena contraseñas, y el test de velocidad de proxy compara la latencia sin necesidad de scripts.
Fuentes
IPv4 privadas que superan la prueba de cURL
Un cliente por IP, ancho de banda ilimitado, HTTP(S) con usuario y contraseña, en 7 países. Consulta los precios en tiempo real.
Ver precios de proxies en tiempo real