快速开始：无头浏览器

通过简单的分步指南，在几分钟内开始使用 Oxylabs 无头浏览器。

已经熟悉基础知识？请查看 无头浏览器文档.

Oxylabs 无头浏览器 是一个云托管的浏览器基础设施，可自动处理反机器人系统、CAPTCHA 和代理轮换。它与 Playwright、Puppeteer 以及用于 AI 应用的 Model Context Protocol (MCP) 完全兼容。

1

设置与凭据

1. 创建账户： 在以下位置注册： Oxylabs Dashboard.
2. 选择方案： 在 Scraping Solutions → 无头浏览器下选择方案或免费试用。
3. 创建用户凭据： 进入无头浏览器产品部分中的 Users 选项卡，创建用户名和密码（这些凭据用于 WebSocket 身份验证）。

2

你的第一个请求

Oxylabs 无头浏览器使用 Chrome DevTools Protocol (CDP)。你可以使用 Playwright 或 Puppeteer 连接它，而无需管理本地浏览器二进制文件。

Python + Playwright 示例：

1. 安装 Playwright： pip install playwright
2. 运行以下脚本（替换 USERNAME 和 PASSWORD 为你的凭据）：

from playwright.sync_api import sync_playwright

username = "USERNAME"
password = "PASSWORD"
endpoint = "ubc.oxylabs.io"
browser_url = f"wss://{username}:{password}@{endpoint}"

with sync_playwright() as p:
    # 连接到远程 Oxylabs 浏览器
    browser = p.chromium.connect_over_cdp(browser_url)
    page = browser.new_page()
    
    page.goto('https://oxylabs.io/')
    print(f"页面标题：{page.title()}")
    
    browser.close()

连接参考

使用与你偏好的浏览器和地理位置最接近的端点：

浏览器	全球端点	美国端点
Chrome	wss://ubc.oxylabs.io	wss://ubc-us.oxylabs.io
Firefox	wss://ubs.oxylabs.io	wss://ubs-us.oxylabs.io

自定义浏览器

你也可以通过连接 URL 使用查询参数直接传递指令：

参数	示例	描述
p_cc	?p_cc=US	将浏览器流量路由到特定国家。
p_device	?p_device=mobile	模拟特定设备类型（仅限 Chrome）。
o_vnc	?o_vnc=true	启用 Session Inspection Tool 进行可视化调试。

下一步

• 想监控你的浏览器？ 了解 Session Inspection Tool 以实时可视化跟踪你的脚本与浏览器的交互。
• 你的脚本太慢了吗？ 试试 Optimizing Traffic 来阻止不必要的资源加载。这将提升抓取速度并减少带宽消耗。
• 遇到错误或超时？ 访问 Troubleshooting Guide 以解决常见的 CDP 连接问题、库版本不匹配和执行超时。
• 在大型网站上遇到“403 Forbidden”？ 查看 Restricted Targets 列表，了解哪些网站或服务对无头浏览器的访问受到限制。