Панель TgWitness: чаты, журнал и экспорт Telegram

TgWitness / Документация · Начало работы

Первоначальная настройка и параметры · Аккаунты · Экспорт и проверка · Отчёты по делам

Что делает каждый экран, что записывается в подписанный журнал и где находится подробное руководство. Панель отображает по одному рабочему пространству за раз: одну учетную запись Telegram с собственными источниками, журналом и ключом подписи. Селектор в верхней части боковой панели позволяет переключаться между рабочими пространствами. Адрес содержит рабочее пространство (?ws=…); пока адрес, селектор и загруженная учётная запись не совпадают, действия остаются заблокированными.

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

На этой странице

• Ориентируйтесь
• Начните здесь
• Чаты
• Журнал
• Источники
• Экспорт
• Настройки, учётные записи и подключение
• Дополнительная информация
• Режимы защиты
• Другие инструменты

Ориентируйтесь#

Ежедневные разделы находятся в верхней части боковой панели, раздел «Аккаунты» — под разделом «Рабочая область », а всё остальное — в разделе «Дополнительные инструменты и настройки ». Переключатель уровня интерфейса в верхней панели определяет, сколько разделов отображается:

Простые вызовы: «Начать здесь», «Журнал» и «Экспорт», «Главная», «Изменения» и «Архивы». Уровень скрывает только разделы. Скрытая функция продолжает работать, а сервер самостоятельно проверяет каждое разрешение. Уровень, язык, тема и часовой пояс сохраняются для каждого оператора и рабочего пространства; см. настройки.

В верхней панели также имеются:

• Перейти к разделу (Ctrl+K или ⌘K на Mac): найти чат, параметр или запись в журнале по #number. Клавиши со стрелками — перемещение, Enter — открытие, Esc — закрытие.
• Уведомления: проблемы и изменения в чатах, выявленные из журнала. Функция «Пометить всё как прочитанное» обнуляет счётчик, а «Правила уведомлений» открывает настройки правил. Настройка отправки уведомлений в Telegram, Discord или по электронной почте осуществляется в разделе «Дополнительно» → «Уведомления».
• Индикатор подключения для этой рабочей области. Состояние коллектора под верхней панелью разбивает его на подключение к Telegram, прием событий, источники и очередь вложений.
• «Замок»: закрывает панель в этом браузере. Коллекция продолжает работать на сервере.
• Режим защиты, указанный рядом с номером версии; см. «Режимы защиты».

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

Начните здесь#

Выберите задачу. Функция «Экспорт моего аккаунта» скачивает то, что аккаунт может прочитать в данный момент. Функция «Следить за расследованием» фиксирует новые сообщения, отмеченные правки и уведомления об удалении из выбранных вами чатов. На карте настройки показаны три шага: подключить аккаунт, выбрать источники, начать наблюдение. Вопрос о цели остаётся на этой странице, пока вы не ответите на него или не пропустите его. Вместо этого открывается новое рабочее пространство с начальной настройкой.

Чаты#

Сохраненные беседы по умолчанию доступны только для чтения.

