
TLG_JoinCaptchaBot 是一款给群主自建群组用的入群验证开源机器人。新成员进群时,它会先发一道 CAPTCHA 题目,通过了才能正常发言,超时没通过就按规则移出群组。它的目标很单纯:把批量注册的小号和发广告的机器人挡在门口,让群主不用整天手动清人,适合已经有一定规模、每天都有新人加入的自建群组。
项目信息
| 软件名 | TLG_JoinCaptchaBot |
| 一句话用途 | 给自建 Telegram 群组加一道入群 CAPTCHA 验证 |
| 运行语言 | Python,支持 Docker 与 systemd 常驻部署 |
| 验证形式 | 图片、视频与自定义投票等多种 CAPTCHA 模式 |
| 管理粒度 | 按群组分别配置语言、难度、欢迎语与验证时限 |
| 获取方式 | 开源仓库源码自托管部署,需自备 Bot Token |
入群验证是怎么工作的
机器人进群并拿到管理员权限后,会监听新成员加入事件。有人进群,它就发一道 CAPTCHA,同时把这个人在通过验证之前的发言权限收紧,比如禁止发链接和媒体消息。规定时间内答对,限制解除,正常参与群聊;超时没答出来,机器人按配置把人移出群组,并顺手清理掉验证过程中产生的机器人消息和残留题目。整个过程不需要群主逐个审批,规则一旦定好就自动执行。
版本选择:先对齐 Python 口径,再动手部署
源稿里出现过两处不一致的 Python 口径,一处徽章写 3.6 以上,另一处要求 3.12 以上,实际兼容范围必须以安装配置和源码为准。这里的推荐很明确:先在测试群用较新的 Python 3.12 以上环境把完整流程跑通,确认验证、超时移除和消息清理都正常,再部署到正式群组。不要凭徽章数字选旧环境,也不要跳过测试群直接上正式群。
| 部署方式 | 说明 | 适合谁 |
| Python 环境直跑 | 改动配置最方便,适合调试 | 第一次上手、还在调参数的群主 |
| systemd 常驻服务 | 随系统启动,掉线能自动拉起 | 长期运行的正式群组 |
| Docker 部署 | 环境相对隔离,迁移方便 | 已有容器习惯的运维人员 |
安装步骤
- 先申请 Bot Token,妥善保存,只给机器人自己用,不要发到群里或写进公开配置。
- 选一种部署方式把机器人跑起来,直跑、systemd 或 Docker 三选一,并按 README 装好 Manim 与 Pillow 这类媒体依赖。
- 把机器人拉进你自己建的群组,授予管理权限,重点是删除消息、限制成员与移除成员这几项,缺了权限验证流程会处处受限。
- 按群组逐项配置:验证类型、难度、验证时限、语言和欢迎语,改完先在测试群走一遍完整流程。
- 测试群验证通过后,再把机器人放到正式群组,并观察头几批新成员的验证情况,确认题目能正常显示、超时移除能正常执行。
必改设置
- 验证时限要定得合理。太短会误伤正常用户,太长会让广告号有空子钻,一般先从测试群的实测体验反推,不要拍脑袋定一个极端值。
- CAPTCHA 类型与难度按群成员构成选。纯文字群与多语言群的接受度不一样,难度要让真人顺手通过、让批量脚本难受,而不是反过来。
- 未验证用户的发言限制必须打开。只发题不设限,等于给广告号留了验证前的窗口期,链接和媒体限制要和验证流程一起生效。
- 超时移除与消息清理规则要成对配置。只移除人、不清理残留题目,群里会越积越多;只清理消息、不移除人,验证就形同虚设。
- 语言与欢迎语按群组单独设置。多语言群不要共用一套文案,题目语言和群规语言对不上,新人第一步就会卡住。
注意事项
- 只用在自己建的、有管理权限的群组。没有管理员身份就不要部署,权限不足时机器人既拦不住人,还会留下大量半截验证消息。
- Bot Token 等于机器人的钥匙。泄露后别人能冒充你的机器人进群操作,换 Token 后要同步更新部署配置并重新验证。
- Manim 与 Pillow 的安装成本不低。环境里缺系统依赖时,视频与图片类题目可能生成失败,部署前先确认这两块能正常工作。
- 不要用它绕过平台验证或批量加群。本篇只写群主自建群的入群验证,任何批量拉人、代人验证的用法都不在适用范围内。
- 持久化、备份与高可用在源稿里没有明确说明。群组规模变大或换服务器前,先核对源码里的存储方式,别默认它什么都帮你存好了。
适用人群与对比
最适合的人是自建群组的群主和管理员,尤其是每天都有新人加入、已经受广告号困扰的群。相比纯人工审核,它省掉了逐个放人的时间;相比平台自带的简单验证,它的题目形式更多、按群配置更细。代价也很清楚:要自己维护服务器和依赖,出了问题没有客服兜底。如果你只是几十人的熟人小群,人工审核反而更省事,没必要为此单独养一个机器人。
取舍说清楚:它赢在自动化和可配置,输在运维成本上。愿意花时间做一次部署和测试群验证的人,能长期省下清广告的时间;只想装完就不管的人,遇到依赖升级或权限变动时反而会多出麻烦。
关注公众号,回复 TLG_JoinCaptchaBot 获取下载链接

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







