Zum Inhalt springen
Anmelden Registrieren

Fehlerbehebung

Funktioniert etwas nicht? Die meisten Probleme lassen sich einem der acht folgenden Muster zuordnen. Finden Sie das passende Symptom, folgen Sie der Diagnose, wenden Sie die Lösung an.

Symptome: Ihr Client meldet “connection refused”, “connection timed out” oder “no route to host” beim Aufruf von p.shifter.io:443.

Diagnose:

  1. Bestätigen Sie, dass Sie auf das neue Gateway zeigen: p.shifter.io:443. Ältere Tarife verwenden Subdomains pro Port wie apollo.p.shifter.io:<port>.
  2. Prüfen Sie, ob Ihre Quell-IP nicht hinter einer Firewall liegt, die ausgehenden Datenverkehr auf Port 443 blockiert.
  3. Testen Sie die reine Konnektivität: nc -vz p.shifter.io 443.

Lösung: Funktioniert die reine Konnektivität, schlägt aber der Proxy fehl, liegt das Problem bei der Authentifizierung. Siehe den Abschnitt zu 407 weiter unten. Schlägt die reine Konnektivität fehl, prüfen Sie die Egress-Firewall-Regeln und versuchen Sie es von einem anderen Netzwerk aus erneut.

Symptome: Jede Anfrage liefert 407 Proxy Authentication Required.

Diagnose:

  • Falsche Zugangsdaten: Tippfehler in Benutzername oder Passwort.
  • Unbekanntes Flag: ein fehlerhafter Ländercode, Stadt-Slug oder Session-String im erweiterten Benutzernamen.
  • Passwort erneuert: altes Passwort nach einer Rotation im Panel nicht mehr gültig. Lösung:
  1. Entfernen Sie zunächst alle Flags und versuchen Sie es mit dem reinen Benutzernamen und Passwort erneut. Funktioniert dies, fügen Sie die Flags nacheinander wieder hinzu.
  2. Prüfen Sie unter shifter.io/panel im Bereich Residential Proxies Ihr Passwort.
  3. Wenn Sie kürzlich Passwörter geändert haben, verteilen Sie den neuen Wert an alle Clients.

Symptome: Anfragen dauern 5-10+ Sekunden. Zuvor schnelle IPs sind langsamer geworden.

Diagnose: Residential IPs stammen von echten ISP-Verbindungen. Gewisse Schwankungen in der Latenz sind normal. Anhaltende Langsamkeit bedeutet meist:

  • Der Endnutzer dieser IP nutzt die Verbindung stark (Netflix, großer Upload).
  • Die Zielseite drosselt die IP.
  • Der Pool-Filter ist zu eng gefasst, und Sie erhalten überlastete IPs.

Lösung:

  • Rotieren Sie aggressiver (Sticky Session aufheben oder ttl verkürzen).
  • Erweitern Sie Ihren Filter (Stadt weglassen, nur das Land behalten).
  • Bei ISP-Proxys: Nutzen Sie Managing IPs → Replace, um die langsame IP gegen eine neue zu tauschen.

IP-Geolokalisierung stimmt nicht mit meinem Ziel überein

Abschnitt betitelt „IP-Geolokalisierung stimmt nicht mit meinem Ziel überein“

Symptome: Sie haben country-us-city-new_york angefordert, und die Zielseite glaubt, Sie befinden sich woanders.

Diagnose:

  • Residential IPs werden von Drittanbieter-Datenbanken (MaxMind, IP2Location) geolokalisiert. Diese Datenbanken stimmen nicht immer mit der eigenen Geolokalisierungsquelle der Zielseite überein.
  • IPs von Mobilfunkanbietern und neu vergebene ISP-Bereiche können wochenlang falsch klassifiziert sein.

Lösung:

  • Wiederholen Sie die Anfrage. Shifter weist bei jeder Anfrage (oder jeder Sticky Session) eine neue IP zu, und die nächste hat möglicherweise eine genauere Geolokalisierung in der Datenbank des Ziels.
  • Wenn Sie für ein bestimmtes Ziel eine garantierte Geografie benötigen, wenden Sie sich mit der Ziel-URL und dem gewünschten Standort an den Support. Wir können IPs im Voraus gegen dieses Ziel validieren.

Symptome: SSL handshake failed, certificate verify failed oder tls: bad record MAC.

