Cloudflare Turnstile | Challenge | Waiting Room

查看全部价格

所有 Turnstile 子类型都会自动支持：手动、非交互式和隐形。因此，对于常规验证码，无需指定子类型。

更多相关内容，请访问我们的博客

重要提示:

在开始之前，请先查看所有三种验证码解决方案，并选择最适合您的方式。

选项 1：Turnstile（token）

您需要解决一个标准 Turnstile 验证码，例如这里。注意，Cloudflare 页面上的验证码可能看起来完全相同。请参阅文章末尾以区分标准 Turnstile 和 Cloudflare Challenge。

注意！

CapMonster Cloud 默认通过内置代理工作——这些代理已包含在费用内。仅当网站不接受令牌或对内置服务的访问受限时，才需要指定您自己的代理。
如果代理按 IP 授权，请将地址 65.21.190.34 加入白名单。
解决后，您将收到一个token 来确认验证码完成。

请求参数

type<string>required

TurnstileTask

websiteURL<string>required

验证码所在页面的 URL

websiteKey<string>required

Turnstile site key

pageAction<string>optional

验证码加载时，在回调函数中找到的 action 字段

data<string>optional

从 cData 参数中获取的 data 字段值。

proxyType<string>optional

http - 普通的 http/https 代理；
https - 仅在 "http" 不起作用时尝试（某些自定义代理服务器要求）；
socks4 - socks4 代理；
socks5 - socks5 代理。

proxyAddress<string>optional

代理 IP 地址 IPv4/IPv6。不允许：

使用透明代理（其中客户端 IP 可见）；
使用来自本地网络的代理。

proxyPort<integer>optional

代理端口。

proxyLogin<string>optional

代理登录。

proxyPassword<string>optional

代理密码。

选项 2：Challenge (token)

注意！

CapMonster Cloud 默认通过内置代理工作——这些代理已包含在费用内。仅当网站不接受令牌或对内置服务的访问受限时，才需要指定您自己的代理。
如果代理按 IP 授权，请将地址 65.21.190.34 加入白名单。
解决后，您将收到一个token 来确认验证码完成。

请求参数

type<string>required

TurnstileTask

websiteURL<string>required

验证码所在页面的 URL

websiteKey<string>required

Turnstile site key

cloudflareTaskType<string>required

token

pageAction<string>required

在回调函数中找到的 action 字段。
如果使用 cloudflareTaskType，action 通常是 “managed” 或 “non-interactive”。

userAgent<string>required

浏览器的 User-Agent。
请仅传递当前 Windows 系统下的有效 UA。当前推荐值为：userAgentPlaceholder

data<string>required

从 cData 中获取的 data 值。

pageData<string>required

从 chlPageData 中获取的 pageData 值。

apiJsUrl<string>optional

包含验证码脚本 URL 的字符串。

proxyType<string>optional

http - 普通的 http/https 代理；
https - 仅在 "http" 不起作用时尝试（某些自定义代理服务器要求）；
socks4 - socks4 代理；
socks5 - socks5 代理。

proxyAddress<string>optional

代理 IP 地址 IPv4/IPv6。不允许：

使用透明代理（其中客户端 IP 可见）；
使用来自本地网络的代理。

proxyPort<integer>optional

代理端口。

proxyLogin<string>optional

代理登录。

proxyPassword<string>optional

代理密码。

这些参数位于 window.turnstile.render(el, paramsObj) 传递的对象中。您可以在加载其他脚本之前执行以下 JavaScript 来获取它们：

(function () {
  const obj = {
    render: function () {
      const { action, cData, chlPageData } = arguments[1];
        const params = [
          ["action", action],
          ["data", cData],
          ["pageData", chlPageData],
        ];
        console.table(params)
    }
  };

  Object.defineProperty(window, "turnstile", {
    get: () => {
      return obj;
    },
  });
})();

当调用 window.turnstile.render(el, paramsObj) 时，验证码会加载到页面上，并在成功解决后调用 callback 函数传递解决信息。

window.turnstile.render(el, paramsObj):

el: 插入验证码的 DOM 元素。
paramsObj: 包含验证码信息和解决说明的对象。通常包括 sitekey、action、cData、chlPageData、callback。
callback: 验证码成功解决后调用的函数。

注意！

本任务需要使用您自己的代理。
解决后，您将收到特殊 cookies 以添加到浏览器。

请求参数

type<string>required

TurnstileTask

websiteURL<string>required

验证码所在页面的 URL

websiteKey<string>required

Turnstile site key（任意字符串均可）

cloudflareTaskType<string>required

cf_clearance

htmlPageBase64<string>required

“Just a moment” 页面（403 响应）的 Base64 编码 HTML。
示例获取 htmlPageBase64:

var htmlContent = document.documentElement.outerHTML;
var htmlBase64 = btoa(unescape(encodeURIComponent(htmlContent)));
console.log(htmlBase64);

userAgent<string>required

浏览器 User-Agent。
仅提供当前 Windows UA: userAgentPlaceholder

proxyType<string>required

http - 常规 HTTP/HTTPS 代理;
https - 如果 http 不工作则使用（某些代理需要）;
socks4 - SOCKS4 代理;
socks5 - SOCKS5 代理。

proxyAddress<string>required

代理 IP 地址 (IPv4/IPv6)。不允许：

透明代理
本地机器代理

proxyPort<integer>required

代理端口。

proxyLogin<string>required

代理登录名。

proxyPassword<string>required

代理密码。

注意！

本任务需要使用您自己的代理。
解决后，您将收到特殊 cookies 以添加到浏览器。

这是 Cloudflare 的一种新保护机制：用户必须平均等待 ~3 分钟才能访问资源：

您还可以通过页面头部识别此 Cloudflare 类型：

请求参数

type<string>required

TurnstileTask

websiteURL<string>required

包含检查的页面 URL

websiteKey<string>required

Cloudflare site key

cloudflareTaskType<string>required

wait_room

htmlPageBase64<string>required

Base64 编码的 HTML 页面，包含 <title>Waiting Room powered by Cloudflare</title>

userAgent<string>required

浏览器 User-Agent。
仅提供当前 Windows UA: userAgentPlaceholder

proxyType<string>required

http - 常规 HTTP/HTTPS 代理;
https - 如果 http 不工作则使用（某些代理需要）;
socks4 - SOCKS4 代理;
socks5 - SOCKS5 代理。

proxyAddress<string>required

代理 IP 地址 (IPv4/IPv6)。不允许：

透明代理
本地机器代理

proxyPort<integer>required

代理端口。

proxyLogin<string>required

代理登录名。

proxyPassword<string>required

代理密码。

请求示例

选项 1. Turnstile (token)

TurnstileTask (无代理)
TurnstileTask (带代理)

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey": "API_KEY",
  "task": {
    "type": "TurnstileTask",
    "websiteURL": "http://tsmanaged.zlsupport.com",
    "websiteKey": "0x4AAAAAAABUYP0XeMJF0xoy"
  }
}

响应

{
  "errorId": 0,
  "taskId": 407533072
}

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey": "API_KEY",
  "task": {
    "type": "TurnstileTask",
    "websiteURL": "http://tsmanaged.zlsupport.com",
    "websiteKey": "0x4AAAAAAABUYP0XeMJF0xoy",
    "proxyType": "http",
    "proxyAddress": "8.8.8.8",
    "proxyPort": 8080,
    "proxyLogin": "proxyLoginHere",
    "proxyPassword": "proxyPasswordHere"
  }
}

响应

{
  "errorId": 0,
  "taskId": 407533072
}

选项 2. Challenge (token)

TurnstileTask (无代理)
TurnstileTask (带代理)

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey": "API_KEY",
  "task": {
    "type": "TurnstileTask",
    "websiteURL": "https://example.com",
    "websiteKey": "0x4AAAAAAADnPIDROrmt1Wwj",
    "cloudflareTaskType": "token",
    "userAgent": "userAgentPlaceholder",
    "pageAction": "managed",
    "pageData": "HUHDWUHuhuwfiweh32..uh2uhuhyugYUG=",
    "data": "874291f4retD1366"
  }
}

响应

{
  "errorId": 0,
  "taskId": 407533072
}

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey": "API_KEY",
  "task": {
    "type": "TurnstileTask",
    "websiteURL": "https://example.com",
    "websiteKey": "0x4AAAAAAADnPIDROrmt1Wwj",
    "cloudflareTaskType": "token",
    "userAgent": "userAgentPlaceholder",
    "pageAction": "managed",
    "pageData": "HUHDWUHuhuwfiweh32..uh2uhuhyugYUG=",
    "data": "874291f4retD1366",
    "proxyType": "http",
    "proxyAddress": "8.8.8.8",
    "proxyPort": 8080,
    "proxyLogin": "proxyLoginHere",
    "proxyPassword": "proxyPasswordHere"
  }
}

响应

{
  "errorId": 0,
  "taskId": 407533072
}

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey":"API_KEY",
  "task": {
	"type":"TurnstileTask",
	"websiteURL":"https://example.com",
	"websiteKey":"xxxxxxxxxx",
	"cloudflareTaskType": "cf_clearance",
	"htmlPageBase64": "PCFET0NUWVBFIGh0...vYm9keT48L2h0bWw+",
	"userAgent": "userAgentPlaceholder",
	"proxyType":"http",
	"proxyAddress":"8.8.8.8",
	"proxyPort":8080,
	"proxyLogin":"proxyLoginHere",
	"proxyPassword":"proxyPasswordHere"
  }
}

响应

{
  "errorId":0,
  "taskId":407533072
}

POST

https://api.capmonster.cloud/createTask

请求

{
  "clientKey":"API_KEY",
  "task": {
	"type":"TurnstileTask",
	"websiteURL":"https://example.com",
	"websiteKey":"xxxxxxxxxx",
	"cloudflareTaskType": "wait_room",
	"htmlPageBase64": "PCFET0NUWVBFIGh0...vYm9keT48L2h0bWw+",
	"userAgent": "userAgentPlaceholder",
	"proxyType":"http",
	"proxyAddress":"8.8.8.8",
	"proxyPort":8080,
	"proxyLogin":"proxyLoginHere",
	"proxyPassword":"proxyPasswordHere"
  }
}

响应

{
  "errorId":0,
  "taskId":407533072
}

获取任务结果的方法

使用 getTaskResult 方法来获取 Turnstile 的解答。根据系统负载情况，响应可能需要 5 到 20 秒。

属性	类型	描述
cf_clearance	String	特殊的 Cloudflare cookies，可在浏览器中设置
token	String	在调用 callback 函数时使用该 token

如何区分标准 Turnstile 与 Cloudflare Challenge

Cloudflare 的验证类型可能会有不同的表现形式。

标准 Turnstile：

样式化变体：

看起来像普通的 Turnstile 验证码，但实际上这是一个 Challenge。

要最终确认是否存在 Challenge，可以打开开发者工具，查看网络流量，分析页面代码，并观察其典型特征：

对网站的第一个请求返回 403 状态码：

带有 id challenge-form 的表单，其 action 属性包含参数 __cf_chl_f_tk=（不要与 Turnstile 验证码的 action 混淆）：

页面中包含两个类似的 <script> 标签，它们会在 window 对象中创建新的值：

使用 Node.js 中的 Selenium 的示例实现

const { Builder } = require('selenium-webdriver');
const chrome = require('selenium-webdriver/chrome');

