持久会话和配置文件

了解 Oxylabs 代理浏览器上的持久（粘性）会话和持久配置文件。重新连接到进行中的会话，并在多个会话中复用您的 Cookie 或本地存储。

管理长时间运行的多阶段自动化工作流，或在不同连接序列之间维护已登录用户状态，需要持久化浏览器状态。Oxylabs Agent Browser 提供两种高级持久化系统：

持久会话	即使客户端断开连接，也保持远程浏览器环境持续运行。
持久化配置文件	保存并恢复 Cookie、本地存储和浏览器缓存。

持久会话

持久（粘性）会话会让你的远程浏览器实例在云端持续运行（即使本地自动化脚本断开连接），方法是定义一个自定义 session_name 到你的连接 URL：

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

持久会话已 默认启用 ，适用于所有用户，默认限制为 5 个并发会话。如果你需要更高的限制，请联系 Oxylabs 支持（在线聊天 或 电子邮件）或你的专属客户经理。

参数	描述	类型
session_name	定义后，会话可持续保留至最大生存时间（TTL）（最长 24 小时或直到停止）。使用相同的 session_name 以重新附加到相同的会话 ID 和现有标签页。支持的格式： ^[A-Za-z0-9-]{3,36}$	字符串
keep_alive	当 false （默认），调用 browser.close() 会回收并关闭会话。 当 true时，在你断开连接后，会话仍会在云端保持运行（最多 10 分钟）。	布尔值

重新连接到现有标签页

// 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 "));

持久化配置文件

持久化配置文件已 默认启用 ，适用于所有用户，默认限制为 5 个配置文件。可用于在命名配置文件下保存 Cookie 和 localStorage，并在全新的会话中恢复它们。以下参数可让你在各个会话之间保持已登录状态，而无需每次重新认证：

参数	描述	类型
o_profile	使用命名配置文件保存/恢复 Cookie 和 localStorage（距上次使用 14 天内）。支持的格式： ^[A-Za-z0-9_-]{1,36}$	字符串
o_profile_save	在会话期间或结束时强制保存配置文件。默认： false.	布尔值
proxy_resi_ses_id	自定义会话 ID，用于在各会话间固定住宅出口 IP。支持的格式： ^[A-Za-z0-9]{3,36}$.	字符串
proxy_resi_ses_time	以分钟为单位，保持固定住宅代理出口 IP 的持续时间。最小值 1，最大值 1440 （24 小时）。	整数

超过 max_profiles 限制 5 会返回 CDP_LIMIT_REACHED: 已达到配置文件上限 错误。你可以直接在 Dashboard（hb.oxylabs.io/dashboard）中查看和删除已保存的配置文件，如果达到上限，或者复用一个稳定的配置文件名称。若需要更高限制，请联系 Oxylabs 支持（在线聊天 或 电子邮件）或你的专属客户经理。

可靠的跨会话恢复

对于具有严格机器人监测系统的网站，仅保存 Cookie 还不够。如果恢复的配置文件从不同的住宅出口 IP 连接，你的 Cookie 可能会失效，导致空白页面或安全验证界面。

为确保登录保持一致，请将你的配置文件与固定的住宅出口 IP 配对：

// 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";