📦 简介
黑鸽Telegram关键词监听系统源码 是面向社群运营和舆情监测场景的 Telegram 群组消息实时监控工具,支持同时登录多个 Telegram 账号监听指定群组,匹配到预设关键词后自动通过 Bot 推送通知到指定聊天窗口。基于 Python Flask + Telethon 开发,附带完整的 Web 管理后台。
纯中文界面 · 完全开源无加密 · ❌ 不支持多语言扩展(前端中文硬编码)
亲测环境:Ubuntu 22 + Nginx 1.24.0 + Python 3.11.9,测试日期:2026-06-10。注意:本项目不含主动私聊功能
⚡ 功能说明
- 🚀 多账号并发监听:支持同时登录多个 Telegram 账号进行群组监听,基于 asyncio 实现并发消息处理,各客户端独立运行互不干扰
- 🎯 关键词匹配 + 多层过滤:消息匹配关键词后依次经过——消息长度过滤、用户名有效性检测、emoji/特殊符号/空格过滤、昵称屏蔽词、话术屏蔽词共 8 道过滤规则,通过后才触发推送
- 📨 Bot 推送与重试机制:通过 Telegram Bot API 推送 HTML 富文本通知,内置推送队列保证顺序执行,单次最多重试 5 次且支持指数退避 + 抖动
- 🔒 Bot 内联按钮一键屏蔽:推送消息附带「🚫 屏蔽用户」内联按钮,管理员点击按钮即可将发送者加入屏蔽名单,无需登录后台操作
- ⚙️ Web 管理后台:Flask 构建的管理界面,支持配置管理(API 凭据/关键词/过滤规则)、账号管理(添加/删除 Telegram 监听号,含验证码+两步验证登录)、高级配置(连接参数/监控参数)、屏蔽用户管理、日志查看、密码修改
- 🛡️ 系统健康监控:内置连接健康检查、内存监控(超阈值自动 GC)、网络连通性检测、CPU/内存/磁盘性能监控、看门狗(5 分钟无活动自动重启)、24 小时预防性重启
- 🔄 配置热重载:Web 后台修改配置后自动生成信号文件,监听进程以 2 秒间隔轮询检测到信号后立即重载配置,无需重启进程
🎬 视频教程
🛠 源码信息
| 界面语言 | 纯中文 |
| 开源状态 | 完全开源 |
| 是否加密 | 无加密 |
| 二开多语言 | 有限支持(前端中文硬编码,需手动翻译模板文件) |
📋 技术栈
| 后端 | Python 3.11+ · Flask 3.0 · Telethon 1.34 |
| 前端 | HTML + CSS + JavaScript(Jinja2模板引擎) |
| 数据库 | 无(JSON文件 unified_config.json 存储所有配置与数据) |
| 环境 | Debian 22 / Windows · Python 3.11+ · Nginx(可选反向代理) |
📥 交付内容
完整源码 + 使用教程 + 视频搭建教程 + 统一配置文件 + 依赖清单
💬 常见问题
Q:源码是什么界面语言?能扩展多语言吗?
A:界面为纯中文,所有前端文案在 Jinja2 模板中硬编码,没有语言文件或 i18n 机制。如需扩展多语言,需要手动翻译 templates/ 目录下的 11 个 HTML 模板文件,有限支持。
Q:是否全开源?有无加密?
A:完全开源无加密。代码中未发现 base64_decode、eval、gzinflate 等加密混淆手段,所有源码清晰可读,无后门代码。subprocess 仅用于合法的进程自启动和看门狗重启。
Q:怎么部署?包技术支持吗?
A:部署需要 Linux 服务器(推荐 Debian 12)+ Python 3.11 环境。附带了详细的部署教程和视频搭建教程,按照教程操作即可。同时需要自行申请 Telegram API ID 和 API Hash(my.telegram.org),并创建一个 Bot 获取 Token。本源码为分享性质,不包含一对一技术支持。
⚠️ 本源码仅供学习研究,请勿用于非法用途。
本站(k8code / K8源码网)更多亲测源码持续更新中
声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。