(async function example() {
  const options = new chrome.Options();
  options.addArguments('--auto-open-devtools-for-tabs')

  const driver = new Builder()
    .forBrowser('chrome')
    .setChromeOptions(options)
    .build();

  try {
    driver.executeScript(`
    window.turnstile = new Proxy(window.turnstile, {
      get(target, prop) {
        if (prop === 'render') {
          return function(a, b) {
            let p = {
              type: "TurnstileTask",
              websiteKey: b.sitekey,
              websiteURL: window.location.href,
              data: b.cData,
              pagedata: b.chlPageData,
              action: b.action,
              userAgent: navigator.userAgent
          }
          
          console.log(JSON.stringify(p))
          window.params = p;
          window.turnstileCallback = b.callback;
            return target.render.apply(this, arguments);
          }
        }
        return target[prop];
      }
    });
    `)

    driver.get('带有验证码的网站');
    
    const params = await driver.executeScript(`
      return new Promise((resolve, reject) => {
        setTimeout(() => {
          resolve(window.params)
        }, 2000)
      })
    `);

    if (params) {
      const data = {
        clientKey: 'API KEY',
        task: {
          type: 'TurnstileTask',
          websiteURL: params.websiteURL,
          websiteKey: params.websiteKey,
          data: params.data,
          action: params.action
        }
      }

      const createResult = await fetch('https://api.capmonster.cloud/createTask', {
        method: 'post',
        body: JSON.stringify(data)
      });

      const createTaskResult = await createResult.json()

      if (createTaskResult.taskId) {
        const asyncDelay = (timeout) =>
          new Promise(resolve => {
              setTimeout(() => {
                  resolve();
              }, timeout);
          });
        
        const getTaskResult = async (taskId) => {
          const taskResult = await fetch('https://api.capmonster.cloud/getTaskResult', {
            method: 'post',
            body: JSON.stringify({
              "clientKey":"API KEY",
              "taskId": createTaskResult.taskId
            })
          });
          const taskResponse = await taskResult.json();
          if (taskResponse.status === 'processing') {
            await asyncDelay(5000);
            return await getTaskResult(taskId)
          }
          return taskResponse;
        }
       
        const taskRes = await getTaskResult(createTaskResult.taskId)

        if (taskRes.solution) {
          await driver.executeScript(`
            window.turnstileCallback(${taskRes.solution.token});
          `);
        }
      }
      
    }

    //DO SOMETHING
  } finally {
    await driver.quit();
  }
})();

如何查找任务创建所需的所有参数

手动方式

请在浏览器中访问您的网站，该网站包含验证码功能。
右键点击验证码元素，选择 检查（Inspect）。

方法一

websiteKey(网站密钥)

可以在 元素(Elements) 标签页中找到：

sitekeyTurnstile

sitekeyTurnstile1

也可以通过控制台命令获取（在验证码URL的独立标签页中打开，URL通常以https://challenges.cloudflare.com/cdn-cgi/challenge-platform/h/g...开头）：

console.log(window._cf_chl_opt.chlApiSitekey);

chlApiSitekey 就是 sitekey

pageAction(页面动作)

Action 和 sitekey 也可以在 callback 回调函数中找到：

callbackTurnstile

对于 方法二 和 方法三，建议使用自动化方式提取参数：

自动方法

为了自动化获取所需参数，可以通过 浏览器（普通模式或 headless 模式，例如使用 Playwright）进行提取，或直接从 HTTP 请求中获取。由于动态参数的有效时间较短，建议在获取后尽快使用。

重要

所提供的代码片段仅作为获取必要参数的基础示例。具体实现方式取决于包含验证码的网站、本身的页面结构，以及所使用的 HTML 元素和选择器。

JavaScript
Python
C#

对于选项 1：Turnstile（token）——在浏览器中

// 检查window.onloadTurnstileCallback是否存在的函数
const checkTurnstileCallback = () => {
  return new Promise((resolve, reject) => {
    const timeout = setTimeout(() => reject('回调超时'), 30000);

    const interval = setInterval(() => {
      if (window.onloadTurnstileCallback !== undefined) {
        clearInterval(interval);
        clearTimeout(timeout);

        const callbackDetails = window.onloadTurnstileCallback.toString();
        const sitekeyMatch = callbackDetails.match(/sitekey: ['"]([^'"]+)['"]/);
        const actionMatch = callbackDetails.match(/action: ['"]([^'"]+)['"]/);

        resolve({
          sitekey: sitekeyMatch ? sitekeyMatch[1] : null,
          action: actionMatch ? actionMatch[1] : null,
        });
      }
    }, 500);
  });
};

// 尝试查找带有data-sitekey属性的元素
const turnstileElement = document.querySelector('[data-sitekey]');

if (turnstileElement) {
  // 提取data-sitekey属性值
  const sitekey = turnstileElement.getAttribute("data-sitekey");
  console.log("Turnstile Sitekey (从元素获取):", sitekey);
} else {
  console.log("未找到Turnstile元素，正在通过回调检查...");

  // 如果找不到元素，通过window.onloadTurnstileCallback检查
  checkTurnstileCallback()
    .then((data) => {
      console.log("Turnstile参数 (从回调获取):", data);
    })
    .catch((error) => {
      console.error(error);
    });
}

对于选项 2：Challenge（token）——在 Node.js 中

import { chromium } from "playwright";

