# Turnstile

Turnstile is Cloudflare's smart CAPTCHA alternative

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/turnstile/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Cloudflare Turnstile](https://cloudflaredoc.ubitools.com/turnstile/index.md): 通过无需 CAPTCHA、注重隐私的替代方案验证访客是人类。

## 套餐方案

- [套餐方案](https://cloudflaredoc.ubitools.com/turnstile/plans/index.md): 比较不同套餐方案中的 Turnstile 功能可用性和小组件限制。

## Turnstile Spin

- [Turnstile Spin](https://cloudflaredoc.ubitools.com/turnstile/spin/index.md): 通过 Cloudflare 仪表板或您的 AI 编码代理设置端到端的 Turnstile（小组件 + 规范的服务器端 siteverify）。

## 快速入门

- [快速入门](https://cloudflaredoc.ubitools.com/turnstile/get-started/index.md): 设置 Turnstile 以在没有传统 CAPTCHA 的情况下验证访问者。
- [嵌入小组件](https://cloudflaredoc.ubitools.com/turnstile/get-started/client-side-rendering/index.md): 使用 JavaScript 或 HTML 在您的网站上嵌入 Turnstile 小组件。
- [小组件配置](https://cloudflaredoc.ubitools.com/turnstile/get-started/client-side-rendering/widget-configurations/index.md): 配置小组件外观、语言和回调函数。
- [移动端实施](https://cloudflaredoc.ubitools.com/turnstile/get-started/mobile-implementation/index.md): 在原生移动端应用程序中实施 Turnstile。
- [验证令牌](https://cloudflaredoc.ubitools.com/turnstile/get-started/server-side-validation/index.md): 使用 siteverify API 在您的服务器上验证 Turnstile 令牌。
- [使用 Cloudflare API 创建和管理小组件](https://cloudflaredoc.ubitools.com/turnstile/get-started/widget-management/api/index.md): 使用 Cloudflare API 创建和管理 Turnstile 小组件。
- [使用 Cloudflare 仪表板创建和管理小组件](https://cloudflaredoc.ubitools.com/turnstile/get-started/widget-management/dashboard/index.md): 在 Cloudflare 仪表板中创建和管理 Turnstile 小组件。
- [使用 Terraform 创建和管理小组件](https://cloudflaredoc.ubitools.com/turnstile/get-started/widget-management/terraform/index.md): 使用 Terraform 提供程序创建和管理 Turnstile 小组件。

## Turnstile 分析 (Turnstile Analytics)

- [Turnstile 分析 (Turnstile Analytics)](https://cloudflaredoc.ubitools.com/turnstile/turnstile-analytics/index.md): 使用 Turnstile 分析来查看已发出的质询数量、质询解决率以及已发出质询的指标。
- [质询结果](https://cloudflaredoc.ubitools.com/turnstile/turnstile-analytics/challenge-outcomes/index.md): 查看 Turnstile 小组件的质询结果指标。
- [令牌验证 (Token validation)](https://cloudflaredoc.ubitools.com/turnstile/turnstile-analytics/token-validation/index.md): 查看您的 Turnstile 小组件的令牌验证指标。

## 迁移 (Migration)

- [迁移 (Migration)](https://cloudflaredoc.ubitools.com/turnstile/migration/index.md): 从 reCAPTCHA 或 hCaptcha 迁移至 Turnstile。
- [从 hCaptcha 迁移](https://cloudflaredoc.ubitools.com/turnstile/migration/hcaptcha/index.md): 从 hCaptcha 迁移到 Cloudflare Turnstile。
- [从 reCAPTCHA 迁移](https://cloudflaredoc.ubitools.com/turnstile/migration/recaptcha/index.md): 从 Google reCAPTCHA 迁移到 Cloudflare Turnstile。

## 教程

- [教程](https://cloudflaredoc.ubitools.com/turnstile/tutorials/index.md): 关于将 Turnstile 与 WAF、登录页面和测试相集成的教程。
- [有条件地强制执行 Turnstile](https://cloudflaredoc.ubitools.com/turnstile/tutorials/conditionally-enforcing-turnstile/index.md): 本教程说明如何根据传入请求（例如请求头中的预共享密钥或特定 IP 地址）有条件地强制执行 Turnstile。
- [在端到端 (E2E) 测试中排除 Turnstile](https://cloudflaredoc.ubitools.com/turnstile/tutorials/excluding-turnstile-from-e2e-tests/index.md): 本教程说明如何通过使用 Turnstile 的专用测试密钥，在端到端 (E2E) 测试中处理 Turnstile。
- [使用临时 ID 进行欺诈检测](https://cloudflaredoc.ubitools.com/turnstile/tutorials/fraud-detection-with-ephemeral-ids/index.md): 了解如何使用 Turnstile 的临时 ID (Ephemeral IDs) 实施欺诈检测，以识别并阻止轮换 IP 地址的恶意行为者。
- [集成 Turnstile、WAF 和 Bot Management](https://cloudflaredoc.ubitools.com/turnstile/tutorials/integrating-turnstile-waf-and-bot-management/index.md): 本教程将指导您如何将 Cloudflare Turnstile、Web 应用防火墙 (WAF) 和 Bot Management 进行集成。这种组合可对各种威胁（包括自动化攻击和恶意登录尝试）建立起强大的防御。
- [保护您的表单](https://cloudflaredoc.ubitools.com/turnstile/tutorials/login-pages/index.md): 本教程将引导您集成 Cloudflare Turnstile 来保护您的 Web 表单，例如登录、注册或联系表单。

## 社区资源

- [社区资源](https://cloudflaredoc.ubitools.com/turnstile/community-resources/index.md): 针对 Cloudflare Turnstile 的社区构建库和集成。

## 更新日志

- [更新日志](https://cloudflaredoc.ubitools.com/turnstile/changelog/index.md): 跟踪 Cloudflare Turnstile 的最新更新与变更。

## additional-configuration

- [临时 ID (Ephemeral IDs)](https://cloudflaredoc.ubitools.com/turnstile/additional-configuration/ephemeral-id/index.md): 生成一次性临时 ID (Ephemeral IDs)，用于欺诈检测和分析。
- [域名管理 (Hostname management)](https://cloudflaredoc.ubitools.com/turnstile/additional-configuration/hostname-management/index.md): 控制哪些域名可以加载您的 Turnstile 小组件。
- [任意域名 (Any Hostname)（仅限企业版）](https://cloudflaredoc.ubitools.com/turnstile/additional-configuration/hostname-management/any-hostname/index.md): 在企业版 (Enterprise) 套餐中允许 Turnstile 小组件在任意域名上运行。
- [Pre-clearance 配置](https://cloudflaredoc.ubitools.com/turnstile/additional-configuration/hostname-management/pre-clearance/index.md): 配置 Pre-clearance 以减少对访问者的重复质询。
- [使用 Offlabel 去除 Cloudflare 品牌标识](https://cloudflaredoc.ubitools.com/turnstile/additional-configuration/offlabel/index.md): 使用 Offlabel 模式去除 Turnstile 小组件中的 Cloudflare 品牌标识。
- [Pre-clearance 支持 (Pre-clearance support)](https://cloudflaredoc.ubitools.com/cloudflare-challenges/concepts/clearance/#pre-clearance-support-in-turnstileindex.md): 签发 clearance cookie 以减少对有效访问者的重复质询。

## concepts

- [Cloudflare 质询](https://cloudflaredoc.ubitools.com/cloudflare-challenges/index.md): Cloudflare 质询如何在 Turnstile 小组件中验证访问者。
- [Turnstile 小组件](https://cloudflaredoc.ubitools.com/turnstile/concepts/widget/index.md): Turnstile 小组件的模式、尺寸和渲染行为。

## extensions

- [在 Google Firebase 中实现 Turnstile](https://cloudflaredoc.ubitools.com/turnstile/extensions/google-firebase/index.md): 将 Turnstile 与 Google Firebase 集成以进行服务器端验证。
- [Pages 插件](https://cloudflaredoc.ubitools.com/pages/functions/plugins/turnstile/index.md): 使用 Pages 插件将 Turnstile 添加到 Cloudflare Pages 中。
- [等候室分析 (Waiting Room Analytics)](https://cloudflaredoc.ubitools.com/waiting-room/waiting-room-analytics/#turnstile-widget-trafficindex.md): 查看等候室 (Waiting Room) 质询事件的 Turnstile 分析。

## reference

- [内容安全策略 (Content Security Policy)](https://cloudflaredoc.ubitools.com/turnstile/reference/content-security-policy/index.md): Turnstile 小组件所需的内容安全策略指令。
- [支持的浏览器](https://cloudflaredoc.ubitools.com/cloudflare-challenges/reference/supported-browsers/index.md): Cloudflare Turnstile 小组件支持的浏览器。
- [支持的语言](https://cloudflaredoc.ubitools.com/turnstile/reference/supported-languages/index.md): Cloudflare Turnstile 小组件支持的语言。

## troubleshooting

- [质询解决问题](https://cloudflaredoc.ubitools.com/cloudflare-challenges/troubleshooting/challenge-solve-issues/index.md): 修复 Turnstile 小组件中的质询死循环和解决失败问题。
- [客户端错误](https://cloudflaredoc.ubitools.com/turnstile/troubleshooting/client-side-errors/index.md): 解决 Turnstile 小组件渲染中的客户端错误。
- [错误代码](https://cloudflaredoc.ubitools.com/turnstile/troubleshooting/client-side-errors/error-codes/index.md): Turnstile 小组件返回的错误代码及其含义。
- [反馈报告](https://cloudflaredoc.ubitools.com/turnstile/troubleshooting/feedback-reports/index.md): 为发生误报的质询提交 Turnstile 反馈报告。
- [轮换密匙](https://cloudflaredoc.ubitools.com/turnstile/troubleshooting/rotate-secret-key/index.md): 在出于安全性考量或密钥泄露时轮换您的 Turnstile 密匙 (secret key)。
- [测试您的 Turnstile 实施](https://cloudflaredoc.ubitools.com/turnstile/troubleshooting/testing/index.md): 使用测试 sitekey 键来测试您的 Turnstile 实施。