Skip to content
KitploitKITPLOIT
工具漏洞利用博客
Log in
提交
工具漏洞利用博客
提交

黑客、渗透测试和网络安全工具,武装您的安全武器库!

Kitploit 是一个黑客、网络安全和渗透测试工具的目录。发现最新的项目更新,查找漏洞、分析系统、自动化测试并加强你的安全。

订阅源联系隐私© 2026 Kitploit

工具目录

分类

查看所有分类
Loading categories
telegram-bot-dumper — 转储 Telegram 机器人。像 Telegram Web 一样浏览它。具有 Web 界面的取证 CLI 工具 | Kitploit
工具/GitHubGitHub/soxoj/telegram-bot-dumper
OSINT (开源情报)数据泄露信息收集
GitHubsoxoj/telegram-bot-dumper

telegram-bot-dumper

转储 Telegram 机器人。像 Telegram Web 一样浏览它。具有 Web 界面的取证 CLI 工具

查看仓库
249341004天前Kitploit 审核通过
分享

telegram-bot-dumper

Documentation Status

轻松导出 Telegram 机器人的全部内容。

输入:仅需机器人 token。

输出:机器人名称与信息、所有聊天的文本历史与媒体、机器人的用户信息与照片。


这是一个 Python 实现。

🚀 由 ScBoln 提供的快速 Golang 版本。

📖 完整文档:https://telegram-bot-dumper.readthedocs.io

Web 查看器

一个类似 Telegram Web 的浏览器界面,用于查看导出数据:聊天列表、带内联媒体的完整消息历史、带照片轮播的用户资料,以及跨所有会话的全局搜索。支持实时模式:它在后台运行导出工具,并将新消息实时推送到浏览器。

打开一个会话并选择 Download chat,即可将其历史记录、媒体和照片保存为 dump_<bot_id>_<chat_id>.zip。该压缩包保留 <bot_id>/<chat_id>/ 目录结构,并排除其他聊天和机器人级别的文件。

使用场景——对泄露的机器人 token 进行渗透测试。 Telegram 机器人 token 在渗透测试中屡见不鲜——硬编码在移动端/桌面应用中、提交到代码仓库,或存在于 CI 日志、配置文件或客户端打包文件中。单独来看,一个 token 似乎只是低危发现;但在这里加载它,就能揭示真正的爆炸半径。对于内部机器人(支持台、IT/DevOps 助手、AI 助手)而言,这意味着与它的每一次员工对话——内部主机名、VPN 配置、凭据和基础设施细节——都可浏览、可搜索,从而让你界定影响范围,并在报告中为发现提供证据。

Web 查看器——内部机器人的导出数据

从预构建镜像运行(Docker Hub)

docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" soxoj/telegram-bot-dumper-web

或本地构建

docker compose up --build      # builds and serves on http://127.0.0.1:8010

或者不使用 Docker

pip install -r requirements.txt
python webapp/server.py        # serves dumps from the repository folder on :8010
./run-viewer.sh                # live mode + dumping new bots, API_ID/API_HASH from .env

打开 http://127.0.0.1:8010 并粘贴 bot token 以打开其 dump:它必须与该 dump 的 bot.json 中保存的 token 匹配。只读查看无需 API 凭据。实时模式 额外需要来自 my.telegram.org 的 API_ID/API_HASH,通过环境变量传入——绝不要烘焙进镜像:

# one-off container
docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" \
  -e API_ID=123456 -e API_HASH=abc... soxoj/telegram-bot-dumper-web

# or with docker compose: put them in a local .env (see .env.example)
cp .env.example .env && $EDITOR .env && docker compose up

PORT 和 HOST 环境变量会覆盖默认值(8010、127.0.0.1)。

从查看器中转储新的机器人

默认情况下,查看器只会打开已有转储的机器人。使用 --allow-new-dumps(在 Docker 中为 ALLOW_NEW_DUMPS=1)启动它后,尚未有转储的 token 会通过 Telegram 进行检查,获取其文件夹和 bot.json,并且实时模式会将其完整历史直接转储到浏览器中。这需要 API_ID/API_HASH。