(async () => {
  const browser = await chromium.launch({ headless: false });
  const page = await browser.newPage();

  let params = null;

  try {
    while (!params) {
      await page.goto("https://example.com");

      await page.evaluate(() => {
        window.turnstile = new Proxy(window.turnstile, {
          get(target, prop) {
            if (prop === "render") {
              return function (a, b) {
                const p = {
                  websiteKey: b.sitekey,
                  websiteURL: window.location.href,
                  data: b.cData,
                  pagedata: b.chlPageData,
                  action: b.action,
                  userAgent: navigator.userAgent,
                };
                window.params = p;
                return target.render.apply(this, arguments);
              };
            }
            return target[prop];
          },
        });
      });

      params = await page.evaluate(() => {
        return new Promise((resolve) => {
          setTimeout(() => resolve(window.params || null), 5000);
        });
      });

      if (!params) {
        await page.waitForTimeout(3000);
      }
    }

    console.log("Turnstile参数:", params);
  } finally {
    await browser.close();
  }
})();

对于选项 3：Challenge（cookie cf_clearance）——在 Node.js 中

import { chromium } from "playwright";
import { Buffer } from "buffer";

(async () => {
  const browser = await chromium.launch({ headless: false });
  const page = await browser.newPage();

  let websiteKey = null;

  while (!websiteKey) {
    await page.goto("https://example.com");

    await page.evaluate(() => {
      window.turnstile = new Proxy(window.turnstile, {
        get(target, prop) {
          if (prop === "render") {
            return function (a, b) {
              window.websiteKey = b.sitekey;
              return target.render.apply(this, arguments);
            };
          }
          return target[prop];
        },
      });
    });

    websiteKey = await page.evaluate(() => {
      return new Promise((resolve) => {
        setTimeout(() => resolve(window.websiteKey || null), 5000);
      });
    });

    if (!websiteKey) {
      await page.waitForTimeout(3000);
    }
  }

  const html = await page.content();
  const htmlPageBase64 = Buffer.from(html).toString("base64");

  const result = {
    websiteKey,
    htmlPageBase64,
  };

  console.log(result);

  await browser.close();
})();

对于选项 1：Turnstile（token）

import asyncio
from playwright.async_api import async_playwright

async def run():
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=False)
        context = await browser.new_context()
        page = await context.new_page()

        await page.goto("https://example.com")  # 替换为您的网站

        # 尝试查找带有data-sitekey属性的元素
        element = await page.query_selector('[data-sitekey]')
        if element:
            sitekey = await element.get_attribute("data-sitekey")
            print("Turnstile Sitekey (从元素获取):", sitekey)
        else:
            print("未找到Turnstile元素，正在通过回调检查...")

            try:
                result = await page.evaluate('''() => {
                    return new Promise((resolve, reject) => {
                        const timeout = setTimeout(() => reject('回调超时'), 30000);
                        const interval = setInterval(() => {
                            if (window.onloadTurnstileCallback !== undefined) {
                                clearInterval(interval);
                                clearTimeout(timeout);
                                const cbStr = window.onloadTurnstileCallback.toString();
                                const sitekeyMatch = cbStr.match(/sitekey: ['"]([^'"]+)['"]/);
                                const actionMatch = cbStr.match(/action: ['"]([^'"]+)['"]/);
                                resolve({
                                    sitekey: sitekeyMatch ? sitekeyMatch[1] : null,
                                    action: actionMatch ? actionMatch[1] : null,
                                });
                            }
                        }, 500);
                    });
                }''')
                print("Turnstile参数 (从回调获取):", result)
            except Exception as e:
                print("错误:", e)

        await browser.close()

asyncio.run(run())

对于选项 2：Challenge（token）

import asyncio
from playwright.async_api import async_playwright

async def extract_turnstile_params():
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=False)
        page = await browser.new_page()

        params = None

        while not params:
            await page.goto("https://example.com")

            await page.evaluate("""
                window.turnstile = new Proxy(window.turnstile, {
                  get(target, prop) {
                    if (prop === "render") {
                      return function(a, b) {
                        const p = {
                          websiteKey: b.sitekey,
                          websiteURL: window.location.href,
                          data: b.cData,
                          pagedata: b.chlPageData,
                          action: b.action,
                          userAgent: navigator.userAgent
                        };
                        window.params = p;
                        return target.render.apply(this, arguments);
                      };
                    }
                    return target[prop];
                  }
                });
            """)

            await page.wait_for_timeout(5000)

            params = await page.evaluate("window.params || null")

            if not params:
                await page.wait_for_timeout(3000)

        print("Turnstile参数:", params)

        await browser.close()

asyncio.run(extract_turnstile_params())

对于选项 3：Challenge（cookie cf_clearance）

import asyncio
import base64
from playwright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=False)
        page = await browser.new_page()

        website_key = None

        while not website_key:
            await page.goto("https://example.com")

            await page.evaluate("""
                () => {
                    window.turnstile = new Proxy(window.turnstile, {
                        get(target, prop) {
                            if (prop === 'render') {
                                return function(a, b) {
                                    window.websiteKey = b.sitekey;
                                    return target.render.apply(this, arguments);
                                };
                            }
                            return target[prop];
                        }
                    });
                }
            """)

            website_key = await page.evaluate("""
                () => new Promise(resolve => {
                    setTimeout(() => resolve(window.websiteKey || null), 5000);
                })
            """)

            if not website_key:
                await page.wait_for_timeout(3000)

        html = await page.content()
        html_base64 = base64.b64encode(html.encode("utf-8")).decode("utf-8")

        result = {
            "websiteKey": website_key,
            "htmlPageBase64": html_base64
        }

        print(result)

        await browser.close()

asyncio.run(main())

对于选项 1：Turnstile（token）

using System;
using System.Text.RegularExpressions;
using System.Threading.Tasks;
using Microsoft.Playwright;

class Program
{
    public static async Task Main()
    {
        using var playwright = await Playwright.CreateAsync();
        var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions
        {
            Headless = false
        });

        var context = await browser.NewContextAsync();
        var page = await context.NewPageAsync();

        await page.GotoAsync("https://example.com"); // 替换为目标URL

        var element = await page.QuerySelectorAsync("[data-sitekey]");

