Справочник / Установка
Настройка сбора Telegram и параметров TgWitness
Мастер настройки, цели, уровни интерфейса, маршруты подключения и настройки, общие для группы аккаунтов.
TgWitness / Документация · Начало работы
Откроется новое рабочее пространство /first-run. На первом экране вам будет предложено выбрать, что вы хотите сделать: «Просто скачать», «Отслеживать чаты» или «Собрать доказательства по делу». Ваш выбор определяет цель и уровень интерфейса: «Простой» для варианта «Просто скачать», «Стандартный» — для двух остальных. Уровень определяет, сколько полей отображается в каждой форме; все страницы остаются доступными в меню. Дополнительные параметры на том же экране позволяют явно задать уровень, тему и часовой пояс; список языков находится в заголовке мастера. Следующие экраны посвящены подключению, Telegram и чатам. Маршруты подключения остаются свернутыми во время автоматической проверки и раскрываются в случае её сбоя. Пятиступенчатая индикатор выполнения позволяет вернуться к уже завершённым этапам. Каждый ответ сохраняется на сервере сразу же после изменения, поэтому при перезагрузке процесс продолжается с того же шага. На последнем экране отображается список ответов, и вы можете вернуться к любому из них.
Язык, часовой пояс IANA, тема и уровень сохраняются для каждого оператора и каждого рабочего пространства. По умолчанию используются язык браузера, часовой пояс устройства, системная тема и простой интерфейс. При смене языка настройки панели сохраняются. Время в подписанном журнале никогда не меняется.
/settings редактирует те же записи, что и мастер. Поиск охватывает основные поля, параметры и расширенные формы; скрытое поле можно открыть, не меняя уровень. Уровни влияют только на то, что показано: права доступа сервер проверяет сам. Раздел, все настройки которого выше выбранного уровня, всё равно их показывает. Настройки сбора и первое подключение принадлежат администратору рабочей области.
Страница настроек — это список. Карточка аккаунта вверху открывает Аккаунт Telegram. Ниже каждая строка называет раздел и текущее значение: Какие чаты? и Подключение в группе Аккаунт; Цель, Сбор и файлы, Защита записей и Уведомления и внешняя копия в группе Запись; Язык, время и оформление в группе Панель; экспертные страницы — в группе Инструменты. Рядом со списком карточка показывает, включены ли рекомендуемые значения, с основными значениями и кнопкой Отменить последнее изменение, а Последние изменения перечисляет последние правки.
Раздел открывается в отдельном окне над списком и имеет собственный адрес, например
/settings/connection. Стрелка «Назад», кнопка «Закрыть», клавиша Escape, щелчок за пределами
окна и кнопка «Назад» в браузере позволяют вернуться к списку. Выбор в разделе Какие чаты? сохраняется при
нажатии Сохранить выбор чатов; при закрытии с несохраненными изменениями сначала появляется запрос на подтверждение. При сохранении сохраняются типы
источников, исключённые чаты, собственные действия и настройки нового чата из Дополнительные инструменты → Источники →
Область действия; выбранный здесь чат удаляется из списка исключённых чатов и записывается как вручную выбранный
источник. Каждое изменение отображает
кнопку Отменить в течение 20 секунд, и каждую запись в Последних изменениях можно отменить позже.
Отмена восстанавливает только те настройки, которые изменила данная запись, включая настраиваемые ограничения на размер файлов.
Если более позднее изменение затронуло те же настройки, отмена отклоняется и ничего
не меняется. Отмена представляет собой новую запись settings.changed в журнале.
| Уровень | Поля | Боковая панель |
|---|---|---|
| Просто | Только самое необходимое | Главная, Чаты, Журнал, Экспорт, Учётные записи и Настройки |
| Стандарт | Общие настройки с пояснениями | Добавлены разделы Доска дел, Источники, Доступ и Документация в разделе Дополнительные инструменты |
| Эксперт | Все поля, ограничения и технические детали | Также в раздел Дополнительные инструменты добавлены Карта системы, Топология сети, Дополнительные функции, Запрос к архиву, Параметры, Учётная запись, Системный журнал и Интеграции. |
Названия разделов остаются неизменными на всех уровнях. Откройте Внешний вид внизу боковой панели, чтобы изменить уровень. В руководстве по панели описан каждый раздел.
Цели#
| Цель | Коллекция | Файлы | Внешние сервисы | Адрес сервера |
|---|---|---|---|---|
| Просто скачать | Однократный экспорт запускается с экрана окончательной настройки; непрерывный сбор данных остается отключенным | Фотографии размером до 20 МБ | Временные метки | Автоматически |
| Подписка на чаты | Непрерывный | Фотографии и видео продолжительностью до 60 секунд / размером до 20 МБ | Временные метки и уведомления о проблемах | Автоматически |
| Доказательства по делу | Непрерывный | Все файлы размером до 1 ГБ | Временные метки, drand, уведомления | Нет, скрыть |
В качестве доказательств рекомендуется использовать внесерверную копию, бота-свидетеля и проверку кода. Для адресов хранилища и уведомлений сначала необходимо указать пункт назначения. Функция, взаимодействующая с внешним сервисом, запрашивает разрешение на отправку запросов за пределы Telegram; отключение этой функции предлагает одновременно отключить временные метки, уведомления и внесерверную копию.
При изменении целевого значения сначала отображаются различия, а ручные изменения можно сохранить. Поле, отличающееся от целевого значения, помечается как «Изменено вами» и может быть восстановлено. Ревизия настроек предотвращает применение проверенного изменения поверх изменения, внесённого на другой вкладке.
Связь#
Пока здесь не будет выбран маршрут, в новой рабочей области будет использоваться Автоматический MTProxy · общедоступные списки с опцией Скрыть адрес (безопасность соединения). Выбор параметра Автоматический, указанного ниже, представляет собой отдельный этап настройки.
Automatic сначала пробует WARP, затем публичные серверы MTProxy, а затем — прямое соединение, причём последнее используется только в том случае, если адрес сервера может быть показан. Automatic и WARP могут устанавливать компоненты с хеш-проверкой и регистрировать сервер в Cloudflare; без такого согласия Automatic пропускает WARP. WARP использует существующий менеджер wgcf/wireproxy и локальный SOCKS5- порт; таблица маршрутизации системы не изменяется.
При массовом импорте запрашивается маршрут до того, как сессия достигнет Telegram: WARP (по умолчанию), публичный MTProxy или прямой. При проверке сессии используется тот же тип маршрута, и каждая импортированная учетная запись получает собственный туннель WARP перед первым входом в систему.
Ваш собственный прокси принимает tg://proxy, socks5://, http:// и https://. Сертификат HTTPS-
прокси проверяется перед отправкой ему учетных данных.
Проверка подключения действительна в течение пяти минут и привязана к маршруту, политике и ответам мастера; изменение любого из этих параметров требует новой проверки. Доступна опция «Продолжить без проверки», которая не заменяет вход в Telegram. Выбранный маршрут перепроверяется в фоновом режиме, а функция «Автоматический» повторно запускает цепочку действий после потери соединения. Если ни один из общедоступных прокси не отвечает, индикатор становится красным, и запускаются действия WARP и повторная проверка.
Группы аккаунтов#
Аккаунты в группе используют общие настройки. Откройте «Аккаунты» → «Группы и общие настройки» → «Общие настройки» или «Настройки группы» на странице «Настройки» аккаунта.
Группа совместно использует цель, сохраненные файлы, временные метки, drand, уведомления о проблемах, внешнюю копию, запросы за пределами Telegram, IP-режим, параметры записи, график повторной проверки, правила уведомлений, настройки отчетов, параметры и маршрут подключения. Адреса для уведомлений, учетные данные прокси и данные для входа сохраняются для каждого аккаунта отдельно, так же как и запуск и приостановка сбора данных.
- Каждый участник подписан на группу. В настройках можно выбрать значение 🔗 из группы или ✏️ собственное значение; нажатие «Вернуть значение группы» восстанавливает исходное значение.
- При внесении изменения отображается список затронутых аккаунтов (применимо к 2 из 3 аккаунтов), и перед заменой собственного значения запрашивается подтверждение для каждого аккаунта. Аккаунты, галочка у которых снята, сохраняют свои значения.
- Параметр, которым группа не делится, остаётся в состоянии «Не поделиться»: каждый аккаунт сохраняет своё собственное значение, пока вы не нажмёте «Поделиться этим значением».
- При копировании настроек из одной учётной записи значения выбранной учётной записи становятся значениями для всей группы.
- Аккаунту, перемещённому в группу, задаётся вопрос: «Принять настройки группы?». В противном случае он сохраняет свои собственные настройки, отмеченные значком ✏️. Аккаунты, добавленные позже, изначально используют настройки группы.
- Учетная запись-наблюдатель сохраняет свой IP-режим до тех пор, пока не будет приостановлена.
Каждое изменение фиксируется в подписанном журнале основного рабочего пространства и каждого участника, к которому оно доходит. При удалении группы её аккаунты и их текущие значения сохраняются.
Страница группы /groups/<id> отображает участников, задачи, требующие внимания, и чаты,
доступные нескольким аккаунтам. См. раздел «Группы аккаунтов».
Существующие рабочие пространства#
В рабочей области, где открыта сессия или ранее была завершена настройка, мастер не отображается. Его значения не заменяются целевыми значениями при загрузке страницы. Скрытие поля не приводит к отключению функции или удалению его значения. При открытии Первой настройки в разделе «Настройки» снова отображаются те же экраны; их завершение не запускает новый экспорт или наблюдение, о чём появляется соответствующее сообщение, а измененный выбор чата сохраняется только при нажатии кнопки Сохранить выбор чата.
Оценка объёма и времени учитывает до трёх выбранных чатов и до 20 сообщений из каждого. Это приблизительная оценка: она не учитывает ограничения Telegram, скорость конкретного сервера или файлы в каждом чате.