所有文章

Browser Use Cloud 支持托管住宅代理和自带(BYO)代理。使用 BYO 时,你在创建 agent run 或云浏览器时提供第三方代理商的连接信息,从而让你掌控代理商、出口位置和会话设置。

在本教程中,我们将把一个第三方代理连接到 Browser Use Cloud,检查浏览器的出口 IP 和国家,并使用相同的凭据配合 Playwright你需要 Python 3.10 或更高版本、可访问的代理服务商,以及用于云示例的 Browser Use API 密钥。

TL;DR

  1. 获取你的代理凭据。
  2. 连接到 Browser Use。
  3. 检查出口 IP 和国家。
  4. 使用 Playwright 配合该代理。

托管代理与自带代理

代理流量本身的费用可能远高于浏览器时间。对于带宽消耗大的任务,这使得代理费率成为基础设施账单中的重要部分。Agent 和模型费用则另行计算。

托管代理自带代理
设置选择 Browser Use 中的托管代理国家填写你的代理服务商端点与凭据
位置与会话使用 Browser Use 的托管路由设置使用你的代理服务商配置位置和粘性会话
流量价格通过 Browser Use 为 $5/GB你的代理服务商费率加上 $0.20/GB 的 Browser Use 出口费
计费Browser UseBrowser Use 和你的代理服务商分别计费

Browser Use 定价 列出浏览器时间为每小时 $0.02。我们 代理服务商对比 包含约 $1-$4/GB 的费率。按此区间计算,使用 BYO 时,一个浏览器小时加 1 GB 流量约需 $1.22-$4.22(含 Browser Use 出口费),而使用托管代理则为 $5.02。

工作原理

你的 Python 脚本会将任务和浏览器设置发送给 Browser Use。随后,云端浏览器会连接到你的代理服务商,由后者将网站请求通过选定的出口转发出去。目标网站看到的就是该出口 IP。

The Python script starts a Browser Use run through the API; the cloud browser exchanges website traffic through a third-party proxy, and the website sees the proxy exit IP

通过你的代理服务商选择出口国家。 自定义代理 会覆盖 Browser Use 的托管 proxyCountryCode 设置;浏览器区域设置和时区不会决定代理出口。

我们将从托管代理开始,然后在本地和云浏览器中使用 Playwright。开源 browser-use 库使用单独的配置接口。

获取你的代理凭据

从你的代理服务商处获取以下连接信息:

  • 代理主机名
  • 代理端口
  • 代理协议(HTTP/S)
  • 用户名
  • 密码

在你的项目目录中,创建一个虚拟环境并安装依赖项:创建一个包含你的连接详细信息的文件:将占位符主机和端口替换为你代理服务商的值。复制完整的用户名,包括任何国家或会话参数。将 保留为裸主机名。 描述的是与代理的连接,因此 HTTP 代理仍然可以将请求传送到 HTTPS 网站。请将 保密并排除在版本控制之外。脚本使用 加载它;凭据绝不应出现在 age

在你的项目目录中,创建一个虚拟环境并安装依赖项:

$ 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
PROXY_HOST=proxy.example.com
PROXY_PORT=12345
PROXY_PROTOCOL=http
PROXY_USERNAME=your_complete_proxy_username
PROXY_PASSWORD=your_proxy_password

将占位符主机和端口替换为你代理服务商的值。复制完整的用户名,包括任何国家或会话参数。将 PROXY_HOST 为裸主机名。 PROXY_PROTOCOL 描述的是与代理的连接,因此 HTTP 代理仍然可以将请求传送到 HTTPS 网站。

保持 .env 保密并排除在版本控制之外。脚本使用 python-dotenv;凭据绝不应出现在 agent 任务或日志中。

连接到 Browser Use

将以下内容保存为 browser_use_proxy.py 旁边 .env。它会创建一个托管代理运行,并使用 browserSettings.customProxy等待结果,然后关闭其浏览器。

任务开始 ipwho.is,一个独立于你的代理服务商的 IP 地理位置查询工具。其 JSON 响应包含 success, ip,以及 country_code.

import os
 
from browser_use_sdk.v4 import BrowserUse
from dotenv import load_dotenv
 
load_dotenv()
 
