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

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

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

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

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

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

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

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

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

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

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

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

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

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

Эти проверки помогают оценить целостность и происхождение. Они не превращают содержимое сообщения в истинное утверждение и не восстанавливают удалённые сообщения, которые никто не успел сохранить. Используйте независимо полученный отпечаток ключа и шаги из [руководства по доверию](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) и [описания формата доказательств](https://phishdestroy.github.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 мс | Локальный тест поиска, не доставки из Telegram |
| 6 ноября 2026 | Два новых экспорта из настоящего Telegram | 27 030 и 29 299 сообщений; всего 56 329 за два запуска | По два аккаунта через WARP, текст и метаданные, без загрузки вложений |
| 6 ноября 2026 | Те же два экспорта с подготовкой и упаковкой | 127,713 и 141,781 сообщения в секунду | Полная скорость экспорта; оба архива проверены по заранее закреплённым ключам |

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

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

По сообщению автора проекта на 6 ноября 2026 года тестирование продолжается более шести месяцев. Это история тестирования проекта. Датированные публичные замеры выше описывают отдельные запуски; они не подтверждают независимо проверенный непрерывный сбор в течение шести месяцев. Возраст сообщений в экспорте также отличается от времени работы сборщика.

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

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

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

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

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

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