📦 简介

黑鸽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源码网)更多亲测源码持续更新中

    

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。