        if (element != null)
        {
            var sitekey = await element.GetAttributeAsync("data-sitekey");
            Console.WriteLine($"Turnstile Sitekey (从元素获取): {sitekey}");
        }
        else
        {
            Console.WriteLine("未找到Turnstile元素，正在通过回调检查...");

            try
            {
                var result = await page.EvaluateAsync(@"() => {
                    return new Promise((resolve, reject) => {
                        const timeout = setTimeout(() => reject('回调超时'), 30000);
                        const interval = setInterval(() => {
                            if (window.onloadTurnstileCallback !== undefined) {
                                clearInterval(interval);
                                clearTimeout(timeout);
                                const cbStr = window.onloadTurnstileCallback.toString();
                                const sitekeyMatch = cbStr.match(/sitekey: ['""]([^'""]+)['""]/);
                                const actionMatch = cbStr.match(/action: ['""]([^'""]+)['""]/);
                                resolve({
                                    sitekey: sitekeyMatch ? sitekeyMatch[1] : null,
                                    action: actionMatch ? actionMatch[1] : null
                                });
                            }
                        }, 500);
                    });
                }");

                Console.WriteLine("Turnstile参数 (从回调获取): " + result?.ToString());
            }
            catch (Exception ex)
            {
                Console.WriteLine("错误: " + ex.Message);
            }
        }

        await browser.CloseAsync();
    }
}

对于选项 2：Challenge（token）

using Microsoft.Playwright;
using System.Text.Json;

class Program
{
    public static async Task Main()
    {
        using var playwright = await Playwright.CreateAsync();
        var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions
        {
            Headless = false
        });

        var page = await browser.NewPageAsync();
        object? parameters = null;

        while (parameters == null)
        {
            await page.GotoAsync("https://example.com");

            await page.EvaluateAsync(@"() => {
                window.turnstile = new Proxy(window.turnstile, {
                    get(target, prop) {
                        if (prop === 'render') {
                            return function(a, b) {
                                const p = {
                                    websiteKey: b.sitekey,
                                    websiteURL: window.location.href,
                                    data: b.cData,
                                    pagedata: b.chlPageData,
                                    action: b.action,
                                    userAgent: navigator.userAgent
                                };
                                window.params = p;
                                return target.render.apply(this, arguments);
                            };
                        }
                        return target[prop];
                    }
                });
            }");

            parameters = await page.EvaluateAsync(@"() => new Promise(resolve => {
                setTimeout(() => resolve(window.params || null), 5000);
            })");

            if (parameters == null)
            {
                await page.WaitForTimeoutAsync(3000);
            }
        }

        Console.WriteLine("Turnstile参数:");
        Console.WriteLine(JsonSerializer.Serialize(parameters, new JsonSerializerOptions { WriteIndented = true }));

        await browser.CloseAsync();
    }
}

对于选项 3：Challenge（cookie cf_clearance）

using System;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Playwright;

class Program
{
    public static async Task Main()
    {
        using var playwright = await Playwright.CreateAsync();
        var browser = await playwright.Chromium.LaunchAsync(
          new BrowserTypeLaunchOptions { Headless = false });
        var page = await browser.NewPageAsync();

        string websiteKey = null;

        while (websiteKey == null)
        {
            await page.GotoAsync("https://example.com");

            await page.EvaluateAsync(@"() => {
                window.turnstile = new Proxy(window.turnstile, {
                    get(target, prop) {
                        if (prop === 'render') {
                            return function(a, b) {
                                window.websiteKey = b.sitekey;
                                return target.render.apply(this, arguments);
                            };
                        }
                        return target[prop];
                    }
                });
            }");

            websiteKey = await page.EvaluateAsync<string>(@"() => 
            new Promise(resolve => {
                setTimeout(() => resolve(window.websiteKey || null), 5000);
            })");

            if (websiteKey == null)
            {
                await page.WaitForTimeoutAsync(3000);
            }
        }

        var html = await page.ContentAsync();
        var htmlBase64 = Convert.ToBase64String(Encoding.UTF8.GetBytes(html));

        Console.WriteLine($"websiteKey: {websiteKey}");
        Console.WriteLine($"htmlPageBase64: {htmlBase64}");

        await browser.CloseAsync();
    }
}

使用 SDK 库

JavaScript
Node.js
Python
C#

选项 1：Turnstile（token）

// https://github.com/ZennoLab/capmonstercloud-client-js

import { 
    CapMonsterCloudClientFactory, 
    ClientOptions, 
    TurnstileRequest 
} from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // 输入您的 CapMonster Cloud API 密钥

document.addEventListener("DOMContentLoaded", async () => {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // 基本示例，无需代理
    // CapMonster Cloud 会自动使用它们的代理
    let turnstileRequest = new TurnstileRequest({
        websiteURL: "http://tsmanaged.zlsupport.com", // CAPTCHA 页面 URL
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy"        // 替换为正确的值
    });

    // 使用您自己的代理的示例
    // 如果想使用自己的代理，请取消注释以下代码块

    /*
    const proxy = {
        proxyType: "https",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    turnstileRequest = new TurnstileRequest({
        websiteURL: "http://tsmanaged.zlsupport.com",
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy",
        proxy,
        userAgent: "userAgentPlaceholder"
    });
    */

    // 如有必要，可以检查余额
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(turnstileRequest);
    console.log("Solution:", result);
});

选项 2：Challenge (token)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { 
    CapMonsterCloudClientFactory, 
    ClientOptions, 
    TurnstileRequest 
} from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // 输入您的 CapMonster Cloud API 密钥

document.addEventListener("DOMContentLoaded", async () => {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // 基本示例，无需代理
    // CapMonster Cloud 会自动使用它们的代理
    let turnstileRequest = new TurnstileRequest({
        websiteURL: "https://example.com", // 验证码页面的 URL
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy", // 替换为正确的值
        data: "YOUR_DATA_HERE",
        pageAction: "managed",
        cloudflareTaskType: "token",
        pageData: "YOUR_PAGE_DATA_HERE",
        userAgent: "userAgentPlaceholder"
    });

    // 使用您自己的代理的示例
    // 如果想使用自己的代理，请取消注释以下代码块

    /*
    const proxy = {
        proxyType: "http",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    turnstileRequest = new TurnstileRequest({
        websiteURL: "https://example.com",
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy",
        proxy,
        data: "YOUR_DATA_HERE",
        pageAction: "managed",
        cloudflareTaskType: "token",
        pageData: "YOUR_PAGE_DATA_HERE",
        userAgent: "userAgentPlaceholder"
    });
    */

    // 如有必要，可以检查余额 
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(turnstileRequest);
    console.log("Solution:", result);
});

选项 3： Challenge (cookie cf_clearance)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { 
    CapMonsterCloudClientFactory, 
    ClientOptions, 
    TurnstileRequest 
} from '@zennolab_com/capmonstercloud-client';

document.addEventListener("DOMContentLoaded", async () => {
    const cmcClient = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: 'YOUR_API_KEY' }) // 输入您的 CapMonster Cloud API 密钥
    );

    // 如有必要，可以检查余额
    const balance = await cmcClient.getBalance();
    console.log('Balance:', balance);

    const proxy = {
        proxyType: "http",
        proxyAddress: '123.45.67.89',
        proxyPort: 8080,
        proxyLogin: 'username',
        proxyPassword: 'password'
    };

    // Cloudflare cf_clearance 只能使用您的代理解决
    const turnstileRequest = new TurnstileRequest({
        websiteURL: 'https://example.com/',
        websiteKey: '0x4AAAAAAABUY0VLtOUMAHxE',
        cloudflareTaskType: 'cf_clearance',
        proxy,
        htmlPageBase64: 'PGh0bW...h0bWw+',
        userAgent: 'userAgentPlaceholder'
    });

    // 发送验证码解决任务
    const result = await cmcClient.Solve(turnstileRequest);
    console.log('Solution:', result.solution);
});