Diagnose:

  • Sie verwenden eine alte OpenSSL- oder Node-Version, die die Cipher Suite des Gateways ablehnt.
  • Die Vertrauenskette bei Unternehmensproxys ist unterbrochen.

Lösung:

  • Aktualisieren Sie die TLS-Bibliothek Ihres Clients. Node 18+, Python requests 2.28+, curl 7.80+ sind bekanntermaßen kompatibel.
  • Pinnen Sie das Gateway-Zertifikat, um Probleme mit der Vertrauenskette zu umgehen, wenn Ihre Umgebung strikte Hosts erfordert.
  • Nur zu Debugging-Zwecken: curl --proxy-insecure deaktiviert die Zertifikatsprüfung auf der Proxy-Seite. Verwenden Sie dieses Flag niemals produktiv.

Symptome: Auch über Residential-Proxys mit Rotation liefert ein bestimmtes Ziel CAPTCHAs, 403er oder leere Antworttexte.

Diagnose: Das Ziel verfügt über mehrschichtigen Anti-Bot-Schutz (Cloudflare, Akamai, DataDome), der über die IP hinaus Fingerprinting betreibt. Häufige Anzeichen:

  • User-Agent stimmt nicht mit dem TLS-Fingerprint überein (JA3/JA4-Diskrepanz).
  • Header werden in einer anderen Reihenfolge gesendet als bei einem echten Browser.
  • Browser-APIs (WebDriver-Erkennung, navigator.webdriver-Flag) verraten Automatisierung.
  • Die IP-Rotation ist für das Sitzungsmodell des Ziels zu aggressiv.

Lösung:

  • Wechseln Sie von reinen Proxys zur Web Scraping API, die einen Stealth-Modus und CAPTCHA-Lösung enthält.
  • Oder: Eröffnen Sie ein Ticket mit der Ziel-URL. Viele Fälle lassen sich von unserer Seite aus anpassen.

Web Scraping API liefert 509 Bandwidth Limit Exceeded

Abschnitt betitelt „Web Scraping API liefert 509 Bandwidth Limit Exceeded“

Symptome: Die Scraping API liefert 509, obwohl auf Ihrem Tarif noch Guthaben vorhanden ist.

Diagnose: 509 bedeutet, dass das Tarifkontingent erschöpft ist. Wenn Sie im Dashboard noch Guthaben haben, prüfen Sie:

  • Sie verwenden den richtigen API-Schlüssel (nicht den eines alten Tarifs).
  • Extra Traffic ist aktiviert, wenn Sie möchten, dass Mehrverbrauch in Pay-as-you-go umgewandelt wird.

Lösung:

  • Bestätigen Sie, dass der Schlüssel dem aktiven Tarif unter Web Scraping API → API Keys entspricht.
  • Aktivieren Sie Billing → Extra Traffic, um Mehrverbrauch automatisch in Preise pro Guthabeneinheit umzuwandeln.
  • Erweitern Sie den Tarif, wenn Ihnen regelmäßig das Guthaben ausgeht.

Zahlung fehlgeschlagen oder Abonnement wurde nicht aktiviert

Abschnitt betitelt „Zahlung fehlgeschlagen oder Abonnement wurde nicht aktiviert“

Symptome: Sie haben bezahlt, aber der Tarif wird als inaktiv angezeigt, oder die Verlängerung ist stillschweigend fehlgeschlagen.

Diagnose:

  • Der Kartenaussteller hat die Transaktion blockiert (häufig bei internationalen Card-not-present-Zahlungen).
  • Karte abgelaufen oder 3DS-Challenge nicht abgeschlossen.
  • Krypto-Zahlung noch nicht bestätigt (6 Bestätigungen erforderlich).

Lösung:

  1. Prüfen Sie den Transaktionsverlauf der Karte in Ihrer Banking-App. Wurde die Zahlung abgelehnt, versuchen Sie es mit einer anderen Karte erneut.
  2. Bei Krypto-Zahlungen werden Zahlungen vom Zahlungsdienstleister nach 6 Blockchain-Bestätigungen erkannt. In der Regel 15-60 Minuten für BTC/ETH.
  3. Wenn die Zahlung durchgeführt wurde, der Tarif aber nach 30 Minuten weiterhin inaktiv ist, senden Sie eine E-Mail an hi@shifter.io mit der Rechnungs-ID.