云代理浏览器
内容
Cloud Proxy Browser 是一款专为网页抓取和自动化而设计的可自动扩展解决方案。它让您能够在我们完全托管的云浏览器实例上无缝运行自动化和抓取代码,利用多个代理网络(包括住宅和移动 IP),并管理反检测浏览器的高级解锁功能,例如真实用户指纹、JavaScript 渲染等。
爬虫浏览器 或云端代理浏览器已包含在您的 NodeMaven 代理套餐中，这意味着您只需为通过我们的浏览器实例使用的代理流量付费
主要功能：
- 无缝集成
原生支持 Playwright、Puppeteer、Selenium 以及其他基于 CDP 的自动化框架，轻松运行脚本。 - 自动扩展基础设施
根据需求动态扩展浏览器实例，实现无限并发会话，无需手动分配资源。 - 高级代理管理
通过以下方式访问高质量的住宅代理和移动代理：- 深度定位(国家、地区、城市、ISP)
- 粘性会话和轮换会话,可实现稳定连接或频繁更换 IP
- IP 质量过滤，确保获得高信任、低风险的 IP
- 真实用户指纹
智能指纹轮换可维持真实、一致的配置,包括:- 硬件规格、操作系统、时区、语言、屏幕分辨率、字体、canvas、WebGL、WebRTC 等等。
- 可自定义的伪装，用于模拟真实用户行为并绕过检测系统。
- JavaScript 渲染
通过完整的 JavaScript 执行支持，确保动态内容准确渲染。 - 实时调试
使用 Chrome DevTools Protocol (CDP) 检查和控制实时浏览器会话，以便排查故障、记录日志和优化脚本。
快速入门指南
1. 快速入门
- 注册地址: NodeMaven 仪表板 并购买代理流量，例如 住宅代理。
- 根据您的代理和浏览器配置需求生成云代理浏览器 CDP URL。您将在网页自动化工具中使用这些 URL。
- CDP URL 构建参数
连接字符串的结构如下：
wss://username_country-{country}-region-{region}-city-{city}-isp-{isp}-type-{type}-sid-{sid}-pid-{pid}:[email protected]:8080
参数：
用户名：您的 NodeMaven 用户名（与代理中的用户名相同）
密码：您的 NodeMaven 用户名（与 proxyusername 相同）
国家, 地区, 城市, isp：定位选项
国家 – 必填参数
地区, 城市, isp – 可选参数
type-mobile：如果只想获取移动 IP，可添加此标志
sid：用于粘性会话的代理会话 ID。如果想获取轮换代理，请删除此参数，这意味着每次请求都会获得新的 IP
pid：包含浏览器配置文件特定设置的配置文件 ID
bsid：浏览器会话 ID，用于在多次请求之间保持会话持久性。
2. 建立首次连接
- 运行以下基础代码示例，检查您的 Cloud Proxy Browser 是否正常工作（记得替换为您自己的凭据和目标 URL）：
Puppeteer
const puppeteer = require('puppeteer'); (async () => { const browser = await puppeteer.connect({ browserWSEndpoint: 'wss://your_connection_string_here' }); const page = await browser.newPage(); await page.goto('https://example.com'); console.log(await page.title()); await browser.close(); })();Playwright
const { chromium } = require('playwright'); (async () => { const browser = await chromium.connectOverCDP('wss://your_connection_string_here'); const page = await browser.newPage(); await page.goto('https://example.com'); console.log(await page.title()); await browser.close(); })();Selenium
from selenium import webdriver options = webdriver.ChromeOptions() options.debugger_address = 'wss://your_connection_string_here' driver = webdriver.Chrome(options=options) driver.get('https://example.com') print(driver.title) driver.quit()3. 使用 Chrome DevTools 查看实时浏览器会话
启用 Chrome DevTools 调试器，以实时监控脚本执行并调试问题，从而提升控制力、可见性和效率。使用以下代码片段可为每个会话自动启动 DevTools：
await page.evaluate(() => { debugger; });
重要提示:限制说明
- 空闲会话超时：5 分钟
- 如果浏览器会话闲置 5 分钟或更长时间且无任何活动，云代理浏览器将自动终止该会话。
- 每用户并发会话数：无限制
- 最大持久配置文件数：根据您的套餐而定
API 文档
配置文件管理
- 创建一次性配置文件（
POST /profiles/one-time/{id}/start) - 获取配置文件信息(
GET /profiles/{id}) - 创建持久化配置文件 (
POST /profiles/persistent/{id}/start) - 更新持久化配置文件(
PATCH /profiles/persistent/{id}) - 删除持久化配置文件(
DELETE /profiles/persistent/{id}) - 批量删除持久化配置文件 (
DELETE /profiles/persistent/{id})
Cookie 管理
- 导出 Cookies（
GET /profiles/{id}/cookies?format=json) - 导入 Cookies（
POST /profiles/{id}/cookies)
指纹选项
- 获取 GPU 渲染器 (
GET /fingerprint/gpu?os=linux&arch=x86_64) - 获取屏幕分辨率(
GET /fingerprint/resolutions?os=windows)
常见错误响应
400 Bad Request：参数无效401 未授权：凭证无效429 请求过多：已超出速率限制
