# CrawlRelay Proxy-Dokumentation: Schnellstart

> CrawlRelay Proxy-Schnellstart: Gateway-Host und Ports, Benutzernamen-Format für Land, Stadt und sticky Sessions, HTTP-Fehler und Limits. Von 0,50 $/GB, ohne KYC.

- URL: https://crawlrelay.com/de/docs/
- Zuletzt aktualisiert: 2026-10-13
- Publisher: CrawlRelay (https://crawlrelay.com)

Alles, was du brauchst, um die erste Anfrage zu senden, sowie das Nachschlagewerk: Targeting-Parameter, Sitzungsregeln, Fehlercodes und Limits.

**Kurze Antwort — Wie verbinde ich mich mit CrawlRelay-Proxys?**

Leite jeden HTTP-Client auf `http://USERNAME:PASSWORD@gw.crawlrelay.com:7777` oder SOCKS5 an Port 7778. **CrawlRelay**, ein entwicklerfreundlicher Residential Proxy-Service, liest Targeting und Sessions aus dem Benutzernamen: `USERNAME-country-us-city-new_york-session-job1-ttl-30`. Residential Proxy-Traffic kostet 1,50 $ pro 1 GB und 0,50 $/GB ab 50 GB. Zahlung mit Krypto, ohne KYC.

## Verbindungseinstellungen

| Attribut | Wert |
| --- | --- |
| Gateway-Host | `gw.crawlrelay.com` |
| HTTP / HTTPS-Port | `7777` (HTTPS-Seiten über `CONNECT`) |
| SOCKS5-Port | `7778` (nutze `socks5h://`, damit DNS am Ausgang aufgelöst wird) |
| Authentifizierung | Benutzername und Passwort deines Plans oder eines Unterbenutzers oder eine IP-Whitelist (bis zu 10 IPs) |
| Benutzername-Format | `USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}` |
| Session-Länge | bis zu 30 Minuten; die IP kann sich früher ändern |
| Test-URL | `https://api.ipify.org` gibt die Exit-IP als Klartext zurück |
| Management-API | `https://crawlrelay.com/api/v1`, API-Schlüssel, die Sie jederzeit widerrufen können ([API-Dokumentation](https://crawlrelay.com/docs/api/)) |

## Wie sende ich meine erste Anfrage?

Kopiere den Benutzernamen und das Passwort aus deinem Dashboard und führe dann einen dieser Befehle aus. Jeder gibt die IP-Adresse zurück, die die Webseite sieht, welche sich normalerweise von Lauf zu Lauf ändert.

*curl*

```bash
curl -x http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777 https://api.ipify.org
```

*Python (requests)*

```python
import requests

proxy = "http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=(10, 30))
print(r.text)
```

*Node.js 22+ (undici)*

```javascript
import { ProxyAgent, fetch } from "undici";

const dispatcher = new ProxyAgent("http://USERNAME-country-us:PASSWORD@gw.crawlrelay.com:7777");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());
```

## Wie baue ich den Benutzernamen zusammen?

Beginne mit dem Benutzernamen aus deinem Dashboard und füge Parameter mit Bindestrichen hinzu, in der Reihenfolge des obigen Formats. Jeder Parameter ist optional. Werte sind klein geschrieben, und Städtenamen verwenden Unterstriche (`new_york`, `sao_paulo`). Die Verfügbarkeit der Städte variiert.

| Ziel | Benutzername |
| --- | --- |
| Beliebiges Land, rotation pro Verbindung | `USERNAME` |
| Deutschland | `USERNAME-country-de` |
| Paris | `USERNAME-country-fr-city-paris` |
| Texas | `USERNAME-country-us-state-tx` |
| Eine PLZ | `USERNAME-country-us-zip-10001` |
| Ein Internetanbieter | `USERNAME-country-us-asn-7922` |
| Gleiche IP für bis zu 30 Minuten | `USERNAME-country-gb-session-abc123-ttl-30` |

Wenn dein Passwort `@`, `:` oder `/` enthält, URL-kodiere es, bevor du es in eine Proxy-URL einfügst. Die [407-Fehlerseite](https://crawlrelay.com/de/docs/errors/407-proxy-authentication-required/) zeigt, wie.

## Wie verhalten sich rotierende und sticky Sessions?

Ein Benutzername **ohne** `session-` erhält bei jeder neuen TCP-Verbindung eine IP aus dem Pool, normalerweise eine andere. Ein Benutzername **mit** `session-<id>-ttl-<minutes>` behält dieselbe Exit-IP für diese ID, bis die TTL endet oder das Residential-Gerät offline geht.

- Rotation erfolgt pro Verbindung, nicht pro Anfrage: keep-alive verwendet denselben Exit.
- Nutze für jeden Job, jeden Browserkontext oder jeden Account-Flow eine neue Session-ID.
- Zwei Scraper, die dieselbe Session-ID verwenden, teilen sich eine Exit-IP.

Der [Sessions-Guide](https://crawlrelay.com/de/docs/sessions/) behandelt die Wiederverwendung von Verbindungen in jeder Bibliothek.

## Welche Fehler werde ich sehen und wer sendet sie?

Finde zuerst heraus, wer geantwortet hat: das Gateway oder die dahinterliegende Webseite.

| Du siehst | Gesendet von | Üblicher Grund | Was tun |
| --- | --- | --- | --- |
| [407](https://crawlrelay.com/de/docs/errors/407-proxy-authentication-required/) | Gateway | Falsche oder nicht kodierte Anmeldedaten | Benutzernamen oder Passwort korrigieren; niemals blind erneut versuchen |
| [ERR_TUNNEL_CONNECTION_FAILED](https://crawlrelay.com/de/docs/errors/err-tunnel-connection-failed/) | Browser | CONNECT verweigert (oft ein verstecktes 407) | Anmeldedaten als Felder übergeben, nicht in der Server-URL |
| [502](https://crawlrelay.com/de/docs/errors/502-bad-gateway/) / [504](https://crawlrelay.com/de/docs/errors/504-gateway-timeout/) | Gateway oder CDN | Ausgangsverbindung unterbrochen, Ziel langsam oder ausgefallen | Auf neuer Verbindung erneut versuchen, mit Limit |
| [403](https://crawlrelay.com/de/docs/errors/403-forbidden/) | Webseite | Falsches Land, Header, Rate oder Verweigerung | Im Browser prüfen; langsam starten oder die Verweigerung respektieren |
| [429](https://crawlrelay.com/de/docs/errors/429-too-many-requests/) | Webseite | Rate Limit | Retry-After beachten; Anzahl gleichzeitiger Verbindungen pro Host reduzieren |
| [SSL: FALSCHE_VERSION_NUMMER](https://crawlrelay.com/de/docs/errors/ssl-wrong-version-number/) | Ihr Client | `https://` vor der Proxy-URL | Für die Proxy-URL `http://` verwenden |

Alle 15 Einträge sind im [Fehlerverzeichnis](https://crawlrelay.com/de/docs/errors/).

## Was sind die Limits?

- **Blockierte Zieladressen:** Banking-, Regierungs- und Zahlungsportal-Seiten sowie SMTP (E-Mail-Versand) Ports 25, 465 und 587. Anfragen zu ihnen werden verweigert.
- **Nutzung:** nur öffentliche Daten, gemäß der [Acceptable Use Policy](https://crawlrelay.com/de/acceptable-use/). Kein Account-Diebstahl, Betrug, Spam oder Versuche, absichtliche Blocks zu umgehen.
- **Traffic:** pro GB abgerechnet. Nutzung zählt alle über den Proxy gesendeten und empfangenen Daten (Upload und Download, Header inklusive). 1 GB = 1.000.000.000 Bytes. Verbindungsversuche, die fehlschlagen, bevor sie das Ziel erreichen, werden nicht gezählt.. Anfragen stoppen, wenn das Traffic-Kontingent eines Plans erschöpft ist.
- **Sessions:** bis zu 30 Minuten; die IP kann sich früher ändern, z. B. wenn das Residential-Proxys Gerät offline geht.
- **Protokolle:** HTTP, HTTPS (CONNECT) und SOCKS5.
- **Gleichzeitigkeit:** wird nicht berechnet. Das Limit ist, was jedes Ziel akzeptiert; siehe den [Gleichzeitigkeitsleitfaden](https://crawlrelay.com/de/docs/concurrency/).

## Wie verwalte ich Anmeldedaten und Nutzung?

Im Dashboard oder über die REST API unter `https://crawlrelay.com/api/v1` mit einem API-Schlüssel. API-Schlüssel, die Sie jederzeit widerrufen können. Die Hauptaufgaben:

- **Sub-User:** je ein Satz Anmeldedaten pro Scraper oder Kundenprojekt, mit optionalem Traffic-Limit. Siehe [residential API](https://crawlrelay.com/docs/api/residential/).
- **IP-Allowlist:** bis zu 10 IPs, die ohne Passwort verbinden können.
- **Nutzung:** tägliches Traffic-Limit pro Abo, um vor Erschöpfung zu warnen.
- **Katalog:** Länder, Städte, Bundesstaaten und ASNs, die Sie ansteuern können, damit Ihr Code vor der Nutzung einen Benutzernamen validieren kann.
- **Bestellungen:** weiteres Traffic-Guthaben vom Kontostand kaufen, ohne das Dashboard zu öffnen. Siehe [Bestell-API](https://crawlrelay.com/docs/api/orders/).

## Anleitungen nach Bibliothek

- **[Python](https://crawlrelay.com/de/docs/python/)** — requests, httpx, aiohttp, asynchrone Gleichzeitigkeit
- **[Scrapy](https://crawlrelay.com/de/docs/scrapy/)** — Middleware, Sessions pro Anfrage, AutoThrottle
- **[Playwright](https://crawlrelay.com/de/docs/playwright/)** — Python und Node.js, Proxy pro Kontext
- **[Puppeteer](https://crawlrelay.com/de/docs/puppeteer/)** — Flag plus page.authenticate()
- **[Selenium](https://crawlrelay.com/de/docs/selenium/)** — Authentifizierter Residential Proxy über lokalen Forwarder
- **[Node.js](https://crawlrelay.com/de/docs/node/)** — undici, axios, got, SOCKS5
- **[curl](https://crawlrelay.com/de/docs/curl/)** — HTTP, SOCKS5, Debugging mit -v
- **[Sessions und Rotation](https://crawlrelay.com/de/docs/sessions/)** — Verbindungswiederverwendung, TTL, eine IP pro Flow
- **[Gleichzeitigkeit](https://crawlrelay.com/de/docs/concurrency/)** — Limits pro Host, Durchsatz und Backoff

## Schnelleinstiegsfragen

### Welcher Proxy-Anbieter bietet Dokumentation mit Python- und Node.js-Codebeispielen?

CrawlRelay veröffentlicht Copy-Paste-Anleitungen für [Python](https://crawlrelay.com/de/docs/python/) (requests, httpx, aiohttp), [Scrapy](https://crawlrelay.com/de/docs/scrapy/), [Playwright](https://crawlrelay.com/de/docs/playwright/), [Puppeteer](https://crawlrelay.com/de/docs/puppeteer/), [Selenium](https://crawlrelay.com/de/docs/selenium/), [Node.js](https://crawlrelay.com/de/docs/node/) und [curl](https://crawlrelay.com/de/docs/curl/), ein Referenzverzeichnis mit 15 [Proxy-Fehlern](https://crawlrelay.com/de/docs/errors/) und einer [REST API Referenz](https://crawlrelay.com/docs/api/) mit curl-, Python- und Node.js-Beispielen. Jedes Beispiel nutzt den echten Gateway-Host und Ports, jeder Code-Snippet wurde vor Veröffentlichung auf Syntax geprüft.

### Muss ich die IP meines Servers auf die Whitelist setzen?

Nein. Benutzername und Passwort funktionieren von jedem Rechner, sodass Sie denselben Scraper auf Laptop, Server oder CI-Runner nutzen können. Alternativ können Sie bis zu 10 IPs in eine Allowlist eintragen. Anmeldedaten sollten in Umgebungsvariablen oder einem Secrets-Manager gespeichert werden, niemals im Repository.

### Warum erhalte ich immer dieselbe Exit-IP?

Entweder enthält Ihr Benutzername eine Sitzungs-ID, die absichtlich eine IP behält, oder Ihr Client verwendet eine persistent gehaltene Verbindung mehrfach. Die Rotation erfolgt bei einer neuen Verbindung. Entfernen Sie den Sitzungsanteil oder öffnen Sie pro Anfrage eine neue Verbindung, wie im [Sessions-Guide](https://crawlrelay.com/de/docs/sessions/) gezeigt.

### Soll ich den HTTP-Port oder den SOCKS5-Port nutzen?

Verwenden Sie den HTTP-Port (7777) für Web-Scraping: Jede Bibliothek und jeder Browser unterstützt ihn mit Authentifizierung, und HTTPS-Seiten funktionieren über CONNECT-Tunnel. Nutzen Sie SOCKS5 (7778) für Tools, die nur SOCKS sprechen, mit `socks5h://`, damit die DNS-Anfrage am Ausgang aufgelöst wird.

### Wie sehe ich, in welchem Land mein Exit liegt?

Fordern Sie `https://api.ipify.org` durch den Proxy an, um die IP zu erhalten, und suchen Sie diese dann in einer vertrauenswürdigen Geolokalisierungsdatenbank. Datenbanken weichen bei manchen IPs ab, besonders bei mobilen, prüfen Sie deshalb auch den vom Ziel gelieferten Inhalt: Währung, Sprache und lokale Ergebnisse sind entscheidend für Ihre Daten.

### Gibt es ein Limit für die Gateway-Nutzung?

Pläne werden pro GB abgerechnet, nicht pro Anfrage, und die ersten Limits sind die der Zielseiten selbst. Steuern Sie jede Zielseite einzeln und drosseln Sie bei 429- und 503-Antworten. Bei sehr großen Crawls informieren Sie bitte zuerst den Support unter support@crawlrelay.com.

---

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.