proxy = {
    "host": os.environ["PROXY_HOST"],
    "port": int(os.environ["PROXY_PORT"]),
    "protocol": os.getenv("PROXY_PROTOCOL", "http"),
    "username": os.environ["PROXY_USERNAME"],
    "password": os.environ["PROXY_PASSWORD"],
}
 
with BrowserUse() as client:
    run = client.runs.create(
        "Use only the browser to open https://ipwho.is/. "
        "Return only a JSON object containing ip and country_code.",
        model="bu-fast",
        browser_settings={"customProxy": proxy},
        max_cost_usd=0.50,
    )
 
    try:
        result = client.runs.wait_for_completion(run.id, timeout=180)
        print(result.result)
 
    except (Exception, KeyboardInterrupt):
        client.runs.cancel(run.id)
        raise
 
    finally:
        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)

运行脚本:

(venv)$ python browser_use_proxy.py

以下内容 Python SDK 会从你的环境中读取,并处理轮询。 会限制模型和搜索费用;浏览器和网络费用则单独计算。如果等待失败或你中断了等待,脚本会在停止其浏览器之前尝试取消。检查出口 IP 和国家在 Browser Use 中打开该运行,并检查加载了 的浏览器操作。将页面中的 和 与脚本的输出进行比较。我们的测试返回了:你的 IP 会有所不同。检查浏览器的页面,而不只是 agent 的完成状态。来自你本地 BROWSER_USE_API_KEY 从你的环境中读取并处理轮询。 max_cost_usd 会限制模型和搜索费用;浏览器和网络费用则单独计算。如果等待失败或你中断了等待,脚本会在停止其浏览器之前尝试取消。

检查出口 IP 和国家

在 Browser Use 中打开该运行,并检查加载了 https://ipwho.is/将页面中的 ip 和 country_code 与脚本的输出进行比较。我们的测试返回了:

{
  "ip": "24.140.205.193",
  "country_code": "US"
}

你的 IP 会有所不同。

检查浏览器的页面,而不只是 agent 的完成状态。一个 curl 或 requests 来自你笔记本电脑的调用检查的是你笔记本电脑的路由,而不是云浏览器的路由。

要切换国家,请更新服务商的连接详情,位置在 .env,然后重新运行并检查所报告的国家。其他网站可能会对同一 IP 进行不同的分类。

将代理与 Playwright 配合使用

同一套凭据既可用于本地 Playwright 浏览器,也可用于 Browser Use Browser Infrastructure。请选择下面任一示例;每个示例都是一个完整脚本。

在 Python 中配置 Playwright 代理

为本地示例安装 Chromium:

(venv)$ python -m playwright install chromium

将其保存为 playwright_proxy.py 旁边 .env:

import json
import os
 
from dotenv import load_dotenv
from playwright.sync_api import sync_playwright
 
load_dotenv()
 
proxy = {
    "server": (
        f"{os.getenv('PROXY_PROTOCOL', 'http')}://"
        f"{os.environ['PROXY_HOST']}:{os.environ['PROXY_PORT']}"
    ),
    "username": os.environ["PROXY_USERNAME"],
    "password": os.environ["PROXY_PASSWORD"],
}
 
with sync_playwright() as pw:
    browser = pw.chromium.launch(proxy=proxy)
 
    try:
        page = browser.new_page()
        page.goto("https://ipwho.is/", timeout=30_000)
 
        data = json.loads(page.locator("body").inner_text())
 
        print(json.dumps({
            "ip": data["ip"],
            "country_code": data["country_code"],
        }, indent=2))
 
    finally:
        browser.close()

运行脚本:

(venv)$ python playwright_proxy.py

该脚本会打印浏览器的出口 IP 和国家,以便你将其与服务商的设置进行对比。

对于 Playwright 代理认证,将 username ,将 password 中。单独的 选项用于向目标网站进行身份验证。将 Playwright 连接到 Browser Use对于云浏览器,请将其保存为 旁边的 。它会创建一个带有 的浏览器,通过 连接,并检查出口。此版本无需安装本地 Chromium。运行脚本:SDK 的 参数在创建浏览器时设置代理。Agent 运行则改用 。通过 CDP 连接会附加到你已配置好的浏览器。此处, 将云浏览器的生命周期限制为三分钟。 proxy单独的 http_credentials 选项用于向目标网站进行身份验证。

