所有文章

Browser Use 的 profile 可让新的浏览器复用此前的登录状态。在附加该 profile 的情况下登录,停止浏览器以保存其状态,然后在下次运行时传入相同的 profile ID。网站仍会决定该登录状态的有效期。

在本教程中,我们将使用一个专用演示 profile 设置 Browser Use 认证,在两次独立运行中验证访问权限,并用 Playwright 的存储状态做同样的操作。你需要 Python、一个 Browser Use API 密钥, 以及云运行的额度。我们将使用一个公开测试账号,因此你无需导入自己的个人浏览器 profile。

简而言之

  1. 创建一个空的 Browser Use profile。
  2. 登录并停止浏览器以保存其状态。
  3. 使用相同的 profile ID 启动新的运行。
  4. 检查已认证的访问权限,并在需要时续期登录。

工作原理

登录后,网站通常通过 Cookie 或浏览器存储中的令牌来识别你的浏览器。一个 profile 会保存 Cookie 和本地存储,以便另一个云浏览器使用它们。 会保存 Cookie 和本地存储,以便另一个云浏览器使用它们。

The first run logs in with browser A, stopping it saves the profile, and a second run loads the same profile into browser B

Profile 与 agent 会话会话保存对话内容,而 profile 保存浏览器状态。继续对话可以复用仍在运行的浏览器,因此同一浏览器中的两个任务并不能证明已保存的登录状态在重启后仍然有效。

我们将显式停止第一个浏览器,并为第二次运行启动一个新的对话。唯一共享的输入将是 profile ID。

创建演示 Profile

在 Browser Use Cloud:

  1. 打开 Configuration -> Profiles。
  2. 点击 Create Profile。
  3. 输入一个名称,例如“ Login reuse tutorial.
  4. 选择“从零开始”。
  5. 复制新 profile 的 ID。

新的 profile 不应显示任何已存储的 Cookie 域。请在本教程中使用这个空 profile,以便将你的个人账户隔离开来。API 密钥和 profile 必须属于同一个项目。 同一项目.

创建一个项目目录,设置虚拟环境,并安装依赖项:

$ python3 -m venv venv
$ source venv/bin/activate
(venv)$ python -m pip install browser-use-sdk==3.12.1 \
  playwright==1.62.0 python-dotenv==1.2.2

创建一个 .env 文件:

BROWSER_USE_API_KEY=your_browser_use_api_key
BROWSER_USE_PROFILE_ID=your_demo_profile_id

将这些条目添加到 .gitignore:

.env
venv/
playwright/.auth/

我们的目标是 互联网的登录页面,该页面会公布其测试用户名和密码。登录后,它会打开 /secure ,并带有 Secure Area 标题和 Logout 链接。这些为我们提供了第二次运行的具体检查点。

登录并保存 Profile

将其保存为 browser_use_profile.py 旁边 .env它会使用演示 profile 登录,等待结果,然后停止浏览器以保存其状态。

import os
 
from browser_use_sdk.v4 import BrowserUse
from dotenv import load_dotenv
 
load_dotenv()
 
task = (
    "Open https://the-internet.herokuapp.com/login and log in "
    "with the public demo credentials shown there. "
    "Confirm the Secure Area heading is visible. Do not log out."
)
 
with BrowserUse() as client:
    run = client.runs.create(
        task,
        model="bu-fast",
        browser_settings={"profileId": os.environ["BROWSER_USE_PROFILE_ID"]},
    )
    result = client.runs.wait_for_completion(run.id)
    print(result.result)
 
    browsers = client.browsers.list(agent_session_id=run.session_id)
    for browser in browsers.items:
        if browser.status.value == "active":
            client.browsers.stop(browser.id)

运行一次以登录并保存 profile:

(venv)$ python browser_use_profile.py

该任务使用测试网站上显示的公开凭据。对于真实账户,请使用适当的凭据流程,例如 1Password,而不是在任务中放入私人密码。

该脚本通过 V4 浏览器设置传入。 profileId 通过 V4 浏览器设置停止浏览器会将其状态保存到该 profile。等待脚本完成后再开始下一次运行。如果执行被中断,请先在仪表板中停止浏览器,然后再继续。

停止浏览器之前不要点击 Logout:那会保存网站的登出状态。关闭浏览器和退出网站登录是两种不同的操作。

在第二次运行中复用登录状态

在以下位置保持相同的 profile ID: .env只替换 task 中的赋值 browser_use_profile.py ,其中:

task = (
    "Open https://the-internet.herokuapp.com/secure. "
    "Do not log in. If redirected to login, report LOGIN_REQUIRED "
    "and stop. Otherwise confirm the Secure Area heading is visible."
)

再次运行该脚本:

