Cloudflare 中文文档
Pages
编辑这个页面
跳转官方原文档
Set theme to dark (⇧+D)

Turnstile页面插件

Turnstile是 Cloudflare 的智能验证码替代方案。

Turnstile Pages 插件可验证 Cloudflare Turnstile 标记。

​​ 安装

​​ 使用方法

本插件仅提供一条路由,以验证作为 cf-turnstile-response 参数的 POST 中传入的 Turnstile 响应。无论安装在何处,它都将可用。在上面的示例中,它被安装在 functions/register.ts中。因此,它将验证对 /register的请求。

​​ 属性

安装插件时只需一个对象参数,该参数具有以下属性:

secret是必填项,都可以在 Turnstile 面板中找到。

responseremoteip 是可选字符串。response 是要验证的 Turnstile 标记。如果未提供,插件将默认从 multipart/form-data 请求中提取 cf-turnstile-response 值)。remoteip 是请求者的 IP 地址。默认为请求的 CF-Connecting-IP header。

onError 是一个可选函数,它接收页面函数上下文对象并返回一个 Response Promise。默认情况下,它会返回一个人类可读的错误Response

context.data.turnstile 将在后续的页面函数(包括 onError 函数)中使用Turnstile siteverify 响应对象进行填充。