Authentifizierte Proxys in Node.js: Axios, natives fetch und Got
Vom ProxyV4-Entwicklungsteam · Updated:
Der verlässliche Weg, einen Node.js-Proxy mit Axios zu nutzen, ist ein als httpsAgent übergebener HttpsProxyAgent zusammen mit proxy: false. Die Axios-eigene Einstellung proxy: { host, port } öffnet keinen HTTP CONNECT-Tunnel und scheitert daher bei https://-URLs; natives fetch() benötigt stattdessen einen ProxyAgent aus undici. Diese Seite zeigt jeden Client mit einer ProxyV4-URL im Format http://user:pass@ip:port und wie Sie die Exit-IP überprüfen.
new HttpsProxyAgent('http://user:pass@ip:port')- 1 IP1,85 $
- 3+ IPs1,70 $
- 10+ IPs1,60 $
- 25+ IPs1,50 $
- 50+ IPs1,40 $
- 100+ IPs1,30 $
- 200+ IPs1,20 $
- 500+ IPs1,10 $
- 1 IP1,85 $
- 3+ IPs1,70 $
- 10+ IPs1,60 $
- 25+ IPs1,50 $
- 50+ IPs1,40 $
- 100+ IPs1,30 $
- 200+ IPs1,20 $
- 500+ IPs1,10 $
Wählen Sie das Snippet für Ihren HTTP-Client
Alle drei Clients verwenden dieselbe Proxy-URL. Erstellen Sie diese aus der Zeile ip:port:user:pass Ihrer Bestellung; das Schema bleibt http://, da der Client via HTTP mit dem Proxy kommuniziert und TLS hindurch tunnelt.
| Client | Installation | Proxy-Einbindung |
|---|---|---|
| Axios | npm i https-proxy-agent | axios.get(url, { httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port'), proxy: false }) |
Natives 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' }) } }) |
Warum `proxy: false` bei Axios wichtig ist
Axios prüft eigenständig die Umgebungsvariablen HTTP_PROXY und HTTPS_PROXY. Ist eine davon auf dem System gesetzt (häufig bei CI-Runnern und Containern) und Sie übergeben zusätzlich einen Agenten, kollidieren beide Konfigurationen. proxy: false weist Axios an, die Umgebung sowie die integrierte Proxy-Logik zu ignorieren, sodass allein der Agent das Routing der Anfrage bestimmt.
Wiederverwendung von Agenten über viele Anfragen hinweg
- Erstellen Sie pro Proxy-IP einen Agenten außerhalb Ihrer Request-Schleife; der Agent verwaltet Keep-Alive-Sockets, während ein neuer Agent pro Aufruf diese verwirft
- Verwalten Sie bei mehreren Proxys eine
Mapvon IP zu Agent und wählen Sie daraus aus, anstatt Agenten dynamisch zur Laufzeit zu erstellen - Vergeben Sie für jeden Aufruf einen
timeout(beispielsweisetimeout: 10000in Axios), damit ein blockiertes Ziel nicht dauerhaft einen Worker belegt - Benötigen Sie die Proxy-Liste als Daten? Der Proxy-Format-Konverter wandelt
ip:port:user:pass-Zeilen in ein JSON-Array um, das Sie mitrequireoderimportladen können
Was eine stabile IP für Node.js-Workflows bedeutet
Eine dedizierte IPv4 von ProxyV4 gehört für die gesamte Mietdauer einem einzelnen Kunden und behält dieselbe Adresse auch bei einer Verlängerung. Dadurch bleiben eine IP-Allowlist für APIs, eine eingeloggte Session oder ein an die IP gebundenes Rate-Limit-Budget zwischen Deployments gültig. Die Bandbreite wird nicht limitiert, was lang laufende Worker verlässlich kalkulierbar macht. Crawling-Muster und Taktung finden Sie im Anwendungsfall Web-Scraping.
Schritt für Schritt
- 1
Client und Agent installieren
Führen Sie
npm install axios https-proxy-agentim Projekt aus (odernpm install undici, falls Sie nativesfetchnutzen). - 2
Agenten einmalig erstellen
Erstellen Sie
const agent = new HttpsProxyAgent('http://user:pass@ip:port');mit den Werten aus Ihrer ProxyV4-Bestellung. - 3
Anfrage über den Proxy senden
Rufen Sie
const res = await axios.get('https://proxyv4.com/api/my-ip', { httpsAgent: agent, proxy: false, timeout: 10000 });auf. - 4
IP-Adresse abgleichen
console.log(res.data)sollte die Proxy-IP ausgeben. Erscheint stattdessen die eigene Adresse Ihres Servers, wurde der Agent nicht angewendet.
Häufig gestellte Fragen
Warum schlägt Axios proxy: { host, port, auth } bei HTTPS-Websites fehl?
Diese Option sendet eine normale HTTP-Anfrage an den Proxy, anstatt zuerst einen HTTP CONNECT-Tunnel anzufordern, sodass die TLS-Verbindung zum Ziel nie korrekt aufgebaut wird. Verwenden Sie httpsAgent: new HttpsProxyAgent('http://user:pass@ip:port') und setzen Sie proxy: false.
Wie binde ich einen Proxy in natives fetch() unter Node 18, 20 oder 22 ein?
Das fetch von Node basiert auf undici. Importieren Sie daher ProxyAgent aus undici und übergeben Sie { dispatcher: new ProxyAgent('http://user:pass@ip:port') } als Option an fetch().
Mein Passwort enthält @ oder :. Schlägt die URL dadurch fehl?
Das kann passieren, da diese Zeichen innerhalb einer URL eine reservierte Bedeutung haben. Enkodieren Sie das Passwort vorab per encodeURIComponent(password), bevor Sie http://user:pass@ip:port zusammensetzen.
Die Anfrage liefert den Fehler 407. Woran liegt das?
Der Proxy hat geantwortet, aber den Login abgelehnt. Überprüfen Sie Benutzername und Passwort aus Ihrer Bestellung; auf der Seite zur Fehlerbehebung von 407 finden Sie die häufigsten Ursachen.
Quellen
Statische IPv4 für Ihre Node.js-Worker
Private IPv4 in 7 Ländern sowie statische ISP in den USA und Vietnam, ungedrosselt, ein Kunde pro IP. Einzeln oder in Paketen erhältlich.
Aktuelle US-Preise prüfen