• Поиск в списке по имени или ID. Команда «Выбрать» добавляет или удаляет чаты из списка наблюдения. Команда «Открыть ссылку Telegram» принимает имя пользователя или ссылку-приглашение и сохраняет превью в журнале. Команда «Присоединиться / открыть и наблюдать» присоединяет вас к чату и добавляет его в ваши источники; открытие бота отправляет его /start.
• В заголовке чата подсчитываются сообщения, удалённые, сохраненные, удалённые до сохранения и не найденные при повторной проверке. Список чатов и уведомления используют те же определения. Удалённое сообщение отображается красным цветом и сохраняет свой сохраненный текст; отредактированное сообщение сохраняет все сохраненные версии. Каждое удаление содержит известную информацию: когда оно было прочитано, то, что Telegram не сообщает, кто его удалил, или что поступило только уведомление.
• Функция «Загрузить историю» отображает последние 100, 250 или 500 сообщений в этом окне и в журнале. Чтобы загрузить все включённые источники, воспользуйтесь меню «Источники» → «Полная история».
• Функция «Экспорт чата» позволяет скачать всю видимую историю в виде подписанного chat.json и chat.html. Несколько подключенных аккаунтов могут разделить работу: каждый скачивает свой диапазон номеров сообщений и подписывает свою часть, а аккаунт, запустивший экспорт, подписывает архив. См. раздел «Экспорт одного чата».
• В разделе «People» перечислены все пользователи, чьи сообщения сохранены в этом чате. Профили пользователей по умолчанию отключены, поскольку содержат личные данные третьих лиц. Если они включены для конкретного чата, в профиле отображаются имя и история пользовательских имён, флаги Telegram, хеши аватаров, активность, кто кому отвечает, другие отслеживаемые чаты, а также упомянутые кошельки, телефоны, пользовательские имена и ссылки. Каждый факт указывает на свою запись. Экспорт профилей сохраняет подписанный файл, по желанию в формате с паролем ZIP; отключение профилей приводит к удалению файла профиля. См. профили участников.
• Функция «Сохранить профиль» теперь создаёт моментальный снимок чата или профиля бота: описание, участники, ссылка для приглашения, команды бота.

Только для чтения, отправка и секретные данные#

Два переключателя над сообщениями обеспечивают защиту аккаунта и читателя:

• Режим «Только для чтения» включен при открытии чата. Отключите его, чтобы отправлять сообщения или нажимать кнопки бота . При каждом действии появляется запрос «Отправить от имени @account?» или «Нажать эту кнопку бота от имени @account?», сообщающий, что участники чата увидят это действие и что оно попадёт в подписанный журнал. Опция «Не спрашивать снова в течение 10 минут в этом чате» позволяет на некоторое время отключить этот запрос. Отправка отключена для цели «Доказательства по делу» — как в панели, так и в API.
• Функция «Mask secrets» скрывает данные, похожие на пароль, код входа, ключ API или хэш, токен бота, строку сеанса, закрытый ключ, JWT или номер платежной карты (номера карт проверяются по сумме Луна). Функция «Show» раскрывает одно значение; раскрытие фиксируется в журнале. Отключение маскировки для данного браузера также фиксируется. Изменяется только отображение: исходные записи и все экспортированные данные сохраняют полный текст.

Журнал#

Все записи, подписанные рабочим пространством, отсортированы по дате — самые новые вверху.

• В разделе «Обзор» подсчитываются просмотренные сообщения, зафиксированные правки, уведомления об удалении и выбранные источники.
• Хронология событий — фильтрация по типу события (все, правки, удаления, реакции, членство, охват), по тексту и по источнику. Загрузить предыдущие события — переход на предыдущую страницу.
• Откройте запись, чтобы увидеть её детали, хэш и содержимое. Ссылка на эту запись — это адрес, по которому открывается та же запись. Возможные секретные данные замаскированы в этом предварительном просмотре; в экспортированных файлах сохраняется исходный текст.
• Журнал доступен только для добавления записей: ни одна из панелей не позволяет редактировать или удалять записи. Проверьте это с помощью «Экспорт» → «Проверить журнал» или python -m tgwitness.verify; см. раздел «Экспорт и проверка».

Источники#

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

Функция «Обновить список чатов» считывает чаты и папки аккаунта. Она не загружает сообщения.

Объём работ#

• Что фиксирует эта учетная запись : Выбранные чаты (только те чаты, которые вы добавляете), Папка Telegram (одна из папок аккаунта, включая чаты, добавленные в неё позже) или Вся учетная запись (каждый чат, а также каждый новый чат, группу, личный чат или бота по мере их появления). Режим расследования предназначен для выделенного аккаунта: он записывает всё, что видит аккаунт, его собственные сообщения и нажатия кнопок, а также сразу сохраняет профиль каждого нового чата и ранее видимые сообщения. На изображении специальное руководство по аккаунтам объясняется, почему никогда не следует использовать свою основную учётную запись.
• Типы источников ограничивают режимы «папка» и «весь аккаунт» каналами, группами, личными чатами и ботами. «Собственные действия» добавляют собственные сообщения аккаунта, правки и нажатия клавиш при ответе.
• При появлении нового чата или бота: сохраните его профиль и до выбранного количества его последних видимых сообщений.

