Ir al contenido

Cómo usar proxies con cURL: Guía completa

TL;DR

Utilice GProxy proxies con cURL para peticiones HTTP de línea de comandos. Cubre tipos de proxy HTTP, HTTPS, SOCKS5, autenticación y opciones avanzadas.

Idioma: CLI

Requisitos previos

  • cURL 7.x+ instalado (pre-instalado en la mayoría de los sistemas)
  • Cuenta de GProxy con un plan de proxy activo
  • Acceso a la Terminal (Linux, macOS, o Windows WSL)

Configuración paso a paso

1

Verificar que cURL esté instalado

Comprueba tu versión de cURL

curl --version
2

Realizar una solicitud básica con proxy

Usa el flag -x para enrutar a través de GProxy

curl -x http://USER:PASS@proxy.gproxy.net:1000 https://httpbin.org/ip
3

Usar proxy SOCKS5

Enrutar a través del endpoint SOCKS5

curl -x socks5://USER:PASS@proxy.gproxy.net:1001 https://httpbin.org/ip
4

Establecer geo-targeting

Apuntar a un país específico

curl -x http://USER-country-de:PASS@proxy.gproxy.net:1000 https://httpbin.org/ip
5

Usar variables de entorno

Configurar el proxy globalmente para todas las solicitudes

export HTTP_PROXY=http://USER:PASS@proxy.gproxy.net:1000
export HTTPS_PROXY=http://USER:PASS@proxy.gproxy.net:1000
curl https://httpbin.org/ip
6

Probar con salida verbose

Depurar la conexión del proxy con el flag -v

curl -v -x http://USER:PASS@proxy.gproxy.net:1000 https://httpbin.org/ip

Ejemplos de código

Solicitud HTTP Proxy · bash
# Basic HTTP proxy
curl -x http://USER:PASS@proxy.gproxy.net:1000 https://httpbin.org/ip

# With custom headers
curl -x http://USER:PASS@proxy.gproxy.net:1000 \
  -H 'User-Agent: Mozilla/5.0' \
  -H 'Accept: application/json' \
  https://api.example.com/data
Solicitudes por lotes con rotación · bash
#!/bin/bash
# Each connection gets a new IP from GProxy's rotating pool
URLS=(
  'https://example.com/page1'
  'https://example.com/page2'
  'https://example.com/page3'
)

PROXY='http://USER:PASS@proxy.gproxy.net:1000'

for url in "${URLS[@]}"; do
  echo "Fetching: $url"
  curl -s -x "$PROXY" -o /dev/null -w "%{http_code} %{time_total}s\n" "$url"
done
Solicitudes con Geo-Targeting · bash
#!/bin/bash
# Compare responses from different countries
COUNTRIES=(us de gb fr jp br)

for country in "${COUNTRIES[@]}"; do
  echo -n "$country: "
  curl -s -x "http://USER-country-${country}:PASS@proxy.gproxy.net:1000" \
    https://httpbin.org/ip | jq -r '.origin'
done

¿Por qué usar proxies con cURL?

cURL es la herramienta de línea de comandos universal para solicitudes HTTP, instalada en prácticamente todos los sistemas Linux, macOS y Windows. Agregar proxies de GProxy a cURL le permite probar conexiones proxy, depurar llamadas API a través de diferentes IPs y crear scripts de shell para la recolección automatizada de datos. Con los más de 10M+ de IPs residenciales de GProxy en más de 150 países, puede realizar solicitudes desde cualquier ubicación directamente desde su terminal.

Sintaxis básica de proxy

cURL admite proxies a través del flag -x o --proxy. El formato es -x protocol://user:pass@host:port. GProxy admite los protocolos HTTP, HTTPS y SOCKS5, todos configurables a través de este único flag.

Métodos de autenticación

GProxy admite dos métodos de autenticación con cURL: credenciales integradas en la URL del proxy y autenticación por IP whitelist (no se necesitan credenciales). Para la autenticación integrada, incluya su nombre de usuario y contraseña directamente en la URL del proxy. Para IP whitelist, simplemente agregue la IP de su máquina al panel de GProxy y use el proxy sin credenciales.

SOCKS5 vs HTTP Proxy

cURL admite tanto proxies HTTP como SOCKS5. Use proxies HTTP (-x http://...) para solicitudes web estándar. Use SOCKS5 (-x socks5://...) cuando necesite un proxy para tráfico que no sea HTTP o cuando el objetivo requiera SOCKS5. GProxy ofrece ambas opciones en diferentes puertos.

Variables de entorno

Configure el proxy para todas las solicitudes cURL utilizando variables de entorno: export HTTP_PROXY=http://user:pass@proxy.gproxy.net:1000 y HTTPS_PROXY. Esto es útil para scripts de shell y pipelines de CI/CD donde desea que todo el tráfico HTTP pase a través de GProxy sin modificar cada comando.

Geo-Targeting

Apunte a países específicos incluyendo el código de país en su nombre de usuario de GProxy: USER-country-us, USER-country-de, etc. Esto enruta su solicitud a través de una IP residencial en ese país, lo cual es esencial para probar APIs con restricciones geográficas o verificar contenido localizado.

Casos de uso

API Testing

Pruebe APIs desde diferentes ubicaciones e IPs para verificar las restricciones geográficas y el comportamiento de rate limiting.

Shell Script Automation

Cree scripts de recolección de datos que roten a través de IPs de GProxy automáticamente.

Proxy Connection Testing

Verifique rápidamente sus credenciales de GProxy y la conectividad del proxy desde la línea de comandos.

CI/CD Pipeline Integration

Enrute solicitudes HTTP de CI/CD a través de GProxy utilizando variables de entorno para pruebas consistentes.

Consejos profesionales
Use la bandera -w para medir los tiempos de respuesta a través del proxy. Añada --connect-timeout 10 para fallar rápido ante problemas del proxy. Use el archivo .curlrc para una configuración de proxy persistente. Envíe la salida a jq para el procesamiento de JSON en scripts.

FAQ

¿Cómo uso cURL con proxies SOCKS5? +
Usa -x socks5://USER:PASS@proxy.gproxy.net:1001 — nota el prefijo de protocolo socks5:// y el puerto diferente.
¿Puedo usar cURL proxy con sitios web HTTPS? +
Sí, cURL soporta HTTPS a través de proxies HTTP mediante el método CONNECT. Usa el mismo flag -x tanto para objetivos HTTP como HTTPS.
¿Cómo guardo las credenciales del proxy de forma segura? +
Usa un archivo .curlrc en tu directorio home con 'proxy = http://USER:PASS@proxy.gproxy.net:1000' o utiliza variables de entorno.
¿Funciona la rotación de IP con cURL? +
Sí. El endpoint de backconnect de GProxy asigna una nueva IP por conexión, por lo que cada comando curl obtiene una IP de salida diferente.

¿Listo para empezar?

Comience con GProxy en minutos — proxies residenciales desde $0.85/GB, IPv6 desde $0.03/proxy, pago por uso.

Otras integraciones

support_agent
GProxy Support
Usually replies within minutes
Hi there!
Send us a message and we'll reply as soon as possible.