Dokumentation

Proxy-Nutzung

Ein Endpunkt, drei Protokolle. Steuerung über den Benutzernamen.

Endpunkt

Host:      proxy.proxinity.one
Port:      8000
Protokolle HTTP-Proxy · HTTP CONNECT (HTTPS) · SOCKS5 (Benutzername/Passwort)
Ziele      TCP 80 und 443

Benutzername

px_<id>[-pool-dc][-country-<cc>][-city-<name>][-asn-<nr>][-session-<id>][-sessttl-<minuten>]
  • pool-dc – Rechenzentrums-/IPv6-Pool statt Residential (eigener, günstigerer GB-Preis). Ohne Angabe: Residential.
  • country-de – Exit-Node in Deutschland (ISO-3166-Code). Nur verfügbare Länder funktionieren; erlaubte Länder des Zugangs werden durchgesetzt.
  • city-berlin – Stadt (Kleinbuchstaben, Umlaute als ae/oe/ue, Leerzeichen als _ – z. B. city-frankfurt_am_main). Verfügbare Städte: Dashboard → Länder & Targeting oder GET /v1/targets.
  • asn-3320 – Internetanbieter (Autonomous System), z. B. Deutsche Telekom = 3320, Vodafone = 3209.
  • session-abc123 – Sticky Session: gleiche Node für alle Verbindungen mit dieser ID (1–64 Zeichen, A–Z, 0–9, _).
  • sessttl-15 – Dauer der Sticky Session in Minuten, begrenzt durch Tarif und Plattformeinstellung.

Beispiele

curl -x http://px_xxxxxxxxxx-country-de:[email protected]:8000 https://api.ipify.org

curl -x socks5h://px_xxxxxxxxxx-session-cart7-sessttl-10:[email protected]:8000 https://example.com
# Python (requests)
proxies = {"https": "http://px_xxxxxxxxxx-country-nl:[email protected]:8000"}
requests.get("https://example.com", proxies=proxies, timeout=30)
// Node.js (undici)
import { ProxyAgent, fetch } from "undici";
const dispatcher = new ProxyAgent("http://px_xxxxxxxxxx:[email protected]:8000");
await fetch("https://example.com", { dispatcher });

Antwortcodes des Gateways

  • 407 – Zugangsdaten fehlen oder sind falsch (wiederholte Fehlversuche sperren die Client-IP vorübergehend).
  • 402 – Guthaben aufgebraucht oder Traffic-Limit des Zugangs erreicht.
  • 403 – Ziel, Port oder Land nicht erlaubt bzw. Zugang/Konto gesperrt.
  • 429 – Verbindungsrate oder gleichzeitige Verbindungen überschritten, oder Drosselung durch Missbrauchsschutz.
  • 503 – Aktuell keine passende Node verfügbar.
  • 502/504 – Ziel nicht erreichbar bzw. Node hat nicht rechtzeitig geantwortet.

Bei SOCKS5 werden die entsprechenden RFC-1928-Antwortcodes verwendet (z. B. 0x02 nicht erlaubt, 0x03 Netz nicht erreichbar).

Verbindung testen

Im Dashboard unter „Proxy-Zugänge“ führt „Testen“ einen echten Request über eine echte Node aus und zeigt Exit-IP, Land und Latenz an. Der Test-Traffic wird wie normaler Traffic abgerechnet.