# ProxyFehler: 'Keine Verbindung zum Proxy möglich' in Python und Node.js

> requests.exceptions.ProxyError 'Kann keine Verbindung zum Proxy herstellen' erklärt: lesen Sie die verschachtelte Ursache (verweigert, Timeout, DNS, 407, 502) und wenden Sie die richtige Behebung an.

- URL: https://crawlrelay.com/de/docs/errors/cannot-connect-to-proxy/
- Zuletzt aktualisiert: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Client-Bibliotheksfehler (Python, Node.js): die genaue Meldung in jedem Tool, wahrscheinliche Ursachen in Reihenfolge und die Lösung, die funktioniert.

**Kurze Antwort — Was bedeutet Cannot connect to proxy (ProxyError) bei einem Proxy?**

**'Keine Verbindung zum Proxy möglich'** ist ein Wrapper-Fehler: Python's requests und urllib3 legen den tatsächlichen Grund darin ab. Lesen Sie die innerste Ursache. 'Verbindung verweigert' oder ein Timeout bedeutet ein Problem mit Host, Port oder Netzwerk; 'Auflösung fehlgeschlagen' bedeutet DNS; 'Tunnelverbindung fehlgeschlagen: 407' bedeutet Anmeldedaten. Bei CrawlRelay hat jeder dieser Fälle eine Ein-Zeilen-Lösung.

## Cannot connect to proxy (ProxyError) auf einen Blick

| Attribut | Wert |
| --- | --- |
| Fehler | Cannot connect to proxy (ProxyError) |
| Typ | Client-Bibliotheksfehler (Python, Node.js) |
| Gesendet von | Ihr HTTP-Client, vor oder während der Kommunikation mit dem Proxy |
| Definiert in | Library error; read the nested cause for the real reason |
| Noch einmal versuchen? | Hängt von der verschachtelten Ursache ab |
| Zuerst prüfen | Lesen Sie die innerste Ausnahme: verweigert, Zeitüberschreitung, Namensauflösung oder ein Statuscode |

## Was bedeutet Cannot connect to proxy (ProxyError)?

urllib3 wirft für jeden Fehler, der den Proxy betrifft, einen `ProxyError`, den requests weiterreicht. Die nützlichen Informationen stecken in der verschachtelten Ausnahme, die der Traceback am Ende einer langen Zeile ausgibt.

Node.js-Clients verhalten sich unterschiedlich: sie melden direkt den Socket-Fehler, z.B. `ECONNREFUSED` oder `ETIMEDOUT`, oft ohne zu erläutern, dass die Adresse zum Proxy gehört.

## Wie sieht 'Cannot connect to proxy' in Python, curl, Node.js und Browsern aus?

Der gleiche Fehler wird in jedem Tool anders angezeigt. Hier sind die Meldungen, nach denen Sie in Ihren Logs suchen sollten:

- **Verweigert:** `ProxyError('Unable to connect to proxy', NewConnectionError(... Connection refused))`
- **DNS:** `NameResolutionError(... Failed to resolve ...)` innerhalb von `ProxyError`
- **Anmeldedaten:** `OSError('Tunnel connection failed: 407 Proxy Authentication Required')`
- **Gateway-Fehler:** `OSError('Tunnel connection failed: 502 Bad Gateway')`
- **Node.js:** `Error: connect ECONNREFUSED`, `ETIMEDOUT` oder `ENOTFOUND`, gefolgt von der Proxy-Adresse

## Was verursacht 'Cannot connect to proxy'?

Wahrscheinlich zuerst:

- **Falscher Host oder Port** in der Proxy-URL.
- **Fehlendes Schema**: `host:port` ohne `http://` wird von manchen Bibliotheken unerwartet interpretiert.
- **Blockierter ausgehender Datenverkehr** in Ihrem Netzwerk oder Server.
- **Anmelde- oder Gateway-Fehler**, die während des CONNECT-Schritts auftreten, in derselben Ausnahme gebündelt.
- **Umgebungsvariablen** wie z.B. `HTTPS_PROXY`, die auf einen alten Proxy verweisen und Ihren Code überschreiben.

