Skip to content
KitploitKITPLOIT
ИнструментыЭксплойтыБлог
Log in
Отправить
ИнструментыЭксплойтыБлог
Отправить

Инструменты для хакинга, пентеста и кибербезопасности — ваш арсенал защиты!

Kitploit — это каталог инструментов для хакинга, кибербезопасности и пентестинга. Находите последние обновления проектов для поиска уязвимостей, анализа систем, автоматизации тестирования и усиления вашей безопасности.

ЛентыКонтактыКонфиденциальность© 2026 Kitploit

Каталог инструментов

Категории

Все категории
Loading categories
telegram-bot-dumper — Сдампите Telegram-бота. Просматривайте его как Telegram Web. Форензический CLI-инструмент с веб-интерфейсом | Kitploit
Инструменты/GitHubGitHub/soxoj/telegram-bot-dumper
OSINT (Разведка открытых источников)Эксфильтрация данныхСбор информации
GitHubsoxoj/telegram-bot-dumper

telegram-bot-dumper

Сдампите Telegram-бота. Просматривайте его как Telegram Web. Форензический CLI-инструмент с веб-интерфейсом

Репозиторий
249341003 дней назадПроверено Kitploit
Поделиться

telegram-bot-dumper

Documentation Status

Простой дамп всех данных Telegram-бота.

Вход: только токен бота.

Выход: имя и информация о боте, текстовая история всех чатов и медиафайлы, информация и фотографии пользователей бота.


Это реализация на Python.

🚀 Быстрая версия на Golang от ScBoln.

📖 Полная документация: https://telegram-bot-dumper.readthedocs.io

Веб-просмотрщик

Браузерный интерфейс в стиле Telegram Web для дампа: список чатов, полная история сообщений со встроенными медиафайлами, профили пользователей с каруселью фотографий и глобальный поиск сразу по всем беседам. Поддерживается режим реального времени: дампер запускается в фоне и передаёт новые сообщения в браузер в реальном времени.

Откройте беседу и выберите Download chat, чтобы сохранить её историю, медиафайлы и фотографии в виде dump_<bot_id>_<chat_id>.zip. Архив сохраняет структуру каталогов <bot_id>/<chat_id>/ и исключает другие чаты и файлы уровня бота.

Сценарий использования — пентест утёкшего токена бота. Токены Telegram-ботов постоянно всплывают в ходе проекта — жёстко зашитые в мобильном/десктопном приложении, закоммиченные в репозиторий или оставленные в логе CI, конфигурационном файле либо клиентском бандле. Сам по себе токен выглядит как находка низкой критичности; загрузка его сюда показывает реальный масштаб последствий. Для внутреннего бота (служба поддержки, помощник IT/DevOps, AI-ассистент) это все беседы сотрудников с ним — внутренние имена хостов, профили VPN, учётные данные и сведения об инфраструктуре — с возможностью просмотра и поиска, что позволяет оценить масштаб влияния и подтвердить находку в отчёте.

Веб-просмотрщик — дамп внутреннего бота

Запуск из готового образа (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.json этого дампа. Для просмотра в режиме только чтения API-учётные данные не нужны. Живой режим дополнительно требует API_ID/API_HASH с my.telegram.org, передаваемых через окружение — никогда не встраиваемых в образ:

# 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 (ALLOW_NEW_DUMPS=1 в Docker), и токен, для которого ещё нет дампа, будет проверен через Telegram, получит свою папку и bot.json, а режим live сбросит всю его историю прямо в браузер. Для этого нужны API_ID/API_HASH.

Любой, кто может открыть страницу, сможет заставить ваш сервер сбросить дамп любого бота под вашим API_ID, поэтому просмотрщик отказывается запускаться с этим флагом при HOST, отличном от loopback. В Docker HOST внутри контейнера всегда равен 0.0.0.0, поэтому добавьте ALLOW_PUBLIC=1 (--allow-public) и сами удерживайте порт на loopback:

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).
  • Режим прослушивания в реальном времени (--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...

Быстрый старт — полный дамп (поведение по умолчанию)

Перебирает идентификаторы 1..∞ по возрастанию пакетами по 200, скачивая каждое сообщение, все медиафайлы и все фотографии профилей пользователей. По умолчанию дампер продолжает прослушивать новые входящие сообщения после завершения дампа. Чтобы выйти сразу после выгрузки истории (идеально для скриптов и заданий cron), передайте --no-listen.

./dumper.py --token 12345678:ABCe2rPVteUWZ7wLeCqCb3CH3ilUY_fLabc

Выгрузка вниз от последнего сообщения

Для активного бота обход вверх натыкается на длинный участок удалённых (удалённых/истёкших) старых id и прекращает работу. Обход вниз от самого последнего id гораздо продуктивнее. --down автоматически проверяет верхнюю границу (степени десяти до 10⁹) и начинает с наибольшего непустого id, который находит:

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

Примечание. Telegram не хранит историю сообщений бота вечно. Эмпирически доступными остаются лишь последние несколько сотен тысяч сообщений — в наших тестах загруженный бот отдавал примерно последние 500K сообщений, после чего messages.getMessages начинал возвращать только MessageEmpty для более старых 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
Скачать инструмент

Популярное

Смотреть все →

Откройте для себя самые используемые инструменты нашего сообщества.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 Полный набор инструментов OSINT: граф расследования, оценка достоверности, семейства псевдонимов, карта, временная шкала и отчёты. 49 модулей, более 400 сайтов, API-ключи не требуются.

    546
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # Приложение GhostLock с запуском в один клик (CVE-2026-43499)

    477
  • 3

    ARTEX

    baarai/artex

    Платформа автономного тестирования на проникновение на основе мультиагентной LLM с агентами-планировщиками и агентами-исполнителями, графами активов и исследования, записью MITM-трафика и повторной проверкой уязвимостей.

    377
  • 4

    redforge

    cybersecurity91/redforge

    Браузерный инструментарий для red team с 102 офлайн-инструментами для разведки, генерации полезной нагрузки, атак на учётные данные, криптографии, кодирования и отчётности по проектам.

    324
  • 5

    estorides

    grisuno/estorides

    Агрегирует 99+ бесплатных источников OSINT параллельно, преобразует сущности в граф знаний и экспортирует в STIX 2.1, MISP или GraphML с анализом при поддержке LLM.

    269
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    Система действий для кибербезопасности на базе ИИ — где намерение превращается в управляемое исполнение, доказательства становятся оперативной памятью, а каждая операция улучшает следующую.

    252

Изучить все инструменты

Просмотрите нашу коллекцию инструментов

Смотреть все инструменты →