# Экспорт аккаунта Telegram в подписанный архив

Canonical page: https://phishdestroy.github.io/TgWitness/ru/docs/reference/account-export/

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

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

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

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документация](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Доказательства и верификация](https://phishdestroy.github.io/TgWitness/ru/docs/reference/evidence/)

![Доказательства и верификация](https://phishdestroy.github.io/TgWitness/assets/chapter-evidence.svg)

Экспорт аккаунта резервирует его исключительно для своей задачи. Перед запуском или возобновлением явно приостановите мониторинг или другой сбор данных: приложение никогда не останавливает их автоматически.

Как администратор установки выберите **«Начать здесь» → «Экспортировать мою учётную запись**» или **«Экспорт» → «Учётная запись Telegram» → «Настроить экспорт учётной записи**». При необходимости войдите в систему, проверьте объем данных и явно запустите экспорт. Непрерывное наблюдение не требуется. **«Сохраненные наблюдения»** — это отдельный экспорт существующего журнала; его ZIP включает все источники, независимо от фильтров журнала. Каждая рабочая область имеет свои собственные задания, идентификатор подписи и хранилище. Предоставленный доступ к панели, включая неограниченное право на обычный экспорт, не позволяет открывать эти маршруты, относящиеся ко всей учетной записи.

Фильтры по отправителю и тексту раскрываются в разделе **«Фильтр по отправителю или тексту сообщения**». **Раздел «Данные аккаунта и способ подключения**» содержит дополнительные категории аккаунтов и выбор между Takeout и обычной сессией; в его сводке отображаются активные настройки даже в закрытом состоянии. При закрытии этих разделов их настройки сохраняются. Черновики экспорта и отчетов остаются в текущей сессии панели при смене представлений; они не сохраняются при перезагрузке браузера. Доступ к существующим заданиям сохраняется при выборе любого из вариантов экспорта.

Этот рабочий процесс экспортирует данные, доступные в данный момент для подключённой учётной записи. По умолчанию используется [Telegram Takeout](https://core.telegram.org/api/takeout); это не является резервной копией недоступных или удалённых данных Telegram. Секретные чаты, недоступная история и более ранние правки не восстанавливаются. Telegram может установить период ожидания перед запуском Takeout. Панель отображает это ожидание; она не переключает транспортный протокол незаметно. Явная опция regular-API имеет другой охват и записывает неподдерживаемые категории.

Takeout — это официальный API экспорта, который также используется Telegram Desktop. TgWitness может записывать JSON, совместимый с Desktop, напрямую из собственного набора данных; импорт чужого архива не требуется. Идентификаторы чатов и сообщений доступны через оба канала передачи данных. Публичный чат или разрешение на пересылку не гарантируют более быстрый экспорт и не устраняют задержку одобрения со стороны Takeout. Перед сравнением скорости убедитесь, что объем данных и настройки мультимедиа одинаковы.

Для до 20 явно выбранных идентификаторов чатов экспорт через стандартный API определяет этих участников непосредственно перед рассмотрением полного списка диалогов учетной записи. Таким образом, читаемый открытый канал можно экспортировать, не присоединяясь к нему, даже если он отсутствует в списке диалогов. Для некешированных участников используется обычный список диалогов. Фильтр архива по-прежнему применяется: если Telegram не возвращает диалог, а заархивированные чаты исключены, неизвестный статус архива фиксируется как пропуск. Takeout сохраняет свою процедуру разделения диалогов по диапазонам. Ни один из способов не присоединяет пользователя к чатам и не изменяет разрешения на пересылку. В формате JSON, совместимом с Desktop, каналы, которые Telegram помечает как `left`, отображаются под `left_chats`, включая общедоступные каналы с правом чтения, к которым аккаунт не присоединился.

Как запросы `FLOOD_WAIT`, так и `FLOOD_PREMIUM_WAIT` приостанавливают работу на весь период, запрошенный сервером. Срок действия учетной записи сохраняется при повторных подключениях и перезапусках; более короткое последующее ожидание не может сократить его. Количество повторных попыток ограничено, отмена сохраняет запечатанные страницы, а учетные данные API не меняются для обхода ограничения по частоте запросов. Покупка Premium не производится.

## Выберите, что собирать

| Настройки | Значение |
| --- | --- |
| Цель | Опишите, почему необходимо данное приобретение. Не указывайте здесь ненужные имена или конфиденциальные детали дела. |
| Язык отчёта | Выберите язык меток в отчёте для чтения. Текст исходного сообщения остаётся неизменным; непереведённые метки шаблона используют английский язык. Язык фиксируется с помощью параметров подписанного задания. |
| Типы чатов / идентификаторы чатов | Все выбранные типы или только перечисленные чаты; «Сохраненные сообщения» относятся к личным чатам. Архивированные чаты можно выбирать отдельно. |
| Даты | UTC. В панели указаны даты «С» и «По» по календарю, включая оба дня. API использует включительные `from_utc` и исключительные `to_utc`; панель отправляет начало дня, следующего за датой «До». Пустой предел оставляет эту сторону неограниченной. |
| Идентификаторы отправителей | Только сообщения от указанных отправителей; пустой список включает всех отправителей. |
| Текст содержит | Литеральные фразы, нечувствительные к регистру, сопоставляются с помощью оператора OR. Условия «отправитель/дата/собственное сообщение» комбинируются с помощью оператора AND. |
| Собственные сообщения | Сохраняйте только исходящие сообщения. |
| Типы медиафайлов | Выберите категории вложений или сбросьте все, чтобы избежать загрузки файлов из сообщений. |
| Ограничения на файлы / общее количество медиафайлов | Объём в MiB для каждого файла и общий объём загруженных медиафайлов в GiB. Текст, квитанции, читаемые отчёты и накладные расходы, связанные с ZIP, требуют дополнительного дискового пространства. |
| Категории аккаунтов | Для профиля, контактов, фотографий профиля, историй, метаданных сеансов и других данных Takeout предусмотрены отдельные элементы управления. |

Предустановка **«Minimize»** отключает файлы и метаданные аккаунтов. Фильтры отправителей и контента применяются до сохранения страниц сообщений и загрузки медиафайлов. Telegram по-прежнему передаёт страницы истории API, содержащие сообщения, необходимые для оценки этих фильтров: фильтрация не гарантирует, что неотборные сообщения никогда не поступят в оперативную память. Другие текущие наблюдения в рабочей области имеют собственные настройки области действия и срока хранения.

История фотографий профиля и истории по умолчанию не выбираются. Отключите также профиль и контакты, если для дела требуются только сообщения. Если вложения или метаданные не нужны, их исключение при сборе данных позволит избежать сохранения ещё одной частной копии в этом экспорте.

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

## Отчёт, охват и проверка

Каждое задание фиксирует свои настройки и идентификатор аккаунта. Инвентарь и захваченные страницы подписываются; в квитанциях страниц фиксируются хеши, курсоры, время, результаты работы с вложениями и предшествующие квитанции. Только зафиксированные страницы учитываются при подсчете прогресса. При перезапуске или возобновлении задания эти записи проверяются перед продолжением работы. Измененный аккаунт, измененная подписанная страница или несогласованная цепочка квитанций отклоняются. Настройки нельзя редактировать в середине процесса сбора данных: для другого объема данных запустите новое задание.

Команда «Pause» приостанавливает текущую операцию с аккаунтом. При перезапуске приложения незавершённая работа остаётся доступной для явного возобновления. Сессия Takeout, срок действия которой истек, требует явного возобновления; изменение диапазонов фрагментов Telegram может потребовать нового сбора данных. При возобновлении сохраняются предыдущие наблюдения, поэтому длительный экспорт не представляет собой единый атомарный снимок. Другие операции по смене аккаунта и конфликтующие экспорты блокируются во время сбора данных. Перед удалением рабочего пространства дождитесь завершения упаковки.

Функция «Возобновить» проверяет уже записанный контент перед продолжением. Объемные архивы на медленном хранилище могут превысить настроенное **в разделе «Параметры» → «Таймаут действия панели»** значение (по умолчанию — 120 секунд). Увеличьте это значение перед повторной попыткой; отмена или прерывание работы хранилища приводит к приостановке задания, а неудачные проверки целостности — к сбою задания с пояснением причины. Проверка должна завершиться или безопасно остановиться, прежде чем файлы можно будет закрыть. Заявления о пропускной способности для крупных аккаунтов не подтверждены синтетическими тестами.

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

Готовые ZIP остаются доступными для повторной загрузки и загрузки по HTTP-диапазону. Архив аккаунта содержит `manifest.json`, `manifest.sig`, подписанные `job.json`, `inventory.json`, `receipts/`, авторитетные `data/*.jsonl`, выделенным `media/`, читаемый HTML и верификатор. Закрепите отпечаток коллектора через независимый канал, а затем проверьте с помощью доверенной установки:

```
python -m tgwitness.verify account-export.zip --fingerprint TRUSTED_SHA256
```

Для архивов, расширенный объём которых превышает 4 ГиБ, необходимо явно задать соответствующий `--max-gib`. Панель проверяет свои аутентифицированные, завершенные локальные архивы, используя их заявленный размер в развернутом виде и опубликованный дайджест ZIP; внешний CLI сохраняет свой независимый лимит размера. Проверьте перед открытием читаемого HTML. Встроенный в архив верификатор удобен, но верификатор, полученный независимо, позволяет избежать доверия к исполняемому коду, поставляемому вместе с доказательством.

Подпись Ed25519 и хэши SHA-256 позволяют обнаруживать изменения после того, как сборщик зафиксировал соответствующие байты. Они **не** доказывают, что Telegram подписал эти сообщения, что оператор сборщика действовал добросовестно, что история аккаунта полна или что суд примет эти материалы. Время записи определяется по часам сборщика. Независимые временные метки и независимое происхождение данных должны оцениваться отдельно.

## Подготовьте раскрытие информации для юриста или другого получателя

После загрузки готового экспорта сохраните исходный файл ZIP и откройте `index.html` из извлечённой копии. В отчёте объясняются его объем, доступный охват и ограничения. Ссылки на записи в отчёте объединяют ссылку на архив, путь к документу и номер записи, чтобы получатель мог найти ту же запись в HTML-файле или на распечатке. Пример с решением см. по ссылке [открыть вымышленный отчёт](https://phishdestroy.github.io/TgWitness/demo/report/).

После завершения экспорта аккаунта выберите **«Подготовить копию для обмена**». Это создаст отдельный подписанный производный файл. Исходный файл ZIP остаётся неизменённым и конфиденциальным; не отправляйте его вместе с минимизированным производным файлом, если получатель не уполномочен получать его полное содержимое. Выберите язык отчёта отдельно. Изменение языка или любых настроек выбора требует повторного предварительного просмотра перед созданием.

1. Укажите цель раскрытия информации и выберите даты, идентификаторы отправителей и критерии по тексту.
2. Выберите, сохранять ли идентификационные данные, раскрывать только указанных участников или использовать псевдонимы для всех. В любом режиме с использованием псевдонимов также заменяются идентификаторы/названия чатов и идентификаторы сообщений. Псевдонимы остаются неизменными в пределах одного раскрытия информации и меняются между независимо подготовленными раскрытиями.
3. Можно сохранить текст сообщения, полностью его опустить или добавить конкретные имена/фразы для маскировки. В приватных режимах инструмент также маскирует известные скрытые имена отправителей и альтернативные имена пользователей, идентификаторы отправителей в виде целых токенов, имена в прямых чатах, ссылки, адреса электронной почты и строки, похожие на номера телефонов. Сопоставление по известным именам учитывает преобразование регистра символов в Unicode, включая `Straße`/`STRASSE`. Общие названия групп/каналов не удаляются автоматически из текста сообщения. Если превышен лимит маскировки известных идентификаторов, сузьте исходный экспорт или опустите текст; инструмент не будет молча пропускать последующие имена. Это правила, действующие в рамках разумных возможностей, а не общая анонимизация.
4. Не включайте файлы, если они не нужны получателю. Включенные исходные файлы сохраняют свои пиксели, аудио, текст и метаданные. Инструмент **не** анонимизирует их.
5. Просмотрите предварительный просмотр с подсчётом, предупреждениями и образцами преобразованных сообщений, а затем явно подтвердите создание. Образцы ограничены 12 сообщениями и 2 000 текстовых символов в каждом. Это пример, а не полный обзор результата. Изменение настроек требует повторного предварительного просмотра. Срок действия предварительного просмотра истекает через 15 минут и привязан к данной сессии администратора и точному исходному ZIP; его нельзя повторно использовать после создания. Новый предварительный просмотр аннулирует предыдущий для той же задачи и сессии.
6. Ознакомьтесь с полным результатом `index.html` и `messages.jsonl` локально перед передачей. Если в нём обнаружится ненужная информация, создайте новое раскрытие с более строгими исключениями. Не редактируйте подписанный ZIP на месте.

### Сообщения, не включённые в выборку

**Предварительный просмотр.** Раскрытие информации не выглядит полным, если оно таковым не является. Внутри каждого чата, в котором сохранено хотя бы одно раскрытое сообщение, сообщения, не вошедшие в выделенный фрагмент, отображаются в виде маркеров, `[withheld by selection — rule: sender]` (или `text`, `period`). Выберите **«Сообщения, не включённые в выделение**»: по одному маркеру для каждой серии последовательных нераскрытых сообщений (по умолчанию) или по одному для каждого сообщения. Маркеры содержат только правило и счётчик, но никогда не содержат текст, отправителя, дату или файлы. Чаты, в которых нет раскрытых сообщений, полностью исключаются, поэтому пакет не показывает их существование.

Раскрытые ответы указывают, на что они отвечают: на сообщение, включённое в эту копию, на сообщение, исключённое при отборе, или на сообщение, которого нет в исходном экспорте (удалённое до экспорта или никогда не экспортированное; экспорт не может определить, что именно). Удержанное сообщение, на которое отвечает раскрытый ответ, всегда получает собственный маркер, поэтому ответ указывает на запись, объясняющую, почему оно пустое. Эти три состояния отличаются от удалений и пробелов в наборе данных, которые относятся к исходному экспорту.

В `messages.jsonl` (формат `tgwitness-account-disclosure-v2`) каждое сообщение имеет `state`: `disclosed`, либо `withheld` с `rules` и `count`. Открытый ответ содержит `reply_to` с целью `id` и `state` (`disclosed`, `withheld`, `not_in_source`). Манифест учитывает раскрытые сообщения, чаты, мультимедиа и `withheld` сообщения. `verify.py` Отклоняет маркер, несущий содержимое, и ответ, указывающий на запись, отсутствующую в пакете; пакеты версии 1 проверяются как и ранее.

В сокращённом формате не отображаются структурированные профили аккаунтов, контакты, аватары, сеансы, истории, исходные объекты Telegram, заголовки пересылок, цитаты из ответов, карточки контактов и метаданные о местоположении. Из него исключены исходные файлы JSONL, настройки частных фильтров, ключ псевдонима и карта идентичностей. Выделенный текст, явно сохраненные идентичности и включённые файлы могут по-прежнему содержать те же имена, идентификаторы или фразы, что и в этих фильтрах; они требуют отдельной проверки. Политика конфиденциальности и ключ псевдонима хранятся в зашифрованном виде в локальном хранилище для данного задания; удаление задания приводит к очистке связанных с ним записей о раскрытии конфиденциальной информации. Записи публичной политики фильтруют количество, а не значения фильтров. Заявленная цель указывается публично в манифесте и HTML: явные критерии конфиденциальности, а в режимах псевдонимизации — известные скрытые идентичности также маскируются там, в том числе когда текст сообщения опущен. Не включайте в цель ненужные личные данные; неизвестный идентифицирующий контекст может оставаться.

Его манифест связывает производные файлы, публичную политику и хэш исходного ZIP. Проверка позволяет установить целостность и, если исходный файл предоставлен локально, подтвердить соответствие исходной ссылки:

```
python -m tgwitness.verify minimized-disclosure.zip --fingerprint TRUSTED_SHA256
python -m tgwitness.verify minimized-disclosure.zip --fingerprint TRUSTED_SHA256 --evidence account-export.zip
```

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

## Передача копии и облачный сбор

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

GitHub Actions поддерживает экспорт данных всей учётной записи и выбранных чатов через Takeout или стандартный API, а также журнал событий одного чата. Руководство по хостируемому сбору данных  объясняет проверку настроек и ограничение по длительности 120 минут. Чтобы проверить копию для обмена, полученную из хостируемого сбора данных, сравните хэш источника с исходным архивом и проверьте аттестацию этого архива с помощью проверок [, специфичных для режима](https://phishdestroy.github.io/TgWitness/ru/docs/reference/evidence/#verification-scope).

[Формат доказательств](https://phishdestroy.github.io/TgWitness/ru/docs/reference/evidence/) · [Отчёты по делам](https://phishdestroy.github.io/TgWitness/ru/docs/reference/case-reports/)
