在穿云 API 的版本演进中,V2 接口引入了更高级的会话持久化技术。为了确保验证绕过的稳定性,V2 在代理使用上与 V1 有显著区别:
1. 代理配置核心差异
- V1 接口(无状态模式):
- 默认代理: V1 内置了动态代理 IP 池,如果不通过
x-cb-proxy传参,系统会自动分配 IP。 - 灵活性: 每次请求都是独立的、无状态的。如果目标网站防护较低,甚至可以不挂载代理直接访问。
- 默认代理: V1 内置了动态代理 IP 池,如果不通过
- V2 接口(会话状态模式):
- 强制要求: V2 必须配置固定 IP 或具有时效性的(Sticky)IP 代理。
- 传参字段: 统一使用
x-cb-proxy设置代理服务器地址。 - 原因: V2 需要在同一个 IP 环境下完成“挑战验证”与“后续访问”的闭环,若 IP 变动会导致会话失效。
2. V2 自动挑战与会话续期机制
V2 接口专为高难度防护设计,具备智能的会话管理能力:
- 自动挑战: 当请求遇到 Cloudflare 的 JavaScript 质询(5 秒盾)时,穿云服务会自动启动云端挑战程序。
- 会话存储: 挑战成功后,系统会生成并存储该站点的 Cloudflare 会话(如 cf_clearance 等),有效期通常持续 10 分钟。
- 自动续期: 在会话有效期内,后续使用相同配置的请求会自动复用该会话,无需重复挑战。每次请求成功,会话时间会自动刷新。

3. x-cb-part:实现会话隔离
为了支持多账号或多任务并行,V2 提供了会话分区功能:
- 参数作用: 通过配置
x-cb-part参数,您可以手动定义不同的会话空间。 - 应用场景: 如果您需要同时登录多个账号,只需为每个账号分配不同的
x-cb-part值,即可确保 Cookie 和验证状态完全隔离,互不干扰。
快速测试建议
由于 V2 对代理的硬性要求,建议您通过 穿云 API 代码生成器 选择 V2 模式 进行脚本构建。生成器会自动提示您输入有效的代理地址,并规范化 x-cb-proxy 的书写格式,确保本地调试 100% 准确。