Guia de solução de problemas

Aprenda a lidar com comportamentos inesperados ou baixas taxas de sucesso ao usar o Oxylabs Agent Browser.

Sintoma	Causa provável	Solução
401 credenciais inválidas (as credenciais estão corretas)	Usando ws:// esquema	Mude para wss://
401 credenciais inválidas	Puro nome de usuário sem sufixo	Use o nome de usuário completo com o token de sufixo do painel (por exemplo, _ab12)
CDP_SESSION_RATE_LIMIT_REACHED	Você está tentando iniciar muitos navegadores por segundo	Fique dentro do 10 limite de sessões por segundo ou contate o suporte para aumentar o limite.
CDP_MAX_CONCURRENT_SESSIONS_REACHED	Sua contagem de sessões ativas atingiu o limite	Fique abaixo de 100 o total de sessões simultâneas ou contate o suporte para aumentar o limite.
Inspeção de sessão (VNC) não conseguiu conectar (o navegador inicia)	Limite máximo de VNC atingido	Use menos sessões de VNC.
Erro de TLS / certificado	Validação de certificado no Node.js	Defina NODE_TLS_REJECT_UNAUTHORIZED="0" antes de carregar o Playwright (apenas para testes).
CDP_LIMIT_REACHED: profile limit reached	o_profile excede max_profiles (padrão: 5)	Reutilize um nome de perfil estável, exclua perfis não usados no Painel (hb.oxylabs.io/dashboard), ou contate o suporte para aumentar o limite.
400 session_name deve ter de 3 a 36 caracteres alfanuméricos ou '-'	Sublinhado ou caracteres inválidos em session_name	Use apenas letras, dígitos e hífens ([A-Za-z0-9-]).
Perfil restaurado, mas os cookies estão vazios	IP de saída mudou entre as sessões	Fixe proxy_resi_ses_id + proxy_resi_ses_time com valores idênticos em cada sessão.
Barreira de login / baixa taxa de sucesso	Reputação do IP, geolocalização incorreta ou incompatibilidade do mecanismo	Defina p_cc (+ p_city), tente um diferente p_device, ou tente novamente em uma sessão nova.
Alvo bloqueado totalmente	Categoria de alvo restrita	Conclua o KYC com seu Gerente de Conta Dedicado.

Ainda com problemas? Contate o suporte da Oxylabs via chat ao vivo ou e-mail ([e-mail]).

Se você estiver enfrentando comportamento inesperado ou baixas taxas de sucesso, considere as seguintes etapas:

Entenda nosso processo de tratamento de CAPTCHA

Familiarize-se com nossos tratamento de CAPTCHA métodos e seu uso. Isso pode fornecer uma visão sobre se os desafios de CAPTCHA são a origem do problema.

Use o parâmetro de país

Especificar um parâmetro de país em suas solicitações pode aumentar significativamente as taxas de sucesso. Isso garante que suas solicitações sejam roteadas por IPs de uma localidade geográfica específica, filtrando IPs de locais aleatórios ou potencialmente menos confiáveis.

Você pode especificar um país para sua sessão do navegador adicionando o ?p_cc parâmetro à sua URL de conexão. Mais informações podem ser encontradas na seção Segmentação por geolocalização.

Use o parâmetro de tipo de dispositivo

Experimentar com um parâmetro de dispositivo pode resultar em taxas de sucesso mais altas. Você pode personalizar como o navegador emula diferentes tipos de dispositivos usando o ?p_device parâmetro. Mais informações podem ser encontradas na seção Tipo de dispositivo .

Se os problemas persistirem após tentar estas etapas, entre em contato com seu Gerente de Conta Dedicado com detalhes do problema e das etapas que você já tomou.

Precisa habilitar um recurso?

Alguns recursos do Agent Browser são limitados por padrão. Para ajustar seus limites, entre em contato com o suporte da Oxylabs (chat ao vivo ou e-mail) ou seu Gerente de Conta Dedicado:

• Mais perfis persistentes – aumente o limite padrão da sua conta de 5 perfis salvos.
• Mais sessões persistentes – aumente o limite padrão da sua conta de 5 sessões persistentes simultâneas.
• Alvos restritos – desbloqueie mais categorias de alvos via processo KYC.
• Limites de taxa mais altos – aumente para além de 100 sessões simultâneas / 10 por segundo.