Turnstile 人機驗證
Cloudflare Turnstile 是免費的人機驗證服務,用來取代 reCAPTCHA 等需要點選圖片的驗證碼。Turnstile 在背景分析瀏覽器行為,大多數真人訪客完全不用操作就能通過,同時擋下自動送出表單的機器人。它可以用在任何網站,網站不需要使用 Cloudflare 代理。
什麼時候需要 Turnstile?
- 註冊、登入、忘記密碼表單,防止大量假帳號與撞庫攻擊。
- 聯絡表單、留言板,防止垃圾訊息。
- 優惠券、投票等容易被腳本刷的功能。
Turnstile 怎麼運作?
sequenceDiagram
participant B as 瀏覽器
participant T as Turnstile
participant S as 你的伺服器
B->>T: 載入元件,背景完成驗證
T-->>B: 回傳 token
B->>S: 送出表單(附帶 token)
S->>T: 用 Secret Key 驗證 token
T-->>S: success: true / false
S-->>B: 處理或拒絕表單
重點是伺服器端必須驗證 token。只在前端放元件而不驗證,機器人可以直接略過前端送出表單。
步驟一:建立 Widget
- 在儀表板左側選 Turnstile → Add widget。
- 填入名稱與要使用的網域(例如
example.com)。 - 模式選 Managed(由 Cloudflare 自動決定是否要使用者點選)。
- 建立後取得 Site Key(放前端)與 Secret Key(只放伺服器)。
步驟二:在表單加入元件
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>
<form action="/contact" method="POST">
<input type="email" name="email" required>
<textarea name="message" required></textarea>
<div class="cf-turnstile" data-sitekey="你的 Site Key"></div>
<button type="submit">送出</button>
</form>
元件會在表單中自動加入名為 cf-turnstile-response 的欄位。
步驟三:伺服器端驗證
以 Cloudflare Workers/Pages Functions(JavaScript)為例:
async function verifyTurnstile(token, secret, ip) {
const body = new FormData();
body.append("secret", secret);
body.append("response", token);
body.append("remoteip", ip);
const res = await fetch(
"https://challenges.cloudflare.com/turnstile/v0/siteverify",
{ method: "POST", body }
);
const result = await res.json();
return result.success === true;
}
驗證失敗就拒絕處理表單。Secret Key 要用環境變數或 Secret 保存,不要寫進前端或 Git。
本機測試用的 Key
Cloudflare 提供一組固定的測試用 Site Key/Secret Key,可以在本機開發時模擬「一定通過」或「一定失敗」,詳見官方文件的 Testing 章節。