Proxy-Port

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

Beta. Der Proxy-Port befindet sich in der Beta-Phase. Traffic darüber wird noch nicht abgerechnet, ist nicht durch Monitoring oder ein Uptime-Versprechen abgedeckt und Optionsnamen können sich noch ändern. Sag uns Bescheid, wenn etwas nicht funktioniert.

Verbindungsaufbau

Einstellung	Wert
Host	`proxy.foura.ai`
Port	`34004`
Protokoll	HTTP CONNECT mit Basic Authentication
Ziel-Ports	`443` und `80`

Zugangsdaten erhältst du im Dashboard. Erstelle einen Proxy-Benutzer 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 unverschlüsselt übertragen, und ein Proxy-Benutzer lässt sich rotieren, ohne deine API-Integration anzupassen. Siehe Proxy Users.

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

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 einfachen Request stattdessen an den Proxy weiterleitet, erhält 405 Method Not Allowed.

Optionen werden im Benutzernamen übergeben

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

USERNAME-network-residential-country-de-session-a1

Werte sind kleingeschriebene Wörter. Ein Bindestrich innerhalb eines Werts startet eine neue Option, daher wird -city-new-york als zwei Optionen gelesen und abgelehnt. Ein unbekannter Schlüssel wird ebenfalls abgelehnt und nie ignoriert: Ein falsch geschriebener -contry-de wird als 400 zurückgegeben, der die unterstützten Schlüssel nennt, anstatt aus dem falschen Land bedient zu werden.

Option	Werte	Funktion
`network`	`shared` (Standard, Alias `pool`), `residential`	Aus welchem Netzwerk die Adresse stammt. Shared sind die eigenen Exits von FourA, die in deinem Plan enthalten sind. Residential sind private IP-Adressen, die aus dem in deinem Plan enthaltenen Premium-Traffic plus zusätzlich gekauftem Traffic stammen.
`fallback`	`residential`, `off`	Nur Shared-Netzwerk. Nutzt einen Residential-Exit, wenn das Shared-Netzwerk den Request nicht ausführen kann. Standardmäßig deaktiviert, greift nur, wenn dein Plan Premium-Traffic enthält und Kontingent übrig ist.
`country`	ISO 3166-1 alpha-2, wiederholbar	Das Exit-Land, das das Ziel sieht. Wiederhole es für einen Multi-Country-Scope: `-country-de-country-fr`.
`session`	1 bis 32 Buchstaben, Ziffern oder Unterstriche	Verbindungen mit demselben Namen teilen sich eine Adresse (sticky). Weglassen für eine neue Adresse pro Verbindung (rotating).
`state`	ein Wort	Region. Nur Residential.
`city`	ein Wort	Stadt. Nur Residential.
`asn`	eine Zahl	Netzwerk nach AS-Nummer. Nur Residential.
`os`	`windows`, `android`, `ios`, `mac`	Der Gerätetyp, zu dem die Adresse gehört. Nur Residential.
`lifetime`	`3` bis `1440`	Minuten, die eine Sticky-Residential-Adresse gehalten wird. Nur Residential.

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

Drei Kombinationen werden mit einem 400-Fehler abgelehnt, statt teilweise ausgeführt zu werden:

state, city, asn, os oder lifetime im Shared-Netzwerk. Das Shared-Netzwerk wird nach Land ausgewählt und nicht genauer; füge -network-residential hinzu, um eine Stadt auszuwählen.
-fallback-residential zusammen mit -network-residential. Ein Fallback ist auf dem Netzwerk, auf das er zurückfällt, wirkungslos.
Genaueres Targeting bei aktivem Fallback. Da ein Fallback eintreten kann oder nicht, wird eine Stadt abgelehnt, die nur manchmal berücksichtigt werden könnte.

Sessions

Im Shared-Netzwerk behält eine benannte Session denselben Exit so lange, wie du sie nutzt, basierend auf einem gleitenden Zehn-Minuten-Fenster. Falls dieser Exit ausfällt, wechselt die Session zu einem anderen, statt fehlzuschlagen. Ein Browser, der über den Port gesteuert wird, sollte immer einen Session-Namen nutzen: Ein Seitenaufruf öffnet Dutzende Verbindungen, und ohne Session stammt jede von einer anderen Adresse.

Im Residential-Netzwerk behält eine benannte Session ihre Adresse für lifetime Minuten oder den Standardwert des Netzwerks, wenn du keinen festlegst.

Gespeicherte Standardwerte

Targeting, das im Dashboard für einen Proxy-Benutzer gespeichert ist, gilt für jede Verbindung, die damit hergestellt wird. Dadurch kann der Benutzername kurz bleiben. Jeder Wert, den du im Benutzernamen angibst, hat Vorrang für diese eine Verbindung, und any setzt einen gespeicherten Wert zurück. Ein gespeicherter Residential-Standardwert verbraucht Guthaben nur dann, wenn dein Tarif dies erlaubt. Andernfalls wird die Verbindung über das geteilte Netzwerk bereitgestellt.

CONNECT-Header

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

Header	Entspricht
`X-Foura-Network`	`-network-`
`X-Foura-Fallback`	`-fallback-` (`residential` 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-`

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

Responses

Ein Tunnel, der sich öffnet, antwortet mit 200 Connection established. Jede Ablehnung enthält einen X-Foura-Error-Header mit einer einzeiligen Begründung. Lies diesen Header daher zuerst aus.

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 Zielport wird nicht bedient oder das Ziel ist kein öffentlicher Internet-Host.
405 Method Not Allowed	Ein einfacher Request anstelle von CONNECT.
407 Proxy Authentication Required	Fehlende oder falsche Zugangsdaten. Die Antwort gibt nie an, welcher Teil falsch war.
408 Request Timeout	Der Client hat sich verbunden und 15 Sekunden lang nichts gesendet.
429 Too Many Requests	Der Proxy-Benutzer hat bereits 200 offene Tunnel oder der Port hat seine Kapazität oder Öffnungsrate erreicht.
502 Bad Gateway	Innerhalb des Auswahlbudgets wurde kein funktionierender Exit für dieses Ziel gefunden oder der 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

Bis zu 200 gleichzeitig geöffnete Tunnel pro Proxy-Benutzer.
Die Suche nach einem Exit dauert bis zu 45 Sekunden, bevor der Port mit 502 abbricht. Eine Session mit bestehendem Exit verbindet sich meist in deutlich unter einer Sekunde.
Ein Tunnel ohne Datenverkehr in beide Richtungen wird nach zwei Minuten Inaktivität geschlossen.
Ein Proxy-Benutzer, den du im Dashboard deaktivierst oder löschst, authentifiziert sich innerhalb einer Minute nicht mehr.

Abrechnung

Bytes über den Port zählen zum Datenvolumen auf deiner Seite Nutzung & Limits, und Bytes über einen Residential-Exit zählen zusätzlich zu deinem Premium-Traffic. Eine Verbindung, die -network-residential angibt, nachdem das Premium-Kontingent aufgebraucht ist, wird trotzdem bedient. Ein Fallback oder ein gespeicherter Residential-Standard wird in diesem Zustand nicht genutzt, stattdessen übernimmt das Shared-Netzwerk die Verbindung.