云端浏览器API

该存储库包含 DICloak 浏览器 OpenAPI 的官方文档，支持对 DICloak 反检测浏览器进行编程控制，以实现多帐户管理。

DICloak 云浏览器自动化脚本

本仓库提供了两个基于DICloak 云浏览器 OpenAPI构建的 Python 自动化脚本，支持以编程方式控制无头模式和有头模式下的反检测浏览器环境。非常适合用于安全的多账户管理、联盟营销、社交媒体自动化、广告测试和网页数据抓取。

📂 脚本概览

脚本文件	模式	用例	系统类型
`dicloak_headless.py`	无头	后台自动化、服务器部署、高并发任务	Linux（无头）
`dicloak_headed.py`	标题	交互式调试、可视化验证、人工监督	Windows（带标题）

✨ 主要特点

通过 DICloak OpenAPI 以编程方式配置浏览器指纹、用户代理和代理设置
启动具有唯一数字身份的独立浏览器配置文件，以防止账户关联。
支持灵活的代理策略：RANDOM，，，或USE_ONECOVERAPPEND
获取用于与 Puppeteer、Playwright 或自定义控制器集成的真实 Chrome DevTools 协议 (CDP) WebSocket URL
自动管理浏览器生命周期（打开/关闭）以优化资源使用
按需生成新的环境令牌，以增强安全性和会话隔离。

🛠️ 要求

拥有来自DICloak的有效帐户和 API 访问权限
可用的代理凭据（可选，但建议用于多账户安全）
Python 3.10+ requests（或您首选的 HTTP 客户端库）

📄 API 文档

完整的 API 文档可在官方网站上找到。

保存环境配置

URL： /v2/env
方法： POST

请求参数

姓名	类型	必需的	描述
random_ua	布尔值	是的	随机生成 User-Agent：true：每次打开时重新生成；false：使用首次生成的 User-Agent。
随机指纹	布尔值	是的	随机指纹：true：每次打开时重新生成指纹，false：使用第一次生成的指纹
代理更新类型	细绳	是的	代理账户数据更新模式：COVER：覆盖，APPEND：追加
代理方式	细绳	是的	代理方式：NON_USE：不使用代理（默认新加坡），RANDOM：随机选择已配置的代理账号，USE_ONE：配置的代理账号仅使用一次
代理	[代理人]	是的	代理账户信息
系统类型	细绳	不	启动系统类型：WINDOW：Windows 系统（有头浏览器），LIUNX：Linux 系统（无头浏览器），默认：WINDOW

代理对象结构

姓名	类型	必需的	描述
类型	细绳	是的	代理类型（NON_USE：不使用，HTTP，HTTPS，SSH，SOCKS5）
主持人	细绳	是的	代理主机
港口	细绳	是的	代理端口
用户名	细绳	是的	代理用户名
密码	细绳	是的	代理密码

请求示例

修改所有数据

{
    "proxy_update_type" : "COVER",
    "proxy_way": "RANDOM",
    "proxys": [
        {"type": "SOCKS5","host":"ep.test.com","port":"6616","user_name":"test","passwd":"test"},
        {"type": "SOCKS5","host":"ep.test.com","port":"6616","user_name":"test","passwd":"test"},
     ],
    "random_ua": true,
    "random_fingerprint": true
}

修改代理数据

{
    "proxy_update_type" : "COVER",
    "proxys": [
        {"type": "SOCKS5","host":"ep.test.com","port":"6616","user_name":"test","passwd":"test"},
        {"type": "SOCKS5","host":"ep.test.com","port":"6616","user_name":"test","passwd":"test"},
     ]
}

修改代理方法

{
    "proxy_way": "USE_ONE"
}

修改 UA 数据

{
  "random_ua": true
   "ua": ""
}

修改随机指纹

{
  "random_fingerprint": true
}

回答示例

{
    "code": 0,
    "msg": "success",
    "data": null
}

开放环境

URL： /v2/env/open_env
方法： PATCH

响应参数

姓名	类型	必需的	描述
网址	细绳	是的	CDP 控制连接
session_id	细绳	是的	当前 CDP 会话 ID

错误代码

错误代码	信息	描述
300104	代理配置已过期，请更新代理配置	当 proxy_way 为 USE_ONE 时，已配置的代理帐户已用完。
300105	启动的浏览器实例过多，请关闭一些实例后重试。	运行实例过多，需要关闭之前未使用的实例。
300106	云浏览器异常	云浏览器启动异常，请检查信息进行判断（通常是由于代理信息错误导致无法启动）
300000	业务例外	系统异常，请查看相关信息以作判断。

回答示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "url": "ws://ip:port/cdp/c0d7fb01933d472687c04bdb47337024",
        "session_id": "c0d7fb01933d472687c04bdb47337024"
    }
}

封闭环境

URL： /v2/env/close_env
方法： PATCH

回答示例

{
    "code": 0,
    "msg": "success",
    "data": null
}

Token生成

URL： /v2/env/generate_token
方法： PATCH

响应参数

姓名	类型	必需的	描述
令牌	细绳	是的	新环境使用令牌

回答示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "token": "64CXXXX8-DCEA-4XX1-9D57-9AA1XXXX3F21"
    }
}

主要特点

保存环境配置：配置浏览器设置，例如随机用户代理、随机指纹、代理设置和系统类型（Windows/无头 Linux）。
打开环境：使用配置的设置启动一个新的浏览器实例，并接收 CDP（Chrome DevTools 协议）连接 URL。
关闭环境：终止特定的浏览器实例以释放资源。
生成令牌：创建一个新令牌，以便在新环境中使用。

🛠️ 问题与支持

如果您遇到任何问题、有任何疑问或需要帮助，请在此 GitHub 代码库中提交 issue。我们鼓励您尽可能详细地描述问题，以便我们快速解决您的问题。

DICloak帮助中心