Proxies autenticados en Node.js: Axios, fetch nativo y Got
Por el equipo de ingeniería de ProxyV4 · Updated:
La forma fiable de usar un proxy en Node.js con Axios es pasar un HttpsProxyAgent como httpsAgent, junto con proxy: false. La configuración propia de Axios proxy: { host, port } no abre un túnel HTTP CONNECT, por lo que falla en URLs https://; el fetch() nativo necesita un ProxyAgent de undici. Esta página muestra cada cliente con una URL http://user:pass@ip:port de ProxyV4 y cómo confirmar la IP de salida.
new HttpsProxyAgent('http://user:pass@ip:port')- 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$
Elige el fragmento para tu cliente HTTP
Los tres clientes aceptan la misma URL de proxy. Constrúyela a partir de la línea ip:port:user:pass de tu pedido; el esquema se mantiene como http:// porque el cliente se comunica mediante HTTP con el proxy y crea un túnel TLS a través de él.
| Cliente | Instalación | Configuración del proxy |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
fetch nativo (Node 18+) | npm i undici | fetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') }) |
| Got | npm i hpagent | got(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } }) |
Por qué `proxy: false` es importante en Axios
Axios comprueba por su cuenta las variables de entorno HTTP_PROXY y HTTPS_PROXY. Si alguna de ellas está configurada en la máquina (habitual en ejecutores de CI y contenedores) y además pasas un agente, ambas configuraciones entran en conflicto. proxy: false le indica a Axios que ignore el entorno y su lógica interna de proxy, de modo que el agente sea lo único que decida a dónde va la petición.
Reutilizar agentes en múltiples peticiones
- Crea un agente por IP de proxy fuera del bucle de peticiones; el agente mantiene sockets keep-alive, mientras que crear un agente nuevo por llamada los descarta
- Si usas varios proxies, mantén un
Mapde IP a agente y selecciónalo desde ahí, en lugar de crear agentes sobre la marcha - Asigna a cada llamada un
timeout(por ejemplotimeout: 10000en Axios) para que un destino bloqueado no retenga a un worker indefinidamente - ¿Necesitas la lista de proxies como datos? El conversor de formatos de proxy transforma las líneas
ip:port:user:passen un array JSON que puedes importar conrequireoimport
Qué aporta una IP fija a un proceso en Node.js
Una IPv4 privada de ProxyV4 pertenece a un solo cliente durante todo el periodo de alquiler y conserva la misma dirección al renovar, por lo que una API con lista blanca, una sesión iniciada o un límite de tasa asociado a esa IP siguen siendo válidos entre despliegues. El ancho de banda no está medido, lo que mantiene predecibles los workers de larga duración. Para patrones de rastreo y ritmos de envío, consulta el caso de uso de web scraping.
Paso a paso
- 1
Instala el cliente y el agente
Ejecuta
npm install axios https-proxy-agenten el proyecto (onpm install undicisi utilizasfetchnativo). - 2
Crea el agente una sola vez
Crea
const agent = new HttpsProxyAgent('http://user:pass@ip:port');con los valores de tu pedido de ProxyV4. - 3
Envía una petición a través de él
Llama a
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });. - 4
Compara la IP
console.log(res.data)debería imprimir la IP del proxy. Si imprime la dirección propia de tu servidor, no se aplicó el agente.
Preguntas frecuentes
¿Por qué falla proxy: { host, port, auth } de Axios en sitios HTTPS?
Esa opción envía una petición HTTP ordinaria al proxy en lugar de solicitar primero un túnel HTTP CONNECT, por lo que TLS hacia el destino nunca se establece de forma correcta. Usa httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') y define proxy: false.
¿Cómo añado un proxy a fetch() nativo en Node 18, 20 o 22?
El fetch de Node se ejecuta sobre undici, así que importa ProxyAgent desde undici y pasa { dispatcher: new ProxyAgent('http://user:pass@ip:port') } dentro de las opciones de fetch().
Mi contraseña contiene @ o :. ¿Se romperá la URL?
Puede romperse, ya que esos caracteres tienen un significado especial dentro de una URL. Codifícala con porcentajes usando encodeURIComponent(password) antes de construir http://user:pass@ip:port.
La petición devuelve 407. ¿Cuál es el problema?
El proxy respondió pero rechazó el inicio de sesión. Revisa de nuevo el usuario y la contraseña de tu pedido; la página de solución de problemas del error 407 enumera las causas más frecuentes.
Fuentes
IPv4 estáticas para tus workers en Node.js
IPv4 privadas en 7 países más ISP estáticas en EE. UU. y Vietnam, sin límite de tráfico, un cliente por IP. Compra una o varias.
Consultar precios en tiempo real para EE. UU.