一行代码,挡住机器人。
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