Integreren · Fouten en probleemoplossing
Elke status waarmee de gateway kan antwoorden, en wat te veranderen.
Gateway fouten komen met een korte reden in het lichaam. Doel fouten passeren onaangeroerd. Het vertellen van de twee uit elkaar is het grootste deel van het oplossen van problemen.
Reacties van de gateway#
| Status | Rede in het lichaam | Oorzaak | Repareren |
|---|---|---|---|
| 407 Proxy-authenticatie vereist | ongeldige_gegevens | Dataverkeerde gebruikersnaam of wachtwoord, of het verbindings-IP staat niet op de whitelist en er zijn geen referenties verzonden | Kopieer het paar opnieuw van het dashboard; controleer de witte lijst tegen curl https://api.ipify.org uitvoeren zonder proxy |
| 400 Slecht verzoek | ongeldige_parameter: … | Een gebruikersnaam parameter is onbekend of onjuist gevormd, of de combinatie is ongeldig (-state- buiten de VS, -city- zonder -cc-) | Repareer de string genoemd in de body; zie Locatiekeuze en sessies |
| 402 Betaling vereist | onvoldoende_saldo | Geen verkeer meer op het poolnetwerk dat u gebruikt, of de sub-gebruiker heeft zijn limiet bereikt | Koop het verkeer of verhoog de sub-gebruiker limiet; controleer GET /v1/balance |
| 403 Verboden | geblokkeerde_bestemming | De bestemming of haven is niet toegestaan (haven 25, of een doel op onze deny lijst), of de rekening is opgeschort | Lees de reden; neem contact met ons op als u van mening bent dat een bestemming verkeerd is vermeld |
| 502 Slechte gateway | no_exit_available / exit_mislukt | Geen apparaat online voor de parameters, of het gekozen apparaat viel midden-verzoek | Eenmaal opnieuw proberen (rotatie kiest al een andere uitgang); verbreed het doel als het zich herhaalt |
| 504 Gateway-time-out | target_time-out | Het doel beantwoordde niet door de exit binnen de termijn | Probeer het opnieuw met een nieuw IP; verhoog de timeout van uw client als het doel van nature traag is |
Gatewayfout of doelfout?#
Een gateway fout komt voordat een byte van het doel: op een HTTPS verzoek is het de reactie op de CONNECT, die de meeste clients als een verbinding of proxy fout in plaats van een HTTP-respons. Een doelfout komt in de tunnel met de eigen headers en lichaam van het doel. curl -v toont het verschil onmiddellijk: kijk naar welke reactie volgt CONNECT.
Diagnostische checklist#
- Voer het eenvoudigste verzoek uit:
curl -x http://USER:PASS@res.proxy-cyber.com:9000 https://api.ipify.orgzonder parameters. Als het werkt, is het probleem in een parameter of in uw client. - Controleer het proxyschema: de proxy-URL start met
http://(ofsocks5h://op 9001), nooithttps://, zelfs voor HTTPS-doelen. - Voeg parameters één voor één toe.
400noemt de slechte;502Op een smalle combinatie betekent dat er niemand online is op dit moment. - Gebruikers op de witte lijst: vergelijk het adres in Instellingen → Witte lijst met de opbrengst van
curl https://api.ipify.orgzonder proxy, draaien op dezelfde machine. Cloud-instances gaan vaak uit via een NAT-gateway met een ander adres. - Controleer de balans van het netwerk dat u daadwerkelijk gebruikt: residentieel en mobiel verkeer zijn gescheiden saldi.
- Zoek naar omgevingsvariabelen (
HTTP_PROXY,HTTPS_PROXY,ALL_PROXY,NO_PROXY) die de code die u doorgeeft, overschrijven. - Als het TLS-certificaat niet kan worden geverifieerd, onderschept iets tussen u en de gateway TLS (bedrijfsproxy, antivirus). De gateway raakt nooit certificaten aan.
Symptomen en hun gebruikelijke oorzaak#
| Zie je | Meestal betekent | Doe dit |
|---|---|---|
curl: (56) Received HTTP code 407 from proxy after CONNECT | Inloggegevens afgewezen | Herkopieer ze; %s-coderen speciale tekens als u uw eigen wachtwoord instelt |
| Bij elk verzoek hetzelfde IP-adres | Uw cliënt hergebruikt een "keep-alive" verbinding, of u liet een -sid- in de gebruikersnaam | Verbindingen tussen verzoeken sluiten of de sessie-id laten vallen |
Wel een ander IP-adres bij elk verzoek -sid- is ingesteld | De levensduur is korter dan de kloof tussen verzoeken, of de id-wijzigingen per verzoek (een willekeurige waarde in een template) | Corrigeer de ID, verhoog -ttl- |
Connection reset by peer midden download | Het huishouden ging offline | Probeer het; met rotatie gebruikt het al een andere exit; bij een plakkerige sessie krijgt het volgende verzoek een nieuw IP |
| Werkt in krul, mislukt in de browser | De browser heeft geen proxy-wachtwoord of de vlag negeert referenties | Gebruik Playwright of Puppeteer authenticatie, of de witte lijst |
| Doelantwoorden 403 of een CAPTCHA | Het doel scoort het bezoek, niet de proxy | Verplaats naar residentieel of mobiel, voeg een plakkerige sessie voor meerdere stappen stromen, match headers naar het land van uitgang, tempo per domein |
| Alles is traag | Verre uitgang of een huishouden op een zwakke lijn | Kies het land dat het dichtst bij het doel ligt, houd sessies kort zodat de volgende landt op een betere lijn, of gebruik datacenter of ISP voor ruwe snelheid |
SSL certificate problem | TLS-onderschepping aan uw kant | Verwijder de interceptie of vertrouw de wortel ervan; de gateway is niet betrokken |
Zit nog steeds vast#
Stuur ons het exacte verzoek (intelligentie verwijderd), het tijdstempel in UTC, de status en het lichaam dat u ontving en het IP-adres van de uitgang als het verzoek doorging. contactpagina legt uit hoe het team te bereiken; accounthouders openen een ticket vanaf het dashboard.