青果浏览器
产品使用文档 v1.0

产品使用文档

青果浏览器 · 新环境 · 新指纹 · 畅采集

青果浏览器是一款专为数据采集工程师打造的指纹伪装浏览器。它可以为每个采集任务创建独立的浏览器环境，每个环境拥有不同的浏览器指纹，并可挂载代理IP，从而避免因指纹相同导致的账号关联或IP封禁。

核心价值： 新环境 · 新指纹 · 畅采集 —— 每次打开都是全新身份，真IP+真指纹双重伪装。

二、安装与登录

2.1 下载客户端

访问青果网络官网，下载对应操作系统（Windows）的青果浏览器客户端安装包，双击安装即可。

2.2 登录账号

打开客户端后，使用青果系统的账号密码登录。登录成功后进入主界面。

若忘记密码，可点击登录页的“忘记密码”跳转至青果官网找回。

三、界面概览

客户端主要分为四个功能模块：

模块 功能说明
环境管理 创建、编辑、删除、启动/关闭浏览器环境
代理配置 管理代理IP资源，供环境挂载使用
本地服务 查看API Key，用于程序化调用本地接口

四、快速上手：创建一个采集环境

4.1 第一步：准备代理（可选）

如果需要使用代理IP，请先在「代理配置」中添加代理。支持三种方式：

  • 自定义代理：手动填写 HTTP/HTTPS/SOCKS5 代理信息。
  • API 提取链接：填入代理平台的提取URL。
  • 同步青果 Authkey：一键同步青果系统中的 API 提取密钥。

添加后可点击「测试连接」检查代理是否可用。

4.2 第二步：创建环境

进入「环境管理」，点击「新建环境」，进入三段式创建向导：

  • 基本信息：填写环境名称，支持粘贴 JSON 格式 Cookie。
  • 代理配置：选择已添加的代理、自定义代理或 API 提取链接。可测试连通性。
  • 指纹配置：一键随机生成指纹，或手动调整。建议将语言/时区/地理位置设为「基于代理IP自动生成」。

4.3 第三步：保存并启动

保存后环境出现在列表中，点击「打开」按钮，独立指纹浏览器即会启动，并自动打开检测页展示代理IP与指纹信息。

环境管理常用操作

  • 打开/关闭环境 · 编辑配置 · 删除环境 · 复制环境ID（用于API调用）
注意：同一环境同一时间只能在一台设备上打开，防止冲突。

六、使用 API 进行自动化调用

青果浏览器提供本地 HTTP API，支持通过代码控制环境启动/关闭/状态查询。

6.1 获取 API Key

在「本地服务」页面查看并复制 API Key。调用接口时需在请求头中携带：Authorization: Bearer <你的API Key>

6.2 基础接口示例

本地 API 默认地址：http://127.0.0.1:54345

启动环境：

curl -X POST http://127.0.0.1:54345/api/v1/browsers/start \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"env_id": "你的环境ID"}'

关闭环境：

curl -X POST http://127.0.0.1:54345/api/v1/browsers/stop \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"env_id": "你的环境ID"}'

6.3 与自动化框架集成

获取启动返回的 debug_port 后，可使用 Playwright 连接浏览器：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.connect_over_cdp("http://127.0.0.1:9222")
    page = browser.new_page()
    page.goto("https://目标网站.com")
    # ... 采集逻辑

七、常见问题

Q1：打开环境后网页显示“代理检测中”或无法联网？

请检查代理配置，可在环境编辑页点击「测试连通性」。部分代理需将本机IP加入白名单。

Q2：指纹随机后网站还是能识别我？

请确保语言、时区、地理位置与代理IP一致，建议设为「基于代理IP自动生成」。保持硬件指纹保护开关开启。

Q3：能否多台电脑同时打开同一环境？

不可以。同一环境仅允许单设备运行，另一设备打开时会提示“已在另一台设备上打开”。

Q4：API 返回鉴权失败？

检查 API Key 是否正确，以及是否在请求头中携带。

Q5：客户端关闭后浏览器会怎样？

客户端退出时所有由其启动的浏览器环境均会自动关闭。

八、联系与支持

  • 帮助文档：客户端内嵌完整 API 文档与代码示例
  • 官网：https://www.qg.net
  • 技术支持：联系青果网络客服或提交工单
© 2026 青果网络 · 青果浏览器