Proxies authentifiés avec Node.js : Axios, fetch natif et Got
Par l'équipe d'ingénierie de ProxyV4 · Updated:
La méthode fiable pour utiliser un proxy Node.js avec Axios consiste à passer un HttpsProxyAgent dans httpsAgent, avec proxy: false. La configuration propre à Axios proxy: { host, port } n'ouvre pas de tunnel HTTP CONNECT et échoue donc sur les URL https:// ; fetch() natif nécessite plutôt un ProxyAgent d'undici. Cette page présente chaque client avec une URL http://user:pass@ip:port de ProxyV4 et explique comment confirmer l'IP de sortie.
new HttpsProxyAgent('http://user:pass@ip:port')- 1 IP1,85 $US
- 3+ IP1,70 $US
- 10+ IP1,60 $US
- 25+ IP1,50 $US
- 50+ IP1,40 $US
- 100+ IP1,30 $US
- 200+ IP1,20 $US
- 500+ IP1,10 $US
- 1 IP1,85 $US
- 3+ IP1,70 $US
- 10+ IP1,60 $US
- 25+ IP1,50 $US
- 50+ IP1,40 $US
- 100+ IP1,30 $US
- 200+ IP1,20 $US
- 500+ IP1,10 $US
Choisissez l'extrait de code pour votre client HTTP
Les trois clients acceptent la même URL de proxy. Construisez-la à partir de la ligne ip:port:user:pass de votre commande ; le protocole reste http:// car le client communique en HTTP avec le proxy et établit un tunnel TLS à travers lui.
| Client | Installation | Configuration du proxy |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
fetch natif (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' }) } }) |
Pourquoi `proxy: false` est indispensable avec Axios
Axios vérifie automatiquement les variables d'environnement HTTP_PROXY et HTTPS_PROXY. Si l'une d'elles est définie sur la machine (fréquent sur les runners CI et dans les conteneurs) et que vous transmettez également un agent, les deux configurations entrent en conflit. proxy: false indique à Axios d'ignorer l'environnement ainsi que sa logique de proxy intégrée, afin que l'agent soit le seul à déterminer la destination de la requête.
Réutiliser les agents sur plusieurs requêtes
- Créez un agent par IP de proxy en dehors de votre boucle de requêtes ; l'agent conserve les sockets keep-alive, tandis qu'un nouvel agent à chaque appel les détruit
- Avec plusieurs proxies, conservez une
Mapassociant chaque IP à son agent et piochez dedans, plutôt que de créer des agents à la volée - Définissez un
timeoutpour chaque appel (par exempletimeout: 10000avec Axios) afin qu'une cible bloquée ne monopolise pas indéfiniment un worker - Besoin de la liste de proxies sous forme de données ? Le convertisseur de format de proxy transforme les lignes
ip:port:user:passen un tableau JSON que vous pouvez utiliser avecrequireouimport
Les avantages d'une IP fixe pour un job Node.js
Une IPv4 privée de ProxyV4 appartient à un seul client pendant toute la durée de location et conserve la même adresse lors du renouvellement, de sorte qu'une API sur liste blanche, une session connectée ou un quota de requêtes lié à cette IP restent valides entre les déploiements. La bande passante est illimitée, ce qui garantit la prévisibilité des workers de longue durée. Pour les modèles de crawl et le contrôle de cadence, consultez le cas d'usage web scraping.
Étape par étape
- 1
Installez le client et l'agent
Exécutez
npm install axios https-proxy-agentdans le projet (ounpm install undicisi vous utilisezfetchnatif). - 2
Créez l'agent une seule fois
Créez
const agent = new HttpsProxyAgent('http://user:pass@ip:port');avec les valeurs de votre commande ProxyV4. - 3
Envoyez une requête à travers celui-ci
Appelez
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });. - 4
Vérifiez l'adresse IP
console.log(res.data)doit afficher l'IP du proxy. Si l'adresse affichée est celle de votre propre serveur, l'agent n'a pas été appliqué.
Foire aux questions
Pourquoi l'option proxy: { host, port, auth } d'Axios échoue-t-elle sur les sites HTTPS ?
Cette option envoie une requête HTTP standard au proxy au lieu de demander d'abord un tunnel HTTP CONNECT, ce qui empêche la connexion TLS vers la cible de s'établir correctement. Utilisez httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') et définissez proxy: false.
Comment ajouter un proxy au fetch() natif dans Node 18, 20 ou 22 ?
Le fetch de Node repose sur undici : importez ProxyAgent depuis undici et transmettez { dispatcher: new ProxyAgent('http://user:pass@ip:port') } dans les options de fetch().
Mon mot de passe contient @ ou :. L'URL sera-t-elle corrompue ?
Cela peut arriver, car ces caractères ont une signification réservée dans une URL. Encodez le mot de passe avec encodeURIComponent(password) avant de construire http://user:pass@ip:port.
La requête renvoie 407. Quel est le problème ?
Le proxy a répondu mais a rejeté l'authentification. Vérifiez à nouveau l'identifiant et le mot de passe de votre commande ; la page de dépannage de l'erreur 407 répertorie les causes courantes.
Sources
IPv4 statiques pour vos workers Node.js
IPv4 privées dans 7 pays ainsi qu'ISP fixes aux États-Unis et au Vietnam, trafic illimité, un seul client par IP. À l'unité ou en volume.
Voir les tarifs en direct aux États-Unis