任何能打开该页面的人都可以让你的服务器在你的 API_ID 下转储任意机器人,因此当此标志在非回环 HOST 上启用时,查看器会拒绝启动。在 Docker 中,容器内的 HOST 始终为 0.0.0.0,因此请添加 ALLOW_PUBLIC=1(--allow-public),并自行将端口保持在回环地址上:

docker run --rm -p 127.0.0.1:8010:8010 -v "$PWD:/data" \
  -e API_ID=123456 -e API_HASH=abc... -e ALLOW_NEW_DUMPS=1 -e ALLOW_PUBLIC=1 \
  soxoj/telegram-bot-dumper-web

功能特性

  • 通过向上(默认)或向下(--down / --start-from-id)遍历消息 ID 来转储机器人消息及其媒体内容。
  • 实时监听模式(--listen-only):实时接收新消息,并提供从首个观测到的 ID 向下转储历史记录的功能。
  • 同时解析传入消息以及机器人传出回复的用户信息。
  • 用于快速枚举用户的轻量模式:跳过媒体、跳过按聊天记录文本历史、将用户写入单个 CSV 文件。
  • 群组 / 超级群组消息会标记为 [from:USER][group:CHAT]。机器人发出的私聊消息会标记为 [to:USER]。
  • 群组监控:如果机器人已被添加到群组/超级群组,且其隐私模式已禁用,则机器人会接收所有群组消息——而不仅仅是命令和回复——并且 --listen-only 会实时转储这些消息。在启用隐私模式(默认设置)的情况下,机器人只能看到命令、提及和回复。

环境要求

  • Python >= 3.6
  • Telethon(固定版本请参见 requirements.txt)
  • 注册一个 Telegram 应用以获取 API_ID 和 API_HASH

作为 CLI 工具使用

pip install -r requirements.txt

# Telegram API credentials from https://my.telegram.org (read from the environment)
export API_ID=123456
export API_HASH=abc...

快速开始 — 完整转储(默认行为)

以每批 200 个的方式向上遍历 id 1..∞,下载每条消息、所有媒体以及所有用户头像。默认情况下,转储器在转储完成后会继续监听新的传入消息。若要在历史转储完成后立即退出(非常适合脚本和 cron 任务),请传入 --no-listen。

./dumper.py --token 12345678:ABCe2rPVteUWZ7wLeCqCb3CH3ilUY_fLabc

从最新消息向下转储

对于活跃的机器人,向上遍历会撞上一大段已被修剪(删除/过期)的旧 id,然后放弃。从最新的 id 向下遍历则高效得多。--down 会自动探测上界(10 的幂,最高到 10⁹),并从它找到的最高非空 id 开始:

./dumper.py --token TOKEN --down

注意。 Telegram 不会永久保留机器人消息历史。根据实际经验,只有最近几十万条消息仍然可访问——在我们的测试中,一个繁忙的机器人大约只暴露了最近 500K 条消息,之后 messages.getMessages 对更早的 id 开始只返回 MessageEmpty。如果你的机器人历史上处理的消息量超过这个数量,那么更早的历史在服务端已经不存在了,任何标志都无法恢复它。

如果你已经知道一个较新的消息 id(例如你实时看到过的某个 id),你可以跳过探测,直接从该 id 开始:

./dumper.py --token TOKEN --start-from-id 11922524

监听模式

不导出任何内容;只观察到达的消息。收到第一条传入消息时,脚本会提示从该 id 开始向下导出:

./dumper.py --token TOKEN --listen-only

轻量级用户枚举(CSV,无媒体,无逐聊天历史)

当你只需要一份与机器人交谈过的用户名单时很有用——不需要 zip 文件、不需要 jpeg 图片、也不需要逐聊天的 *_history.txt。

./dumper.py --token TOKEN --down --users-csv --no-photos --no-media --no-history

输出:<bot_id>/users.csv,包含列 id, username, first_name, last_name, phone, lang_code, bot, premium, verified, scam, fake。

崩溃后恢复 / FloodWait

向下遍历会将下一批边界保存到 <bot_id>/last_message_id.txt。 如果运行被中断,请在现有转储文件夹中继续,无需再次探测:

