Cómo configurar un proxy en Node.js (Axios y Native Fetch)

Actualizado:

La opción predeterminada de Axios proxy: { host, port } falla al realizar peticiones a destinos https:// porque no establece un túnel HTTP CONNECT. Para dirigir el tráfico de Node.js y TypeScript limpiamente a través de los proxies HTTP(S) autenticados de VinaProxy, utiliza un HttpsProxyAgent (https-proxy-agent) con Axios o un dispatcher undici.ProxyAgent con la función nativa fetch().

Node.js (Axios / Undici) · HTTP Proxy Format
new HttpsProxyAgent('http://user:pass@ip:port')
IPv4 privado (datacenter)
🇺🇸 United States
Disponible
Desde
20.000 ₫ / IP / mes
≈ 0,74 US$ · facturado en VND
Descuentos por volumen
  • 1 IP40.000 ₫
  • 5+ IPs35.000 ₫
  • 10+ IPs25.000 ₫
  • 20+ IPs25.000 ₫
  • 50+ IPs25.000 ₫
  • 100+ IPs25.000 ₫
  • 200+ IPs25.000 ₫
  • 500+ IPs25.000 ₫
  • 1000+ IPs22.000 ₫
  • 2000+ IPs20.000 ₫
Comprar United States
IPv4 privado (datacenter)
🇸🇬 Singapore
Disponible
Desde
20.000 ₫ / IP / mes
≈ 0,74 US$ · facturado en VND
Descuentos por volumen
  • 1 IP40.000 ₫
  • 5+ IPs35.000 ₫
  • 10+ IPs25.000 ₫
  • 20+ IPs25.000 ₫
  • 50+ IPs25.000 ₫
  • 100+ IPs25.000 ₫
  • 200+ IPs25.000 ₫
  • 500+ IPs25.000 ₫
  • 1000+ IPs22.000 ₫
  • 2000+ IPs20.000 ₫
Comprar Singapore

Comparativa de configuración de proxy en Axios y fetch() nativo

Ambas librerías aceptan directamente la URL estándar http://user:pass@ip:port provista en tu panel de VinaProxy:

Cliente HTTPPaquete NPMFragmento de código recomendado
Axiosnpm i https-proxy-agentaxios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false })
Nativo fetch (Node 18+)npm i undicifetch(url, { dispatcher: new ProxyAgent('http://user:pass@ip:port') })
Gotnpm i hpagentgot(url, { agent: { https: new HttpsProxyAgent({ proxy: 'http://user:pass@ip:port' }) } })

Reutilización de conexiones y control de timeouts en Node.js

  • Declara siempre proxy: false junto con httpsAgent en Axios para que ignore posibles variables de entorno HTTP_PROXY del sistema operativo
  • Instancia HttpsProxyAgent o ProxyAgent una sola vez por IP de proxy fuera de los bucles para reutilizar conexiones TCP keep-alive persistentes
  • Exporta tu lista de proxies VinaProxy directamente como un array JSON mediante nuestro Conversor de formato de proxy

Paso a paso

  1. 1

    Instala https-proxy-agent (o undici)

    Ejecuta npm install axios https-proxy-agent en tu proyecto de Node.js.

  2. 2

    Crea la instancia de HttpsProxyAgent

    Inicializa const agent = new HttpsProxyAgent('http://user:pass@ip:port'); con tus credenciales de VinaProxy.

  3. 3

    Pasa httpsAgent y proxy: false a Axios

    Llama a const res = await axios.get('https://vinaproxy.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });.

  4. 4

    Verifica la IP pública de salida

    Imprime res.data para comprobar que la conexión transitó por tu IP de proxy dedicada.

Preguntas frecuentes

¿Por qué la configuración default proxy: { host, port, auth } de Axios falla en URLs HTTPS?

El sistema interno de Axios envía una petición HTTP plana sin abrir un túnel TLS mediante HTTP CONNECT. Usar httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') con proxy: false soluciona este comportamiento.

¿Cómo se configura un proxy en la función fetch() nativa de Node.js 18/20/22?

Importa ProxyAgent desde undici e introduce { dispatcher: new ProxyAgent('http://user:pass@ip:port') } en el objeto de opciones de fetch().

¿Se puede convertir una lista de proxies a formato JSON para proyectos Node.js?

Sí. Introduce tus líneas en formato ip:port:user:pass en nuestro Conversor de formato de proxy gratuito y escoge la salida JSON.

Potencia tus servicios y scrapers en Node.js con IPs estáticas dedicadas

Proxies Dedicated IPv4 y Static ISP ilimitados con aprovisionamiento instantáneo en 7 países.

Comprar proxies para Node.js

Artículos relacionados

Proxies por plataforma
Proxies para Web Scraping: pools de IPv4 e ISP dedicados sin límite para scrapers 24/7
Proxies HTTP(S) IPv4 dedicados e ISP estáticos de alta velocidad para Python, Playwright, Selenium y Scrapy con ancho de banda mensual ilimitado.
Configuración de proxy
Cómo configurar un proxy con autenticación en Puppeteer (Node.js)
Aprende a configurar proxies HTTP(S) autenticados en Puppeteer para Node.js usando el flag --proxy-server y await page.authenticate().
Configuración de proxy
Cómo configurar un proxy en Playwright (autenticación global y por contexto)
Configura proxies HTTP(S) autenticados en Playwright para Node.js y Python. Ejecuta múltiples IPs estáticas aisladas en distintos BrowserContexts.
Herramientas gratuitas
Conversor masivo de formato de proxies (100% seguro en el navegador)
Herramienta masiva para formatear listas de proxies 100% en el navegador. Convierte entre ip:port:user:pass, user:pass@ip:port, URLs http://, URIs SOCKS5, arrays JSON y FoxyProxy.
Proxies por plataforma
Proxies para SEO y seguimiento de SERP: rankings precisos de palabras clave en 7 países
Monitoriza el ranking de palabras clave locales, audita redirecciones geográficas y ejecuta Screaming Frog con proxies IPv4 dedicados e ISP estáticos sin límite.
Proxies por plataforma
Proxies para Discord: aísla cuentas y tokens en IPs estáticas dedicadas
Protege múltiples cuentas y tokens de Discord frente a bloqueos de verificación telefónica y Cloudflare. Proxies estáticos dedicados en EE. UU., Singapur y Vietnam.
IPV4 · united states
Proxies IPv4 privados de Estados Unidos: IP de centro de datos rápidas y dedicadas
Proxies IPv4 privados de EE. UU. para scraping, SERP, anuncios y Amazon. IP estática, un usuario por IP, ancho de banda ilimitado y activación rápida.
IPV4 · singapore
Proxies IPv4 privados de Singapur: IP dedicadas para ventas y anuncios en el Sudeste Asiático
Proxies IPv4 privados de Singapur para Lazada, Shopee SG, cuentas publicitarias y automatización de baja latencia. Tráfico ilimitado e IP estática.