Ограничения: опубликованный облачный сборщик данных не принимает секретные чаты. Отдельный интерфейс Pseudo-secret и его демо-версия описаны с указанием их статуса разработки и имеющихся дефектов. Ничего не записывается, пока TgWitness не запущен; после перезапуска он фиксирует только то, что Telegram ещё возвращает, и в отчёте отображается пробел. Чаты, выходящие за пределы списка чатов (диалоги 1,000, если не изменено в параметрах), добавляются при их следующей активации. Кнопки бота, нажатые в другом приложении, невидимы; ответ бота записывается.

Чаты, входящие в сферу действия#

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

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

Полная история#

Загружает доступную историю каждого включённого источника в раздел «Чаты» и журнал. Ход работы сохраняется после перезапуска; вложения отображаются в соответствии с вашими настройками мультимедиа. См. историю источников.

Запись#

• Выберите, какие изменения следует сохранить: новые сообщения, правки, уведомления об удалении, видимые реакции, вступления в группу и выходы из неё. Предустановка изменяет форму; кнопка «Сохранить настройки записи» применяет её. Повторное включение категории не восстанавливает пропущенные события.
• Сохранение медиафайлов при наличии: загрузка вложений размером до определенного предела на файл, установка предела для каждого типа от 1 до 2 000 MiB и ограничение длительности видео в секундах (0 означает отсутствие ограничения). Результат каждой попытки загрузки фиксируется.
• Перепроверка: приоритетные чаты проверяются каждые несколько минут, остальные — реже, благодаря чему аккаунт не превышает ограничения Telegram по FloodWait. Значение 0 отключает группу. Отметьте приоритетные чаты звездочкой в списке; количество чатов за один проход и пауза между ними указаны в параметрах. См. коллекцию.

Экспорт#

В разделе «Загрузки» готовятся файлы; в разделе «Отчет о сборке» выбирается формат отчетов.

• Шифрование вышеуказанных загрузок с помощью пароля (12 символов или более) приводит к сохранению файла AES-256 ZIP, который открывается программами 7-Zip или WinRAR. Находящийся внутри подписанный файл остаётся неизменённым. Пароль не сохраняется.
• В разделе «Подготовленные экспорты» хранится до 20 файлов объёмом не более 2 ГБ, плюс самый последний, для повторных загрузок, каждый из которых содержит свой тег SHA-256. Подготовка файла не гарантирует его доставку.
• Если браузер отклоняет диалоговое окно сохранения, панель переключается на обычную загрузку.
• Ваша идентичность для подписи отображает отпечаток ключа. Функции «Сохранить контрольную точку» и «Скачать подписанную квитанцию о запуске» позволяют сохранять записи вне коллектора. Функция «Подготовить запрос с временной меткой» формирует запрос по стандарту RFC 3161 без обращения к каким-либо сервисам.

Настройки, аккаунты и подключение#

• Настройки: цель, подключение, что записывать и интерфейс. См. раздел «Первая настройка и параметры».
• Аккаунты: каждое рабочее пространство со своим состоянием, источниками, событиями и очередью вложений. Фильтрация по категориям «Требует внимания», «В процессе сбора», «Офлайн» или «Приостановлено» либо «Не подключено», приостановка или возобновление выделения, массовый импорт файлов аккаунтов и управление группами. См. раздел «Аккаунты».
• Аккаунт: вход в систему и маршрут подключения для данного аккаунта. Прямое подключение, профиль WireGuard, ваш собственный прокси-сервер, общедоступный пул MTProto или WARP; подготовьте и проверьте маршрут, затем примените его к данному аккаунту, группе или ко всем аккаунтам. См. разделы «Подключение» и «Прокси-серверы».

Дополнительные возможности#

