seansuny/pt-captcha repository overview

⁠pt-captcha---PT验证码识别

验证码 --- 一个验证码识别框架 base on an Tencent / Baidu OCR API

⁠PT验证码识别简介

==========

针对 pt 站点常用的验证码进行预处理并调用腾讯/百度的 ocr api 进行识别，通常用于自动签到

大致的使用流程如下：

1. 首先需要开通百度或腾讯任意一个 ocr 服务，获取到 apikey 及 secret
2. 通过设置环境变量的方式进行配置，并启动运行服务（建议使用 docker 运行）
3. 通过 http 接口调用 POST base64 编码的图片数据，接口将响应并返回识别结果

⁠使用方式及步骤

==========

⁠申请凭证

首先需要选择一个 ocr 服务提供方申请接入，并拿到 apikey 及 secret 凭证，具体参考：

• 申请百度智能云 OCR 接入⁠
• 申请腾讯云 OCR 接入⁠

⁠Docker容器部署方式

• Docker地址 : https://hub.docker.com/r/seansuny/pt-captcha⁠

以腾讯云为例，假设已经获取到的凭证已经保存到对应变量：

• apikey: $TENCENT_SECRET_ID
• secret: $TENCENT_SECRET_KEY

则容器启动命令如下：

docker run -d --name pt-captcha \
    --restart=always -p 5500:5000 \
    -e API_KEY="$TENCENT_SECRET_ID" \
    -e SECRET_KEY="$TENCENT_SECRET_KEY" \
    -e OCR_VENDOR="tencent" \
    seansuny/pt-captcha:latest

之后就可以通过容器宿主的 5500 端口访问

⁠服务测试

假设容器宿主 IP 为 10.0.0.100，则可通过以下方式来查看当前使用的哪个服务提供商：

curl http://10.0.0.100:5500/current_ocr

因为上文中使用了腾讯的服务，所以该命令会返回 tencent

⁠图片识别

首先我们需要将验证码图片转为 base64 编码，本仓库 image 目录下提供的示例图片为例：

将其通过代码或者在线网站转成 base64 编码，假设将其赋值到变量 $IMAGE_BASE64，然后就可通过 POST 方法调用该接口进行识别，具体方式如下：

curl -X POST http://10.0.0.100:你指定的端口/upload \
    -H 'Content-Type: text/json' \
    -d "{\"image\": \"$IMAGE_BASE64\"}"

注意上述参数需要严格的 json 格式，必须使用双引号，最终返回数据为：

"recognition":"R5B6B4"

⁠参数

==========

本仓库只提供容器运行方案，对应配置均通过环境变量进行设置：

各厂商对应 API_KEY 与 SECRET_KEY 叫法如下：

另外，API_REGION 仅在使用腾讯 ocr 接口时有效，其可选值为：

⁠鸣谢

==========

shuosiw⁠

⁠许可

===========

MIT⁠ 许可协议