快速上手：无头浏览器

通过简单的分步指南，只需几分钟即可开始使用 Oxylabs 无头浏览器。

已经熟悉基础内容？查看 无头浏览器文档.

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

1

设置与凭据

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

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 = "hb.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: {page.title()}")
    
    browser.close()

浏览器自定义

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

参数	示例	描述
p_cc	?p_cc=US	将浏览器流量路由通过特定国家。
p_device	?p_device=mobile	模拟特定设备类型。
session_name	?session_name=ses-1	创建粘性会话，使你的远程浏览器实例持续在云端运行。

在无头浏览器 文档中.

下一步

• 想监控你的浏览器吗？ 了解 Session Inspection Tool ，以实时可视化跟踪脚本与浏览器的交互。
• 你的脚本太慢吗？ 试试 优化流量 以阻止不必要的资源加载。这将提高抓取速度并减少带宽消耗。
• 遇到错误或超时？ 访问 故障排除指南 以解决常见的 CDP 连接问题、库版本不匹配和执行超时。
• 在大型网站上遇到 "403 Forbidden"？ 查看 受限目标 列表，了解哪些网站或服务限制通过无头浏览器访问。