# Proxy-Port

> URL: https://foura.ai/de/docs/api/proxy-port
> Updated: 2026-10-15
> Index: https://foura.ai/llms.txt

Sende deinen eigenen Traffic über die Exits von FourA, und zwar von jedem Client, der eine Proxy-URL unterstützt: einem Browser, einem Download-Tool oder einem Scraper, den du bereits betreibst. Der Proxy-Port öffnet einen Tunnel zum angegebenen Ziel und überträgt Bytes in beide Richtungen. Er verarbeitet somit auch das, was die JSON-API nicht abdeckt: Streams, große Downloads und komplette Browser-Sessions.

## Verbindungsaufbau

| Setting | Value |
|---------|-------|
| Host | `proxy.foura.ai` |
| Port | `34004` |
| Protocol | HTTP CONNECT mit Basic authentication |
| Target ports | `443` und `80` |

Zugangsdaten erhältst du im Dashboard. Erstelle einen Proxy-User unter **Proxy** in der Seitenleiste, um einen generierten Benutzernamen und ein Passwort zu erhalten. Diese sind bewusst von deinem API-Key getrennt: Ein Proxy-Handshake wird bei jeder Verbindung im Klartext übertragen, und ein Proxy-User lässt sich rotieren, ohne deine API-Integration zu ändern. Siehe [Proxy-User](https://foura.ai/docs/dashboard/proxy).

```bash
curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 https://example.com
```

```python
import requests

proxy = "http://USERNAME:PASSWORD@proxy.foura.ai:34004"
r = requests.get("https://example.com", proxies={"https": proxy, "http": proxy})
print(r.status_code)
```

Der Port akzeptiert ausschließlich CONNECT. Ein `https://`-Ziel wird von jedem Client getunnelt. Ein einfaches `http://`-Ziel funktioniert, wenn dein Client es ebenfalls tunnelt (curl: `--proxytunnel`); ein Client, der den Plain-Request stattdessen an den Proxy weiterleitet, erhält `405 Method Not Allowed`.

## Optionen im Benutzernamen

Alles nach den Zugangsdaten ist eine Liste von `-key-value`-Paaren in beliebiger Reihenfolge:

```
USERNAME-network-premium-country-de-session-a1
```

Werte sind Wörter in Kleinbuchstaben. Ein Bindestrich innerhalb eines Werts startet eine neue Option, daher wird `-city-new-york` als zwei Optionen interpretiert und abgelehnt. Ein unbekannter Schlüssel wird ebenfalls abgelehnt und nie ignoriert: Ein falsch geschriebenes `-contry-de` führt zu einem 400-Fehler, der die unterstützten Schlüssel nennt, anstatt die Anfrage über das falsche Land zu leiten.

| Option | Werte | Funktion |
|--------|--------|--------------|
| `network` | `shared` (Standard, Alias `pool`), `premium` (Alias `residential`) | Aus welchem Netzwerk die Adresse stammt. Shared umfasst FourAs eigene Exits, die in deinem Tarif enthalten sind. Premium sind private IP-Adressen (Home-Adressen), die über das in deinem Tarif enthaltene Premium-Datenvolumen sowie zugekauftes Volumen bereitgestellt werden. |
| `fallback` | `premium` (Alias `residential`), `off` | Nur Shared-Netzwerk. Nutzt einen Premium-Exit, wenn das Shared-Netzwerk den Request nicht verarbeiten kann. Standardmäßig inaktiv. Greift nur, wenn dein Tarif Premium-Datenvolumen enthält und noch Guthaben vorhanden ist. |
| `country` | ISO 3166-1 Alpha-2, wiederholbar | Das für das Ziel sichtbare Exit-Land. Wiederhole es für einen Bereich über mehrere Länder: `-country-de-country-fr`. |
| `session` | 1 bis 32 Buchstaben, Ziffern oder Unterstriche | Verbindungen mit demselben Namen teilen sich eine Adresse (Sticky). Lass ihn weg für eine neue Adresse pro Verbindung (Rotating). |
| `state` | ein Wort | Region. Nur Premium. |
| `city` | ein Wort | Stadt. Nur Premium. |
| `asn` | eine Zahl | Netzwerk nach AS-Nummer. Nur Premium. |
| `os` | `windows`, `android`, `ios`, `mac` | Der Gerätetyp, zu dem die Adresse gehört. Nur Premium. |
| `lifetime` | `3` bis `1440` | Haltedauer einer Sticky-Premium-Adresse in Minuten. Nur Premium. |

Jede Option außer `network`, `fallback` und `session` akzeptiert `any`, wodurch ein für den Proxy-Benutzer gespeicherter Wert für diese einzelne Verbindung gelöscht wird.

Drei Kombinationen werden mit einem 400-Fehler abgelehnt, anstatt teilweise angewendet zu werden:

- `state`, `city`, `asn`, `os` oder `lifetime` im Shared-Netzwerk. Das Shared-Netzwerk wird maximal nach Land ausgewählt, nicht genauer. Füge `-network-premium` hinzu, um eine Stadt als Ziel zu wählen.
- `-fallback-premium` zusammen mit `-network-premium`. Ein Fallback ist auf dem Netzwerk, auf das zurückgegriffen wird, wirkungslos.
- Genaueres Targeting bei aktivem Fallback. Da ein Fallback nicht zwingend greift, wird eine Stadtangabe abgelehnt, die nur manchmal berücksichtigt werden könnte.

### Sessions

Im Shared-Netzwerk behält eine benannte Session denselben Exit, solange du sie aktiv nutzt, basierend auf einem gleitenden 10-Minuten-Fenster. Wenn dieser Exit nicht mehr funktioniert, wechselt die Session zu einem anderen, anstatt fehlzuschlagen. Ein über den Port gesteuerter Browser sollte immer einen Session-Namen nutzen: Ein Seitenaufruf öffnet Dutzende Verbindungen, und ohne Session nutzt jede Verbindung eine andere Adresse.

Im Premium-Netzwerk behält eine benannte Session ihre Adresse für `lifetime` Minuten oder nutzt den Netzwerk-Standard, falls du keine Dauer festlegst.

### Gespeicherte Standardwerte

Das im Dashboard für einen Proxy-Benutzer gespeicherte Targeting gilt für jede damit hergestellte Verbindung, sodass der Username kurz bleiben kann. Alle Angaben im Username haben für diese eine Verbindung Vorrang, und `any` setzt einen gespeicherten Wert zurück. Ein gespeicherter Premium-Standard verbraucht nur Guthaben, wenn dein Plan dies erlaubt; andernfalls wird die Verbindung über das geteilte Netzwerk bereitgestellt und der Tunnel öffnet sich trotzdem.

### CONNECT-Header

Ein Client, der Header zum CONNECT-Request hinzufügen kann, darf dieselben Optionen als Header senden. Ein Header hat Vorrang vor derselben Option im Username.

| Header | Entspricht |
|--------|---------|
| `X-Foura-Network` | `-network-` |
| `X-Foura-Fallback` | `-fallback-` (`premium` oder `off`) |
| `X-Foura-Country` | `-country-`, kommagetrennt für mehrere |
| `X-Foura-Session` | `-session-` |
| `X-Foura-State` | `-state-` |
| `X-Foura-City` | `-city-` |
| `X-Foura-Asn` | `-asn-` |
| `X-Foura-Lifetime` | `-lifetime-` |

```bash
curl -x http://USERNAME:PASSWORD@proxy.foura.ai:34004 \
  --proxy-header "X-Foura-Country: de" \
  https://example.com
```

## Responses

Ein erfolgreich geöffneter Tunnel antwortet mit `200 Connection established`. Jede Ablehnung nach Prüfung deiner Anmeldedaten enthält einen `X-Foura-Error`-Header mit einer einzeiligen Begründung. Lies daher zuerst diesen Header.

| Status | Wann |
|--------|------|
| 400 Bad Request | Ein fehlerhafter Request oder eine Option, die FourA nicht unterstützt. `X-Foura-Error` nennt die Option und die unterstützten Werte. |
| 403 Forbidden | Der Ziel-Port wird nicht bedient, das Ziel ist kein öffentlicher Internet-Host, der Port ist nicht in deinem Plan enthalten oder du hast `-network-premium` angegeben und dein Plan hat keinen Premium-Traffic mehr oder enthält das Premium-Netzwerk nicht. |
| 405 Method Not Allowed | Ein normaler Request statt CONNECT. |
| 407 Proxy Authentication Required | Fehlende oder falsche Anmeldedaten. Die Antwort gibt nie an, welcher Teil falsch war. |
| 408 Request Timeout | Der Client hat sich verbunden und 15 Sekunden lang nichts gesendet. |
| 431 Request Header Fields Too Large | Die Header des CONNECT-Requests waren größer als 16 KB. |
| 429 Too Many Requests | Ein Limit deines Plans wurde erreicht: gleichzeitig offene Tunnel, Tunnelöffnungen pro Minute oder der Standard-Traffic für diesen Abrechnungszeitraum. Gilt auch, wenn der Port selbst seine Kapazität oder Öffnungsrate erreicht hat. `X-Foura-Error` gibt an, welches Limit zutrifft. |
| 502 Bad Gateway | Innerhalb des Auswahlbudgets wurde kein funktionierender Exit für dieses Ziel gefunden oder der eigene Resolver von FourA konnte den Host nicht auflösen. Beides sind unterschiedliche Meldungen in `X-Foura-Error`. |
| 503 Service Unavailable | Der Proxy-Port ist deaktiviert. |

## Limits

- Gleichzeitig offene Tunnel und Tunnelöffnungen pro Minute hängen von deinem Plan ab. Sie werden für den gesamten Account gezählt und nicht pro Proxy-Nutzer: Ein zweiter Satz Anmeldedaten erhöht das Kontingent nicht. Deine Limits findest du unter [Usage & Limits](https://foura.ai/docs/dashboard/quota).
- Die Suche nach einem Exit dauert bis zu 45 Sekunden, bevor der Port mit einem 502 abbricht. Eine Session mit einem bereits vorhandenen Exit verbindet sich meist in deutlich unter einer Sekunde.
- Ein Tunnel ohne Datenverkehr in beide Richtungen wird nach zwei inaktiven Minuten geschlossen.
- Bei Updates des Ports haben bereits geöffnete Tunnel knapp drei Minuten Zeit zum Beenden und werden danach geschlossen, während neue Verbindungen weiterhin geöffnet werden. Bei langen Downloads oder Streams solltest du dich nach dem Schließen des Tunnels neu verbinden.
- Ein im Dashboard deaktivierter oder gelöschter Proxy-Nutzer verliert die Authentifizierung innerhalb einer Minute.

## Messung

Bytes über den Port zählen zum Datenvolumen auf deiner [Usage & Limits](https://foura.ai/docs/dashboard/quota)-Seite. Bytes über einen Premium-Exit zählen zusätzlich zu deinem Premium-Traffic: dieselben Bytes, zweimal erfasst, nie addiert. Öffnet sich ein Tunnel, zählt auch der Traffic von Premium-Exits, die der Port versucht, aber nicht genutzt hat, als Premium-Traffic. Nicht genutzte Versuche im Shared-Netzwerk werden nicht gezählt. Wenn sich kein Tunnel öffnet, wird nichts erfasst.

Der Standard-Traffic, den der Port nutzen darf, richtet sich nach deinem Tarif. Bei einem Tarif auf Credit-Basis verfügt der Port über eigene enthaltene Gigabyte, und über die Billing-Seite kannst du weitere hinzukaufen; bei einem Tarif nach Datenvolumen nutzt er denselben Pool wie die API. Wenn dieser aufgebraucht ist, werden neue Verbindungen abgelehnt, bis der Abrechnungszeitraum zurückgesetzt wird oder du mehr hinzufügst. Die Nutzungs-E-Mails informieren dich darüber, wann das der Fall ist.

Sobald das Premium-Kontingent aufgebraucht ist, werden die drei Zugangswege zu diesem Netzwerk bewusst unterschiedlich behandelt. Eine Verbindung, die `-network-premium` angibt, wird mit einem 403-Fehler abgewiesen, da ein Aufrufer, der explizit Kontingent verbrauchen wollte und stattdessen stillschweigend von woanders bedient wird, weiterhin Anfragen senden und eine Premium-Leistung verbuchen würde, die nie erbracht wurde. Ein Fallback wird nicht ausgelöst, und ein für den Proxy-Benutzer gespeicherter Premium-Standardwert wird auf das Shared Network herabgestuft, wodurch der Tunnel weiterhin geöffnet wird: In keinem dieser beiden Fälle wurde entschieden, für diese Verbindung zusätzliches Kontingent auszugeben.

## Verwandte Themen

- [Proxy-Benutzer](https://foura.ai/docs/dashboard/proxy): Erstelle Proxy-Benutzer und generiere einen Connection-String im Dashboard
- [Proxy-Request](https://foura.ai/docs/api/endpoints#proxy-request): Die JSON-API-Alternative mit integrierten Retries und Validierung
- [Einen Proxy über Requests hinweg wiederverwenden](https://foura.ai/docs/how-to/reuse-a-proxy): Einen Exit-Node in der JSON-API beibehalten
- [Nutzung und Limits](https://foura.ai/docs/dashboard/quota): Bandbreite und Premium-Traffic im Rahmen deines Tarifs