(venv)$ python browser_use_profile.py

每次调用都会创建一个新的智能体对话,因为脚本没有传入一个 session_id第一个浏览器已经停止,因此本次运行必须将已保存的 profile 加载到一个全新的浏览器中。

复用任务不包含任何凭据,也没有登录回退机制。如果网站重定向到 /login,它应当报告 LOGIN_REQUIRED 并停止。

在 2026 年 11 月 15 日的测试中,两次运行都到达了受保护页面。我们还分别连接了每个正在运行的浏览器,独立于智能体的回答检查了其 URL、标题和 Logout 链接:

检查首次运行第二次运行
浏览器 IDa9ec014b...23addfdc...
页面 URL/secure/secure
Secure Area 标题可见Logout 链接可见可见登录表单已填写是/否清理后浏览器状态已停止已停止此处浏览器 ID 已缩写。第二次运行的操作轨迹显示导航到 以及页面检查,没有输入凭据。这演示了在演示网站上跨不同浏览器生命周期的复用;它并不保证其他网站会接受转移的登录。如需自行检查,请查看该运行的浏览器操作和最终响应。确认受保护 URL 和一个已认证元素,即
Logout 链接可见可见
登录表单已填写否否
清理后的浏览器状态已停止已停止

此处浏览器 ID 已缩写。第二次运行的操作轨迹显示导航到 /secure 以及页面检查,没有输入凭据。这演示了在演示网站上跨不同浏览器生命周期的复用;它并不保证其他网站会接受转移的登录。

如需自行检查,请查看该运行的浏览器操作和最终响应。确认受保护 URL 和一个已认证元素,然后在进行账户相关操作之前检查预期的账户身份。

作为对照,选择第二个空 profile,并用第二个任务再次运行脚本。它应当达到登录要求。我们的空 profile 云端运行正是如此。之后切回原来的演示 profile;对照运行不需要登录。

保存 Playwright 认证状态

使用本地 Playwright,你可以将认证状态保存到 JSON 文件,并将其加载到新的浏览器上下文中。JavaScript API 将其称为 storageState;Python 使用 storage_state.

安装 Chromium:

(venv)$ python -m playwright install chromium

首先,将其保存为 playwright_login.py它会登录公开演示账户,并将已认证状态写入文件:

from pathlib import Path
 
from playwright.sync_api import expect, sync_playwright
 
Path("playwright/.auth").mkdir(parents=True, exist_ok=True)
 
with sync_playwright() as pw:
    browser = pw.chromium.launch()
    context = browser.new_context()
    page = context.new_page()
    page.goto("https://the-internet.herokuapp.com/login")
    page.get_by_label("Username").fill("tomsmith")
    page.get_by_label("Password").fill("SuperSecretPassword!")
    page.get_by_role("button", name="Login").click()
    heading = page.get_by_role("heading", name="Secure Area", exact=True)
    expect(heading).to_be_visible()
    context.storage_state(path="playwright/.auth/demo.json")
    browser.close()

接下来,将其保存为 playwright_reuse.py它会启动一个新的浏览器,加载该文件,并在不输入凭据的情况下打开受保护页面:

from playwright.sync_api import expect, sync_playwright
 
with sync_playwright() as pw:
    browser = pw.chromium.launch()
    context = browser.new_context(storage_state="playwright/.auth/demo.json")
    page = context.new_page()
    page.goto("https://the-internet.herokuapp.com/secure")
    heading = page.get_by_role("heading", name="Secure Area", exact=True)
    expect(heading).to_be_visible()
    browser.close()

从同一目录分别运行它们:

(venv)$ python playwright_login.py
(venv)$ python playwright_reuse.py

当认证成功时,两个脚本都会在未出现断言错误的情况下结束。第一个脚本在保存之前检查 Secure Area 标题;第二个脚本在加载已保存的状态之后检查该标题。如果被重定向到登录页面,该检查就会失败。

Playwright 的 认证状态 包括 Cookie 和本地存储。如果你的应用将认证信息存储在 IndexedDB 中,请在保存时选择启用:

context.storage_state(path="playwright/.auth/demo.json", indexed_db=True)

sessionStorage 需要单独处理。存储状态文件也与持久化的浏览器用户数据目录不同:它不会保存每个标签页、扩展或浏览器设置。请选择你的应用实际需要的状态。

处理过期的 Cookie

保存的状态并不能让登录永久有效。Cookie 可能会过期,服务器可能会撤销其会话,或者网站在设备或网络发生变化后可能要求进行另一次验证。 Browser Use 的 profile 指南 描述了这些限制。

