Lexmount 云浏览器

使用 Lexmount 云浏览器进行大规模自动化评测

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

​

服务地址

Lexmount 提供两个生产环境，按评测实际运行所在地区选择：

环境	管理后台	API base URL
生产（国内）	browser.lexmount.cn	https://api.lexmount.cn
生产（国外）	browser.lexmount.com	https://api.lexmount.com

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 中添加凭证：

LEXMOUNT_API_KEY=your_api_key
LEXMOUNT_PROJECT_ID=your_project_id

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

# config.yaml
agents:
  browser-use:
    browser:
      browser_id: lexmount
      lexmount_browser_mode: normal   # normal | light
      lexmount_api_key: $LEXMOUNT_API_KEY
      lexmount_project_id: $LEXMOUNT_PROJECT_ID

​

登录态管理（Login Contexts）

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

​

Step 1: 创建登录态

# 小红书
bubench login add xiaohongshu

# 淘宝
bubench login add taobao

# 自定义 URL（未内置的站点）
bubench login add my_site --website https://example.com/login

执行后终端会输出 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: 其他命令

# 查看所有已保存的登录态
bubench login list

# 删除本地映射（保留远端 Context）
bubench login remove xiaohongshu

# 同时删除远端 Lexmount Context
bubench login remove xiaohongshu --delete-remote

​

运行需要登录的任务

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

1. 确保已登录

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

2. 使用 Normal 模式

   # config.yaml
   agents:
     browser-use:
       browser:
         browser_id: lexmount
         lexmount_browser_mode: normal
   
3. 运行任务

   bubench run \
     --agent browser-use \
     --benchmark LexBench-Browser \
     --split high_freq_login \
     --mode first_n --count 5
   

​

优势

无需本地浏览器

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

会话持久化

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

并行执行

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

稳定可靠

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

​

注意事项

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