> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 启用 Cloudflare Turnstile 保护表单

> 启用 Cloudflare Turnstile，无需 CAPTCHA 即可保护落地页表单免受机器人攻击，同时提升安全性和访客体验。

> 在 LanderLab 的落地页中添加 Cloudflare Turnstile，即可保护你的表单免受机器人和垃圾提交的侵扰，而无需让访客解答 CAPTCHA 谜题。

## 什么是 Cloudflare Turnstile？

Cloudflare Turnstile 是一款免费的机器人防护工具，用来替代传统的 CAPTCHA 验证。它不会要求访客识别红绿灯或输入扭曲的文字，而是利用浏览器信号和行为分析在后台静默验证访客。

对大多数正常访客来说，Turnstile 完全不可见。只有可疑流量才会被要求进行验证，因此你的表单既能得到保护，又不会给真实用户增加阻力。

LanderLab 会帮你完成 Turnstile 脚本的安装。使用你的 Site Key 添加集成后，Turnstile 会自动在你的落地页表单上生效。

<Note>
  添加 Turnstile 集成后，它会被**全局**保存在你的账户中。你可以在多个落地页中重复使用，无需再次输入详细信息。
</Note>

## 开始之前

在 LanderLab 中添加 Turnstile 之前，你需要先在 Cloudflare 账户中创建一个 Turnstile 小组件（widget），并获取你的 **Site Key**。整个过程大约需要 2 分钟。

<Steps>
  <Step title="登录 Cloudflare">
    访问 [dash.cloudflare.com](https://dash.cloudflare.com) 并登录。如果你还没有 Cloudflare 账户，可以在 [cloudflare.com](https://www.cloudflare.com) 免费注册。
  </Step>

  <Step title="打开 Turnstile">
    在 Cloudflare 控制台的左侧边栏中点击 **Turnstile**，进入 Turnstile 小组件管理页面。
  </Step>

  <Step title="创建新的小组件">
    点击 **Add Widget**，并填写以下内容：

    | 字段 | 填写内容 |
    | :- | :- |
    | **Widget name** | 该小组件的描述性名称（例如“LanderLab Forms”）。 |
    | **Hostname** | 点击 **Add Hostname**，输入你的落地页域名（例如 `yourdomain.com`，不要带 `https://` 或 `www`）。 |
    | **Widget mode** | 选择适合你设置的模式。详见下方的小组件模式说明。 |

    点击 **Create** 保存小组件。
  </Step>

  <Step title="复制你的 Site Key">
    创建小组件后，Cloudflare 会显示你的 **Site Key** 和 Secret Key。复制 **Site Key**（形如 `0x4AAAAAAA...`）。LanderLab 只需要 Site Key。

    <Note>
      请妥善保管你的 **Secret Key**，不要与他人分享。LanderLab 只需要 Site Key。
    </Note>
  </Step>
</Steps>

## 小组件模式说明

Cloudflare Turnstile 提供三种小组件模式。在 Cloudflare 控制台中创建小组件时，选择符合你需求的模式。

| 模式 | 工作方式 |
| :- | :- |
| **Managed** | 由 Cloudflare 自动判断。大多数访客会静默通过，只有可疑流量才会看到验证。这是大多数落地页推荐使用的模式。 |
| **Non-Interactive** | 始终显示一个小的可见小组件，但访客无需点击或与之交互。适合你想展示可见安全标识的情况。 |
| **Invisible** | 完全静默，不显示任何小组件，验证完全在后台进行。 |

<Tip>
  对于线索获取类落地页，**Managed 模式**通常是最佳选择。它既能让真实访客顺畅体验，又能拦截机器人提交。
</Tip>

## 如何在 LanderLab 中添加 Turnstile

<Steps>
  <Step title="进入你的落地页">
    前往 **Landing Pages**，点击你想启用 Turnstile 机器人防护的**落地页名称**。
  </Step>

  <Step title="打开集成标签页">
    点击 **Add Integration** 打开集成面板。
  </Step>

  <Step title="选择 Turnstile">
    在可用集成列表中找到 **Turnstile**（标注为“Protect your forms from bots with Turnstile”）并点击。随后会出现配置表单。
  </Step>

  <Step title="填写必填字段">
    输入以下信息：

    | 字段 | 说明 |
    | :- | :- |
    | **Name** | 用于识别该集成的标签（例如“Turnstile”）。在多个页面间复用时，方便你辨认。 |
    | **Site Key** | 你的 Cloudflare Turnstile 小组件的 Site Key（例如 `0x4AAAAAAA...`）。创建小组件后，可在 Cloudflare 控制台的 Turnstile 下找到。 |
  </Step>

  <Step title="点击 Add Turnstile">
    点击 **Add Turnstile** 按钮保存集成。LanderLab 会全局保存它，之后你可以将其连接到其他落地页，无需重新输入详细信息。
  </Step>

  <Step title="发布你的落地页">
    点击 **Publish** 或 **Republish** 发布你的落地页，即可在表单上启用 Turnstile。无需在表单编辑器中进行额外配置。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/HMKrQYFyvSl4tVFf/images/turnstile.png?fit=max&auto=format&n=HMKrQYFyvSl4tVFf&q=85&s=3f997793d00d9554271d930dc42fdb52" alt="在 LanderLab 中添加 Turnstile 集成的表单" width="1920" height="991" data-path="images/turnstile.png" />
</Frame>

## 将 Turnstile 连接到其他落地页

由于 Turnstile 集成是全局保存的，你无需为每个落地页单独创建新集成。你可以在多个页面中复用任何已保存的集成。

<Steps>
  <Step title="打开另一个落地页">
    前往 **Landing Pages**，点击你想使用同一 Turnstile 集成的落地页名称。
  </Step>

  <Step title="添加集成">
    点击 **Add Integration**。你会看到之前保存的 Turnstile 配置列表，选择你要连接的那一个。
  </Step>

  <Step title="选择变体（如适用）">
    如果你的落地页有多个 **A/B 测试变体**，会弹出一个窗口，让你选择哪些变体使用该集成。选择所需变体并确认。

    <Note>
      只有当落地页有多个活跃变体时，才会出现变体选择弹窗。如果只有一个变体，集成会自动应用。
    </Note>
  </Step>

  <Step title="保存并发布">
    点击 **Save**，然后点击 **Publish** 或 **Republish** 发布你的落地页，即可在所选变体上启用 Turnstile。
  </Step>
</Steps>

## 如何验证 Turnstile 是否正常工作

启用 Turnstile 并发布落地页后：

1. 在浏览器中打开**已发布的落地页 URL**。
2. 使用测试数据提交表单。
3. Turnstile 会在后台自动校验这次提交。

要在 Cloudflare 端确认它是否正常工作：

1. 返回你的 [Cloudflare 控制台](https://dash.cloudflare.com)。
2. 点击侧边栏中的 **Turnstile**。
3. 选择你的小组件。
4. 查看 **Analytics** 部分。完成几次测试提交后，你应该能看到 **Challenges issued** 和 **Likely human** 百分比。

<Tip>
  Turnstile 对大多数访客都是静默运行的，因此除非你选择了 Non-Interactive 模式，否则页面上很可能看不到任何可见的小组件。这属于正常现象。
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.