Integrieren · Fehler & Fehlersuche
Jeder Status, mit dem das Gateway antworten kann, und was geändert werden muss.
Gateway-Fehler haben einen kurzen Grund im Text. Zielfehler bleiben unberührt. Der größte Teil der Fehlerbehebung besteht darin, die beiden zu unterscheiden.
Antworten vom Gateway#
| Status | Vernunft im Körper | Ursache | Fix |
|---|---|---|---|
| 407 Proxy-Authentifizierung erforderlich | invalid credentials | Falscher Benutzername oder falsches Passwort oder die Verbindungs-IP ist nicht auf der Whitelist und es wurden keine Anmeldeinformationen gesendet | Kopieren Sie das Paar erneut aus dem Dashboard. Überprüfen Sie die Whitelist gegen curl https://api.ipify.org ohne Proxy |
| 400 Bad Request | invalid parameter: ... | Ein Benutzernamensparameter ist unbekannt oder fehlerhaft oder die Kombination ist ungültig (-state- außerhalb der USA, -city- ohne -cc-) | Beheben Sie die String im Körper benannt; siehe Targeting & Sessions |
| 402 Zahlungserfordernis | Unzureichend Saldo | Auf dem von Ihnen verwendeten Pool-Netzwerk ist kein Datenverkehr mehr vorhanden oder der Unterbenutzer hat sein Limit erreicht | Kaufen Sie Traffic oder erhöhen Sie das Sub-User-Limit; Überprüfen GET /v1/balance |
| 403 Verboten | block Ziel | Das Ziel oder der Port ist nicht zulässig (Port 25 oder ein Ziel auf unserer Sperrliste) oder das Konto ist gesperrt | Lesen Sie den Grund; Kontaktieren Sie uns, wenn Sie glauben, dass ein Reiseziel falsch aufgeführt ist |
| 502 Bad Gateway | no exit available / exit failed | Für die Parameter ist kein Gerät online oder das ausgewählte Gerät wurde während der Anfrage abgebrochen | Einmal erneut versuchen (Rotation wählt bereits einen anderen Ausgang); Erweitern Sie das Targeting, wenn es sich wiederholt |
| 504 Gateway Timeout | target timeout | Die Zielperson antwortete nicht innerhalb der Frist durch den Ausgang | Versuchen Sie es erneut mit einer neuen IP. Erhöhen Sie das Timeout Ihres Clients, wenn das Ziel von Natur aus langsam ist |
Gateway-Fehler oder Zielfehler?#
Ein Gateway-Fehler kommt vor jedem Byte vom Ziel: Bei einer HTTPS-Anfrage ist es die Antwort auf das CONNECT, was bei den meisten Clients als Verbindungs- oder Proxyfehler und nicht als HTTP-Antwort auftritt. Ein Zielfehler kommt mit den eigenen Headern und dem Text des Ziels im Tunnel an. curl -v zeigt den Unterschied sofort: Schauen Sie sich an, welche Antwort folgt CONNECT.
Diagnose-Checkliste#
- Führen Sie die einfachste Anfrage aus:
curl -x http://USER:PASS@res.proxy-cyber.com:9000 https://api.ipify.orgohne Parameter. Wenn es funktioniert, liegt das Problem in einem Parameter oder in Ihrem Client. - Überprüfen Sie das Proxy-Schema: Die Proxy-URL beginnt mit
http://odersocks5h://9001, niemalshttps://Auch für HTTPS-Ziele. - Fügen Sie Parameter nacheinander zurück.
400Namensgebung des Schlechten;502Bei einer engen Kombination bedeutet, dass dort gerade niemand online ist. - Whitelist-Benutzer: Vergleichen Sie die Adresse in Einstellungen → Whitelist Mit dem Output von
curl https://api.ipify.orgohne Proxy, auf demselben Computer ausführen. Cloud-Instanzen verlassen häufig ein NAT-Gateway mit einer anderen Adresse. - Überprüfen Sie den Saldo des Netzwerks, das Sie tatsächlich nutzen: Privat- und Mobilfunkverkehr sind getrennte Salden.
- Suchen Sie nach Umweltvariablen ()
HTTP_PROXY,HTTPS_PROXY,ALL_PROXY,NO_PROXYUnd das überschreibt, was Sie im Code weitergeben. - Wenn die Überprüfung des TLS-Zertifikats fehlschlägt, fängt etwas zwischen Ihnen und dem Gateway TLS ab (Unternehmens-Proxy, Antivirus). Das Gateway berührt niemals Zertifikate.
Symptome und ihre übliche Ursache#
| Sie sehen | In der Regel bedeutet | Tun Sie dies |
|---|---|---|
curl: (56) Received HTTP code 407 from proxy after CONNECT | Zulassung abgelehnt | Kopieren Sie sie erneut. Sonderzeichen prozentual kodieren, wenn Sie Ihr eigenes Passwort festlegen |
| Die gleiche IP auf jeder Anfrage | Ihr Client verwendet eine Keep-Alive-Verbindung wieder oder Sie haben eine hinterlassen -sid- im Benutzernamen | Schließen Sie Verbindungen zwischen Anfragen oder löschen Sie die Sitzungs-ID |
Eine andere IP auf jeder Anfrage, obwohl -sid- ist gesetzt | Die Lebensdauer ist kürzer als die Lücke zwischen Anfragen oder die ID ändert sich pro Anfrage (ein zufälliger Wert in einer Vorlage). | Fix die ID, raise -ttl- |
Connection reset by peer Mid-Download | Der Haushalt ging offline | Wiederholen; bei Rotation nutzt es bereits einen anderen Ausgang; Bei einer Sticky-Sitzung erhält die nächste Anfrage eine neue IP |
| Funktioniert in curl, scheitert im Browser | Der Browser verfügt über kein Proxy-Passwort oder das Flag ignoriert Anmeldeinformationen | Verwenden Sie die Playwright- oder Puppeteer-Authentifizierung oder Whitelist |
| Zielantworten 403 oder ein CAPTCHA | Das Ziel bewertet den Besuch, nicht den Proxy | Wechseln Sie zu Privat- oder Mobilgeräten, fügen Sie eine Sticky-Sitzung für mehrstufige Abläufe hinzu, passen Sie Header an das Ausgangsland an und beschleunigen Sie sie pro Domain |
| Alles ist langsam | Fernausgang oder ein Haushalt auf einer schwachen Linie | Wählen Sie das Land aus, das dem Ziel am nächsten liegt, halten Sie die Sitzungen kurz, damit die nächste auf einer besseren Leitung landet, oder nutzen Sie ein Rechenzentrum oder einen ISP für reine Geschwindigkeit |
SSL certificate problem | TLS-Abhörung auf Ihrer Seite | Entfernen Sie das Abfangen oder vertrauen Sie seiner Wurzel; Das Gateway ist nicht beteiligt |
Stillgelegt#
Senden Sie uns die genaue Anfrage (Anmeldeinformationen entfernt), den Zeitstempel in UTC, den Status und Text, den Sie erhalten haben, sowie die Exit-IP, falls die Anfrage erfolgreich war. Die Kontaktseite erklärt, wie man das Team erreicht; Kontoinhaber eröffnen ein Ticket über das Dashboard.