Node.js suporta proxy nativamente?

O fetch nativo e axios não suportam proxy diretamente — é necessário um agente como `https-proxy-agent` para rotear tráfego HTTPS.

Como debugar erro de autenticação de proxy?

Um erro 407 (Proxy Authentication Required) indica problema nas credenciais do proxy, diferente de um erro do site de destino. Trate os dois separadamente no log.

Como integrar proxy via API: guia com exemplos práticos

Q: Preciso de biblioteca especial para usar proxy em Python?

Não. O módulo `requests` já suporta proxy nativamente via o parâmetro `proxies`, sem dependência adicional.

A maior barreira para começar a usar proxy em um projeto não é técnica — é achar que precisa de biblioteca especializada ou configuração complexa. Na prática, integração de proxy via HTTP é poucas linhas em qualquer stack.

cURL

curl -x http://usuario:[email protected]:8080 https://api.destino.com/dados

O -x (ou --proxy) especifica o endereço do proxy com autenticação embutida na URL. Funciona para HTTP e HTTPS.

Python (requests)

import requests

proxies = {
    "http": "http://usuario:[email protected]:8080",
    "https": "http://usuario:[email protected]:8080",
}

response = requests.get("https://api.destino.com/dados", proxies=proxies, timeout=10)
print(response.status_code, response.text)

O padrão requests já suporta proxy nativamente via o parâmetro proxies — sem dependência extra.

Node.js (com axios + https-proxy-agent)

const axios = require('axios');
const { HttpsProxyAgent } = require('https-proxy-agent');

const agent = new HttpsProxyAgent('http://usuario:[email protected]:8080');

axios.get('https://api.destino.com/dados', { httpsAgent: agent })
  .then(res => console.log(res.status, res.data));

Node não suporta proxy nativamente no fetch/axios sem um agente — https-proxy-agent é a biblioteca mais usada para isso.

Boas práticas de integração

Sempre configure timeout: proxy adiciona um salto de rede extra; sem timeout, uma falha de proxy trava a aplicação inteira.
Trate erro de proxy separado de erro do destino: um 407 (Proxy Authentication Required) é diferente de um 403 do site de destino — logue separado para debugar mais rápido.
Rotação via nova chamada, não via estado compartilhado: se seu proxy suporta rotação sob demanda, trate isso como uma chamada de API explícita, não como efeito colateral escondido.

Próximos passos

Comece com o exemplo da sua stack, valide com uma chamada simples (ex.: um serviço de verificação de IP) antes de integrar em produção.

Como integrar proxy via API: guia com exemplos em cURL, Python e Node