Skip to content

Jasonzhang2023/group_assist_bot

Repository files navigation

image image

操作说明

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中配置好的)后,就能见到操作界面

About

让机器人管理你的telegram群组

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors