TLG_JoinCaptchaBot动画视频验证码揭秘：Manim实时生成与视频池管理策略

TLG_JoinCaptchaBot动画视频验证码揭秘Manim实时生成与视频池管理策略【免费下载链接】TLG_JoinCaptchaBotTelegram Bot to verify if users joining a group are human. The Bot sends a captcha challenge to each new user and removes those who fail to solve it within a specified time.项目地址: https://gitcode.com/gh_mirrors/tl/TLG_JoinCaptchaBotTLG_JoinCaptchaBot 是一款 Telegram 入群验证码机器人Join Captcha Bot用于验证新加入群聊的用户是否为真人。它的最大亮点之一是用 Manim 数学动画引擎实时生成动画视频验证码并通过视频池预生成策略让每次入群验证毫秒级响应。本文带你拆解这套动画视频验证码的生成原理、视频池管理机制以及如何按需调优配置。为什么用动画视频验证码 传统文本验证码数字、算式、图片已被成熟的 OCR 和打码平台大量破解。而 Manim 生成的动画视频验证码由连续运动的图形与字符组成动态画面让机器识别难度大幅提升同时真人只需看一遍动画就能快速读出答案体验友好。TLG_JoinCaptchaBot 内置多种验证码模式其中video动画视频是默认模式与nums数字、math算式、poll投票、hex十六进制、ascii等模式可随时按群切换也可随机混合出题防止脚本针对性破解。Manim 实时生成动画验证码的原理 机器人并不自己渲染动画而是依赖 requirements.txt 中锁定的manim-captcha1.2.2组件。它是基于 Manim 社区版封装的验证码生成库核心类CaptchaAutoGenerator负责自动化完成出题 → 动画 → 渲染成片全流程。在 src/join_captcha_bot.py 第 181 行附近机器人实例化了一个视频验证码生成器传入视频存放目录CAPTCHAS_DIR_VIDEO传入补货间隔TIME_VIDEO_GEN_INTERVAL_S默认 600 秒传入视频池上限MAX_NUM_VIDEO_CAPTCHAS默认 100 条生成器会在后台线程周期性工作检查池中视频数量是否低于阈值不足时自动调用 Manim 场景渲染新的验证码视频并追加进池子。也就是说Manim 的渲染始终发生在后台与用户入群事件解耦——这是实时生成背后的关键设计。视频池管理策略为什么不是按需生成 ⏱️Manim 渲染一段动画视频需要数秒甚至更久如果等用户入群后再临时渲染验证码迟迟发不出来体验很差。TLG_JoinCaptchaBot 的解法是视频池 定期补货配置项默认值作用CAPTCHABOT_MAX_NUM_VIDEO_CAPTCHAS100视频池最大容量池内始终囤着可直接下发的视频CAPTCHABOT_TIME_VIDEO_GEN_INTERVAL_S600后台检查/补货间隔秒即每 10 分钟盘点一次池子这套策略的好处即时响应用户入群时直接从池里get_captcha()取一条现成视频几乎零延迟削峰填谷渲染压力被摊平到后台周期任务中不会在群爆入时集中卡顿防耗尽池容量有上限补货间隔可控既不会无限占满磁盘也能保证高峰期有货可发。相关默认值定义在 src/settings.py并由 src/constants.py 统一解析还支持通过CAPTCHABOT_MAX_NUM_VIDEO_CAPTCHAS、CAPTCHABOT_TIME_VIDEO_GEN_INTERVAL_S等环境变量覆盖方便 Docker 部署时注入。视频验证码下发全流程 在 src/join_captcha_bot.py 的send_captcha_video函数中完整的下发逻辑相当稳健取题从视频池获取一条验证码拿到视频文件与对应答案发送以captcha.mp4名义把视频发到群里附带的说明文字做了 1024 字符截断保护视频 caption 上限支持双语模式自动追加英文提示重试发送失败最多重试 5 次应对网络抖动降级兜底若 5 次均失败自动降级为图片验证码重新出题确保用户始终能完成验证不会卡死在入群流程风控联动验证期间临时限制该用户发送图片、视频等媒体消息配合 URL 消息删除策略进一步压住机器刷屏。发送成功后答案、超时时间、待清理消息 ID 一并写入用户验证状态等待用户在限时内回复正确答案。如何调整视频验证码配置 ️所有关键参数都集中在 src/settings.py按需修改即可想要更低的视频消耗调小CAPTCHABOT_MAX_NUM_VIDEO_CAPTCHAS池上限想更快补货调小CAPTCHABOT_TIME_VIDEO_GEN_INTERVAL_S如 300 秒想换默认模式修改CAPTCHABOT_INIT_CAPTCHA_MODE默认video。 提示视频池文件存放在CAPTCHABOT_CAPTCHAS_DIR默认src/data/captchas下磁盘紧张时记得定期清理该目录。部署注意Manim 环境依赖 ⚙️Manim 渲染依赖系统级图形库Linux 部署前需先安装前置依赖见 README 安装说明build-essential、libcairo2-dev、libpango1.0-dev等。拿到代码后一条命令即可完成环境初始化git clone https://gitcode.com/gh_mirrors/tl/TLG_JoinCaptchaBot cd TLG_JoinCaptchaBot make setup make start日常运维同样由 Makefile 接管make status查状态、make stop停止服务。生产环境推荐使用 systemd 常驻或直接使用项目提供的 docker/Dockerfile 构建容器配套 docker/README.mdManim 依赖已包含在镜像构建流程中省去手动装库的麻烦。小结TLG_JoinCaptchaBot 的动画视频验证码 Manim 后台渲染视频池预生成发送失败自动降级。这套生成与下发解耦的设计既保证了入群验证的低延迟体验又把 Manim 这种重型渲染开销稳稳消化在后台。对于想自建群组防机器人方案的你这套视频池管理思路也值得借鉴。【免费下载链接】TLG_JoinCaptchaBotTelegram Bot to verify if users joining a group are human. The Bot sends a captcha challenge to each new user and removes those who fail to solve it within a specified time.项目地址: https://gitcode.com/gh_mirrors/tl/TLG_JoinCaptchaBot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考