选项 1：Turnstile (token)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, TurnstileRequest } from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // 输入您的 CapMonster Cloud API 密钥

async function solveTurnstile() {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // 基本示例，无需代理
    // CapMonster Cloud 会自动使用它们的代理
    let turnstileRequest = new TurnstileRequest({
        websiteURL: "http://tsmanaged.zlsupport.com", // CAPTCHA 页面 URL
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy"        // 替换为正确的值
    });

    // 使用您自己的代理的示例
    // 如果想使用自己的代理，请取消注释以下代码块

    /*
    const proxy = {
        proxyType: "https",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    turnstileRequest = new TurnstileRequest({
        websiteURL: "http://tsmanaged.zlsupport.com",
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy",
        proxy,
        userAgent: "userAgentPlaceholder"
    });
    */

    // 如有必要，可以检查余额
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(turnstileRequest);
    console.log("Solution:", result);
}

solveTurnstile().catch(err => console.error("错误:", err));

选项 2：Challenge (token)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { 
    CapMonsterCloudClientFactory, 
    ClientOptions, 
    TurnstileRequest 
} from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // 输入您的 CapMonster Cloud API 密钥

(async () => {
    const client = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // 基本示例，无需代理
    // CapMonster Cloud 会自动使用它们的代理
    let turnstileRequest = new TurnstileRequest({
        websiteURL: "https://example.com", // 验证码页面的 URL
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy", // 替换为正确的值
        data: "YOUR_DATA_HERE",
        pageAction: "managed",
        cloudflareTaskType: "token",
        pageData: "YOUR_PAGE_DATA_HERE",
        userAgent: "userAgentPlaceholder"
    });

    // 使用您自己的代理的示例
    // 如果想使用自己的代理，请取消注释以下代码块

    /*
    const proxy = {
        proxyType: "http",
        proxyAddress: "123.45.67.89",
        proxyPort: 8080,
        proxyLogin: "username",
        proxyPassword: "password"
    };

    turnstileRequest = new TurnstileRequest({
        websiteURL: "https://example.com",
        websiteKey: "0x4AAAAAAABUYP0XeMJF0xoy",
        proxy,
        data: "YOUR_DATA_HERE",
        pageAction: "managed",
        cloudflareTaskType: "token",
        pageData: "YOUR_PAGE_DATA_HERE",
        userAgent: "userAgentPlaceholder"
    });
    */

    // 如有必要，可以检查余额 
    const balance = await client.getBalance();
    console.log("Balance:", balance);

    const result = await client.Solve(turnstileRequest);
    console.log("Solution:", result);
})();

选项 3： Challenge (cookie cf_clearance)

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, TurnstileRequest } from '@zennolab_com/capmonstercloud-client';

async function main() {
    const cmcClient = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: 'YOUR_API_KEY' }) // 输入您的 CapMonster Cloud API 密钥
    );

    // 如有必要，可以检查余额
    const balance = await cmcClient.getBalance();
    console.log('Balance:', balance);

    const proxy = {
        proxyType: "http",
        proxyAddress: '123.45.67.89',
        proxyPort: 8080,
        proxyLogin: 'username',
        proxyPassword: 'password'
    };

    // Cloudflare cf_clearance 只能使用您的代理解决
    const turnstileRequest = new TurnstileRequest({
        websiteURL: 'https://example.com/',
        websiteKey: '0x4AAAAAAABUY0VLtOUMAHxE',
        cloudflareTaskType: 'cf_clearance',
        proxy,
        htmlPageBase64: 'PGh0bW...h0bWw+',
        userAgent: 'userAgentPlaceholder'
    });

    // 发送验证码解决任务
    const result = await cmcClient.Solve(turnstileRequest);
    console.log('Solution:', result.solution);
}

