Cómo usar un proxy con curl: la opción -x, las variables http_proxy y https_proxy, SOCKS5 con socks5h, autenticación del proxy y cómo leer los errores CONNECT y 407.
ipvolt / notas de campoBiblioteca para desarrolladores
Construye una conexión mejor.
Conocimiento práctico sobre proxies, desde la primera petición hasta los detalles que importan. Ejemplos claros. Distinciones útiles. Menos suposiciones.
Conecta tu stack.Integración
Conecta tu stack.
Configuración explícita, peticiones acotadas y una forma clara de verificar la conexión.
Configura un proxy en Python Requests: el diccionario proxies, ajustes de Session, credenciales, SOCKS5 con requests[socks], variables de entorno y ProxyError.
Enruta el fetch nativo de Node.js a través de un ProxyAgent de Undici con autenticación explícita, un plazo de cancelación y limpieza de la respuesta.
Configura un proxy HTTP autenticado en un contexto de navegador de Playwright, aísla el estado de la prueba y diagnostica la navegación por separado de los subrecursos.
Configura un cliente async de HTTPX con proxy, cierra bien las respuestas en streaming y reproduce un PoolTimeout en local antes de cambiar la configuración del proxy.
Gestiona eventos de listados de Amazon SP-API con una bandeja de entrada SQLite probada: deduplica entregas, recupera tras un reinicio y rechaza lecturas ya superadas.
Ejecuta 12 comprobaciones de reloj para Australia en Playwright, incluido el cambio de 30 minutos de Lord Howe. Separa el UTC fijo, la zona del navegador y Node.
Usa una instantánea de configuración y visitas emparejadas para probar la localización de Shopify en Canadá. Separa IP, URL, idioma, elección guardada y dirección.
curl, Wget 1.x, urllib, node:http, PHP curl, Guzzle y java.net.http.HttpClient no envían Accept-Encoding (o envían identity) por defecto. Soluciones y bytes comprobados.
Configura proxies para Axios en Node.js, separa los ajustes explícitos del enrutamiento por entorno y agentes y reproduce las pruebas de autenticación y TLS.
Configura un proxy en aiohttp 3.14: sustituye BasicAuth y proxy_auth, ya obsoletos, activa trust_env y entiende los errores 407 y Bad status line. Probado en 3.14.4.
Configura proxies en Scrapy 2.19: credenciales en meta["proxy"], rotación por petición, HTTP_PROXY y soluciones para TunnelError 407, el 407 ignorado y socks5.
Configura proxies en curl_cffi 0.16.3: credenciales e impersonate, por qué un 407 en CONNECT lanza ConnectionError y no ProxyError, HTTP_PROXY y socks5h.
Bloquea imágenes, fuentes y medios en Playwright con route() en Python y Node.js, en todo el contexto o por host, con las salvedades de la caché y los service workers.
Conceptos
Entiende las contrapartidas.
Elige un protocolo, un modelo de sesión o un tipo de red con las preguntas adecuadas en mente.
Compara HTTP CONNECT y SOCKS5, entiende dónde se resuelve el DNS y los límites de TLS, y elige un protocolo que tu cliente y tu proveedor realmente soporten.
Elige la rotación según el flujo completo más pequeño, distingue la afinidad de salida de las cookies y prueba qué pasa si una sesión persistente termina antes.
Compara redes de salida de operadores móviles y de hogares para QA, mantén separada la emulación del navegador y mide las capacidades que tu flujo de trabajo necesita.
Solución de problemas
Encuentra el fallo.
Separa los errores de autenticación, conectividad y destino antes de cambiar la configuración.
Diagnostica Proxy Authentication Required en un orden repetible: gateway, método de autenticación, codificación de credenciales, alcance de cuenta y ajustes del cliente.
Diagnostica las diferencias de enrutamiento de HTTP_PROXY, HTTPS_PROXY, ALL_PROXY y NO_PROXY en curl, Python Requests y Node.js con una comprobación local aislada.
Separa los retrasos de DNS, TCP, CONNECT, TLS y respuesta del proxy con los tiempos de curl, define plazos por petición y decide si un reintento es seguro.
ERR_TUNNEL_CONNECTION_FAILED y ERR_PROXY_CONNECTION_FAILED explicados con una matriz verificada de fallos de proxy y cómo recuperar el estado CONNECT que Chromium oculta.
Descifra TypeError: fetch failed de Node.js tras un proxy: imprime la cadena err.cause, corrige un HTTPS_PROXY ignorado o el desfase de undici y lee un 403, 407 o 502.
El fetch de Node ignora HTTPS_PROXY y falla con UND_ERR_CONNECT_TIMEOUT aunque curl funcione. Corrígelo con NODE_USE_ENV_PROXY=1 o, en versiones antiguas, con undici.
El mismo error SSL wrong version number aparece en dos saltos detrás de un proxy. Cómo saber cuál falló en curl, Requests y HTTPX, y cómo corregir cada caso.
Corrige el error Missing dependencies for SOCKS support en Python Requests, pip y HTTPX: instala requests[socks] o limpia la variable ALL_PROXY que lo provoca.
Scrapy 2.16 eliminó Spider.start_requests(): el spider registra Crawled 0 pages y se cierra como finished sin avisos. Solución: async def start(). Probado en 2.19.
Países
Comprueba la ubicación.
Entiende las redes locales, verifica las ubicaciones de salida y haz mejores preguntas antes de elegir un proveedor.
Evalúa proxies de Países Bajos con contexto de la red neerlandesa, comprobaciones de IP de salida y ciudad, evidencia ASN y una lista de prueba antes de elegir proveedor.
Evalúa proxies de EE. UU. por país, estado y ciudad. Compara la evidencia de red, planifica comprobaciones regionales y mide las sesiones antes de elegir proveedor.
Evalúa proxies del Reino Unido con contexto actual de operadores, geografía UK y GB, límites de los códigos postales y un plan de pruebas para requisitos de país o red.
Evalúa proxies de Alemania con contexto actual de operadores y roaming, límites de la ubicación por ciudad, control del idioma del navegador y una lista de aceptación.
Evalúa proxies de Francia distinguiendo operadores y marcas, alcance metropolitano y de ultramar, evidencia de IP de salida y una matriz de pruebas de localización.
Proxies de Brasil, móviles o residenciales: qué demuestra la etiqueta, contexto de Vivo, Claro y TIM, estados, zonas horarias, CEP y CPF como entradas y plan de prueba.
Especifica y verifica proxies de Portugal: alcance continental e insular, operadores según ANACOM, ajustes pt-PT, campos del checkout portugués y prueba de cuatro filas.
Elige la evidencia que necesita una prueba de proxies australianos: país o ciudad, etiquetas de red de Telstra, Optus y TPG, capas de proveedor de nbn y sesión.
Evalúa proxies de Canadá con una matriz de aceptación de país, operador y sesión. Separa las marcas Rogers, Bell, TELUS y Quebecor de la evidencia que necesitas.
Evalúa proxies de Japón con evidencia separada de ubicación IP, salida y acceso móvil. Analiza las marcas au/UQ y el roaming de Rakuten antes de aceptar una muestra.