Guía de solución de problemas

Aprende a manejar comportamientos inesperados o bajas tasas de éxito al usar Headless Browser.

Síntoma	Causa probable	Solución
401 credenciales inválidas (las credenciales son correctas)	Usando ws:// esquema	Cambia a wss://
401 credenciales inválidas	Sin nombre de usuario sin sufijo	Usa el nombre de usuario completo con el token de sufijo del panel (p. ej., _ab12)
CDP_SESSION_RATE_LIMIT_REACHED	Estás intentando iniciar demasiados navegadores por segundo	Mantente dentro del 10 límite de sesiones por segundo o contacta con soporte para aumentar el límite.
CDP_MAX_CONCURRENT_SESSIONS_REACHED	Tu número de sesiones activas alcanzó el límite	Mantente por debajo de 100 total de sesiones concurrentes o contacta con soporte para aumentar el límite.
Inspección de sesión (VNC) no puede conectarse (el navegador se inicia)	Se alcanzó el límite máximo de VNC	Usa menos sesiones VNC.
Error de TLS / certificado	Validación de certificados en Node.js	Establece NODE_TLS_REJECT_UNAUTHORIZED="0" antes de importar Playwright (solo para pruebas).
CDP_LIMIT_REACHED: se alcanzó el límite de perfiles	o_profile el número supera max_profiles (predeterminado: 5)	Reutiliza un nombre de perfil estable, elimina los perfiles no usados en el Panel (hb.oxylabs.io/dashboard), o contacta con soporte para aumentar el límite.
400 session_name debe tener entre 3 y 36 caracteres alfanuméricos o '-'	Guion bajo o caracteres no válidos en session_name	Usa solo letras, dígitos y guiones ([A-Za-z0-9-]).
Perfil restaurado pero cookies están vacías	La IP de salida cambió entre sesiones	Fija proxy_resi_ses_id + proxy_resi_ses_time con valores idénticos en cada sesión.
Muro de inicio de sesión / baja tasa de éxito	Reputación de IP, geolocalización incorrecta o desajuste del motor	Establece p_cc (+ p_city), prueba otro p_device, o vuelve a intentarlo en una sesión nueva.
Objetivo bloqueado por completo	Categoría de objetivo restringida	Completa el KYC a través de tu Account Manager dedicado.

¿Sigues atascado? Contacta con soporte de Oxylabs por chat en vivo o email ([e-mail]).

Si experimentas un comportamiento inesperado o bajas tasas de éxito, considera los siguientes pasos:

Entiende nuestro proceso de gestión de CAPTCHA

Familiarízate con nuestros gestión de CAPTCHA métodos y su uso. Esto puede dar una idea de si los desafíos CAPTCHA son la fuente del problema.

Usa el parámetro de país

Especificar un parámetro de país en tus solicitudes puede aumentar significativamente las tasas de éxito. Esto garantiza que tus solicitudes se enruten a través de IPs de una ubicación geográfica específica, filtrando IPs de ubicaciones aleatorias o potencialmente menos fiables.

Puedes especificar un país para tu sesión de navegador añadiendo el ?p_cc parámetro a tu URL de conexión. Más información se puede encontrar en la sección Orientación por geolocalización.

Usa el parámetro de tipo de dispositivo

Experimentar con un parámetro de dispositivo puede resultar en tasas de éxito más altas. Puedes personalizar cómo el navegador emula diferentes tipos de dispositivo usando el ?p_device parámetro. Más información se puede encontrar en Tipo de dispositivo sección.

Si los problemas persisten después de probar estos pasos, contacta a tu Dedicated Account Manager con los detalles del problema y los pasos que ya has tomado.

¿Necesitas habilitar una función?

Algunas funciones de Headless Browser están limitadas de forma predeterminada. Para ajustar tus límites, contacta con soporte de Oxylabs (chat en vivo o email) o tu Dedicated Account Manager:

• Más perfiles persistentes – aumenta el límite predeterminado de tu cuenta de 5 perfiles guardados.
• Más sesiones persistentes – aumenta el límite predeterminado de tu cuenta de 5 sesiones persistentes concurrentes.
• Objetivos restringidos – desbloquea más categorías de objetivos mediante el proceso de KYC.
• Límites de velocidad más altos – aumenta más allá de 100 sesiones concurrentes / 10 por segundo.