配置浏览器代理

选择一种代理来源

官方代理、外部代理和 SDK 本地代理是互斥的会话选项。它们作用于浏览器流量，不应推断 SDK 自身的 API 请求或独立 Web Fetch 请求也经过相同代理。

const session = await client.sessions.create({
  browserMode: 'normal',
  officialProxy: true,
});

官方代理需要项目有可用的代理流量额度。Free 每个用量周期包含 100 MB，Pro、Pro+ 和 Enterprise 每周期包含 1 GB。上传和下载流量都计入额度；耗尽后无法创建新的官方代理会话。自定义上游使用代理服务商提供的凭据：

const session = await client.sessions.create({
  browserMode: 'normal',
  proxy: {
    type: 'external',
    server: process.env.PROXY_SERVER!,
    username: process.env.PROXY_USERNAME,
    password: process.env.PROXY_PASSWORD,
  },
});

PROXY_SERVER 填服务商地址，包含协议和端口，例如 http://proxy.example.net:8080。以上是二选一的创建片段，不是连续执行两次；创建后必须在 finally 关闭会话。

验证实际出口

在浏览器页面访问自有或可信的 IP 检查接口，对照服务商预期出口，再测试真正的目标网站。创建会话返回 HTTP 200 不代表代理认证或目标访问成功。不要在截图、分享 URL 或日志中包含代理密码。

407 先检查上游认证；连接失败检查协议、端口、服务商白名单和网络可达性。代理请求成功不保证所有网站均可访问。参见故障排查和代理示例。

SDK 本地代理

需要从云浏览器访问 SDK 电脑可达的公司内网、VPN 或开发站点时，使用 client.tunnels.open()，再以 proxy.type=local 创建普通浏览器会话。完整 Node.js/Python 示例、同区域要求、生命周期和故障排查见 本地代理指南。