## Wie diagnostiziere ich 'Cannot connect to proxy' Schritt für Schritt?

1. Drucken Sie die vollständige Ausnahme aus und lesen Sie die letzte verschachtelte Ursache.
2. Drucken Sie `requests.utils.get_environ_proxies(url)` oder die Variablen `HTTP_PROXY`, `HTTPS_PROXY` und `NO_PROXY` aus, um weitere Konfigurationen zu sehen.
3. Führen Sie den unten stehenden curl-Test auf derselben Maschine aus.
4. Ordnen Sie die Ursache der unten stehenden Fehlerliste zu.

*Testen Sie die fehlerhafte URL mit curl (HTTP-Port, ausführlich)*

```bash
# Use the URL that fails; with https://api.ipify.org instead, you test the gateway alone.
# "HTTP/1.1 200 Connection established" first, then the site's own status: the site answered.
curl -v -x http://USERNAME:PASSWORD@gw.crawlrelay.com:7777 https://TARGET_URL

# Same test through the SOCKS5 port, with DNS resolved at the exit
curl -v --socks5-hostname gw.crawlrelay.com:7778 --proxy-user USERNAME:PASSWORD https://TARGET_URL
```

## Wie behebe ich 'Cannot connect to proxy'?

- **Verweigert oder Zeitüberschreitung:** Korrigieren Sie Host und Port, oder erlauben Sie ausgehenden Datenverkehr zum Gateway.
- **Auflösung fehlgeschlagen:** Überprüfen Sie DNS auf der Maschine; testen Sie den Host mit `nslookup`.
- **407:** Korrigieren und URL-kodieren Sie die Anmeldedaten. Siehe [407 Proxy Authentication Required](https://crawlrelay.com/de/docs/errors/407-proxy-authentication-required/).
- **502 oder 504:** Versuchen Sie es mit einem neuen Ausgang. Siehe [502](https://crawlrelay.com/de/docs/errors/502-bad-gateway/) und [504](https://crawlrelay.com/de/docs/errors/504-gateway-timeout/).
- **Unerwünschter Umgebungsproxy:** Setzen Sie `session.trust_env = False` in requests oder löschen Sie die Variablen.

*Python: Bau der Proxy-URL mit kodierten Zugangsdaten*

```python
from urllib.parse import quote

import requests

user = "USERNAME-country-us"
password = "p@ss:word/1"  # example containing special characters

# safe="" also encodes "/", "@" and ":" inside the credentials
proxy = "http://{}:{}@gw.crawlrelay.com:7777".format(
    quote(user, safe=""), quote(password, safe="")
)
proxies = {"http": proxy, "https": proxy}  # http:// for both keys

r = requests.get("https://api.ipify.org", proxies=proxies, timeout=(10, 30))
print(r.status_code, r.text)
```

## Soll ich nach 'Cannot connect to proxy' einen erneuten Versuch starten?

Wiederholen Sie nur Netzwerkebenen-Fehler, die sich ändern können: Timeouts und Gateway-Fehler wie 502 oder 504. Eine verweigerte Verbindung, DNS-Fehler oder ein 407 wiederholt sich, bis Sie die Konfiguration ändern. Behandeln Sie diese daher als schwerwiegende Fehler.

## Wie wirkt sich Cannot connect to proxy (ProxyError) auf CrawlRelay aus?

Für CrawlRelay ist die Proxy-URL `http://USERNAME:PASSWORD@`, gefolgt von dem unten angegebenen Gateway-Host und HTTP-Port, für HTTP- und HTTPS-Ziele gleichermaßen. Verwenden Sie dieselbe `http://`-URL für die `http`- und `https`-Schlüssel in requests: Das Schema gibt das Protokoll an, das zum Proxy gesprochen wird, nicht zur Website.

Gateway: `gw.crawlrelay.com`, Port 7777 (HTTP, HTTPS über CONNECT) und Port 7778 (SOCKS5). Benutzername im Format: `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}`. Verwandt: [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/de/docs/errors/ssl-wrong-version-number/) · [407](https://crawlrelay.com/de/docs/errors/407-proxy-authentication-required/) · [Python-Leitfaden](https://crawlrelay.com/de/docs/python/).

## Cannot connect to proxy (ProxyError): Fragen, die Entwickler stellen

### Was bedeutet 'Max retries exceeded with url' bei einem Proxy?

Es bedeutet, dass urllib3 nach dem Aufbrauchen des Retry-Budgets aufgegeben hat, der eigentliche Grund steht im Teil 'Caused by' der Meldung. Bei einem Proxy ist dieser Teil meist ein ProxyError mit einer verschachtelten Ursache: Verbindung verweigert, Timeout, Namensauflösungsfehler oder ein Tunnelstatus wie 407.

### Warum verwendet requests einen Proxy, den ich nicht konfiguriert habe?

requests liest standardmäßig die Umgebungsvariablen `HTTP_PROXY`, `HTTPS_PROXY` und `NO_PROXY`, und unter Windows auch die Systemeinstellungen für Proxy. Ein übrig gebliebener Wert überschreibt dann Ihre Einstellungen. Setzen Sie `session.trust_env = False` oder übergeben Sie die Proxys explizit bei jeder Anfrage.

### Soll ich http:// oder https:// vor die Proxy-Adresse schreiben?

Schreiben Sie `http://` für einen HTTP-Proxy, selbst wenn die Website HTTPS verwendet. Das Schema beschreibt, wie Ihr Client mit dem Proxy spricht. `https://` bewirkt, dass neuere urllib3-Versionen TLS mit dem Proxy starten, was auf einem einfachen HTTP-Proxy-Port mit einem SSL-Fehler scheitert.

## Weitere Proxy-Fehler in diesem Leitfaden

- [401 Unauthorized vs 407](https://crawlrelay.com/de/docs/errors/401-unauthorized/)
- [403 Forbidden](https://crawlrelay.com/de/docs/errors/403-forbidden/)
- [407 Proxy Authentication Required](https://crawlrelay.com/de/docs/errors/407-proxy-authentication-required/)
- [429 Too Many Requests](https://crawlrelay.com/de/docs/errors/429-too-many-requests/)
- [502 Bad Gateway](https://crawlrelay.com/de/docs/errors/502-bad-gateway/)
- [503 Service Unavailable](https://crawlrelay.com/de/docs/errors/503-service-unavailable/)
- [504 Gateway Timeout](https://crawlrelay.com/de/docs/errors/504-gateway-timeout/)
- [Cannot connect to proxy (ProxyError)](https://crawlrelay.com/de/docs/errors/cannot-connect-to-proxy/)
- [Connection reset by peer (ECONNRESET)](https://crawlrelay.com/de/docs/errors/connection-reset/)
- [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/de/docs/errors/err-proxy-connection-failed/)
- [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/de/docs/errors/err-tunnel-connection-failed/)
- [Read timed out (ReadTimeout)](https://crawlrelay.com/de/docs/errors/read-timeout/)
- [SOCKS5 proxy errors](https://crawlrelay.com/de/docs/errors/socks5-proxy-errors/)
- [SSL: CERTIFICATE_VERIFY_FAILED](https://crawlrelay.com/de/docs/errors/ssl-certificate-verify-failed/)
- [SSL: WRONG_VERSION_NUMBER](https://crawlrelay.com/de/docs/errors/ssl-wrong-version-number/)

**Residential-Proxys mit Dokumentationen, die Fehlerfälle abdecken** CrawlRelay Residential-Proxys von 0,50 $/GB, Traffic, der nie abläuft. [Preise ansehen](https://crawlrelay.com/de/pricing/) · [Schneller Start](https://crawlrelay.com/de/docs/)

---

CrawlRelay: CrawlRelay ist ein entwicklerfreundlicher rotierender Residential-Proxy- und 4G/5G mobile Proxy-Service für Scraper und KI-Datenpipelines: nicht verfallende Pay-as-you-go-Traffic ab 0,50 $/GB, mit Krypto bezahlt, ohne ID-Upload. Kein KYC — keine ID, kein Selfie, keine Dokumente. Mit Krypto bezahlen.