v1.4--带有群组管理面板,可以封禁用户(移除群聊),单用户禁言,群组禁言
v1.5--修复图片、视频等多媒体下载(包含nginx配置文件nginx.conf),筛选
v1.6--轻度禁言,只准发送文本文字,有自动禁言功能
v1.7--查看群员信息
v1.8--入群验证功能
v1.9--垃圾信息检测
v2.0--整合需要用户修改的配置文件
v2.1--修正群组成员列表
v2.2--群组成员列表 不超过主窗口(目前最新版本)
=========py版本,小白可以看下面的docker版本====================================
1. 新建必要的文件夹
mkdir -p /home/tel_group_ass/static/js
mkdir -p /home/tel_group_ass/templates
2. 将必要的文件内容复制下来,并放入对应的文件夹
文件树如下:
/home/tel_group_ass
├── config.py
├── static
│ ├── js
│ │ ├── GroupAdminPanel.js
│ │ ├── GroupMembersPanel.js
│ │ ├── JoinVerificationPanel.js
│ │ ├── messages.js
│ │ └── SpamFilterPanel.js
│ └── login.html
├── telegram-bot.py
└── templates
└── index.html
或者你也可以直接从github上克隆下来(确保 /home/tel_group_ass 目录在你执行克隆操作前不存在)
git clone https://github.com/Jasonzhang2023/group_assist_bot /home/tel_group_ass
文件都保存好后,记得改属性:
chmod +x /home/tel_group_ass/telegram-bot.py /home/tel_group_ass/static/login.html /home/tel_group_ass/templates/index.html
chmod +x /home/tel_group_ass/static/js/GroupAdminPanel.js /home/tel_group_ass/static/js/messages.js /home/tel_group_ass/static/js/SpamFilterPanel.js /home/tel_group_ass/static/js/JoinVerificationPanel.js
或者你也可以直接从github上克隆下来
这些文件你需要修改的地方有:
config.py(可以看着修改,小白也能看得懂需要修改的地方,我就不赘述了)
其他主体文件就不需要修改,直接用即可。
3. Nginx的配置
因为用了webhook,所以要用反代,nginx的配置文件你可以放到你的nginx的conf文件夹内,nginx内需要修改的地方为:
第4行,你的网址,和config.py中的网址保持一致
第6、7行,证书地址
4. 配置进程保护 telegram_group_assistant.service
touch /etc/systemd/system/telegram_group_assistant.service
nano /etc/systemd/system/telegram_group_assistant.service
填入以下内容:
[Unit]
Description=Telegram Group assistant
After=network.target
[Service]
Type=simple
User=root
WorkingDirectory=/home/tel_group_ass
ExecStart=/root/venv/bin/python /home/tel_group_ass/telegram-bot.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
5. 配置Python虚拟环境(如果你是高手,也可以不用Python虚拟环境)
步骤 1: 安装虚拟环境支持工具
首先,确保你的系统安装了 python3-venv 包,这允许你创建和管理虚拟环境。
sudo apt update
sudo apt install python3-venv
步骤 2: 创建一个虚拟环境
选择一个目录来创建虚拟环境。例如,你可以在你的用户目录下创建一个名为 venv 的环境:
python3 -m venv ~/venv
步骤 3: 激活虚拟环境
在安装任何包之前,你需要激活虚拟环境:
source ~/venv/bin/activate
要退出虚拟环境:
deactivate
6. 进入虚拟环境,安装必要的工具
source ~/venv/bin/activate
pip install Flask request jsonify session redirect url_for send_file timedelta httpx HTTPXRequest RotatingFileHandler check_password_hash
(如果运行的时候提示缺少工具,那么就pip install 这个工具名字)
7. 确保上面步骤都操作和填写好你的信息后,就可以启动进程了
输入:
sudo systemctl daemon-reload
sudo systemctl enable telegram_group_assistant.service
sudo systemctl start telegram_group_assistant.service
sudo systemctl status telegram_group_assistant.service
8. 你需要将你的机器人加入到群内,并升级为admin管理员,就可以愉快的管理群了。
输入你的网址,会提示你输入密码(config.py中配置好的)后,就能见到操作界面
=========docker版本====================================
1、在服务器上部署:
# 创建必要的目录
mkdir -p /home/docker/telegram-bot/{data,logs}
mkdir -p /home/docker/telegram-bot/data/files
chmod -R 755 /home/docker/telegram-bot
2、下载必要的文件
# 进入文件夹
cd /home/docker/telegram-bot
# 复制配置文件模板,并修改为你的配置信息config.py
wget https://raw.githubusercontent.com/Jasonzhang2023/group_assist_bot/refs/heads/master/docker-config.py -O config.py
# 编辑配置文件(小白都可以看得懂的,请自行修改)
nano config.py
修改必须的几个参数:
TELEGRAM = {
'BOT_TOKEN': 'YOUR_BOT_TOKEN', # 替换为你的bot token
'ADMIN_ID': 123456789, # 替换为你的管理员ID(整数)
'WEBHOOK_URL': 'https://your-domain.com/webhook' # 替换为你的webhook URL
}
'ACCESS_TOKEN': 'your-access-token' # 替换为你的访问令牌
# 下载 docker-compose.yml
wget https://raw.githubusercontent.com/Jasonzhang2023/group_assist_bot/refs/heads/master/docker-compose.yml
3、 启动服务
docker-compose up -d
4、配置nginx(选择docker-nginx_website.conf 并保存到你的nginx配置文件中)
5、你需要将你的机器人加入到群内,并升级为admin管理员,就可以愉快的管理群了。
输入你的网址,会提示你输入密码(config.py中配置好的)后,就能见到操作界面Jasonzhang2023/group_assist_bot
Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|