./dumper.py --token TOKEN --resume

使用与原始运行相同的 --output 目录(如果已设置)。已保存的聊天记录和会话文件会被保留。缺失或无效的检查点会在连接前产生错误。--resume 不能与 --listen-only 或 --start-from-id 组合使用;它意味着向下遍历。

若要改为手动选择起始点,请使用 Requesting message ids X..Y ... 中最后打印的下界:

./dumper.py --token TOKEN --start-from-id <Y>

调整批处理大小

较小的批次 → 日志中的反馈更快,FloodWait 后的恢复窗口更短。较大的批次 → 在扫描稀疏 / 已裁剪的 id 范围时往返次数更少。在实践中,最大到 1000 的值都能正常工作。

./dumper.py --token TOKEN --down --batch-size 50
./dumper.py --token TOKEN --down --batch-size 500
./dumper.py --token TOKEN --down --batch-size 1000

其他标志

标志作用
--lookahead N在一个全空的批次之后,继续扫描 N 个批次再放弃。当 id 稀疏时很有用。
--no-photos跳过下载用户头像(avatars)。
--no-media跳过下载消息内的照片和文档;元数据仍会写入文本历史记录。
--no-history不写入每个聊天的 <chat_id>_history.txt。与 --users-csv 组合使用可实现最轻量的运行。
--users-csv将用户写入单个 <bot_id>/users.csv,而不是 <user_id>/<user_id>.json 目录。
--tor通过本地 127.0.0.1:9050 上的 Tor SOCKS5 代理进行路由(绕过 Telegram 封锁)。

运行 ./dumper.py --help 查看完整列表。

目前已知问题

  1. 机器人在历史记录完全导出之前就退出了。 如果某些消息已被用户删除,一个批次可能返回完全为空,脚本可能会过早停止。此外,如果机器人处理了非常大量的流量,旧消息已不再由 Telegram 服务器返回——它们已被清理,任何标志都无法恢复它们。对于稀疏但确实存在的历史记录,请调高 --lookahead 以继续扫描越过空档:

    # check additionally 5*200 = 1000 ids
    ./dumper.py --token TOKEN --lookahead 5
    

    或者直接使用 --down,它受旧 id 间隙的影响要小得多。

  2. 未导出群聊(基础群组、超级群组)的历史记录。 messages.getMessages 只返回机器人的私聊历史记录;超级群组历史记录需要按频道逐个调用,而机器人通常无法进行此类调用。如果群组隐私已关闭(参见功能特性),群组消息仍会在 --listen-only 模式下实时捕获。

测试

离线单元测试(无网络、无令牌):

pip install -r test-requirements.txt
pytest tests/ --ignore=tests/bot_test.py

针对真实 bot 的集成测试(需要可用的 bot token):

TEST_TOKEN=12345678:... pytest tests/bot_test.py

Token 泄露

Dorks 示例:telepot.bot

下载工具

最受欢迎

查看全部 →

发现我们社区最常用的工具。

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 终极 OSINT 工具包:调查图谱、置信度评分、别名家族、地图、时间线和报告。49 个模块、400+ 个站点,无需 API 密钥。

    732
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock 一键执行应用(CVE-2026-43499)

    506
  • 3

    ARTEX

    baarai/artex

    基于LLM的多智能体自主渗透测试平台,具备规划器/执行器智能体、资产与探索图谱、MITM流量记录以及漏洞复测功能。

    405
  • 4

    redforge

    cybersecurity91/redforge

    浏览器端红队工具包,包含 102 个离线工具,用于侦察、载荷生成、凭据攻击、加密、编码和交战报告。

    342
  • 5

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AI原生网络安全的行动系统——在这里,意图转化为受治理的执行,证据沉淀为运营记忆,每一次操作都让下一次更出色。

    261
  • 6

    antifox

    antifox-ai/antifox

    AI multi-agent autonomous penetration testing platform that runs recon, attack-surface discovery, exploitation validation and evidence-backed report delivery.

    259

探索所有工具

浏览我们的工具集合

查看所有工具 →