Необязательно: для начала сбора данных достаточно одного аккаунта и источников. Настройки открываются только для той опции, которую вы выберете, и ничего не подключается автоматически. Карточка «Уровень защиты» вверху показывает режим защиты.

Цель и уровень защиты#

Четыре вопроса:

1. Для чего это нужно? Для личного архива, расследования или в качестве доказательств по делу.
2. Какой объём данных вы будете отслеживать? Несколько чатов (до примерно 50), много чатов (до примерно 500) или целые аккаунты. Это устанавливает ограничение на количество чатов в списке — 1 000, 3 000 или 20 000.
3. Фотографии и файлы? Только текст, фотографии и короткие медиафайлы (фотографии до 20 МБ, видео до 100 МБ) или всё (видео и документы размером до 1 ГБ каждый). Режим «Всё» с полными аккаунтами также оставляет 4 ГиБ свободного места на диске.
4. Где он будет работать? На этом компьютере или на сервере, который всегда включён.

В списке предложений перечислены независимые временные метки, drand и список устройств Telegram, причём для каждого указано, что именно он добавляет. Временные метки создаются каждые 60, 30 или 10 минут для личной записи, расследования или доказательств; drand и список устройств требуют временных меток. Применяйте изменения только к этим элементам, к политике вложений и к двум параметрам, указанным выше. Каждое изменение представляет собой запись в журнале, плюс setup.applied. Уведомления, внесайтовая копия, сервер, шлюз DNS, проверка кода и свидетель предлагаются в качестве следующих шагов со своими собственными формами.

Две шкалы рассчитываются на основе заданных параметров, а не на основе цели:

Максимальный уровень чтения — 80% и выше, высокий — 50%, умеренный — 25%, ниже этого — базовый. Надежность в настоящее время определяется наличием постоянно работающего сервера, как указано в ответе на вопрос 4, до проверки какого-либо сервера.

Уведомления#

Уведомления отправляются через Apprise в Telegram, Discord, Slack, ntfy, по электронной почте, в Matrix и более чем 100 других сервисов. Выберите сервис, заполните одно или два поля и отправьте тестовое уведомление, либо вставьте адреса Apprise напрямую.

• Проблемы: диск почти заполнен, выход из аккаунта, ошибки при сборе, копировании или установке временной метки. На изолированном сервере открытый SSH-порт или вход в систему также являются проблемой.
• Изменения: удалённые, отредактированные и отсутствующие сообщения в отслеживаемых чатах, сгруппированные в одно уведомление за каждую проверку (каждую минуту, если не изменено в настройках).
• Завершённые задачи: история, экспорт и резервные копии.
• Ежедневная сводка в выбранное время по серверному времени.

Уведомления содержат названия чатов и количество сообщений. По умолчанию выдержки из сообщений отключены; если они включены, текст сообщений покидает этот компьютер.

Ваш операторский бот — это ваш собственный бот, созданный с помощью @BotFather, который отвечает /status и /stats, а также, по желанию, /pause, /resume и /copy. Им могут пользоваться только указанные чаты и идентификаторы пользователей Telegram; текст разговора остаётся в рабочей области. Используйте отдельного бота, если другое приложение уже принимает его команды. См. разделы «Уведомления» и «Операторский бот».

Доказательства и резервные копии#

• Независимые временные метки отправляют только SHA-256 каждой подписанной контрольной точки в авторитетные источники RFC 3161 и календари OpenTimestamps каждые 5–1 440 минут. Anchor сейчас выполняет цикл проверки. См. временные метки.
• Дополнительные источники данных, каждый из которых отключен до момента выбора: последний раунд drand, список подключённых устройств Telegram без указания IP-адресов и журнал DNS-запросов сервера Cloudflare Gateway. См. дополнительные записи.
• Зашифрованная резервная копия сохраняет журнал, файлы, контрольные точки и экспортированные данные чатов в хранилище, совместимое с S3 (Wasabi, Amazon S3, Backblaze B2, Cloudflare R2, MinIO). Всё сначала шифруется на этом компьютере. Скачайте ключ шифрования и храните его отдельно: без него копию прочитать невозможно. Функция Object Lock в режиме «Управление» или «Соответствие требованиям» защищает объекты от удаления в течение заданного количества дней. См. раздел «Внесайтовая копия».

