穿云 NodeJS API 集成指南

概述:
穿云 API 致力于帮助开发者轻松绕过 Cloudflare 的严苛验证,包括 WAF 防护5秒盾(JS Challenge)Turnstile CAPTCHA。通过模拟全栈浏览器指纹(如 JA3HTTP/2),穿云能确保您的爬虫程序在复杂的反爬环境下依然能够稳定获取数据。


发起请求:核心逻辑与参数

穿云 API 采用标准的 HTTPS 协议,支持所有 HTTP 方法。

  • API 接口地址: https://api.cloudbypass.com
  • V2 核心逻辑: 与旧版 V1 不同,V2 接口必须提供固定或具有时效性的 IP 代理。当遇到 Cloudflare 挑战时,系统会自动执行破解逻辑。挑战成功后,穿云将存储该会话 10 分钟,后续请求将自动复用并续期会话。

必须配置的请求头 (Headers):

参数名描述示例
x-cb-apikey您的唯一 API 密钥your_api_key_here
x-cb-host目标服务器的主机名 (Host)www.example.com
x-cb-proxy必填 (V2)。设置您的 IP 代理服务器地址http://user:pass@host:port
x-cb-part选填。设置会话分区,用于实现不同任务间的会话隔离session_01

NodeJS 代码实现 (Axios 示例)

规范化的代码块如下,已针对 V2 同步模式进行优化:

const axios = require('axios');

/**
 * 穿云 API V2 绕过 Cloudflare 测试脚本
 */
async function fetchTargetPage() {
    const config = {
        method: 'get',
        url: 'https://api.cloudbypass.com/path/to/page', // 替换为目标站点的路径
        headers: {
            'x-cb-apikey': '您的API密钥',
            'x-cb-host': 'www.target-website.com',   // 目标网站域名
            'x-cb-proxy': 'http://proxy_user:proxy_pass@proxy_host:proxy_port', // V2必须配置代理
            // 'x-cb-part': 'custom_partition',      // 如需会话隔离请取消注释
            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36'
        }
    };

    try {
        const response = await axios(config);
        console.log('状态码:', response.status);
        console.log('返回内容:', response.data);
    } catch (error) {
        console.error('请求失败:', error.response ? error.response.data : error.message);
    }
}

fetchTargetPage();

调试与参考工具

  1. 代码生成器:如果您需要生成更复杂的请求(如 POST 或处理 Cookie),请使用官方工具:
    👉 穿云 API 代码生成器(NodeJS / V2)
  2. 详细文档:关于指纹模拟、JA3 算法对齐及更多高级配置,请参考:
    👉 NodeJS 快速开始文档