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 el almacenamiento local a través de varias sesiones.

Gestionar 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 conservar los estados del navegador. Oxylabs Headless Browser ofrece dos sistemas avanzados de persistencia:

Sesiones persistentes	Mantén un entorno de navegador remoto activo en funcionamiento durante las desconexiones del cliente.
Perfiles persistentes	Guarda y restaura cookies, almacenamiento local y la caché del navegador. (Se requiere activación)

Sesiones persistentes

Las sesiones persistentes (sticky) mantienen tu instancia de navegador remoto en ejecución en la nube (incluso cuando tu script de automatización local se desconecta) al definir un session_name personalizado en la URL de conexión:

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

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

Reconéctate 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

Perfiles persistentes la función y o_profile los parámetros están restringidos de forma predeterminada. Para acceder a ellos, contacta con el soporte de Oxylabs (chat en vivo o correo electrónico) o con tu gerente de cuenta dedicado.

Guarda cookies y localStorage bajo un perfil con nombre y restaúralos en una sesión completamente nueva. Usar los siguientes parámetros te permite mantener una persona con sesión iniciada entre sesiones sin volver a autenticarte cada vez:

Parámetro	Descripción	Tipo
o_profile	Guarda/restaura cookies y localStorage con un perfil con nombre (14 días desde el último uso). Formato admitido: ^[A-Za-z0-9_-]{1,36}$	Cadena
o_profile_save	Fuerza el guardado del perfil en mitad de la sesión. Predeterminado: true.	Booleano
proxy_resi_ses_id	ID de sesión personalizado para fijar la IP de salida residencial entre sesiones. Formato admitido: ^[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 (24 h).	Entero

El número de perfiles por cuenta está limitado (max_profiles). Superar el límite devuelve CDP_LIMIT_REACHED: se alcanzó el límite de perfiles error. Reutiliza un nombre de perfil estable cuando sea posible, o contacta con el soporte de Oxylabs (chat en vivo o correo electrónico) o con tu gerente de cuenta dedicado para aumentar el límite.

Restauración fiable entre sesiones

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

Para asegurar inicios de sesión consistentes, empareja tu 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";