# Сообщения меняются. Сохраните то, что вы видели. Canonical page: https://phishdestroy.github.io/TgWitness/ru/ [Открытый исходный код / v0.7.0](https://phishdestroy.github.io/TgWitness/ru/docs/reference/changelog/) Фиксируйте сообщения Telegram, сохраняйте изменения и экспортируйте подписанный журнал. [Открыть демо-версию](https://phishdestroy.github.io/TgWitness/demo/?lang=ru)[Руководство по настройке](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=ru) В демонстрационной версии используются вымышленные данные. Вход в Telegram не требуется. [Выгрузка через GitHub Actions (предварительная версия)](https://phishdestroy.github.io/TgWitness/ru/docs/capture/) [Внесайтовая копия на S3: настройка и восстановление](https://phishdestroy.github.io/TgWitness/ru/#s3) СООБЩЕНИЕ, ПРЕОДОЛЕВАЮЩЕЕ ВРЕМЯ #0042 Northstar · ИсследованияВымышленный источник / сообщение 42 1. **Зафиксировано сообщение**09:41:02 Брифинг начинается с 14:00. 2. **Редактирование сохранено**09:43:18 Брифинг начинается с 15:00. Предыдущая версия сохранена 3. **Уведомление об удалении**10:06:45 Зафиксированный контент остается в вашем журнале. Три наблюдения. Одна история. ПРИМЕР Сообщение исчезает. Зафиксированная история сохраняется. ## Каждое зафиксированное изменение. Именно там, где вам это нужно. Посмотрите интерфейс на вымышленных данных. TgWitness / Сохраненные чатыВАШЕ РАБОЧЕЕ ПРОСТРАНСТВО ДЛЯ НАБЛЮДЕНИЙ ![Сохраненные переписки в Telegram в темной теме, с фиксированными изменениями и удалёнными сообщениями, представленными в контексте](https://phishdestroy.github.io/TgWitness/assets/chats-dark.png) 01 / Сохраненные чаты. Привычный вид диалога, в котором рядом с сообщениями отображаются зафиксированные изменения и уведомления об удалении. TgWitness / ЖурналЛОКАЛЬНОЕ РАБОЧЕЕ ПРОСТРАНСТВО ![Журнал с зафиксированными сообщениями, правками, уведомлениями об удалении и событиями, подпадающими под охват](https://phishdestroy.github.io/TgWitness/assets/workspace.png) 02 / Журнал — Хронология событий, зафиксированных вашим аккаунтом, с возможностью поиска, включая перерывы в работе. TgWitness / История измененийЛОКАЛЬНОЕ РАБОЧЕЕ ПРОСТРАНСТВО ![Вкладка с подробностями, в которой сравниваются зафиксированные предыдущая и отредактированная версии сообщения](https://phishdestroy.github.io/TgWitness/assets/detail.png) 03 / История изменений. Сравнение сохраненных версий без перезаписи более ранних записей. TgWitness / Подписанные экспортные файлыЛОКАЛЬНОЕ РАБОЧЕЕ ПРОСТРАНСТВО ![Функция экспорта рабочей области, позволяющая получить подписанные файлы в форматах ZIP, JSONL, CSV, а также автономный отчёт в формате HTML](https://phishdestroy.github.io/TgWitness/assets/exports.png) 04 / Подписанные экспортные файлы. Возьмите журнал с собой — с манифестом и независимым верификатором. 01 / ЗАПИСЬ ### Вы сами определяете сферу применения. Выбранные чаты, папка Telegram или весь аккаунт. Отдельное рабочее пространство для каждого аккаунта. [Сравните режимы сбора данных](https://phishdestroy.github.io/TgWitness/ru/guides/modes.html#scope) 02 / СОХРАНЕНИЕ ### Изменения дополняют общую картину. Наблюдённые версии, уведомления об удалении и разрывы наблюдения остаются в журнале. [См. матрицу событий](https://phishdestroy.github.io/TgWitness/ru/guides/modes.html#events) 03 / ПЕРЕДАЧА ### Запись, которая путешествует. Подписанный ZIP, сохранённые файлы и автономный отчёт. Защита паролем — по желанию. [Экспорт и проверка](https://phishdestroy.github.io/TgWitness/ru/docs/exports/) ## Измените один байт — цепочка сразу об этом сообщит. Каждое событие содержит ссылку на предыдущий хеш и подпись Ed25519. ![Зафиксированные события сопряжены с предыдущими хешами, снабжены подписями и передаются в виде поддающегося проверке экспорта.](https://phishdestroy.github.io/TgWitness/assets/evidence-chain-animated.svg) ![Изменение сохраненной записи приводит к изменению её хеша и делает невозможной проверку связанной с ней записи.](https://phishdestroy.github.io/TgWitness/assets/evidence-tamper-animated.svg) ![Отдельно сохраняемый контрольный пункт позволяет получателю сравнить экспортированный журнал с более ранними данными.](https://phishdestroy.github.io/TgWitness/assets/evidence-checkpoint-animated.svg) Ознакомьтесь с тем, что обеспечивает каждый механизм проверки и где пролегают его ограничения. [Ознакомьтесь с восемью уровнями доказательности](https://phishdestroy.github.io/TgWitness/ru/guides/modes.html#levels) ## Готов к дополнительной проверке. Предоставляйте данные наблюдений, файлы и автономный отчёт в формате HTML в одном подписанном пакете. [Ознакомьтесь с моделью доказательств](https://phishdestroy.github.io/TgWitness/ru/docs/reference/evidence/) tgwitness-evidence.zipПАКЕТ С ПОДПИСЯМИ - 01 Первоначальные наблюденияЗаписи в формате JSONL + таблица в формате CSV - 02 Удобный для чтения контекстОфлайн-отчёт в формате HTML + сохраненные мультимедийные файлы - 03 Независимая проверкаПодписанный манифест + автономный верификатор Подписи позволяют выявлять попытки подделки на основе доверенного ключа. Они не подтверждают происхождение сообщений из Telegram и не гарантируют полную запись данных. Содержимое журнала и мультимедийные файлы должны храниться в зашифрованном виде на предоставленном вами хранилище. ## Копии в S3. Внешние проверки. Сохраняйте зашифрованные копии и добавляйте независимые проверки. По умолчанию отключено ### Копирование в S3-совместимое хранилище Журнал, файлы, контрольные точки с отметками времени и экспортированные данные чатов — зашифровываются перед загрузкой в AWS S3 или совместимое хранилище. **Настройки хранения и восстановление** Шифрование перед загрузкой Объекты шифруются на этом компьютере с помощью `AES-256-GCM`. Провайдер получает зашифрованные объекты. Копирование по расписанию или вручную Запустите копирование сразу или задайте интервал от 1 до 1 440 минут. Ход копирования отображается в панели. Object Lock Если бакет поддерживает Object Lock, задайте срок хранения в днях и режим. Панель покажет, подтверждено ли удержание загруженного объекта. Восстановление с проверкой Скачайте ключ шифрования и храните его отдельно. Восстановить копию можно на другом компьютере; файлы появятся в целевом каталоге только после проверки. ![Полная панель настроек для внешнего хранения: конечная точка, регион, хранилище, ключи доступа, расписание, управление функцией Object Lock и ключом восстановления](https://phishdestroy.github.io/TgWitness/assets/off-site-copy.png) Вся форма с раскрытыми дополнительными настройками. Учётные данные хранилища не указаны. Журнал и СМИ`AES-256-GCM`Хранилище, совместимое с S3 [Настройте S3 и восстановите копию](https://phishdestroy.github.io/TgWitness/ru/docs/exports/#s3)[Ознакомьтесь с подробностями проверки:](https://phishdestroy.github.io/TgWitness/ru/docs/reference/evidence/#off-site-copy-and-restore-s3) **Чего не делает** восстановление данных без экспортированного ключа дешифрования и не заменяет независимого свидетеля. ### Уведомления · Apprise Уведомления о проблемах, изменениях в чатах и ежедневные сводки через Apprise: мессенджеры, электронную почту или ваш собственный веб-хук JSON. **Чего не делает** Не отправляет текст сообщений, пока вы не включите короткие выдержки. [Настроить получателей уведомлений](https://phishdestroy.github.io/TgWitness/ru/docs/reference/operations/#notifications) ### Внешние временные метки Метки времени RFC 3161 и OpenTimestamps для хешей контрольных точек. **Чего не делает** рассматривает ожидающее подтверждения календарное подтверждение как подтверждённую временную метку Bitcoin. [Проверьте доказательства с временными метками:](https://phishdestroy.github.io/TgWitness/ru/docs/reference/timestamp/) ### Независимый свидетель Отдельный сервер хранит подписанные наблюдения и может публиковать контрольные точки `TGW1`. **Чего не делает**: не превращает две рабочие среды на одном хосте-коллекторе в независимые источники доказательств. [Настройте Witness](https://phishdestroy.github.io/TgWitness/ru/docs/witness/) ### Восстановление данных и заметные пробелы Продолжение после перезапуска. Перепроверки и `coverage.json` показывают восстановленные сообщения и разрывы. **Чего не делает**: не восстанавливает каждое пропущенное изменение или исчезнувшее сообщение. [Проверьте непрерывность и наличие пробелов](https://phishdestroy.github.io/TgWitness/ru/guides/modes.html#continuity) ## Ваша первая рабочая среда начинается здесь. Сначала ознакомьтесь с демо-версией. Когда будете готовы, подключите выделенную учетную запись. Windows, Linux, macOS или Docker. [Ознакомьтесь с руководством по настройке](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=ru) **Один импортированный сеанс — один запущенный клиент.** Не запускайте импортированный ключ TData/сессии одновременно в Telegram Desktop и TgWitness. Telegram может аннулировать общую авторизацию (AUTH_KEY_DUPLICATED). Для параллельного использования создайте отдельный вход в TgWitness с помощью телефона или QR-кода. [Ознакомьтесь с предупреждением об импорте сеанса](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=ru#session-warning) **Ознакомьтесь с информацией, прежде чем подключаться.** Откройте рабочее пространство с вымышленными данными без аккаунта Telegram. [Открыть онлайн-демо →](https://phishdestroy.github.io/TgWitness/demo/?lang=ru) Windows `scripts\Demo.cmd`Linux / macOS `sh start.sh --demo` **Команды для локальной установки** ШАГ 01 ### Получить исходный код. [Скачайте ZIP-архив с исходным кодом](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) и распакуйте его или клонируйте репозиторий: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` Для запуска исходного кода требуется Python версии 3.11 или выше. Программа запуска для Windows предлагает установить Python, если он отсутствует. [Просмотреть версии](https://github.com/phishdestroy/TgWitness/releases) Нет Python на Windows? [Загрузите портативный пакет](https://github.com/phishdestroy/TgWitness/releases/download/v0.7.0/TgWitness-0.7.0-windows-amd64-portable.zip), распакуйте его и дважды щелкните по файлу «`TgWitness.cmd`». ШАГ 02 ### Выберите способ запуска. Дважды щелкните по файлу `Start.cmd` или запустите его в PowerShell: ``` .\Start.cmd ``` Просто знакомитесь с проектом? Дважды щелкните по ссылке `scripts\Demo.cmd`, чтобы перейти к автономной демо-версии. Вход в Telegram не требуется. При наличии Python 3.11+ и библиотеки `venv`: ``` sh start.sh ``` Чтобы вместо этого открыть вымышленный журнал, выполните команду `sh start.sh --demo`. При запущенном Docker и установленном Compose версии 2.20 или выше: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` Вторая команда отображает токен вашей личной панели. Сохраните его на своём компьютере. После запуска откройте [127.0.0.1:8787](http://127.0.0.1:8787). При установке из исходного кода токен находится в `data/live/panel-token.txt`. Для входа в Telegram можно использовать встроенные настройки API или собственную пару ключей с [сайта my.telegram.org](https://my.telegram.org). [Полное руководство по настройке ↗](https://phishdestroy.github.io/TgWitness/ru/docs/reference/quickstart/) **TgWitness 0.7.0** [Что нового →](https://phishdestroy.github.io/TgWitness/ru/docs/reference/changelog/) · [Возможности и известные ограничения →](https://phishdestroy.github.io/TgWitness/ru/docs/reference/features/) ## Четкие инструкции. Полезный следующий шаг. [Ознакомьтесь с руководствами ↗](https://phishdestroy.github.io/TgWitness/ru/docs/) [### Режимы, сценарии и уровни доказательности Четыре режима сбора данных. Восемь уровней проверки. Выберите рабочий процесс, подходящий для вашего дела.](https://phishdestroy.github.io/TgWitness/ru/guides/modes.html) [01 ### Подключить аккаунт Импорт данных с мобильных телефонов, QR-кодов и поддерживаемых сеансов.](https://phishdestroy.github.io/TgWitness/ru/docs/accounts/)[02 ### Выберите прокси-сервер Публичные списки MTProxy или ваш собственный маршрут.](https://phishdestroy.github.io/TgWitness/ru/docs/proxies/)[03 ### Настройте бота-свидетеля Подписанные контрольные точки в вашем канале Telegram.](https://phishdestroy.github.io/TgWitness/ru/docs/witness/)[04 ### Экспорт и проверка Поделитесь сохраненной историей и проверьте её целостность.](https://phishdestroy.github.io/TgWitness/ru/docs/exports/) ## Работайте с архивом. Загрузка истории, просмотр источников ИИ, подключение клиента MCP, распознавание сохраненных медиафайлов и отправка подписанных веб-хуков. Доступно из текущего исходного кода. Портативная предварительная версия 0.7.0 была выпущена до появления этих инструментов. [Ознакомьтесь с рабочим процессом](https://phishdestroy.github.io/TgWitness/ru/docs/archive/) ## Прежде чем начать. **Связана ли эта страница с Telegram?** Нет. Это статичная страница проекта с вымышленными примерами и скриншотами. Фактическое приложение работает на вашем компьютере или сервере; вход в систему осуществляется именно там. **Может ли он восстанавливать сообщения, удалённые до момента их фиксации?** Нет. TgWitness сохраняет контент, который был доступен в вашем аккаунте на момент проведения сбора данных. Более поздний снимок истории не позволяет восстановить пропущенные изменения или удалённые сообщения. **Зашифрован ли весь мой журнал?** Учетные данные и секретные ключи для подписи хранятся в зашифрованном хранилище. Для локальных сообщений и вложений требуется зашифрованный диск или том. При экспорте данных можно по желанию использовать ZIP-архив с шифрованием AES-256, защищённый паролем. **Имеет ли этот проект какое-либо отношение к Telegram?** Нет. TgWitness — это независимый проект, использующий Telethon, распространяемый по лицензии MIT. Вы авторизуете свои собственные учётные записи, используя встроенные настройки API или свою собственную пару API. PROJECT NOTICE / LICENCE ## Operator incompatibility. **Taylor Wessing PartG mbB — German core, Hamburg office.** Our statement as the authors of TgWitness. It adds no condition to the MIT License. Read the complete notice and its source record. [Read the complete notice](https://phishdestroy.github.io/TgWitness/docs/reference/notice/) [Original text](https://phishdestroy.github.io/TgWitness/NOTICE) ## Сначала ознакомьтесь с информацией. Настройте систему, когда будете готовы. [Открыть демо-версию](https://phishdestroy.github.io/TgWitness/demo/?lang=ru)[Руководство по настройке](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=ru)