Справочник / Установка
TgWitness: экспорт Telegram, OSINT и проверка данных
Установка одной командой или сбор через GitHub Actions. Сценарии расследования, опубликованный масштаб и смысл проверки архива.
TgWitness — открытый инструмент экспорта Telegram и работы с расследованиями. Установите его одной командой, подключите аккаунт, выберите переписку и получите подписанный архив. Также доступны временный сбор через GitHub Actions и длительные расследования с сохранением правок, наблюдений об удалении, поиском и отчётами.
Начните со своей задачи#
| Ваша задача | Кратчайший путь | Результат |
|---|---|---|
| Сохранить переписку или аккаунт | Установить, подключить аккаунт, выбрать область экспорта | Подписанный архив с выбранной историей, результатами сбора и материалами проверки |
| Собрать данные на временном исполнителе | Запустить сбор через GitHub Actions, авторизовать новую сессию и выбрать область | Зашифрованный архив с данными о происхождении из рабочего процесса GitHub |
| Следить за изменениями | Оставить наблюдение включённым для выбранных чатов | Сохранённые версии, уведомления об удалениях, вложения и сведения о покрытии |
| Расследовать и передать выводы | Искать по архиву, использовать доску дела и настроить отчёт или копию для передачи | Выводы со ссылками на источники и проверяемый комплект для получателя |
Установка одной командой#
Установщик включает Python и зависимости. Исходный код, Docker, провайдер ИИ и независимый свидетель — дополнительные варианты, а не обязательные условия запуска.
Linux / macOS:
curl -fsSL https://get.destroy.tools/install.sh | bash
Windows, в PowerShell или командной строке:
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
Откройте панель, подключите свой аккаунт Telegram и выберите область сбора. Сама установка сбор не запускает. Руководство по установке объясняет локальный доступ, серверы, обновления и проверку загруженной сборки.
Для временного исполнителя используйте сбор через GitHub Actions. Нужны форк на GitHub, авторизация и пароль архива. Страница сбора объясняет эти шаги и ограничение времени сессии до запуска. Скачайте и сохраните полученный архив вместе с материалами для проверки.
Дополнительные настройки по мере необходимости#
Для экспорта одного чата нужны аккаунт и выбранная область. Длительное наблюдение, несколько аккаунтов, прокси, правила загрузки вложений, оформление отчётов, доступ рецензентов, внешние метки времени и резервное хранение служат разным задачам расследования и передачи материалов. Настраивайте их, когда они нужны.
Область сбора, разрешения и копии с сокращённым набором данных помогают выбирать, что собирать и передавать. Подсказки по юрисдикциям и настройки отчётов поддерживают это решение; выбор профиля сам по себе не устанавливает соответствие закону или допустимость доказательств. См. экспорт аккаунта, доступ и настройку отчётов.
Приложение работает на выбранном компьютере или сервере. Для обычного сбора не нужны GPU или LLM. Дополнительные OCR, транскрибация и ИИ-анализ имеют собственные требования к ресурсам. Выбирайте конфигурацию по потоку сообщений, вложениям, объёму истории и числу одновременно работающих аккаунтов; простая установка не означает одинаковый расход памяти при любой нагрузке.
Сохранять материал независимо от того, кому он выгоден#
Цель — сохранять наблюдаемый материал, контекст и изменения независимо от того, чью позицию они поддерживают. Доказательства могут противоречить версии самого сборщика. Источники, пробелы покрытия и аналитические выводы должны оставаться различимыми, чтобы другой человек мог оценить тот же материал.
Логика работы: наблюдение доступных аккаунту данных → подписанный журнал → экспорт → проверка получателем. Правки добавляют версии. Наблюдения об удалении сохраняют ранее полученное содержимое. Записи покрытия показывают известные перерывы. Отчёты и ИИ-анализ ссылаются на сохранённые источники; интерпретация не становится исходным наблюдением только потому, что включена в подписанный отчёт.
| Проверка | Что может установить получатель |
|---|---|
| Хеши файлов, подписи и цепочка журнала | Переданные записи и файлы согласуются с ожидаемым ключом и границей журнала |
| Отдельно сохранённая контрольная точка или свидетель | Архив согласуется с ранее сохранённым состоянием журнала |
| Проверенная внешняя метка времени | Указанные байты существовали к этому времени при заявленных предпосылках доверия |
| Аттестация сбора на GitHub | Архив соответствует одобренному рабочему процессу, ревизии сборщика и записанному хешу |
Эти проверки помогают оценить целостность и происхождение. Они не превращают содержимое сообщения в истинное утверждение и не восстанавливают удалённые сообщения, которые никто не успел сохранить. Используйте независимо полученный отпечаток ключа и шаги из руководства по доверию и описания формата доказательств.
Опубликованный масштаб и измеренная производительность#
Ниже приведены результаты разных нагрузок и дат. Счётчики не взаимозаменяемы: событие журнала не обязательно является уникальным сообщением Telegram.
| Дата | Нагрузка | Опубликованный результат | Что измерялось |
|---|---|---|---|
| 1 ноября 2026 | Работающий сервер, десять баз рабочих пространств | 1 610 818 записей журнала; 900 232 события новых сообщений, 80 683 правки и 400 536 событий удаления | Подсчёт в режиме чтения; без замера скорости и повторной проверки всей цепочки |
| 5 ноября 2026 | Поиск по 1 000 000 синтетических сообщений в 200 чатах | Индекс построен за 71 секунду; медианное время отдельных поисковых запросов — 9–190 мс | Локальный тест поиска, не доставки из Telegram |
| 6 ноября 2026 | Два новых экспорта из настоящего Telegram | 27 030 и 29 299 сообщений; всего 56 329 за два запуска | По два аккаунта через WARP, текст и метаданные, без загрузки вложений |
| 6 ноября 2026 | Те же два экспорта с подготовкой и упаковкой | 127,713 и 141,781 сообщения в секунду | Полная скорость экспорта; оба архива проверены по заранее закреплённым ключам |
Протокол проверок содержит подсчёт на сервере, проверки живого сбора и замер поиска. Производительность экспорта публикует два реальных запуска, оборудование, длительность, хеши архивов и подписанные файлы измерений. Эти результаты относятся к указанным ревизиям и условиям, а не устанавливают универсальную скорость или предел ёмкости.
История и длительность тестирования#
По сообщению автора проекта на 6 ноября 2026 года тестирование продолжается более шести месяцев. Это история тестирования проекта. Датированные публичные замеры выше описывают отдельные запуски; они не подтверждают независимо проверенный непрерывный сбор в течение шести месяцев. Возраст сообщений в экспорте также отличается от времени работы сборщика.
Точно читать статус возможностей#
Оценивайте каждый сценарий по реализации, опубликованной сборке и результатам проверок. Текущий исходный код обозначен как preview. Этот статус версии сосуществует с работающим сбором, экспортами, независимой проверкой и опубликованными измерениями масштаба. В одном приложении могут быть новая предварительная функция и проверенный сценарий; называйте конкретную возможность и факты, на которых основана оценка.
Читайте вместе текущие возможности, функции и ограничения, проверки и историю изменений. При ссылке на результат указывайте проверенную ревизию. Снимок измерений от 6 ноября также сохраняет неудачные и пропущенные тесты; они не считаются успешными.
Документация для людей и ИИ#
Сайт предоставляет краткий llms.txt, полный английский справочник в
llms-full.txt и llms-full.md, а также Markdown-версии страниц. Это форматы
документации; для работы TgWitness ИИ не требуется.
Дополнительные MCP и командная строка позволяют авторизованным инструментам читать выбранные сохранённые записи. Текст сообщений остаётся недоверенным входом. Сводки должны ссылаться на источники, отделять наблюдаемые факты от предположений и сохранять неопределённость. Полнотекстовый поиск, OCR и вывод ИИ не изменяют исходные подписанные наблюдения.