Telegram-CAPTCHA-Lite-bot

一个用于验证新成员是不是真人的简易bot。

A bot running on Telegram which will send CAPTCHA to verify if the new member is a human.

基于原始项目重制

Remaked and forked based on Original Repository

修改者：Telegram @tooruchan Rsplwe

原理

本 Bot 通过读取 Telegram API 中返回的入群消息来识别新用户入群，并对加入群的用户进行提问。

Telegram Bot API 使用了基于 MTProto 框架的 pyrogram，多线程使用了 asyncio。

安装与使用

由于 Bot 使用了 Python 3.6 的变量类型标注支持特性，在低于 Python 3.6 的版本上会出现 SyntaxError，因此源码只能在 Python 3.6+ 上运行!

请先向 @BotFather 申请一个 Bot API Token

你申请到的机器人会在你的 Telegram 账号所在数据中心上运行（即申请机器人的账号A位于 DC5 (新加坡)，则 A 申请到的机器人也将会在 DC5 上运行)

在 Obtaining Telegram API ID 申请 API ID 与 API Hash
在服务器上安装 pyrogram 以及 tgcrypto（以 Ubuntu Server 18.04 LTS 为例）:

# 若未安装pip3，请先安装 python3-pip
apt install python3-pip
pip3 install -U https://github.com/Tooruchan/Telegram-CAPTCHA-Lite-Bot/raw/master/pyrogram-asyncio.zip
# 由于 pyrogram 经常更新伴随着大改语法，所以在这里直接使用最适合当前版本的 pyrogram 版本，以免部署时发生意外情况。
# pyrogram-asyncio.zip 的校验：
# SHA1: E57BDF355E2B3CA04C6934BB94254ABA7A45A5AF
# CRC32: E4016E8D
pip3 install --upgrade tgcrypto

git clone https://github.com/Tooruchan/Telegram-CAPTCHA-Lite-Bot
cd Telegram-CAPTCHA-Lite-Bot

将 config.json 里的 token 项修改为你在 @BotFather 获取到的 API Token，API hash 和 API id 修改为你在步骤2中获得的两串内容，其中 API ID 为数字，而 API Hash 为一组字符，你也可以对 config.json 里的内容酌情修改。

有关填写字段的一些说明:

token: 机器人访问 Telegram Bot API 使用的验证Token，格式为11111111:ABCDEF。

api_hash: 在Obtaining Telegram API ID中获得的 API Hash，通常是一个字符串。

api_id: 在上述步骤中获得的 API ID，通常是一个数字。

channel: Bot 日志记录频道，~~未填写将会导致无法正常工作（这是一个 bug）~~。

manage_user: 管理用户，不填写则/leave指令无效。

使用 python3 main.py 运行这个 bot,或者在 /etc/systemd/system/ 下新建一个 .service 文件，使用 systemd 控制这个bot的运行，配置文件示例请参考本项目目录下的 example.service 文件进行修改。
将本 Bot 加入一个群组，并给予封禁用户的管理员权限，即可开始使用。

本 Bot 并未明确要求任何读取聊天内容的权限，因此在部署的时候可以放心地打开隐私模式；然而由于 Telegram 官方的原因，就算是启用了隐私模式的 Bot ，在给予管理员权限之后仍然会显示“可读取消息”，这并不代表本 Bot 就可以获取除了入群通知之外的消息内容，望周知。

在多个群组（10个以上等）部署本Bot的提示

由于一个已知无解的严重 Bug， Bot 在运行一周至13天左右的时间可能会由于线程冲突导致整个 Bot 死掉，如果需要在多个（10个以上）的群组内部署本 Bot 请考虑在crontab等地方设置定期重启。

现在的分支加入了一遇到异常就会自动重启的设定，Bot 在正常运行情况下应该是不会卡死了。

日志

在安装了 systemd ，且已经在 /etc/systemd/system 下部署了服务的 Linux 操作系统环境下，请使用命令：

journalctl -u captchabot.service 
# 这里的 captchabot.service 请自行更名为你在服务器上部署的服务名

开源协议

本项目使用 AGPLv3 协议开源，使用请注明本项目地址，基于本项目做出的任何修改也请开源。

nonomal / telegram-captcha-lite-bot Goto Github PK