main().catch(console.error);

选项 1：Turnstile（token）

# https://github.com/ZennoLab/capmonstercloud-client-python

import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import TurnstileRequest
# from capmonstercloudclient.requests.baseRequestWithProxy import ProxyInfo  # 如果计划使用代理，请取消注释

API_KEY = "YOUR_API_KEY"  # 输入您的 CapMonster Cloud API 密钥

async def solve_turnstile_token():
    client_options = ClientOptions(api_key=API_KEY)
    cap_monster_client = CapMonsterClient(options=client_options)

    # 基本示例，无需代理
    # CapMonster Cloud 会自动使用它们的代理
    turnstile_request = TurnstileRequest(
        websiteURL="http://tsmanaged.zlsupport.com",
        websiteKey="0x4AAAAAAABUYP0XeMJF0xoy",
    )

    # 使用您自己的代理的示例
    # 如果想使用自己的代理，请取消注释以下代码块
    #
    # proxy = ProxyInfo(
    #     proxyType="http",
    #     proxyAddress="123.45.67.89",
    #     proxyPort=8080,
    #     proxyLogin="username",
    #     proxyPassword="password"
    # )
    #
    # turnstile_request = TurnstileRequest(
    #     websiteURL="http://tsmanaged.zlsupport.com",
    #     websiteKey="0x4AAAAAAABUYP0XeMJF0xoy",
    #     proxy=proxy
    # )

    # 如有必要，可以检查余额
    balance = await cap_monster_client.get_balance()
    print("Balance:", balance)

    result = await cap_monster_client.solve_captcha(turnstile_request)
    print("Solution:", result)

asyncio.run(solve_turnstile_token())

选项 2：Challenge (token)

# https://github.com/ZennoLab/capmonstercloud-client-python

import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import TurnstileRequest
# from capmonstercloudclient.requests.baseRequestWithProxy import ProxyInfo  # 如果计划使用代理，请取消注释

API_KEY = "YOUR_API_KEY"  # 输入您的 CapMonster Cloud API 密钥

async def solve_turnstile_token():
    client_options = ClientOptions(api_key=API_KEY)
    cap_monster_client = CapMonsterClient(options=client_options)

    # 基本示例，无需代理
    # CapMonster Cloud 会自动使用它们的代理
    turnstile_request = TurnstileRequest(
        websiteURL="http://example.com",  # 验证码页面的 URL
        websiteKey="0x4AAAAAAABUYP0XeMJF0xoy",        # 替换为正确的值
        data="YOUR_DATA_HERE",
        pageAction="managed",
        cloudflareTaskType="token",
        pageData="YOUR_PAGE_DATA_HERE",
        userAgent="userAgentPlaceholder"
    )

    # 使用您自己的代理的示例
    # 如果想使用自己的代理，请取消注释以下代码块
    #
    # proxy = ProxyInfo(
    #     proxyType="http",               
    #     proxyAddress="123.45.67.89",    
    #     proxyPort=8080,                 
    #     proxyLogin="username",          
    #     proxyPassword="password"        
    # )
    #
    # turnstile_request = TurnstileRequest(
    #     websiteURL="http://tsmanaged.zlsupport.com",
    #     websiteKey="0x4AAAAAAABUYP0XeMJF0xoy",
    #     proxy=proxy,
    #     data="YOUR_DATA_HERE",
    #     pageAction="managed",
    #     cloudflareTaskType="token",
    #     pageData="YOUR_PAGE_DATA_HERE",
    #     userAgent="userAgentPlaceholder"
    # )

    # 如有必要，可以检查余额 
    balance = await cap_monster_client.get_balance()
    print("Balance:", balance)

    result = await cap_monster_client.solve_captcha(turnstile_request)
    print("Solution:", result)

asyncio.run(solve_turnstile_token())

选项 3： Challenge (cookie cf_clearance)

# https://github.com/ZennoLab/capmonstercloud-client-python

import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import TurnstileRequest
from capmonstercloudclient.requests.baseRequestWithProxy import ProxyInfo  # 使用 ProxyInfo

API_KEY = "YOUR_API_KEY"  # 输入您的 CapMonster Cloud API 密钥

async def solve_cf_clearance():
    client_options = ClientOptions(api_key=API_KEY)
    cap_monster_client = CapMonsterClient(options=client_options)

    # 代理设置示例
    proxy = ProxyInfo(
        proxyType="http",
        proxyAddress="123.45.67.89",
        proxyPort=8080,
        proxyLogin="username",
        proxyPassword="password"
    )

    # Cloudflare cf_clearance 只能使用您的代理解决
    turnstile_request = TurnstileRequest(
        websiteURL="https://example.com",
        websiteKey="0x4AAAAAAABUYP0XeMJF0xoy",
        cloudflareTaskType="cf_clearance",
        htmlPageBase64="BASE64_HTML_PAGE_HERE",
        userAgent="userAgentPlaceholder",
        proxy=proxy
    )

    # 如有必要，可以检查余额
    balance = await cap_monster_client.get_balance()
    print("Balance:", balance)

    # 发送验证码解决任务
    result = await cap_monster_client.solve_captcha(turnstile_request)
    print("Solution:", result)

asyncio.run(solve_cf_clearance())

选项 1：Turnstile（token）

// https://github.com/ZennoLab/capmonstercloud-client-dotnet

using System;
using System.Threading.Tasks;
using Zennolab.CapMonsterCloud;
using Zennolab.CapMonsterCloud.Requests;

