如何解决 Cloudflare Turnstile？

TL;DR

• Cloudflare Turnstile 是一种注重隐私的 CAPTCHA 替代方案，旨在通过最小的用户交互来阻止自动化流量。
• CapSolver 支持 所有 Turnstile 变体（手动型、非交互式、隐形型）并具备自动检测功能。
• AntiTurnstileTaskProxyLess 任务允许您在不提供代理的情况下解决 Turnstile。
• 从 getTaskResult 返回的 token 必须提交到目标网站以成功完成验证。

简介

Cloudflare Turnstile 是一种注重隐私的 CAPTCHA 替代方案，取代了传统的 reCAPTCHA 挑战。它旨在减少用户干扰，同时仍有效防止自动化滥用。然而，从开发者的角度来看，Turnstile 为自动化、测试和数据收集工作流带来了新的挑战。

与 Cloudflare 的 5 秒挑战不同，Turnstile 依赖于 基于令牌的验证，而不是浏览器指纹连续性。这使其更容易集成——前提是使用正确的参数和任务类型。

在本指南中，您将学习：

• CapSolver 处理的 Cloudflare Turnstile 类型
• CapSolver 如何自动管理 Turnstile 挑战
• 如何使用 AntiTurnstileTaskProxyLess 在不使用代理的情况下解决 Turnstile
• 如何正确获取并提交令牌以避免被拒绝

本教程适合寻找 快速、可扩展且低维护 的 Turnstile 解决方案的开发者。

CapSolver 处理的 Turnstile 类型

CapSolver 自动处理所有 Cloudflare Turnstile 变体，包括：

• 手动型
• 非交互式
• 隐形型

无需额外配置即可区分这些类型——CapSolver 会自动检测并处理它们。

克服 Cloudflare Turnstile

在解决 Cloudflare Turnstile 之前，请确保满足以下先决条件并了解验证要求。

先决条件

• CapSolver API 密钥

有效解决方案的关键考虑因素

• getTaskResult 响应中返回的 token 是 最终的 CAPTCHA 验证令牌。
• 此令牌必须按照 Turnstile 验证流程预期的方式提交到目标网站。

有关完整的参数说明，请参阅官方文档：
https://docs.capsolver.com/en/guide/captcha/cloudflare_turnstile/

本教程仅关注必需的参数。Cloudflare Turnstile 支持的任务类型为：

• AntiTurnstileTaskProxyLess – 使用 CapSolver 内置的代理基础设施

当网站受 Cloudflare Turnstile 保护且 不需要浏览器级指纹重用 时，推荐使用此任务类型。

第1步：使用 CapSolver 创建任务

使用 createTask API 创建任务并提交必要信息：

POST https://api.capsolver.com/createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "AntiTurnstileTaskProxyLess",
    "websiteURL": "https://www.yourwebsite.com",
    "websiteKey": "0x4XXXXXXXXXXXXXXXXX",
    "metadata": {
      "action": "login",  
      "cdata": "0000-1111-2222-3333-example-cdata"
    }
  }
}

• websiteKey 为必填项
• metadata.action 和 metadata.cdata 为可选参数，具体取决于网站的实现

第2步：获取结果

轮询 getTaskResult 端点，直到任务完成：

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "YOUR_API_KEY",
  "taskId": "TASKID_OF_CREATETASK"
}

一旦任务完成，响应将包含有效的 Turnstile 令牌：

正确使用 Turnstile 令牌

要在目标网站完成验证：

• 将返回的 token 提交到网站的 Turnstile 验证端点
• 确保令牌在 过期前使用
• 不要在不相关的会话中重复使用令牌

⚠️ 如果令牌被拒绝，请确认网站是否受 Cloudflare Turnstile 保护，而不是 Cloudflare 5 秒挑战，后者需要不同的任务类型和参数。

结论

Cloudflare Turnstile 提供了简化版的 CAPTCHA 替代方案，但自动化仍需要可靠的令牌生成流程。

CapSolver 通过 AntiTurnstileTaskProxyLess 简化了 Turnstile 的解决过程，无需自定义代理或浏览器指纹管理。通过提供正确的参数并正确提交返回的令牌，开发者可以快速且大规模地将 Turnstile 解决方案集成到其工作流中。

通过正确的设置，解决 Cloudflare Turnstile 变得高效、可预测且适合生产环境。

常见问题

1. Cloudflare Turnstile 和 5 秒挑战有什么区别？

Turnstile 是基于令牌的 CAPTCHA 机制，而 5 秒挑战是浏览器和网络指纹验证流程。它们需要不同的任务类型。

2. 我需要自己的代理来解决 Cloudflare Turnstile 吗？

不需要。AntiTurnstileTaskProxyLess 使用 CapSolver 的内部代理基础设施。

3. 为什么我的 Turnstile 令牌被拒绝？

常见原因包括错误的 websiteKey、过期的令牌，或尝试使用 Cloudflare 5 秒挑战而非 Turnstile。

4. 同一令牌能否多次使用？

不能。Turnstile 令牌是 一次性使用 的，并与特定会话或操作绑定。

有关 Cloudflare 5 秒挑战（IUAM）的解决方案，请参考：
https://www.capsolver.com/blog/how-to-solve-cloudflare-challenge