# net::ERR_TUNNEL_CONNECTION_FAILED mit Proxy: Ursachen und Lösungen

> net::ERR_TUNNEL_CONNECTION_FAILED mit Proxy in Chrome, Playwright oder Puppeteer: Der CONNECT-Tunnel ist fehlgeschlagen. Finden Sie den versteckten Status und beheben Sie das Problem.

- URL: https://crawlrelay.com/de/docs/errors/err-tunnel-connection-failed/
- Zuletzt aktualisiert: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Chromium-Netzwerkfehler: die genaue Meldung in jedem Tool, wahrscheinliche Ursachen in Reihenfolge und die Lösung, die funktioniert.

**Kurze Antwort — Was bedeutet ERR_TUNNEL_CONNECTION_FAILED bei einem Proxy?**

**net::ERR_TUNNEL_CONNECTION_FAILED** bedeutet, Chrome hat den Proxy gebeten, einen Tunnel zu einer HTTPS-Seite zu öffnen, und der Proxy hat nicht mit `200 Connection established` geantwortet. Der Browser verbirgt den echten Status. Bei CrawlRelay residential Proxies liegt die Ursache meist an fehlenden Zugangsdaten in Playwright oder Puppeteer, danach an einem Ziel, das das Gateway nicht erreicht. Reproduzieren Sie mit `curl -v`, um den echten Code zu sehen.

## ERR_TUNNEL_CONNECTION_FAILED auf einen Blick

| Attribut | Wert |
| --- | --- |
| Fehler | ERR_TUNNEL_CONNECTION_FAILED |
| Typ | Chromium-Netzwerkfehler |
| Gesendet von | Ihr Browser, nachdem der Proxy die CONNECT-Anfrage abgelehnt oder nicht erfüllt hat |
| Definiert in | CONNECT method: RFC 9110, section 9.3.6 |
| Noch einmal versuchen? | Erst den dahinterliegenden Status herausfinden |
| Zuerst prüfen | Mit curl -v reproduzieren, um den echten CONNECT-Status zu sehen |

## Was bedeutet ERR_TUNNEL_CONNECTION_FAILED?

Um eine HTTPS-Seite durch einen HTTP-Proxy zu laden, sendet der Browser zuerst `CONNECT host:443`. Antwortet der Proxy mit 200, startet der Browser TLS im Tunnel. Jede andere Antwort, z. B. 407, 403 oder 502, beendet den Versuch und Chromium zeigt einen generischen Fehler.

Deshalb sagt dieser Fehler, wo der Fehler lag, im Tunnel, aber nicht warum. Das Warum ist der vom Proxy gesendete Statuscode, den Sie mit curl sehen können.

## Wie sieht ERR_TUNNEL_CONNECTION_FAILED 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:

- **Playwright:** `page.goto: net::ERR_TUNNEL_CONNECTION_FAILED at https://...`
- **Puppeteer:** `Error: net::ERR_TUNNEL_CONNECTION_FAILED at https://...`
- **Chrome-Adressleiste:** 'Diese Seite ist nicht erreichbar' mit dem Code `ERR_TUNNEL_CONNECTION_FAILED`
- **Selenium mit Chrome:** derselbe Code in einem `WebDriverException`

## Was verursacht ERR_TUNNEL_CONNECTION_FAILED?

Wahrscheinlich zuerst:

- **Keine Anmeldedaten gesendet** (versteckter 407). Chrome ignoriert Benutzername und Passwort in `--proxy-server`.
- **Ein verweigertes Ziel** (versteckter 403), z. B. eine durch die Proxy-Nutzungsrichtlinie gesperrte Kategorie.
- **Ein unerreichbares Ziel** (versteckter 502 oder 504): ein toter Host, ein Tippfehler oder ein DNS-Fehler am Ausgang.
- **Ein falscher Port**: den Browser auf den SOCKS5-Port statt auf HTTP zeigen lassen oder umgekehrt.

## Wie diagnostiziere ich ERR_TUNNEL_CONNECTION_FAILED Schritt für Schritt?