将 Playwright 连接到 Browser Use

对于云浏览器,请将其保存为 playwright_cloud_proxy.py 旁边的 .env它会创建一个带有 customProxy,通过 connect_over_cdp(),并检查出口。此版本无需安装本地 Chromium。

import json
import os
 
from browser_use_sdk.v4 import BrowserUse, CustomProxy
from dotenv import load_dotenv
from playwright.sync_api import sync_playwright
 
load_dotenv()
 
proxy = CustomProxy(
    host=os.environ["PROXY_HOST"],
    port=int(os.environ["PROXY_PORT"]),
    protocol=os.getenv("PROXY_PROTOCOL", "http"),
    username=os.environ["PROXY_USERNAME"],
    password=os.environ["PROXY_PASSWORD"],
)
 
with BrowserUse() as client:
    session = client.browsers.create(custom_proxy=proxy, timeout=3)
 
    try:
        with sync_playwright() as pw:
            browser = pw.chromium.connect_over_cdp(session.cdp_url)
            page = browser.contexts[0].new_page()
            page.goto("https://ipwho.is/", timeout=30_000)
 
            data = json.loads(page.locator("body").inner_text())
 
            print(json.dumps({
                "ip": data["ip"],
                "country_code": data["country_code"],
            }, indent=2))
 
    finally:
        client.browsers.stop(session.id)

运行脚本:

(venv)$ python playwright_cloud_proxy.py

SDK 的 custom_proxy 参数在创建浏览器时设置代理。Agent 运行则改用 browser_settings={"customProxy": proxy} 而是通过 CDP 连接到你已配置好的浏览器。

此处, timeout 将云浏览器的生命周期限制为三分钟。 finally 单独的这个选项也会明确阻止它:仅关闭 CDP 连接并不会停止云浏览器。

故障排查

先填写代理凭据和端点,然后检查浏览器配置和目标地址。

症状需要检查的内容
Browser Use API 返回身份验证错误检查 Browser Use API 密钥和项目。这与你的代理服务商的身份验证是分开的。
代理返回 407,或 Chromium 报告身份验证错误检查代理用户名/密码,包括必需的路由参数。在 Playwright 中,将凭据放入 proxy.
代理连接失败或超时验证主机、端口、协议、服务商访问权限以及网络可达性。云浏览器无法使用仅绑定到你笔记本电脑本地主机的代理。
隧道或 TLS 错误检查代理支持的协议和证书要求。HTTPS 目标并不自动要求与代理之间使用 HTTPS 连接。避免将禁用证书验证作为默认修复方案。
脚本报告了错误的国家用你的代理服务商核对所选国家,然后创建一个全新的浏览器。Browser Use 的托管国家字段不会覆盖自定义代理。
检查器工作正常,但目标地址返回 403 或 429检查目标站点的限制、速率限制以及实际页面。代理能正常工作,并不保证目标站点会接受该会话。

在本地测试中,错误的密码和无法访问的代理端口都会导致超时。诊断超时时,请检查凭据和连通性;身份验证失败并不总是会产生可见的 407。

生产环境提示

对于多步骤任务,请在保留代理会话的同时保留浏览器 Cookie 和存储。仅靠粘性 IP 无法保留登录状态,也无法确保不同浏览器共享同一出口。

限制重试次数,并停止未使用的浏览器。比较两个服务的带宽账单;失败的请求和重复的页面加载也会消耗流量。

如果创建请求在返回 ID 之前超时,请在重试前检查仪表板,以免启动重复的工作。

结论

你现在已经具备了一套配置,可以将第三方代理连接到 Browser Use,检查浏览器的出口 IP 和国家,并将其与 Playwright 配合使用。先在你实际需要的网站上执行一个小型只读任务,然后在可用的配置基础上继续构建。

来源与延伸阅读:

发布于 2026 年 11 月 11 日

继续阅读

所有文章

教程

2026年11月9日

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

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

Nik Tomazic

精选合集

/2026年11月6日

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

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

Nik Tomazic

解读

/2026年11月5日

计算机使用 vs 浏览器使用:AI 智能体应如何控制软件

计算机使用代理读取截图并点击整个桌面上的像素。浏览器使用代理则通过页面和 CDP 驱动真实浏览器。两者的区别,以及何时选择哪一种。

Gregor Zunic