# captcha **Repository Path**: source/captcha ## Basic Information - **Project Name**: captcha - **Description**: 行为验证码(滑动拼图、点选文字)，前后端交互，支持h5/flutter/uni-app - **Primary Language**: JavaScript - **License**: Apache-2.0 - **Default Branch**: dev - **Homepage**: https://mirror.anji-plus.com/captcha-web/#/ - **GVP Project**: No ## Statistics - **Stars**: 8 - **Forks**: 1857 - **Created**: 2020-04-25 - **Last Updated**: 2025-04-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # **在线体验暂时下线 ！！！** ####   在线文档:[https://ajcaptcha.beliefteam.cn/captcha-doc/](https://ajcaptcha.beliefteam.cn/captcha-doc/ "doc")
[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)[![Total Lines](https://tokei.rs/b1/github/anji-plus/captcha?category=lines)](https://github.com/anji-plus/captcha) [![EN doc](https://img.shields.io/badge/document-English-blue.svg)](README.md)[![CN doc](https://img.shields.io/badge/文档-中文版-blue.svg)](README_CN.md) ## 简介     AJ-Captcha行为验证码，包含滑动拼图、文字点选两种方式，UI支持弹出和嵌入两种方式。后端提供Java、Golang实现，前端提供了php、angular、html、vue、uni-app、flutter、android、ios等代码示例。 # 1 在线体验 **在线体验暂时下线** # 2 功能概述 ####   2.1 组件介绍    行为验证码采用嵌入式集成方式，接入方便，安全，高效。抛弃了传统字符型验证码展示-填写字符-比对答案的流程，采用验证码展示-采集用户行为-分析用户行为流程，用户只需要产生指定的行为轨迹，不需要键盘手动输入，极大优化了传统验证码用户体验不佳的问题；同时，快速、准确的返回人机判定结果。目前对外提供两种类型的验证码，其中包含滑动拼图、文字点选。如图1-1、1-2所示。若希望不影响原UI布局，可采用弹出式交互。
   后端基于Java实现，提供纯Java.jar和SpringBoot Starter。前端提供了Android、iOS、Futter、Uni-App、ReactNative、Vue、Angular、Html、Php等多端示例。
| 滑动拼图 | 文字点选 | | --- | --- | |![滑动拼图](images/%E6%BB%91%E5%8A%A8%E6%8B%BC%E5%9B%BE.gif "滑动拼图") |![点选文字](images/%E7%82%B9%E9%80%89%E6%96%87%E5%AD%97.gif "点选文字")| | 图1-1 | 图1-2 |
####   2.2 概念术语描述 | 术语 | 描述 | | ------------ | ------------ | | 验证码类型 | 1）滑动拼图 blockPuzzle 2）文字点选 clickWord| | 验证 | 用户拖动/点击一次验证码拼图即视为一次“验证”，不论拼图/点击是否正确 | | 二次校验 | 验证数据随表单提交到后台后，后台需要调用captchaService.verification做二次校验。目的是核实验证数据的有效性。 | # 3 交互流程 ① 用户访问应用页面，请求显示行为验证码
② 用户按照提示要求完成验证码拼图/点击
③ 用户提交表单，前端将第二步的输出一同提交到后台
④ 验证数据随表单提交到后台后，后台需要调用captchaService.verification做二次校验。
⑤ 第4步返回校验通过/失败到产品应用后端，再返回到前端。如下图所示。 ![时序图](view/vue/static/shixu.png "时序图") # 4 目录结构 ├─core
│ ├─captcha    java核心源码
│ └─captcha-spring-boot-starter    springboot快速启动
├─images       效果图
├─service
│ ├─go    后端为go项目示例
│ ├─php    后端为php项目示例
│ ├─go    后端为go项目示例
│ ├─springboot    后端为springboot-2.x项目示例
│ ├─springboot3    后端为springboot-3.x项目示例
│ └─springmvc    后端为springmvc非springboot项目示例
└─view       多语言客户端示例
 ├─android    原生android实现示例
 ├─angular    angular实现示例
 ├─flutter    flutter实现示例
 ├─html    原生html实现示例
 ├─ios    原生ios实现示例
 ├─php    php实现示例
 ├─react    react实现示例
 ├─uni-app    uni-app实现示例
 ├─wx-applet    微信小程序实现示例
 └─vue    vue实现示例
  # 5 接入文档 ####   5.1 本地启动   第一步，启动后端，导入Eclipse或者Intellij,启动service/springboot的StartApplication。[社区底图库](https://gitee.com/anji-plus/AJ-Captcha-Images)
  第二步，启动前端，使用visual code打开文件夹view/vue，npm install后npm run dev，浏览器登录
```js npm install npm run dev DONE Compiled successfully in 29587ms 12:06:38 I Your application is running here: http://localhost:8081 ```  详细的前后端接入文档，后端示例代码service目录下，前端示例代码view目录下。 # 6 技术支持，如有问题，请提交Issue 提交Issue前请查阅已有Issue. 如有兴趣提交PR,请参考[提交PR规范](./CONTRIBUTING.md),切忌不要直接提交大PR，否则会影响合并流程和审核时效，也不要提交到master分支。 加微信前请备注AJ-Captcha。
微信群地址 #### 开源不易，劳烦各位star ☺
# Stargazers over time [![Stargazers over time](https://starchart.cc/anji-plus/captcha.svg)](https://starchart.cc/anji-plus/captcha)