TgWitness / Документация

Что проверено →

Справочник / Установка

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 и вывод ИИ не изменяют исходные подписанные наблюдения.