穿云 API Go 开发指南

概述:
穿云 API 致力于为开发者提供极速绕过 Cloudflare 验证的解决方案。目前已全面支持绕过 WAF 防护Turnstile CAPTCHA 以及 5 秒盾(JS Challenge)

本文档详细说明了如何通过 Go 语言集成穿云 HTTP API。通过模拟 JA3 指纹HTTP/2 全栈环境,您可以像访问普通接口一样访问受保护的目标网站。


发起请求:V2 核心逻辑

穿云 API 采用标准的 HTTPS 协议,支持所有 HTTP 请求方法。在 V2 架构下,系统引入了更智能的会话保持与指纹对齐机制。

1. 基础请求地址:
https://api.cloudbypass.com

2. 必选请求头参数:

参数名描述备注
x-cb-apikey您的 API 密钥控制台获取
x-cb-host目标服务器主机名如访问 example.com/path,则填 example.com
x-cb-proxy固定或具时效性的代理V2 必须配置,用于对齐会话环境
x-cb-part会话分区 ID可选。用于多并发下的会话隔离与独立存储

3. V1 与 V2 逻辑区别:

  • V1 模式: 每次请求均为无状态,主要依靠指纹库直接突破。
  • V2 模式(推荐): 必须提供 x-cb-proxy 代理地址。当遇到 Cloudflare 挑战时,穿云将自动完成人机验证。挑战成功后,系统会为该分区/代理自动存储会话 10 分钟。后续请求将复用该成功会话,并在成功访问后自动续期,极大提升了采集效率。

Go 代码实现示例

以下是基于 Go 标准库实现的 V2 接口请求模板。该示例已针对最新的 V2 异步挑战逻辑 进行了结构规范化。

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    client := &http.Client{}

    // 目标 URL 路径(除域名外的部分)
    reqUrl := "https://api.cloudbypass.com/api/v2/example-path"

    req, _ := http.NewRequest("GET", reqUrl, nil)

    // 配置穿云 V2 核心请求头
    req.Header.Set("x-cb-apikey", "您的API_KEY")
    req.Header.Set("x-cb-host", "www.target-website.com")

    // V2 必须设置代理,格式为 http://user:pass@host:port
    req.Header.Set("x-cb-proxy", "http://your-proxy-address:port")

    // 可选:设置会话分区以隔离不同任务的会话
    req.Header.Set("x-cb-part", "session_001")

    // 发起请求
    resp, err := client.Do(req)
    if err != nil {
        fmt.Printf("请求异常: %v\n", err)
        return
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println("响应内容:", string(body))
}

快速联调与资源