Открытый исходный код / v0.7.0

Сообщения меняются. Сохраните то, что вы видели.

Фиксируйте сообщения Telegram, сохраняйте изменения и экспортируйте подписанный журнал.

В демонстрационной версии используются вымышленные данные. Вход в Telegram не требуется.

Выгрузка через GitHub Actions (предварительная версия) Внесайтовая копия на S3: настройка и восстановление
СООБЩЕНИЕ, ПРЕОДОЛЕВАЮЩЕЕ ВРЕМЯ #0042
Northstar · ИсследованияВымышленный источник / сообщение 42
  1. Зафиксировано сообщение

    Брифинг начинается с 14:00.

  2. Редактирование сохранено

    Брифинг начинается с 15:00.

    Предыдущая версия сохранена
  3. Уведомление об удалении

    Зафиксированный контент остается в вашем журнале.

Сообщение исчезает. Зафиксированная история сохраняется.

01: РАБОЧЕЕ ПРОСТРАНСТВО

Каждое зафиксированное изменение. Именно там, где вам это нужно.

Посмотрите интерфейс на вымышленных данных.

TgWitness / Сохраненные чатыВАШЕ РАБОЧЕЕ ПРОСТРАНСТВО ДЛЯ НАБЛЮДЕНИЙ
Сохраненные переписки в Telegram в темной теме, с фиксированными изменениями и удалёнными сообщениями, представленными в контексте
01 / Сохраненные чаты. Привычный вид диалога, в котором рядом с сообщениями отображаются зафиксированные изменения и уведомления об удалении.
TgWitness / ЖурналЛОКАЛЬНОЕ РАБОЧЕЕ ПРОСТРАНСТВО
Журнал с зафиксированными сообщениями, правками, уведомлениями об удалении и событиями, подпадающими под охват
02 / Журнал — Хронология событий, зафиксированных вашим аккаунтом, с возможностью поиска, включая перерывы в работе.
TgWitness / История измененийЛОКАЛЬНОЕ РАБОЧЕЕ ПРОСТРАНСТВО
Вкладка с подробностями, в которой сравниваются зафиксированные предыдущая и отредактированная версии сообщения
03 / История изменений. Сравнение сохраненных версий без перезаписи более ранних записей.
TgWitness / Подписанные экспортные файлыЛОКАЛЬНОЕ РАБОЧЕЕ ПРОСТРАНСТВО
Функция экспорта рабочей области, позволяющая получить подписанные файлы в форматах ZIP, JSONL, CSV, а также автономный отчёт в формате HTML
04 / Подписанные экспортные файлы. Возьмите журнал с собой — с манифестом и независимым верификатором.
01 / ЗАПИСЬ

Вы сами определяете сферу применения.

Выбранные чаты, папка Telegram или весь аккаунт. Отдельное рабочее пространство для каждого аккаунта.

Сравните режимы сбора данных
02 / СОХРАНЕНИЕ

Изменения дополняют общую картину.

Наблюдённые версии, уведомления об удалении и разрывы наблюдения остаются в журнале.

См. матрицу событий
03 / ПЕРЕДАЧА

Запись, которая путешествует.

Подписанный ZIP, сохранённые файлы и автономный отчёт. Защита паролем — по желанию.

Экспорт и проверка

КАК СФОРМИРОВЫВАЕТСЯ ЗАПИСЬ

Измените один байт — цепочка сразу об этом сообщит.

Каждое событие содержит ссылку на предыдущий хеш и подпись Ed25519.

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

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

Ознакомьтесь с восемью уровнями доказательности

ПОДГОТОВЛЕНО ДЛЯ РЕЦЕНЗИИ

Готов к дополнительной проверке.

Предоставляйте данные наблюдений, файлы и автономный отчёт в формате HTML в одном подписанном пакете.

Ознакомьтесь с моделью доказательств
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 и ключом восстановления
Вся форма с раскрытыми дополнительными настройками. Учётные данные хранилища не указаны.
Журнал и СМИAES-256-GCMХранилище, совместимое с S3

Чего не делает восстановление данных без экспортированного ключа дешифрования и не заменяет независимого свидетеля.

Уведомления · Apprise

Уведомления о проблемах, изменениях в чатах и ежедневные сводки через Apprise: мессенджеры, электронную почту или ваш собственный веб-хук JSON.

Чего не делает Не отправляет текст сообщений, пока вы не включите короткие выдержки.

Настроить получателей уведомлений

Внешние временные метки

Метки времени RFC 3161 и OpenTimestamps для хешей контрольных точек.

Чего не делает рассматривает ожидающее подтверждения календарное подтверждение как подтверждённую временную метку Bitcoin.

Проверьте доказательства с временными метками:

Независимый свидетель

Отдельный сервер хранит подписанные наблюдения и может публиковать контрольные точки TGW1.

Чего не делает: не превращает две рабочие среды на одном хосте-коллекторе в независимые источники доказательств.

Настройте Witness

Восстановление данных и заметные пробелы

Продолжение после перезапуска. Перепроверки и coverage.json показывают восстановленные сообщения и разрывы.

Чего не делает: не восстанавливает каждое пропущенное изменение или исчезнувшее сообщение.

Проверьте непрерывность и наличие пробелов

НА ВАШЕМ КОМПЬЮТЕРЕ

Ваша первая рабочая среда начинается здесь.

Сначала ознакомьтесь с демо-версией. Когда будете готовы, подключите выделенную учетную запись. Windows, Linux, macOS или Docker.

Ознакомьтесь с руководством по настройке
Ознакомьтесь с информацией, прежде чем подключаться.

Откройте рабочее пространство с вымышленными данными без аккаунта Telegram.

Открыть онлайн-демо →

Windows scripts\Demo.cmdLinux / macOS sh start.sh --demo
Команды для локальной установки
ШАГ 01

Получить исходный код.

Скачайте ZIP-архив с исходным кодом и распакуйте его или клонируйте репозиторий:

git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness

Для запуска исходного кода требуется Python версии 3.11 или выше. Программа запуска для Windows предлагает установить Python, если он отсутствует.

Просмотреть версии

Нет Python на Windows? Загрузите портативный пакет, распакуйте его и дважды щелкните по файлу «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 .

При установке из исходного кода токен находится в data/live/panel-token.txt. Для входа в Telegram можно использовать встроенные настройки API или собственную пару ключей с сайта my.telegram.org. Полное руководство по настройке ↗

TgWitness 0.7.0 Что нового → · Возможности и известные ограничения →

ОДНА ЗАДАЧА ЗА РАЗ

Четкие инструкции. Полезный следующий шаг.

Ознакомьтесь с руководствами ↗

Режимы, сценарии и уровни доказательности

Четыре режима сбора данных. Восемь уровней проверки. Выберите рабочий процесс, подходящий для вашего дела.

Работайте с архивом.

Загрузка истории, просмотр источников ИИ, подключение клиента MCP, распознавание сохраненных медиафайлов и отправка подписанных веб-хуков.

Доступно из текущего исходного кода. Портативная предварительная версия 0.7.0 была выпущена до появления этих инструментов.

Ознакомьтесь с рабочим процессом

Прежде чем начать.

Связана ли эта страница с 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.

ВАШ СЛЕДУЮЩИЙ ШАГ

Сначала ознакомьтесь с информацией. Настройте систему, когда будете готовы.