跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.bubench.lexmount.io/llms.txt

Use this file to discover all available pages before exploring further.

local（别名 Chrome-Local）后端通过 Playwright 在本机启动一个 Chromium。开发、小规模跑、不需要云会话时默认用它。
本地浏览器不会继承你的系统 / shell 代理。 即使你的日常 Chrome 经 clash / v2ray / Surge 能正常访问 bloomberg.com，bench 启动的 Chromium 默认仍然走直连——除非你显式配下面的 local_proxy_server。不配的话，需要走代理的站点会静默报 net::ERR_CONNECTION_RESET / ERR_CONNECTION_TIMED_OUT，看起来像是 agent / 模型问题，实则是网络层。

​
配置

在任何支持 browser_id: local 的 agent 下加这些字段： 
# config.yaml
agents:
  skyvern:
    browser:
      browser_id: local
      headless: false
      # 可选代理。server 为空 == 直连（不走代理）
      local_proxy_server: "http://127.0.0.1:7890"   # clash 默认；v2ray 一般 1087/10809；SOCKS 写 socks5://...
      # local_proxy_username: ""                    # 可选鉴权
      # local_proxy_password: ""
      # local_proxy_bypass: "127.0.0.1,localhost,*.local"
字段类型默认说明
local_proxy_serverstring""（不走代理）完整 URL：http(s)://host:port 或 socks5://host:port
local_proxy_usernamestring—可选鉴权用户名
local_proxy_passwordstring—可选鉴权密码
local_proxy_bypassstring—逗号分隔的旁路 host / 通配符

​
Agent 支持矩阵

Agent支持 local_proxy_*？实现方式
skyvern✅ 是直接通过 args 把 --proxy-server=...（如配了 bypass 也加 --proxy-bypass-list=...）传给 Skyvern.launch_local_browser()。注意：bench 走的是 Skyvern 的库模式 launch，绕过了 Skyvern 自己的 setup_proxy() / HOSTED_PROXY_POOL 路径，Chrome flag 才是真正生效的入口
browser-use✅ 是构造 browser_use.browser.profile.ProxySettings 传给 SDK 的 Browser(...)
Agent-TARS❌ 否（会告警）agent-tars CLI 自己启动 Chromium 且没暴露代理参数。配置后 bench 输出一次 WARNING
claude-code❌ 否（会告警）走 @playwright/mcp，目前没有代理透传通道。同样 WARNING
openai-cua❌ 否（会告警）同样 WARNING
deepbrowse❌ 否（会告警）同样 WARNING
不支持代理的 agent 建议切到云端浏览器——见 Lexmount 云浏览器。Lexmount 国际版会话从大陆境外出口，绝大多数被墙站点无需你本地配代理就能访问。

​
安全提示：凭证出现在 Chrome 进程参数里

skyvern agent 把 local_proxy_username / local_proxy_password URL 编码后嵌进 --proxy-server=http://user:pass@host:port 传给 Chrome。Chrome 的进程参数对同机其他用户可见（ps -ef 或 macOS 的 ps auxe）。 如果代理密码敏感（比如团队共享的企业凭证），推荐其中一种：
  • 本地起一个免认证转发器 — clash / v2ray 客户端通常能在 127.0.0.1:7890 监听并自己处理上游认证。这样不要配 local_proxy_username / _password，只填 local_proxy_server: http://127.0.0.1:7890 给 Chrome。
  • 改用 browser-use agent — 凭证直接以进程内对象 ProxySettings(...) 传给 Playwright，不会出现在 Chrome 命令行。

​
验证代理是否生效

挑一个必须走代理才能到达的任务跑一次，看 runtime.log： 
bubench run --agent skyvern --benchmark LexBench-Browser --mode by_id --id 89
设了 local_proxy_server 时，Skyvern 会打印 Connected to proxy http://... 之类的日志，且 navigation 成功。如果你在日常 Chrome 里能打开的站点这里仍然报 ERR_CONNECTION_RESET / ERR_CONNECTION_TIMED_OUT，代理多半没接进去——检查 config 段，并确认你的代理客户端真的在那个端口上监听。