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.
Leer como Markdown ↗

Integración

Conecta tu stack.

Configuración explícita, peticiones acotadas y una forma clara de verificar la conexión.

Usar un proxy con curl

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.

Configurar Python Requests

Configura un proxy en Python Requests: el diccionario proxies, ajustes de Session, credenciales, SOCKS5 con requests[socks], variables de entorno y ProxyError.

Usar un proxy con fetch de Node.js

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.

Configurar un proxy en Playwright

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.

Proxies async en HTTPX

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.

Notificaciones de listados de Amazon

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.

Conceptos

Entiende las contrapartidas.

Elige un protocolo, un modelo de sesión o un tipo de red con las preguntas adecuadas en mente.

Proxies HTTP vs SOCKS5

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.

Proxies rotativos vs persistentes

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.

Proxies móviles vs residenciales

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.

Corrige el error de proxy 407

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.

Variables de entorno de proxy

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.

Diagnostica timeouts de proxy

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.

Corrige ERR_TUNNEL_CONNECTION_FAILED

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.

Países

Comprueba la ubicación.

Entiende las redes locales, verifica las ubicaciones de salida y haz mejores preguntas antes de elegir un proveedor.

Proxies de Países Bajos

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.

Proxies de EE. UU.

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.

Proxies del Reino Unido

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.

Proxies de Alemania

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.

Proxies de Francia

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.