Proxy autenticati in Node.js: Axios, fetch nativo e Got
A cura del team di ingegneria di ProxyV4 · Updated:
Il modo più affidabile per usare un proxy Node.js con Axios è passare un HttpsProxyAgent come httpsAgent, insieme a proxy: false. L'impostazione predefinita di Axios proxy: { host, port } non apre un tunnel HTTP CONNECT, quindi non funziona con gli URL https://; il metodo nativo fetch() richiede invece un ProxyAgent di undici. Questa pagina mostra ciascun client con un URL ProxyV4 http://user:pass@ip:port e come verificare l'IP di uscita.
new HttpsProxyAgent('http://user:pass@ip:port')- 1 IP1,85 USD
- 3+ IP1,70 USD
- 10+ IP1,60 USD
- 25+ IP1,50 USD
- 50+ IP1,40 USD
- 100+ IP1,30 USD
- 200+ IP1,20 USD
- 500+ IP1,10 USD
- 1 IP1,85 USD
- 3+ IP1,70 USD
- 10+ IP1,60 USD
- 25+ IP1,50 USD
- 50+ IP1,40 USD
- 100+ IP1,30 USD
- 200+ IP1,20 USD
- 500+ IP1,10 USD
Scegli lo snippet per il tuo client HTTP
Tutti e tre i client accettano lo stesso URL proxy. Crealo a partire dalla riga ip:port:user:pass del tuo ordine; lo schema resta http:// perché il client comunica in HTTP con il proxy e fa passare TLS attraverso il tunnel.
| Client | Installazione | Configurazione proxy |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
Native fetch (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' }) } }) |
Perché `proxy: false` è fondamentale in Axios
Axios verifica autonomamente le variabili d'ambiente HTTP_PROXY e HTTPS_PROXY. Se una di esse è impostata sulla macchina (situazione comune nei runner CI e nei container) e si passa anche un agent, le due configurazioni entrano in conflitto. proxy: false indica ad Axios di ignorare l'ambiente e la propria logica proxy integrata, lasciando all'agent il controllo esclusivo sull'instradamento della richiesta.
Riutilizzare gli agent per più richieste
- Crea un solo agent per ciascun IP proxy all'esterno del ciclo delle richieste; l'agent mantiene attivi i socket keep-alive, mentre crearne uno nuovo a ogni chiamata li distruggerebbe
- Se utilizzi più proxy, gestisci una
Mapda IP ad agent e seleziona da essa, invece di istanziare gli agent al volo - Imposta un
timeoutper ogni chiamata (ad esempiotimeout: 10000in Axios), così che una destinazione bloccata non occupi un worker all'infinito - Ti serve l'elenco dei proxy come dato strutturato? Il convertitore di formati proxy trasforma le righe
ip:port:user:passin un array JSON pronto perrequireoimport
I vantaggi di un IP stabile per un job Node.js
Un IPv4 privato di ProxyV4 appartiene a un solo cliente per l'intera durata del noleggio e mantiene lo stesso indirizzo al rinnovo: così le API in whitelist, le sessioni attive o i limiti di frequenza legati a tale IP restano validi tra un deploy e l'altro. La larghezza di banda non ha limiti di traffico, garantendo la massima prevedibilità per i worker a esecuzione prolungata. Per i pattern di crawling e la gestione della frequenza, consulta il caso d'uso per il web scraping.
Guida passo-passo
- 1
Installa il client e l'agent
Esegui
npm install axios https-proxy-agentnel progetto (oppurenpm install undicise usifetchnativo). - 2
Crea l'agent una volta sola
Crea
const agent = new HttpsProxyAgent('http://user:pass@ip:port');con i valori del tuo ordine ProxyV4. - 3
Invia una richiesta attraverso il proxy
Esegui
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });. - 4
Verifica l'IP
console.log(res.data)dovrebbe stampare l'IP del proxy. Se mostra l'indirizzo del tuo server, l'agent non è stato applicato.
Domande frequenti
Perché l'opzione proxy: { host, port, auth } di Axios fallisce sui siti HTTPS?
Tale opzione invia una normale richiesta HTTP al proxy invece di richiedere prima un tunnel HTTP CONNECT, impedendo la corretta inizializzazione di TLS verso la destinazione. Usa httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') e imposta proxy: false.
Come si aggiunge un proxy a fetch() nativo in Node 18, 20 o 22?
Il comando fetch di Node si basa su undici: importa ProxyAgent da undici e passa { dispatcher: new ProxyAgent('http://user:pass@ip:port') } tra le opzioni di fetch().
La mia password contiene @ o :. L'URL darà errore?
È possibile, perché questi caratteri hanno un significato specifico all'interno di un URL. Applica la codifica percentuale alla password con encodeURIComponent(password) prima di creare http://user:pass@ip:port.
La richiesta restituisce 407. Qual è il problema?
Il proxy ha risposto ma ha rifiutato l'autenticazione. Controlla nuovamente nome utente e password indicati nel tuo ordine; la guida alla risoluzione dell'errore 407 elenca le cause più comuni.
Fonti
IPv4 statici per i tuoi worker Node.js
IPv4 privati in 7 paesi e ISP statici negli Stati Uniti e in Vietnam, traffico illimitato, un solo cliente per IP. Acquista uno o più IP.
Vedi i prezzi attuali per gli USA