Proxies autenticados no Node.js: Axios, fetch nativo e Got
Pela equipe de engenharia da ProxyV4 · Updated:
A forma confiável de usar um proxy no Node.js com o Axios é passar um HttpsProxyAgent como httpsAgent, junto com proxy: false. A configuração proxy: { host, port } do próprio Axios não abre um túnel HTTP CONNECT, falhando em URLs https://; já o fetch() nativo precisa de um ProxyAgent do undici. Esta página mostra cada cliente com uma URL http://user:pass@ip:port da ProxyV4 e como confirmar o IP de saída.
new HttpsProxyAgent('http://user:pass@ip:port')- 1 IPUS$ 1,85
- 3+ IPsUS$ 1,70
- 10+ IPsUS$ 1,60
- 25+ IPsUS$ 1,50
- 50+ IPsUS$ 1,40
- 100+ IPsUS$ 1,30
- 200+ IPsUS$ 1,20
- 500+ IPsUS$ 1,10
- 1 IPUS$ 1,85
- 3+ IPsUS$ 1,70
- 10+ IPsUS$ 1,60
- 25+ IPsUS$ 1,50
- 50+ IPsUS$ 1,40
- 100+ IPsUS$ 1,30
- 200+ IPsUS$ 1,20
- 500+ IPsUS$ 1,10
Escolha o snippet para o seu cliente HTTP
Todos os três clientes aceitam a mesma URL de proxy. Monte-a a partir da linha ip:port:user:pass do seu pedido; o esquema permanece http:// porque o cliente se comunica via HTTP com o proxy e cria um túnel TLS através dele.
| Cliente | Instalação | Configuração do 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 que `proxy: false` é importante no Axios
O Axios verifica as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY por conta própria. Se uma delas estiver definida na máquina (comum em runners de CI e contêineres) e você também passar um agente, as duas configurações entram em conflito. proxy: false diz ao Axios para ignorar o ambiente e sua lógica interna de proxy, garantindo que apenas o agente decida para onde a requisição vai.
Reutilizando agentes em várias requisições
- Crie um agente por IP de proxy fora do loop de requisições; o agente mantém sockets keep-alive, enquanto criar um novo agente a cada chamada os descarta
- Com vários proxies, mantenha um
Mapde IP para agente e selecione a partir dele, em vez de criar agentes em tempo de execução - Defina um
timeoutem cada chamada (por exemplotimeout: 10000no Axios) para que um destino travado não bloqueie um worker indefinidamente - Precisa da lista de proxies como dados? O conversor de formato de proxy transforma linhas
ip:port:user:passem um array JSON que você pode usar comrequireouimport
O que um IP estável oferece a uma tarefa em Node.js
Um IPv4 privado da ProxyV4 pertence a um único cliente durante todo o período de locação e mantém o mesmo endereço na renovação, de modo que uma API na allowlist, uma sessão ativa ou um limite de requisições vinculado a esse IP permanecem válidos entre deploys. A largura de banda é ilimitada, mantendo workers de longa execução previsíveis. Para padrões de crawling e ritmo de requisições, confira o caso de uso de web scraping.
Passo a passo
- 1
Instale o cliente e o agente
Execute
npm install axios https-proxy-agentno projeto (ounpm install undicise usar ofetchnativo). - 2
Crie o agente uma única vez
Crie
const agent = new HttpsProxyAgent('http://user:pass@ip:port');com os valores do seu pedido na ProxyV4. - 3
Envie uma requisição através dele
Chame
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });. - 4
Compare o IP
console.log(res.data)deve exibir o IP do proxy. Se exibir o endereço do seu próprio servidor, o agente não foi aplicado.
Perguntas frequentes
Por que a opção proxy: { host, port, auth } do Axios falha em sites HTTPS?
Essa opção envia uma requisição HTTP comum para o proxy em vez de solicitar primeiro um túnel HTTP CONNECT, de modo que o TLS para o destino nunca é configurado corretamente. Use httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') e defina proxy: false.
Como adiciono um proxy ao fetch() nativo no Node 18, 20 ou 22?
O fetch do Node roda sobre o undici, portanto importe ProxyAgent de undici e passe { dispatcher: new ProxyAgent('http://user:pass@ip:port') } nas opções do fetch().
Minha senha contém @ ou :. A URL vai quebrar?
Pode quebrar, pois esses caracteres têm significado especial dentro de uma URL. Aplique percent-encoding na senha com encodeURIComponent(password) antes de montar http://user:pass@ip:port.
A requisição retorna 407. O que está errado?
O proxy respondeu, mas rejeitou a autenticação. Verifique novamente o nome de usuário e a senha do seu pedido; a página de solução de problemas do erro 407 lista as causas mais comuns.
Fontes
IPv4 estático para seus workers em Node.js
IPv4 privado em 7 países, além de ISP estático nos EUA e Vietnã, tráfego ilimitado e um único cliente por IP. Compre um ou vários.
Ver preços dos EUA em tempo real