Solução de problemas

Algo não está funcionando? A maioria dos problemas se enquadra em um dos oito padrões abaixo. Encontre o sintoma que corresponde, siga o diagnóstico, aplique a correção.

Conexão recusada ou timeout no gateway

Sintomas: Seu cliente reporta “connection refused”, “connection timed out” ou “no route to host” ao chamar p.shifter.io:443.

Diagnóstico:

1. Confirme que você está apontando para o novo gateway: p.shifter.io:443. Planos legados usam subdomínios por porta, como apollo.p.shifter.io:<port>.
2. Verifique se seu IP de origem não está atrás de um firewall que bloqueia a saída pela porta 443.
3. Teste a conectividade bruta: nc -vz p.shifter.io 443.

Correção: Se a conectividade bruta funciona mas o proxy falha, o problema é de autenticação. Veja a seção 407 abaixo. Se a conectividade bruta falha, verifique as regras de firewall de saída e tente novamente a partir de outra rede.

HTTP 407 Proxy Authentication Required

Sintomas: Toda requisição retorna 407 Proxy Authentication Required.

Diagnóstico:

• Credenciais incorretas: erro de digitação no usuário ou na senha.
• Flag desconhecida: um código de país, slug de cidade ou string de sessão malformada no nome de usuário estendido.
• Senha regenerada: a senha antiga deixou de ser válida após uma rotação no painel. Correção:

1. Remova todas as flags e tente novamente primeiro apenas com o usuário e a senha simples. Se funcionar, adicione as flags de volta uma a uma.
2. Verifique em shifter.io/panel, na seção Residential Proxies, para confirmar sua senha.
3. Se você rotacionou senhas recentemente, propague o novo valor para todos os clientes.

Tempos de resposta lentos com IPs residenciais

Sintomas: As requisições levam 5-10+ segundos. IPs que antes eram rápidos ficaram mais lentos.

Diagnóstico: IPs residenciais vêm de conexões reais de ISP. Alguma variação na latência é normal. Lentidão persistente geralmente significa:

• O usuário final daquele IP está usando a conexão intensamente (Netflix, upload grande).
• O site alvo está limitando (throttling) o IP.
• O filtro do pool está muito restrito e você está recebendo IPs congestionados.

Correção:

• Rotacione com mais frequência (remova a sessão fixa ou reduza o ttl).
• Amplie seu filtro (remova a cidade, mantenha apenas o país).
• Para proxies de ISP: use Managing IPs → Replace para trocar o IP lento por um novo.

A geolocalização do IP não corresponde ao meu alvo

Sintomas: Você solicitou country-us-city-new_york e o site alvo acha que você está em outro lugar.

Diagnóstico:

• IPs residenciais têm sua geolocalização definida por bases de dados de terceiros (MaxMind, IP2Location). Essas bases nem sempre são consistentes com a própria fonte de geolocalização do site alvo.
• IPs de operadoras móveis e faixas de ISP recém-atribuídas podem ficar mal classificadas por semanas.

Correção:

• Tente novamente a requisição. O Shifter atribui um novo IP a cada requisição (ou a cada sessão fixa) e o próximo pode ter geolocalização mais precisa na base de dados do alvo.
• Se você precisa de geografia garantida para um alvo específico, entre em contato com o suporte com a URL do alvo e a localização desejada. Podemos pré-validar IPs contra esse alvo.

Erros de HTTPS, falhas de SSL/TLS

Sintomas: SSL handshake failed, certificate verify failed ou tls: bad record MAC.

Diagnóstico:

• Você está usando uma versão antiga do OpenSSL ou do Node que rejeita o conjunto de cifras (cipher suite) do gateway.
• Cadeia de confiança quebrada em proxies corporativos.

Correção:

• Atualize a biblioteca TLS do seu cliente. Node 18+, Python requests 2.28+, curl 7.80+ são versões conhecidas por funcionarem bem.
• Fixe (pin) o certificado do gateway para contornar problemas de cadeia, se seu ambiente exigir hosts estritos.
• Apenas para depuração: --proxy-insecure no curl desativa a verificação de certificado no trecho do proxy. Nunca use essa flag em produção.

O site alvo ainda me bloqueia

Sintomas: Mesmo usando proxies residenciais com rotação, um alvo específico retorna CAPTCHAs, 403s ou corpos vazios.

Diagnóstico: O alvo tem anti-bot em camadas (Cloudflare, Akamai, DataDome) que faz fingerprinting além do IP. Sinais comuns:

• O User-Agent não corresponde ao fingerprint de TLS (incompatibilidade de JA3/JA4).
• Os headers são enviados em uma ordem diferente da de um navegador real.
• APIs do navegador (detecção de WebDriver, flag navigator.webdriver) expõem a automação.
• A rotação de IP é agressiva demais para o modelo de sessão do alvo.

Correção:

• Mude de proxies brutos para a Web Scraping API, que inclui modo stealth e resolução de CAPTCHA.
• Ou: abra um chamado com a URL do alvo. Muitos casos são ajustáveis do nosso lado.

Web Scraping API retorna 509 Bandwidth Limit Exceeded

Sintomas: A Scraping API retorna 509 mesmo com créditos restantes no seu plano.

Diagnóstico: 509 significa que a cota do plano foi esgotada. Se você ainda tem créditos no painel, verifique:

• Se você está usando a chave de API correta (não uma de um plano antigo).
• Se o Extra Traffic está ativado, caso você queira que o excedente seja convertido em pay-as-you-go.

Correção:

• Confirme que a chave corresponde ao plano ativo em Web Scraping API → API Keys.
• Ative Billing → Extra Traffic para converter automaticamente os excedentes em preço por crédito.
• Faça upgrade do plano se você estiver ficando sem créditos regularmente.

Pagamento falhou ou assinatura não ativou

Sintomas: Você pagou mas o plano aparece como inativo, ou a renovação falhou silenciosamente.

Diagnóstico:

• A operadora do cartão bloqueou a transação (comum em cobranças internacionais sem cartão presente).
• Cartão expirado ou desafio 3DS não concluído.
• Pagamento em cripto ainda não confirmado (são necessárias 6 confirmações).

Correção:

1. Verifique o histórico de transações do cartão no aplicativo do seu banco. Se a cobrança foi rejeitada, tente novamente com um cartão diferente.
2. Para cripto, os pagamentos são detectados pelo processador após 6 confirmações na blockchain. Geralmente 15-60 minutos para BTC/ETH.
3. Se a cobrança foi concluída mas o plano continua inativo após 30 minutos, envie um e-mail para hi@shifter.io com o ID da fatura.

Dica

Para qualquer coisa não coberta aqui, inicie um chat ao vivo pelo painel ou envie um e-mail para hi@shifter.io. Inclua: o produto, o plano, um timestamp e a mensagem de erro literal.

Veja também

• Cobrança e Preços - reembolsos, faturas, formas de pagamento.
• Suporte - canais de contato, SLAs, página de status.