TGSherlock

本地 Web 面板中的 Telegram OSINT：实时监控、告警、用户追踪与关键词扫描。

安装

pipx install tgsherlock

从 GitHub 安装最新版：pipx install git+https://github.com/emrekybs/tgsherlock.git（如果之后找不到 tgsherlock，请运行 pipx ensurepath 并打开一个新终端）。

运行

tgsherlock

面板会在浏览器中打开，地址为 http://127.0.0.1:8765。在 Linux 上，首次运行还会将 TGSherlock 添加到应用程序菜单，因此你可以一键启动它。

首次运行： 在 my.telegram.org → API development tools 创建一个应用，输入你的 API ID 和 API Hash，然后用 Telegram 扫描二维码（设置 → 设备 → 关联桌面设备）。也支持手机号登录。

功能

• 实时监控：实时获取所选用户、群组和频道的消息，并可选择下载媒体文件。
• 告警：监控某个用户、某个群组或所有聊天中的任意消息、关键词、正则表达式、媒体或指标。可通过应用内、桌面、电子邮件（SMTP）或 webhook 接收通知，并支持摘要节流。
• 用户资料：简介、用户名、标记、共同群组、在每个群组中的首次和最后出现时间、每小时活动以及带日期的消息时间线。
• 搜索：搜索用户、群组和频道，并显示其头像。
• 群组历史 · 关键词扫描 · 用户追踪：后台任务，带进度显示并自动处理 FloodWait。
• 实体：自动提取电子邮件、电话号码、URL、IP、加密货币钱包、邀请链接和话题标签。
• 归档与导出：筛选你收集的所有内容，并导出为 CSV、JSON 或 HTML 报告。
• 多账户：可从侧边栏添加、切换和退出登录。

更新：pipx upgrade tgsherlock

选项：--port 8790、--no-browser、--install-desktop、--uninstall-desktop。 数据保留在本地：~/.config/tgsherlock（设置、会话）和 ~/.local/share/tgsherlock（数据库、媒体）。

负责任的使用

专为防御性 OSINT 和威胁情报而构建。TGSherlock 只能看到你自己的 Telegram 账户所能看到的内容。请遵守当地法律和 Telegram 的服务条款。

许可证

MIT