Sesiones y perfiles persistentes

Aprende sobre las Sesiones persistentes (sticky) y los perfiles persistentes en Oxylabs Headless Browser. Reconéctate a sesiones en curso y reutiliza tus cookies o almacenamiento local durante varias sesiones.

Administrar flujos de trabajo de automatización de varias etapas de larga duración o mantener estados de usuario con sesión iniciada entre secuencias de conexión distintas requiere persistir los estados del navegador. Oxylabs Headless Browser ofrece dos sistemas avanzados de persistencia:

Sesiones persistentes	Mantenga en ejecución un entorno remoto de navegador en vivo incluso tras las desconexiones del cliente.
Perfiles persistentes	Guarde y restaure cookies, almacenamiento local y caché del navegador.

Sesiones persistentes

Las Sesiones persistentes (sticky) mantienen su instancia remota del navegador en la nube (incluso cuando su script de automatización local se desconecta) al definir un session_name en su URL de conexión:

wss://USER:[e-mail]?session_name=checkout-flow-test

Las Sesiones persistentes están habilitadas de forma predeterminada para todos los usuarios, con un límite predeterminado de 5 sesiones concurrentes. Si necesita un límite más alto, contacte con soporte de Oxylabs (chat en vivo o correo electrónico) o con su Dedicated Account Manager.

Parámetro	Descripción	Tipo
session_name	Cuando se define, una sesión persiste hasta el tiempo de vida máximo (TTL) (máx. 24 h o hasta detenerse). Reconéctese con el mismo session_name para volver a adjuntar el mismo ID de sesión y las pestañas existentes. Formato compatible: ^[A-Za-z0-9-]{3,36}$	Cadena
keep_alive	Mientras false (predeterminado), llamar a browser.close() recupera y cierra la sesión. Mientras true, la sesión permanece activa en la nube después de desconectarte (hasta 10 minutos).	Booleano

Reconectarse a una pestaña existente

// Reconnect to existing session with 
const browser = await chromium.connectOverCDP(endpoint);
const ctx = browser.contexts()[0];
const page = ctx.pages().find(p => p.url().includes("http://example.com "));

Perfiles persistentes

Los Perfiles persistentes están habilitadas de forma predeterminada para todos los usuarios, con un límite predeterminado de 5 perfilesÚselo para guardar cookies y localStorage bajo un perfil con nombre y restaurarlos en una sesión completamente nueva. Los siguientes parámetros le permiten mantener una identidad autenticada entre sesiones sin volver a autenticarse cada vez:

Parámetro	Descripción	Tipo
o_profile	Guarde/restaure cookies y localStorage con un perfil con nombre (14 días desde el último uso). Formato compatible: ^[A-Za-z0-9_-]{1,36}$	Cadena
o_profile_save	Forzar el guardado del perfil durante o al final de la sesión. Predeterminado: false.	Booleano
proxy_resi_ses_id	ID de sesión personalizado para fijar la IP de salida residencial entre sesiones. Formato compatible: ^[A-Za-z0-9]{3,36}$.	Cadena
proxy_resi_ses_time	Duración para mantener fijada la IP de salida del proxy residencial en minutos. Mín 1, máx. 1440 (24h).	Entero

Superar el max_profiles límite de 5 devuelve CDP_LIMIT_REACHED: profile limit reached error. Puede inspeccionar y eliminar perfiles guardados directamente en el Dashboard (hb.oxylabs.io/dashboard) si alcanza el límite, o reutilice un nombre de perfil estable. Contacte con soporte de Oxylabs (chat en vivo o correo electrónico) o con su Dedicated Account Manager si se requieren límites más altos.

Restauración fiable entre sesiones

Para los sitios web con sistemas estrictos de supervisión de bots, guardar cookies no es suficiente. Si un perfil restaurado se conecta desde una IP de salida residencial diferente, sus cookies pueden invalidarse, lo que da como resultado páginas en blanco o pantallas de verificación de seguridad.

Para garantizar inicios de sesión consistentes, combine su perfil con una IP de salida residencial fijada:

// Session 1: Authenticate and back up state
const connectionOne = "wss://USER:[e-mail]?o_profile=my_user_profile&proxy_resi_ses_id=ip_session_abc&proxy_resi_ses_time=120";

// Session 2: Restore profile with the exact same IP session context
const connectionTwo = "wss://USER:[e-mail]?o_profile=my_user_profile&proxy_resi_ses_id=ip_session_abc&proxy_resi_ses_time=120";