class Program
{
    static async Task Main(string[] args)
    {
        // 输入您的 CapMonster Cloud API 密钥
        var clientOptions = new ClientOptions
        {
            ClientKey = "YOUR_API_KEY"
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);

        // 基本示例，无需代理
        // CapMonster Cloud 会自动使用它们的代理
        var turnstileRequest = new TurnstileRequest
        {
            WebsiteUrl = "http://tsmanaged.zlsupport.com", // 验证码页面的 URL
            WebsiteKey = "0x4AAAAAAABUYP0XeMJF0xoy"       // 替换为正确的值
        };

        // 使用您自己的代理的示例
        // 如果想使用自己的代理，请取消注释以下代码块

        /*
        var turnstileRequest = new TurnstileRequest
        {
            WebsiteUrl = "http://tsmanaged.zlsupport.com",
            WebsiteKey = "0x4AAAAAAABUYP0XeMJF0xoy",

            Proxy = new ProxyContainer(
                "123.45.67.89", 
                8080,
                ProxyType.Http, 
                "username",
                "password"
            )
        };
        */

        // 如有必要，可以检查余额
        var balance = await cmCloudClient.GetBalanceAsync();
        Console.WriteLine("Balance: " + balance);

        var turnstileResult = await cmCloudClient.SolveAsync(turnstileRequest);

        Console.WriteLine("Solution: " + turnstileResult.Solution.Value);
    }
}

选项 2：Challenge (token)

// https://github.com/ZennoLab/capmonstercloud-client-dotnet

using System;
using System.Threading.Tasks;
using Zennolab.CapMonsterCloud;
using Zennolab.CapMonsterCloud.Requests;

class Program
{
    static async Task Main(string[] args)
    {
        // 您的 CapMonster Cloud API 密钥
        var clientOptions = new ClientOptions
        {
            ClientKey = "YOUR_API_KEY"
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);

        // 基本示例，无需代理
        // CapMonster Cloud 会自动使用它们的代理
        var turnstileRequest = new TurnstileRequest
        {
            WebsiteUrl = "https://example.com",        // 验证码页面的 URL
            WebsiteKey = "0x4AAAAAAABUYP0XeMJF0xoy",    // 替换为正确的值
            Data = "data_here",
            PageAction = "managed",
            CloudflareTaskType = "token",
            PageData = "pagedata_here",
            UserAgent = "userAgentPlaceholder"
        };

        // 使用您自己的代理的示例
        // 如果想使用自己的代理，请取消注释以下代码块

        /*
        var turnstileRequest = new TurnstileRequest
        {
            WebsiteUrl = "https://example.com",
            WebsiteKey = "0x4AAAAAAABUYP0XeMJF0xoy",
            Data = "data_here",
            PageAction = "managed",
            CloudflareTaskType = "token",
            PageData = "pagedata_here",
            UserAgent = "userAgentPlaceholder",

            Proxy = new ProxyContainer(
                "123.45.67.89",      
                8080,              
                ProxyType.Http,   
                "username", 
                "password"  
            )
        };
        */

        // 如有必要，可以检查余额 
        var balance = await cmCloudClient.GetBalanceAsync();
        Console.WriteLine("Balance: " + balance);

        var turnstileResult = await cmCloudClient.SolveAsync(turnstileRequest);

        Console.WriteLine("Solution: " + turnstileResult.Solution.Value);
    }
}

选项 3： Challenge (cookie cf_clearance)

// https://github.com/ZennoLab/capmonstercloud-client-dotnet

using Zennolab.CapMonsterCloud;
using Zennolab.CapMonsterCloud.Requests;

class Program
{
    static async Task Main(string[] args)
    {
        var clientOptions = new ClientOptions
        {
            ClientKey = "YOUR_API_KEY" // 输入您的 CapMonster Cloud API 密钥
        };

        var cmCloudClient = CapMonsterCloudClientFactory.Create(clientOptions);
        
        // Cloudflare cf_clearance 只能使用您的代理解决
        var turnstileRequest = new TurnstileRequest
        {
            WebsiteUrl = "https://example.com",     // 验证码页面的 URL        
            WebsiteKey = "0x4AAAAAAADnPIDROrmt1Wwj",  // 替换为正确的值     
            CloudflareTaskType = "cf_clearance",                                    
            HtmlPageBase64 = "htmlPageBase64Here",        
            UserAgent = "userAgentPlaceholder", 

            Proxy = new ProxyContainer(
                "123.45.67.89",       // 代理地址
                8080,                 // 代理端口
                ProxyType.Http,       // 代理类型
                "username",           // 代理用户名
                "password"            // 代理密码
            )
        };

        var turnstileResult = await cmCloudClient.SolveAsync(turnstileRequest);

        Console.WriteLine("Solution: " + turnstileResult.Solution.Clearance);
    }
}

选项 1：Turnstile（token）​

请求参数​

选项 2：Challenge (token)​

请求参数​

选项 3： Challenge (cookie)​

请求参数​

选项 4. Waiting Room (cookie)​

请求参数​

请求示例​

选项 1. Turnstile (token)​

选项 2. Challenge (token)​

选项 3. Challenge (cookie)​

选项 4. Waiting Room (cookie)​

获取任务结果的方法​

如何区分标准 Turnstile 与 Cloudflare Challenge​

如何查找任务创建所需的所有参数​

手动方式​

方法一​

websiteKey(网站密钥)​

pageAction(页面动作)​

自动方法​

使用 SDK 库​

选项 1：Turnstile（token）

请求参数

选项 2：Challenge (token)

请求参数

选项 3： Challenge (cookie)

请求参数

选项 4. Waiting Room (cookie)

请求参数

请求示例

选项 1. Turnstile (token)

选项 2. Challenge (token)

选项 3. Challenge (cookie)

选项 4. Waiting Room (cookie)

获取任务结果的方法

如何区分标准 Turnstile 与 Cloudflare Challenge

如何查找任务创建所需的所有参数

手动方式

方法一

websiteKey(网站密钥)

pageAction(页面动作)

自动方法

使用 SDK 库