Guía · Python

Uso de proxies con Python requests y httpx

requests es la biblioteca HTTP más popular de Python e incluye compatibilidad nativa con proxies autenticados. Los errores más comunes son declarar incorrectamente la clave https en el diccionario proxies y no codificar los caracteres especiales en las contraseñas. Esta guía explica la configuración correcta, incluidos timeouts y la gestión de errores para scripts de larga ejecución.

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

Configuración básica

  • Formatea la cadena ip:port:user:pass en una URL: proxy_url = "http://user:pass@IP:PORT".
  • Declara ambas claves: proxies = {"http": proxy_url, "https": proxy_url}. La clave "https" sigue apuntando a una URL que comienza con http:// porque los proxies de ONET son proxies HTTP; requests utiliza CONNECT automáticamente para sitios HTTPS.
  • Envía la petición: r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30)); print(r.text). El resultado debe ser la IP del proxy.
  • No escribas "https": "https://IP:PORT". Los proxies de ONET no aceptan conexiones TLS hacia sí mismos y devolverán un error de SSL o cerrarán la conexión.

¿Cómo usar proxies con caracteres especiales en la contraseña en requests?

Codifica el usuario y la contraseña en formato URL antes de ensamblarlos: from urllib.parse import quote; proxy_url = f"http://{quote(user, safe='')}:{quote(pw, safe='')}@{ip}:{port}". Sin este paso, los caracteres @ o : en la contraseña harán que requests interprete incorrectamente la dirección del proxy.

Uso de Session y reintentos

  • Crea s = requests.Session(); s.proxies.update(proxies). Todas las peticiones realizadas a través de s comparten el proxy y mantienen las conexiones, lo cual es más rápido que llamar a requests.get repetidamente.
  • Monta un HTTPAdapter con Retry(total=3, backoff_factor=1, status_forcelist=[429, 502, 503]) para reintentar automáticamente ante errores transitorios.
  • Define siempre un timeout. Sin un timeout, una conexión colgada puede congelar tu programa indefinidamente.
  • requests también lee la variable de entorno HTTPS_PROXY, a menos que configures s.trust_env = False.

Con httpx

A partir de httpx 0.26, pasa el proxy mediante el parámetro proxy: httpx.Client(proxy="http://user:pass@IP:PORT", timeout=30). Las versiones anteriores usan proxies={"all://": url}. httpx admite modo asíncrono (httpx.AsyncClient) si necesitas ejecutar peticiones concurrentes.

¿Qué errores de proxy suele encontrar Python requests?

Los tres errores más comunes son 407 por usuario o contraseña incorrectos, tiempos de espera al no alcanzar el proxy, y 429 por los límites de solicitudes del sitio web de destino.

ProxyError … 407 Proxy Authentication Required

Usuario o contraseña incorrectos, o no se codificaron los caracteres especiales.

ConnectTimeout o ProxyError … timed out

No se puede conectar con el proxy: IP o puerto incorrectos, o bloqueo de red. Verifica usando curl.

HTTP 429 desde el sitio de destino

Límite de peticiones alcanzado en el sitio de destino. Reduce las solicitudes por IP, añade pausas o distribuye la carga entre varios proxies.

¿No tienes un proxy? Compra proxies dedicados con activación automática

Proxies IPv4 dedicados en 9 países desde 20.000₫/IP/mes al comprar 2.000 IPs o más (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 y aprovisionamiento automático tras el pago. Los proxies de Vietnam actualmente solo admiten HTTP(S), sin SOCKS5.

Comprar proxies ahora

Preguntas frecuentes

¿Los proxies de ONET tienen límites de hilos o de datos?+

Ancho de banda ilimitado. La cantidad de peticiones que puedes enviar a un sitio de destino está limitada por dicho sitio; superarla generará un error 429.

¿Puedo usar aiohttp?+

Sí. Pasa proxy="http://IP:PORT" y proxy_auth=aiohttp.BasicAuth(user, pass) en cada petición.