一行代码,挡住机器人。

Calo Gate 是开源的轻量人机验证组件。用户按顺序点击几个图形就能通过,不需要选图、不需要打勾。你可以直接用,也可以把它部署到自己的 Cloudflare。

1

图形顺序验证

先看懂题目,再按顺序点击对应的图形。题目每次随机,同一道题最多尝试 4 次。

2

短期 Token

通过后拿到一个 5 分钟有效的签名 Token,后端校验一次即作废,避免重放。

3

可自托管

整套服务跑在 Cloudflare Worker + D1 上,免费额度足够中小站点使用。

Live demo

亲自试一次

下面这个框就是别人网站上嵌进去的样子。点一下开始,按题目顺序点击图形。

等待验证
通过验证后这里会显示 Token

Integration

三步接入

前端放一个容器,引入脚本,用户通过后把 Token 提交给你的后端校验。


    

API

接口一览

所有接口都是 JSON,公共实例地址为 https://gate.calopic.top。

方法路径说明
GET/v1.js验证组件脚本
POST/api/challenge生成题目
POST/api/verify提交答案,换取 Token
POST/api/siteverify服务端校验 Token(与你后端对接)
GET/api/reputation/lookup查询 IP 信誉分(需密钥)
POST/api/reputation/batch批量查询 IP 信誉(需密钥)

Self-hosting

部署到你自己的 Cloudflare

只需要一个 Worker 和一个 D1 数据库,免费额度即可运行。

# 1. 创建数据库
wrangler d1 create calo-gate

# 2. 把返回的 database_id 填进 wrangler.toml

# 3. 建表
wrangler d1 execute calo-gate --remote --file schema.sql

# 4. 部署
wrangler deploy