1. Führen Sie dieselbe URL mit curl und `-v` aus (Befehl unten) und lesen Sie die Zeile nach `CONNECT`.
2. Ein `407` bedeutet Anmeldedaten; ein `403` bedeutet verweigertes Ziel; ein `502` oder `504` bedeutet das Ziel oder den Ausgang.
3. Bestätigen Sie, dass der Browser den HTTP-Port für einen `http://` Proxy-Server verwendet.
4. Testen Sie eine einfache Seite wie `https://api.ipify.org` vor Ihrem eigentlichen Ziel.

*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 ERR_TUNNEL_CONNECTION_FAILED?

- **Playwright:** übergeben Sie `server`, `username` und `password` in der `proxy`-Option, pro Browser oder Kontext. Siehe den [Playwright-Leitfaden](https://crawlrelay.com/de/docs/playwright/).
- **Puppeteer:** starten Sie mit `--proxy-server=http://host:port` und rufen Sie vor dem ersten `goto` `page.authenticate()` auf. Siehe den [Puppeteer-Leitfaden](https://crawlrelay.com/de/docs/puppeteer/).
- **Selenium:** führen Sie einen kleinen lokalen Forwarder aus, der die Anmeldedaten hinzufügt. Siehe den [Selenium-Leitfaden](https://crawlrelay.com/de/docs/selenium/).
- **Überprüfen Sie das Ziel** anhand unserer [Akzeptablen Nutzungsrichtlinie](https://crawlrelay.com/de/acceptable-use/).

*Playwright (Python): Zugangsdaten als separate Felder*

```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(proxy={
        "server": "http://gw.crawlrelay.com:7777",
        "username": "USERNAME-country-us",
        "password": "PASSWORD",
    })
    page = browser.new_page()
    response = page.goto("https://api.ipify.org")
    print(response.status, page.inner_text("body"))
    browser.close()
```

## Soll ich nach ERR_TUNNEL_CONNECTION_FAILED einen erneuten Versuch starten?

Wiederholen Sie nur, wenn Sie den versteckten Status kennen. Ein versteckter 407 oder 403 wird endlos wiederholt; beheben Sie die Konfiguration. Ein versteckter 502 oder 504 kann bei einem neuen Ausgang erneut versucht werden, wie jeder Gateway-Fehler.

## Wie wirkt sich ERR_TUNNEL_CONNECTION_FAILED auf CrawlRelay aus?

CrawlRelays HTTP-Port leitet HTTPS durch `CONNECT`-Tunnel weiter, die jedes Chromium-basierte Tool unterstützt. Verwenden Sie den HTTP-Port für Browser: Chromium unterstützt SOCKS5 nicht mit Benutzername und Passwort.

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: [407 Proxy Authentication Required](https://crawlrelay.com/de/docs/errors/407-proxy-authentication-required/) · [ERR_PROXY_CONNECTION_FAILED](https://crawlrelay.com/de/docs/errors/err-proxy-connection-failed/) · [Playwright-Leitfaden](https://crawlrelay.com/de/docs/playwright/).

## ERR_TUNNEL_CONNECTION_FAILED: Fragen, die Entwickler stellen

### Warum funktioniert curl, aber Playwright zeigt ERR_TUNNEL_CONNECTION_FAILED an?

Weil curl die Anmeldedaten aus der Proxy-URL sendet, während Chromium Anmeldedaten, die in der Proxy-Server-Adresse stehen, ignoriert. In Playwright übergeben Sie `username` und `password` als separate Felder der `proxy`-Option. In Puppeteer rufen Sie vor der ersten Navigation `page.authenticate()` auf.

### Kann ich SOCKS5-Proxys mit Authentifizierung in Chrome verwenden?

Nicht direkt. Chromium unterstützt SOCKS5-Proxys, aber keine SOCKS5-Authentifizierung mit Benutzername und Passwort. Verwenden Sie stattdessen den HTTP-Port des Gateways, der HTTPS-Sites durch CONNECT-Tunnel verarbeitet, oder betreiben Sie einen lokalen Forwarder, der für den Browser authentifiziert.

### Wird ERR_TUNNEL_CONNECTION_FAILED durch die Webseite verursacht?

Selten direkt. Der Tunnel besteht zwischen Browser und Proxy, daher tritt der Fehler auf, bevor die Webseite einen TLS-Handshake sieht. Die Webseite kann indirekt Ursache sein, wenn sie nicht erreichbar ist und der Proxy mit 502 oder 504 auf die CONNECT-Anfrage antwortet.

## 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.