Skip to main content
Lexmount 提供基于云的浏览器实例，用于运行浏览器自动化任务。支持会话保持、登录态管理和大规模并行执行。

​
服务地址

Lexmount 提供两个生产环境，按评测实际运行所在地区选择： API base URL 可选 —— SDK 默认使用国内地址。在 .env 中配置 LEXMOUNT_BASE_URL，或在 config.yaml 中设置 lexmount_base_url 即可覆盖默认值（国外用户建议切换到 .com）。

​
前置条件

1

获取 API Key

到 Lexmount 管理后台注册账号（国内用 browser.lexmount.cn，国外用 browser.lexmount.com），申请 API Key。
2

获取 Project ID

在同一后台创建项目，获取 Project ID。

​
配置

在 .env 中添加凭证：
先复制示例配置（cp config.example.yaml config.yaml），再在根目录 config.yaml 中为对应 Agent 配置云浏览器：

​
登录态管理（Login Contexts）

对于需要登录的任务，使用 bubench login 子命令在 Lexmount 上创建持久化 Context 并保存登录态。评测运行时会根据任务的 target_website 自动 fork 该 Context，一次登录可供多次并发评测复用。

​
Step 1: 创建登录态

执行后终端会输出 Inspect URL。在本地浏览器打开该 URL，完成登录后回到终端按 Enter 保存 Cookie 到 Context。
内置近百个常见站点（电商、社交、视频、办公协作等）。运行 bubench login add help 可查看全部站点清单，或编辑 browseruse_bench/browsers/login_sites.yaml 追加新站点。

​
Step 2: 登录流程

1

运行命令

bubench login add <site> 会创建 Context → 打开远程会话 → 打印 Inspect URL
2

在浏览器中登录

复制终端输出的 Inspect URL，在本地浏览器打开，远程 Chrome 页面已自动跳转到目标站点
3

确认保存

登录完成后，回到终端按 Enter。脚本会关闭会话，Cookie 自动持久化到 Context
登录态记录保存在 browser_data/login_contexts/index.json。

​
Step 3: 其他命令

​
运行需要登录的任务

只要任务的 login_required: true 且 target_website 能解析到已登录站点，运行时会自动挂载对应 Context，无需额外参数：
1

确保已登录

bubench login list 查看目标站点是否已在列表中
2

使用 Normal 模式

3

运行任务

​
优势

无需本地浏览器

在服务器环境运行，无需安装 Chrome

会话持久化

登录状态跨任务保持，无需重复登录

并行执行

支持多个浏览器实例并行运行

稳定可靠

云端隔离环境，避免本地资源冲突

​
注意事项

  • 云浏览器会产生费用，请合理使用
  • Normal 模式的会话有过期时间，请定期检查登录状态
  • 不要在公开环境暴露 API Key