Проверка кода#

Проверяет, соответствует ли установленная программа опубликованной версии.

1. Укажите репозиторий GitHub (официальный уже указан) и тег, ветку или коммит.
2. Функция «Check now» запрашивает у API GitHub через маршрут этой рабочей области для внешних запросов список файлов данного коммита. Она сравнивает ID git-блоба каждого измеряемого программного файла с данными коммита. Результаты проверки в Windows с преобразованными символами конца строки по-прежнему совпадают.
3. В результате выводится список измененных, дополнительных и отсутствующих файлов (до 50 каждого типа), который сохраняется в виде записи source.checked записью журнала.

Результат считается актуальным только до тех пор, пока файлы запущенной программы не изменятся: проверьте снова после обновления. Токен не требуется, и работают только публичные репозитории; чаты и учетные данные не загружаются. Совпадение идентифицирует код на диске. Это не аппаратная аттестация; для этого см. Phala Cloud.

Режимы защиты#

Переключатель рядом с номером версии показывает выбранный режим и количество из 18 активных уровней защиты, например 🟠 Witnessed 9/18. Изменить режим можно в «Дополнительно» → «Уровень защиты» — там открывается список вариантов. Каждый режим описывает конкретную цель и перечисляет, чего ещё не хватает; запись, подпись и сохранённые настройки одинаковы во всех режимах.

Слои: каждая запись подписана и включена в цепочку; подписанная квитанция о запуске; вложения, сохраненные с помощью SHA-256; подписанные контрольные точки; повторные проверки; оповещения о проблемах; доступ свидетеля только для чтения; проверка свидетелем по расписанию; временные метки RFC 3161; доказательства OpenTimestamps; проверенная последняя временная метка; зашифрованная внесайтовая копия; детали дела в отчетах; проверка соответствия кода ; Telegram никогда не видит IP-адрес этого устройства; внешние запросы через прокси; Object Lock на копии; запечатанный сервер с записями провайдера. Уровень, который отключен, имеет пункт «Настройка», который открывает соответствующую форму. Выбор более низкого режима требует подтверждения и ничего не удаляет.

Другие инструменты#

Extras → Independent capture: connect a separate browser or AyuGram recorder, pin its signing key, select capture options, start/pause, take snapshots and download verified signed archives. Each recorder has its own manual login, route, journal and key. Both connections start disabled. See the English Independent capture guide.

• Обратитесь к архиву: выполните поиск по сохраненным наблюдениям, просмотрите источники, а затем решите, стоит ли отправлять их в модель искусственного интеллекта. См. раздел «Анализ архива» и «Локальное распознавание текста и транскрипция».
• Параметры: ограничения и скорость сбора данных, повторные проверки, загрузки, профили, уведомления и экспорт. Поиск по имени, отображение значений Только измененные и подготовка значений по умолчанию в виде черновика с помощью Восстановить настройки по умолчанию…. Сохраните параметры применяет эти значения при следующем использовании, и каждое изменение фиксируется в журнале.
• Доступ: отдельные токены для рецензентов, аналитиков и операторов, ограниченные выбранными рабочими пространствами, чатами и правами. См. раздел «Доступ».
• Системный журнал : действия, выполненные этим процессом с момента запуска (подключения, смены прокси, входы в систему, отказы, изменения настроек) с скрытыми IP-адресами. Функция «Следить за новыми строками» позволяет всегда видеть самую последнюю строку. Сообщения хранятся только в журнале.
• Интеграции: поставщик ИИ, подключения к MCP только для чтения и подписанные веб-хуки.
• Case Board: личные заметки команды, закладки и фрагменты рядом с доказательствами. См. Case Board.
• GitHub Actions фиксирует данные в разделе «Экспорт»: один чат, зафиксированный из вашего форка. См. запечатанный снимок.