每个任务开始时,先检查受保护页面或预期的账户身份。如果保存的登录状态失效:

  1. 停止正常工作流程,并报告需要进行身份验证。
  2. 完成网站支持的登录和验证流程。
  3. 保存更新后的状态:停止 Browser Use 浏览器,或写入新的 Playwright 状态文件。
  4. 在继续任务之前,重试一次小型的只读检查。

在本演示中,请恢复第一个任务,并使用相同的 profile ID 运行云脚本,然后重复第二个任务。在本地,重新运行 playwright_login.py 以替换已保存的 JSON 文件,然后运行 playwright_reuse.py 以进行检查。

要在本地测试失败路径,请将空状态加载到新的上下文中,并打开 /secure:

context = browser.new_context(storage_state={"cookies": [], "origins": []})
page = context.new_page()
page.goto("https://the-internet.herokuapp.com/secure")
expect(page).to_have_url("https://the-internet.herokuapp.com/login")

这项检查在我们的测试中通过了。它模拟的是缺少认证状态的情况;我们并没有等待 Cookie 自然过期。修改 Cookie 的过期时间戳并不是续期服务器已拒绝的会话的办法。

保持用户配置文件相互独立

为每个最终用户使用不同的 Browser Use profile。你的应用可以维护如下映射:

应用用户Browser Use profile本地 Playwright 文件
AliceAlice 的 profile IDplaywright/.auth/alice.json
Bob 的 profile IDBob 的 profile IDplaywright/.auth/bob.json

以上为示例性说明。上方的演示验证的是登录持久性和空配置文件对照,而非两个真实客户账户之间的隔离。

从服务器上已认证的应用用户中查找 profile。不要让请求选择任意客户的 profile ID。在目标网站上做出更改之前,请核实可见的账户或工作区以及登录状态。

如果两个浏览器上下文使用同一个账户,那么即使它们彼此隔离,也无法在网站服务器上隔离数据。两个共享同一账户的 worker 仍然可以修改相同的记录。作为实用的默认做法,应串行执行更新同一 profile 的任务,或者在任务需要独立状态时使用不同的账户和 profile。

故障排查

症状应检查的内容
第二次运行到达登录页面确认使用了相同的 profile ID,并且第一个浏览器在成功登录后已停止。检查网站是否拒绝了该会话或使其过期。
它在后续运行中有效,但在新对话中失败后续运行可能复用了仍在运行的浏览器。请重复停止并重启的检查。
无法加载配置文件请使用该 profile 所属项目中的 API 密钥。对话 ID 或工作区 ID 并不是 profile ID。
Playwright 找不到状态文件运行 playwright_login.py ,并使用相同的工作目录来运行 playwright_reuse.py.
状态已加载,但缺少认证检查来源和存储机制。IndexedDB 需要主动启用;sessionStorage 不会被保存。 storage_state.
错误的用户出现检查应用用户到 profile 的映射,并在执行账户特定操作之前停止。
保存的登录状态会触发额外的验证步骤完成网站支持的验证流程。已保存的 Cookie 并不能绕过其安全策略。

生产环境提示

像对待凭据一样对待已保存的 Cookie 和状态文件。不要将它们提交到 git、公开截图或日志中,并限制谁可以使用这些 profile 或读取这些文件。演示密码是公开的;真实账户凭据则不是。

让自动化 profile 专用于其对应的账户和用途。在执行工作前验证身份认证,限制恢复尝试次数,并明确提示需要重新认证,而不是反复提交相同的失败登录。

请显式停止未使用的浏览器。在本示例中,同时停止这两个浏览器既能限制浏览器的存活时间,也能完成下一次运行所需的 profile 保存步骤。

结论

现在有两种方式可以复用有效登录:在云端运行之间使用 Browser Use profile,或在本地执行之间使用 Playwright 状态文件。请在新的浏览器中验证访问权限,保持用户相互隔离,并在网站要求时续期认证。请参阅 Browser Use profile 文档 以用于此处的 profile 设置。

发布于 2026 年 11 月 15 日

继续阅读

所有文章

教程

/2026年11月11日

如何在 Browser Use 中使用自定义代理

将你自己的代理连接到 Browser Use Cloud,验证浏览器的出口 IP 和国家/地区,并在本地或云端 Playwright 中复用该设置。

Nik Tomazic

教程

/2026年11月9日

使用 1Password 和 Browser Use 自动填充密码

将 1Password 连接到 Browser Use,通过服务账号为智能体授予只读的保险库访问权限,并自动化并验证一次登录。

Nik Tomazic

文章合集

/2026年11月6日

2026 年 AI 智能体最佳代理服务商

比较八家面向浏览器自动化和 AI 智能体的住宅代理服务商,包含实操任务测试、入门价格以及粘性会话的取舍。

Nik Tomazic