# TgWitness: экспорт Telegram, OSINT и проверка данных

Canonical page: https://phishdestroy.io/tgwitness/ru/docs/reference/overview/

Установка одной командой или сбор через GitHub Actions. Сценарии расследования, опубликованный масштаб и смысл проверки архива.

[Project context and measured scale](https://phishdestroy.io/tgwitness/ru/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ru/llms.txt)

Установка одной командой или сбор через 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 и выберите область сбора. Сама установка сбор не запускает. [Руководство по установке](https://phishdestroy.io/tgwitness/ru/docs/reference/installation/) объясняет локальный доступ, серверы, обновления и проверку загруженной сборки.

Для временного исполнителя используйте [сбор через GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Нужны форк на GitHub, авторизация и пароль архива. Страница сбора объясняет эти шаги и ограничение времени сессии до запуска. Скачайте и сохраните полученный архив вместе с материалами для проверки.

## Дополнительные настройки по мере необходимости

Для экспорта одного чата нужны аккаунт и выбранная область. Длительное наблюдение, несколько аккаунтов, прокси, правила загрузки вложений, оформление отчётов, доступ рецензентов, внешние метки времени и резервное хранение служат разным задачам расследования и передачи материалов. Настраивайте их, когда они нужны.

Область применения, разрешения и копии с минимальным доступом помогают операторам выбирать, что собирать и раскрывать. Рекомендации по юрисдикции и настройки отчетов фиксируют выбранную процедуру и этапы подготовки. См. [экспорт учетной записи](https://phishdestroy.io/tgwitness/ru/docs/reference/account-export/), [доступ](https://phishdestroy.io/tgwitness/ru/docs/reference/access/) и [настройку отчетов](https://phishdestroy.io/tgwitness/ru/docs/reference/case-reports/).

Приложение работает на выбранном компьютере или сервере. Для базового сбора данных не требуется графический процессор (GPU) или модель большого языка (LLM). Дополнительные функции OCR, транскрипции и анализа с помощью ИИ имеют свои собственные требования к ресурсам. Подберите размер развертывания с учётом скорости поступления сообщений, вложений, сохраняемой истории и количества одновременно работающих учётных записей.

## Сохранять материал независимо от того, кому он выгоден

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

Логика работы: наблюдение доступных аккаунту данных → подписанный журнал → экспорт → проверка получателем. Правки добавляют версии. Наблюдения об удалении сохраняют ранее полученное содержимое. Записи покрытия показывают известные перерывы. Отчёты и ИИ-анализ ссылаются на сохранённые источники; интерпретация не становится исходным наблюдением только потому, что включена в подписанный отчёт.

| Проверка | Что может установить получатель |
| --- | --- |
| Хеши файлов, подписи и цепочка журнала | Переданные записи и файлы согласуются с ожидаемым ключом и границей журнала |
| Отдельно сохранённая контрольная точка или свидетель | Архив согласуется с ранее сохранённым состоянием журнала |
| Проверенная внешняя метка времени | Указанные байты существовали к этому времени при заявленных предпосылках доверия |
| Аттестация сбора на GitHub | Архив соответствует одобренному рабочему процессу, ревизии сборщика и записанному хешу |
| Аттестация Intel TDX | Цитата, состояние платформы, ожидаемые показатели ОС/приложения, актуальность и идентификатор сборщика проходят настроенные проверки |

При аттестованном сборе данных аутентифицированное соединение с Telegram утвержденного сборщика и его вывод привязаны к проверенной среде выполнения. Архив сохраняет захваченное содержимое и контекст; отчеты и анализ ссылаются на эти записи. Используйте этапы проверки, специфичные для конкретного режима, и доверенные входные данные, указанные в [руководстве по доверию](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) и [формате доказательств](https://phishdestroy.io/tgwitness/ru/docs/reference/evidence/).

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

Ниже приведены результаты разных нагрузок и дат. Счётчики не взаимозаменяемы: событие журнала не обязательно является уникальным сообщением Telegram.

| Дата | Нагрузка | Опубликованный результат | Что измерялось |
| --- | --- | --- | --- |
| 1 ноября 2026 | Работающий сервер, десять баз рабочих пространств | 1 610 818 записей журнала; 900 232 события новых сообщений, 80 683 правки и 400 536 событий удаления | Инвентарь сохраненных журналов, доступный только для чтения |
| 5 ноября 2026 | Поиск по 1 000 000 синтетических сообщений в 200 чатах | Индекс построен за 71 секунду; медианное время отдельных поисковых запросов — 9–190 мс | Тест производительности локального поиска |
| 6 ноября 2026 | Два новых экспорта из настоящего Telegram | 27 030 и 29 299 сообщений; всего 56 329 за два запуска | По два аккаунта через WARP, текст и метаданные, без загрузки вложений |
| 6 ноября 2026 | Те же два экспорта с подготовкой и упаковкой | 127,713 и 141,781 сообщения в секунду | Полная скорость экспорта; оба архива проверены по заранее закреплённым ключам |

[Запись верификации](https://phishdestroy.io/tgwitness/ru/docs/reference/verification/) содержит информацию об инвентаре сервера, проверках сбора данных в режиме реального времени и измерениях поиска. [Отчет о производительности](https://phishdestroy.io/tgwitness/docs/validation/) публикует данные о двух реальных запусках, аппаратном обеспечении, продолжительности, хешах архива и подписанных файлах измерений, каждый из которых сопровождается зафиксированной версией и условиями.

[Квалификационная проверка публичной истории](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) также фиксирует **48 проверенных архивов с 3,598,381 записями** из списка входных данных, включающего 50 источников, и 40 рабочих пространств учетных записей. Источник A с восемью учетными записями получил **768,007 записей истории за 1,117.082 секунд**, включая время ожидания: **687.512 записей в секунду**, при отключенной загрузке вложений. Полная попытка, включая валидацию, заняла 1,574.920 секунд. Эти измерения описывают данную рабочую нагрузку наряду с приведенными выше примерами меньшего объема свежего экспорта.

### История и длительность тестирования

Разработка и тестирование TgWitness продолжались около шести месяцев. Сначала были созданы сборщик, подписанный журнал и верификатор; веб-панель и дополнительные модули были построены на их основе позднее. Данный репозиторий был создан 29 октября 2026 года с целью публикации и содержал исходный код, существовавший на тот момент, поэтому его возраст не соответствует возрасту проекта ([истории разработки](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)). Общий объём проведённых тестовых нагрузок составляет порядка 100 миллионов, включая предыдущие запуски, сбои, исправления и повторные проверки. Отдельные запуски, каждый со своей ревизией, методом и результатом, задокументированы в [датированных публичных отчётах об измерениях](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements).

## Точно читать статус возможностей

Оценивайте каждый сценарий по реализации, опубликованной сборке и результатам проверок. Текущий исходный код обозначен как preview. Этот статус версии сосуществует с работающим сбором, экспортами, независимой проверкой и опубликованными измерениями масштаба. В одном приложении могут быть новая предварительная функция и проверенный сценарий; называйте конкретную возможность и факты, на которых основана оценка.

Читайте вместе [текущие возможности](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [функции и ограничения](https://phishdestroy.io/tgwitness/ru/docs/reference/features/), [проверки](https://phishdestroy.io/tgwitness/ru/docs/reference/verification/) и [историю изменений](https://phishdestroy.io/tgwitness/ru/docs/reference/changelog/). При ссылке на результат указывайте проверенную ревизию. Снимок измерений от 6 ноября также сохраняет неудачные и пропущенные тесты; они не считаются успешными.

## Документация для людей и ИИ

Сайт предоставляет краткий `llms.txt`, полный английский справочник в `llms-full.txt` и `llms-full.md`, а также Markdown-версии страниц. Это форматы документации; для работы TgWitness ИИ не требуется.

Дополнительные [MCP](https://phishdestroy.io/tgwitness/ru/docs/reference/mcp/) и [командная строка](https://phishdestroy.io/tgwitness/ru/docs/reference/cli/) позволяют авторизованным инструментам читать выбранные сохранённые записи. Текст сообщений остаётся недоверенным входом. Сводки должны ссылаться на источники, отделять наблюдаемые факты от предположений и сохранять неопределённость. Полнотекстовый поиск, OCR и вывод ИИ не изменяют исходные подписанные наблюдения.
