Integrar · Erros e solução de problemas
Códigos de resposta do gateway e como resolver cada erro.
Erros de gateway vêm com um breve motivo no corpo. Erros de alvo passam intactos. Diferenciar os dois é a maior parte da solução de problemas.
Respostas do gateway#
| Estado | Razão no corpo | Causa | Correção |
|---|---|---|---|
| 407 Autenticação de proxy necessária | credenciais_inválidas | Nome de usuário ou senha incorretos ou o IP de conexão não está na lista de permissões e nenhuma credencial foi enviada | Copie o par do painel novamente; verifique a lista de permissões em relação curl https://api.ipify.org rodar sem proxy |
| 400 Solicitação incorreta | parâmetro_inválido:… | Um parâmetro de nome de usuário é desconhecido ou malformado ou a combinação é inválida (-state- fora dos EUA, -city- sem -cc-) | Corrija a string nomeada no corpo; veja Segmentação e sessões |
| 402 Pagamento necessário | saldo_insuficiente | Não há tráfego restante na rede do pool que você está usando ou o subusuário atingiu seu limite | Compre tráfego ou aumente o limite de subusuários; verificar GET /v1/balance |
| 403 Proibido | destino_bloqueado | O destino ou porta não é permitido (porta 25 ou um alvo em nossa lista de negações) ou a conta está suspensa | Leia o motivo; entre em contato conosco se você acredita que um destino está listado incorretamente |
| 502 Gateway ruim | no_exit_available / exit_failed | Nenhum dispositivo on-line para os parâmetros ou o dispositivo escolhido caiu no meio da solicitação | Tente novamente uma vez (a rotação já seleciona outra saída); ampliar a segmentação caso ela se repita |
| 504 Tempo limite do gateway | target_timeout | O alvo não respondeu pela saída dentro do prazo | Tente novamente com um novo IP; aumente o tempo limite do seu cliente se o alvo for lento por natureza |
Erro de gateway ou erro de alvo?#
Um erro de gateway chega antes de qualquer byte do destino: em uma solicitação HTTPS, é a resposta ao CONNECT, que a maioria dos clientes apresenta como um erro de conexão ou proxy, em vez de uma resposta HTTP. Um erro de destino chega dentro do túnel com os próprios cabeçalhos e corpo do alvo. curl -v mostra a diferença imediatamente: veja qual resposta segue CONNECT.
Lista de verificação de diagnóstico#
- Execute a solicitação mais simples:
curl -x http://USER:PASS@res.proxy-cyber.com:9000 https://api.ipify.orgsem parâmetros. Se funcionar, o problema está em um parâmetro ou no seu cliente. - Verifique o esquema de proxy: o URL do proxy começa com
http://(ousocks5h://em 9001), nuncahttps://, mesmo para destinos HTTPS. - Adicione parâmetros um de cada vez.
400nomeia o ruim;502em uma combinação estreita significa que ninguém está online no momento. - Usuários da lista de permissões: compare o endereço em Configurações → Lista de permissões com a saída de
curl https://api.ipify.orgsem proxy, execute na mesma máquina. As instâncias de nuvem geralmente saem por meio de um gateway NAT com um endereço diferente. - Verifique o saldo da rede que você está realmente usando: o tráfego residencial e móvel são saldos separados.
- Procure variáveis de ambiente (
HTTP_PROXY,HTTPS_PROXY,ALL_PROXY,NO_PROXY) que substituem o que você passa no código. - Se o certificado TLS não for verificado, algo entre você e o gateway interceptará o TLS (proxy corporativo, antivírus). O gateway nunca toca em certificados.
Sintomas e sua causa usual#
| Você vê | Geralmente significa | Faça isso |
|---|---|---|
curl: (56) Received HTTP code 407 from proxy after CONNECT | Credenciais rejeitadas | Copie-os novamente; caracteres especiais com codificação percentual se você definir sua própria senha |
| O mesmo IP em todas as solicitações | Seu cliente reutiliza uma conexão keep-alive ou você deixou uma -sid- no nome de usuário | Fechar conexões entre solicitações ou descartar o ID da sessão |
Um IP diferente em cada solicitação, embora -sid- está definido | O tempo de vida é menor que o intervalo entre as solicitações ou o ID muda por solicitação (um valor aleatório em um modelo) | Corrija o id, aumente -ttl- |
Connection reset by peer meio do download | A família ficou off-line | Tente novamente; com rotação já utiliza outra saída; em uma sessão fixa, a próxima solicitação recebe um novo IP |
| Funciona em curl, falha no navegador | O navegador não tem senha de proxy ou o sinalizador ignora as credenciais | Use a autenticação Playwright ou Puppeteer, ou o lista branca |
| O alvo responde 403 ou um CAPTCHA | O alvo pontua a visita, não o proxy | Mude para residencial ou móvel, adicione uma sessão fixa para fluxos de várias etapas, combine cabeçalhos com o país de saída, ritmo por domínio |
| Tudo é lento | Saída distante ou casa em linha fraca | Escolha o país mais próximo do alvo, mantenha as sessões curtas para que a próxima chegue a uma linha melhor ou use o datacenter ou ISP para obter velocidade bruta |
SSL certificate problem | Interceptação TLS do seu lado | Remova a interceptação ou confie em sua raiz; o gateway não está envolvido |
Ainda preso#
Envie-nos a solicitação exata (credenciais removidas), o carimbo de data/hora em UTC, o status e o corpo que você recebeu e o IP de saída se a solicitação for concluída. O página de contato explica como chegar à equipe; os titulares de contas abrem um ticket no painel.