Деякі частини цієї сторінки досі залишаються англійською мовою: англійський оригінал зазнав змін після перекладу.
Довідка / Налаштування
Telegram · Формати облікових записів та сеансів
Увійдіть за допомогою телефону, QR-коду або ключа автентифікації, імпортуйте сесії з Telethon, Pyrogram або Telegram Desktop та керуйте кількома обліковими записами.
TgWitness / Документація · Початок роботи
TgWitness входить у систему як обліковий запис користувача Telegram (а не як бот) через MTProto, використовуючи Telethon. Кожен обліковий запис розміщується у власному робочому просторі (який у API та інструментах командного рядка називається «workspace») із власною сесією, джерелами, журналом та ключем підпису.
Файли сеансів, рядки сеансів та ключі автентифікації є засобами авторизації облікового запису: той, хто володіє ними, може діяти від імені цього облікового запису. Вони не містять історії повідомлень.
[!ПОПЕРЕДЖЕННЯ] Використовуйте спеціальні облікові записи. Telegram обмежує та може назавжди заблокувати облікові записи за обсяги запитів, які вважає надмірними, незалежно від клієнта чи мети, і документує ці обмеження лише частково. Підключайте облікові записи, підготовлені для спостереження, а не особисті чи інші цінні облікові записи, та створюйте API-ідентифікатор / API-хеш на спеціальному обліковому записі.
- Короткий огляд
- Перш ніж почати: ідентифікатор API та хеш API
- Номер телефону · QR-код · Ключ автентифікації + ідентифікатор DC
- Файли облікових записів: Telethon .session · Pyrogram .session · Пара «сесія + JSON» · TData · StringSession · Ключ автентифікації та DC в одному рядку · JSON-файл облікового запису
- Визначте, що у вас є · Непідтримувані формати
- Кілька облікових записів · Забезпечення безпеки файлів облікових записів · Усунення несправностей
Короткий огляд#
| Що у вас є | Вкладка «Додати обліковий запис» | Вам також знадобиться |
|---|---|---|
| Номер телефону та доступ до кодів входу | Телефон | Пароль 2FA, якщо функція увімкнена |
| Telegram відкрито на іншому пристрої | QR-код | Пароль 2FA, якщо функція увімкнена |
Файл .session (Telethon або Pyrogram) |
Файли | Додатковий супровідний файл JSON для налаштувань додатка |
.session + .json з однаковою назвою |
Файли (виберіть обидва) | Зазвичай нічого іншого |
Папка «tdata» у Telegram Desktop |
Файли (у форматі ZIP) | Локальний пароль для настільного комп’ютера, якщо такий встановлено |
StringSession для Telethon (текст, .txt, .tgwitness-session) |
Файли | Окремої пари API не потрібно |
Ключ автентифікації та DC в одному рядку: <512 hex>:<1–5> |
Файли (вставлений текст або текстовий файл) | Окремої пари API не потрібно |
.json із сесією або ключем автентифікації |
Файли | Окремої пари API не потрібно |
| Ключ автентифікації (512 шестнадцяткових символів) та його номер DC | Ключ автентифікації | Опціональний ідентифікатор користувача |
TgWitness розпізнає файли за їхнім вмістом, а не за іменами. Перейменування файлу ніколи не призводить до його конвертації.
Перш ніж почати: ідентифікатор API та хеш API#
Ви можете увійти, не створюючи додатка Telegram API. Якщо жодна пара не введена,
не імпортована або не збережена в робочому просторі, TgWitness вибирає пару зі свого вбудованого пулу з
50 публічних пар API (tgwitness/api_pool.py), надаючи перевагу Telegram Desktop для нового
входу та спочатку використовуючи збережену пару; решта варіантів перемішуються. Якщо Telegram відхиляє пару
(API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), випробовується наступна,
до восьми на один вхід; відхилені пари пропускаються до перезапуску. Пара, яка здійснила вхід,
зберігається разом з обліковим записом і використовується для нього повторно.
Вбудовані пари є загальнодоступними: вони опубліковані у відкритому вихідному коді клієнтів
та бібліотек Telegram. Ідентифікатор API та хеш API ідентифікують додаток для Telegram
і не надають доступу до даних облікового запису. Для входу використовується власна система авторизації облікового запису: код
входу та пароль 2FA, або сесія, в якій обліковий запис уже авторизовано. У кожному
observation.started запис містить назву використаної пари, тому вбудована пара задокументована для
суду так само, як і ваша власна. Замість цього ви можете ввести власну пару на сайті my.telegram.org.
З досвіду проекту, нова особиста пара призводить до виходу з більшості облікових записів, тому використовуйте її
лише тоді, коли справа вимагає вашого власного додатка: створіть її за допомогою спеціального облікового запису та
введіть її до початку збору даних (кроки наведено нижче).
У полях з відсутніми даними про з’єднання використовується детермінована пара пристрій/ОС із вбудованих каталогів
opentele2 2.0.0:
Desktop 2040, Android 6, Android X 21724, iOS 10840, macOS 2834 та Web 2496.
Ідентифікатор збірки з вихідного коду для Android 4 також використовує каталог Android, як зазначено в
BuildVars Telegram для Android.
Для Web за замовчуванням використовується A; імпортований суфікс версії додатка K або мовний пакет macos обирає
K, а версія 0.7.0 обирає Webogram. Невідомі ідентифікатори додатків зберігають
значення за замовчуванням Telethon. Імпортовані поля завжди мають пріоритет, включаючи старішу версію додатка та порожній
мовний пакет. Каталог ніколи не змінює ідентифікатор API/хеш. Його знімок версії
перевіряється явно, а не отримується під час входу. Збережений профіль залишається стабільним після оновлень.
account.getAuthorizations повідомляє про збережені метадані авторизації Telegram; це
не є повторенням кожного нового initConnection. Порівняйте його з фактично надісланим профілем.
Підключення існуючої авторизації не перевіряє відповідний хеш API:
initConnection надсилає ідентифікатор API, тоді як хеш використовується у запитах на вхід.
Після авторизації за допомогою нового телефону або QR-коду TgWitness запитує конфігурацію, найближчий центр обробки даних,
статус підключення, мови (якщо мовний пакет не порожній), оновлення додатка та
оновлення умов надання послуг з інтервалом між запитами 0.3–1.5 секунди. Оновлення статусу
на короткий час позначає обліковий запис як активний. Ця послідовність виконується один раз після завершення входу,
а не під час імпорту, повторного підключення чи перезапуску. Спочатку зберігається авторизація; невдалий
запит зупиняє послідовність без повторної спроби або скасування входу. Результати
записуються як account.initialized із зазначенням назв помилок, а не тіл відповідей.
Обмеження щодо облікових записів визначаються власними політиками Telegram.
Для tdesktop
, якщо tz_offset
відсутній, використовується локальне зміщення UTC сервера, округлене
до 900
секунд за допомогою алгоритму
opentele2
(MIT; ліцензія в tgwitness/client_profiles.LICENSE
). Воно оновлюється при кожному
підключенні, щоб відображати зміни, пов’язані з переходом на літній час. Імпортований tz_offset
має пріоритет на кожній платформі та зберігається точно, включаючи нуль. Інші записи
initConnection.params
зберігаються.
Форма входу через HTTP приймає числове значення часового поясу, повернуте під час імпорту файлу;
булеві значення, дроби та зміщення поза межами підтримуваного діапазону відхиляються.
Прямі маршрути, SOCKS5 та HTTP CONNECT використовують протокол Telethon ConnectionTcpObfuscated
(зашифрований скорочений MTProto). HTTPS CONNECT зберігає TLS до проксі та використовує
той самий зашифрований транспорт усередині тунелю. MTProxy зберігає необхідний
випадковий проміжний транспорт та обробку секретних даних. Перемикання маршрутів застосовує
ті самі параметри. Зашифрування змінює структуру пакетів; воно не приховує обліковий запис
або метадані клієнта від Telegram і не означає імунітету до обмежень.
Після підключення авторизованого клієнта TgWitness перевіряє конфігурацію, найближчий центр обробки даних,
поточну авторизацію, переглянуту базову версію рівня, мови, оновлення додатків
та оновлення умов надання послуг. Ці діагностичні перевірки виконуються один раз для кожного екземпляра клієнта,
перед початком збору даних, і відображаються у деталях з’єднання разом із часом їх виконання. У записі `
account.connection_checked` зберігається результат без хеш-значень сеансів, IP-адрес,
токенів або хеш-значень API. Вони ніколи не приймають умови використання та не встановлюють оновлення. Помилка запиту
або стан `FloodWait` зупиняють подальші запити; відсутній результат залишається невідомим.
Локальні перевірки все одно можуть повідомляти про свої результати, тоді як мережеві перевірки пропускаються.
Якщо увімкнено режим Вибрані чати, поточна
авторизація не запитується, і ця перевірка відображається як пропущена.
Після входу в систему та під час кожного нового підключення TgWitness зчитує налаштування щодо
контенту для дорослих у обліковому записі. Якщо цей параметр вимкнено, а Telegram дозволяє його змінити, TgWitness вмикає його,
щоб контент, який Telegram позначає як конфіденційний (18+), зберігався, та записує значення параметра
account.content_settings. Цей параметр належить обліковому запису та застосовується в усіх
додатках Telegram. У режимі «Вибрані чати» він залишається незмінним; увімкніть цей режим перед входом у систему.
Одночасні запити на відновлення з’єднання в одній робочій області використовують спільний клієнт і очікують завершення встановлення з’єднання. У разі невдалої або скасованої спроби наступний запит отримує можливість повторити спробу. Якщо під час встановлення з’єднання збережені облікові дані, клієнт або стан авторизації змінюються, попередня спроба припиняється, замість того щоб повідомити про готовність з’єднання.
Діагностика FloodWait зберігає метод TL, що завершився невдачею, будь-які обгортки Takeout/range,
запит сервера на очікування та ефективний кінцевий термін у telegram.backoff.
Деталі з’єднання показують метод та кінцевий термін, коли запити призупинені.
Діагностика включає лічильники викликів клієнта за кожним методом з моменту
створення цього клієнта; вони окремо підраховують вкладене визначення однорангових вузлів, але не враховують пакети
або внутрішні спроби повторного виклику Telethon. Поточні лічильники також доступні як
collector.rpc_activity у API стану. Аргументи запиту, імена користувачів,
хеші доступу або текст винятків не включаються. Остання діагностика та повний термін
зберігаються після перезапуску. Раніше очікування без запису методу не можна приписати
ретроспективно. Див. export limits для огляду джерел та
розмежування між виявленням та отриманням історії.
official_app=True або False — це прапор поточної авторизації Telegram. Жодне з
цих значень не визначає, чи є обліковий запис обмеженим, надійним або перебуває під спостереженням.
Існуючі знімки account.devices у режимі доказів залишаються історією всіх
підключених пристроїв; діагностика з’єднання зберігає лише опис поточного пристрою.
Перед підключенням попередні перевірки порівнюють платформу API, мовний пакет, формати пристрою/ОС та версії додатка, локаль мобільної системи та фактичний рівень схеми Telethon із базовим каталогом, що пройшов перевірку. Попередження з’являються у журналі сервера та метаданих статусу облікового запису; вони ніколи не замінюють імпортовані значення та не змінюють рівень схеми. Відмінність рівнів є сигналом для перевірки сумісності; власний статус підключення облікового запису показує, чи все працює. Telegram визначає обмеження зі свого боку, незалежно від того, який профіль клієнта використовується. Статус від’єднаного облікового запису використовує збережений профіль замість створення нового опису пристрою.
Щоб замість цього використовувати власний додаток:
- Відкрийте my.telegram.org і увійдіть, вказавши будь-який номер телефону, який належить вам. Код надходить у додаток Telegram, а не у вигляді SMS.
- Виберіть інструменти для розробки API.
- Створити заявку: будь-яка назва та коротка назва (5–32 літери), платформа — «Настільний ПК». Поля «URL» та «Опис» можна залишити порожніми.
- Скопіюйте App api_id (число) та App api_hash (32 шестнадцяткові символи).
У панелі під формою входу вказано «API ID + Hash». Ви можете ввести одну
пару api_id:api_hash у поле «API ID», і обидва поля заповняться автоматично. Одну пару можна
використовувати для всіх ваших облікових записів. Після успішного входу дані зберігаються у зашифрованому вигляді
виключно в цьому робочому просторі й ніколи не надсилаються назад до браузера.
Задіяно три різні типи облікових даних:
| Секрет | Відкрити | Де це знаходиться |
|---|---|---|
| Токен панелі | Веб-панель TgWitness | panel-token.txt у каталозі даних або TGWITNESS_TOKEN |
| Ідентифікатор API + хеш | Нічого окремо; ідентифікує додаток | Вбудована пара, імпортовані налаштування або ваш власний додаток на my.telegram.org |
| Авторизація облікового запису | Акаунт у Telegram | Створюється шляхом входу через телефон/QR-код або імпортується як сесія |
Якщо для доступу до Telegram потрібно використовувати проксі-сервер, спочатку налаштуйте його в меню Додаткові інструменти → Обліковий запис → Налаштування → Налаштування з’єднання → Змінити маршрут з’єднання.
Номер телефону#
- Відкрийте Більше інструментів → Обліковий запис, вкладку Телефон і введіть номер у міжнародному форматі,
наприклад,
+44 7700 900123. Пробіли та тире видаляються автоматично. - Натисніть «Продовжити». Поля «API ID» та «Хеш» можна залишити порожніми.
- Введіть код, який надсилає Telegram, зазвичай у додаток Telegram; Telegram вирішує, чи надсилати SMS.
- Якщо для облікового запису налаштовано двоступеневу аутентифікацію, введіть цей пароль. Це не токен панелі і не код доступу до пристрою.
- Перевірте ідентифікатор облікового запису, що відображається після входу, а потім виберіть джерела.
Коди входу та пароль 2FA ніколи не записуються на диск.
QR-код#
Використовуйте цю функцію, коли обліковий запис уже ввійшов у систему на телефоні або іншому комп’ютері.
- Вкладка «QR-код» → Показати QR-код. Поля «API ID» та «Хеш» можна залишити порожніми.
- На пристрої, на якому ви увійшли: Налаштування → Пристрої → Підключити настільний пристрій, відскануйте код та підтвердіть.
- Введіть пароль 2FA у TgWitness, якщо Telegram його вимагає.
Зображення QR-коду генерується локально. Термін дії кодів обмежений; натисніть «Створити інший QR-код», щоб спробувати ще раз. Блокування панелі, перехід до іншого робочого простору або початок нової сесії входу скасовує код, що очікує на використання.
Ключ автентифікації + ідентифікатор DC#
Ключ авторизації (Auth Key) — це необроблений 256-байтовий код авторизації, що лежить в основі кожного сеансу Telegram, записаний у вигляді 512 шістнадцяткових символів разом із номером центру обробки даних DC 1–5.
- Вкладка «Ключ авторизації». Вставте повний ключ; скорочений ключ, що містить
…, не працюватиме. - Виберіть DC-ідентифікатор, наданий разом із ключем.
- За бажанням введіть ідентифікатор користувача. У такому разі TgWitness відмовить у підключенні, якщо Telegram повідомить про інший обліковий запис.
- Акаунт у Press Connect.
Ключ авторизації (512 символів) — це не хеш API (32 символи). Цей самий ключ також можна імпортувати у форматі JSON, див. JSON-файл облікового запису.
Файли облікових записів#
Open Add account → Files and select up to four files belonging to one account, 8 MiB in total, press Check files, then Connect account. Choosing files or pasting session text sends nothing; Check files sends them to your TgWitness server, which reads them without signing in and shows the session it found.
Форми Files, Auth key та масового імпорту показують попередження про паралельні сесії перед підключенням. За замовчуванням імпортовані авторизації використовуються повторно. Залишайте оригінальний клієнт закритим, поки його ключ використовується тут. Files та Auth key також пропонують Створити незалежну авторизацію, описану нижче. Масовий імпорт все ще використовує прямий режим. Вхід за допомогою телефону та інтерактивного QR-коду створює окремі авторизації. Заголовок попередження залишається видимим у формі імпорту; його повне пояснення відкривається автоматично після введення файлів або рядка ключа/сесії. Його можна згорнути після прочитання, щоб на телефоні залишалися доступними елементи керування вибором файлів та підключенням.
Підтверджене розгортання (Phala Cloud, Intel TDX) не здійснює збір даних за імпортованим ключем. У цьому випадку файли та ключ авторизації пов’язуються лише за умови вибору опції Створити незалежну авторизацію; масовий імпорт не підтримується. Вхід за номером телефону та QR-кодом працює як зазвичай.
- Файли конвертуються в оперативній пам’яті на вашому сервері TgWitness. Завантажені дані не зберігаються, архіви ZIP не розпаковуються на диск, і не відбувається звернення до жодних зовнішніх сервісів.
- Отримані дані потім перевіряються за допомогою Telegram. Якщо у файлі вказано ідентифікатор користувача, він повинен збігатися з даними облікового запису, які надає Telegram.
- Файли, що описують різні облікові записи або різні облікові дані API, відхиляються, замість того, щоб вибрати один із них.
- Поле Пароль або Текст сесії містить локальне поле пароля TData, поле для вставлення StringSession та функцію Читати файли без входу (заповнює форму без звернення до Telegram). Вставлення StringSession очищає вибрані файли, а вибір файлів очищає вставлений текст, тому перевірка та підключення використовують останній вибір. Після зміни пароля натисніть Перевірити файли ще раз.
Створити незалежну авторизацію#
Виберіть Створити незалежну авторизацію перед підключенням імпортованих файлів або авторизаційного ключа. TgWitness короткочасно підключає імпортованого донора, використовує його для затвердження QR-токену входу нового клієнта та відключає донора одразу після затвердження. Новий клієнт має власний ключ авторизації та окремо обраний профіль для настільного комп’ютера . Надані донором облікові дані API та профіль пристрою використовуються лише для підключення донора. Жодна існуюча авторизація не виходить із системи та не скасовується.
Під час виконання цього кроку оригінальний клієнт донора має залишатися повністю закритим. Початкове з’єднання все ще використовує скопійований ключ, тому цей режим не може усунути ризик паралельного використання. Після встановлення нового авторизованого з’єднання власник може знову відкрити оригінальний клієнт і користуватися обома одночасно. Інтерактивний вхід за допомогою QR-коду дозволяє оригінальному клієнту затвердити вхід без копіювання або підключення свого ключа на цьому етапі.
Не виходите з системи та не закривайте сеанс донора. Коли сеанс, який затвердив вхід за QR-кодом,
завершується, Telegram також завершує сеанс, який він затвердив; під час тестування в реальному часі нова
авторизація припинилася протягом секунди після виходу донора з системи. Функція імпорту
реєструє сеанс донора (session_origin.approved_by: пристрій, ID API та час створення).
У списку сеансів вона позначається як Завершити сеанс — відхиляється, а опції Завершити всі інші сеанси
та Зробити цей сеанс єдиним залишають донора у системі.
Якщо Telegram вимагає двофакторної аутентифікації (2FA), цей режим використовує twoFA дані з вибраного JSON-файлу, якщо він є,
або запитує пароль. У разі відхилення імпортованого пароля відбувається повернення до форми введення пароля.
Паролі не зберігаються. Ключ-кандидат зберігається у зашифрованому вигляді в
independent_login.enc, включаючи зміни під час міграції між дата-центрами. Після
перерви виберіть того самого донора та цю опцію, щоб відновити збережений кандидатний ключ.
Донор перевіряється help.getAppConfig перед затвердженням; заблокований обліковий запис
зупиняється на цьому етапі. Якщо Telegram відхиляє донора перед затвердженням входу, незатверджений
кандидат-ключ відкидається, і імпорт можна розпочати знову. Інший донор замінює
збереженого кандидата лише тоді, коли Telegram повідомляє, що цей кандидат не ввійшов у систему;
кандидат, який увійшов у систему або очікує на свій пароль 2FA, зберігається.
Робоча область залишається зарезервованою для цього облікового запису; невдале завершення не призводить до видалення
нової робочої області. Збережіть її каталог даних та ключ сховища. Остаточні облікові дані та
account.authorized запис у журналі містять метод імпорту, формати вхідних даних та
ідентифікатор API донора, без ключа або пароля донора.
5 листопада 2026 року спеціальний обліковий запис пройшов перевірки в режимі реального часу з донорами Telethon, Pyrogram та TData: завершення 2-факторної автентифікації (2FA), унікальні нові ключі авторизації, одночасний доступ донора та нового клієнта, а також читання публічного каналу. У випадку з Telethon також було відновлено збережений варіант після переривання на етапі введення пароля. Кожна нова авторизація завершувала шість запитів на ініціалізацію після входу, а її підписаний журнал перевірявся. Початкова сесія залишалася придатною для використання у всіх чотирьох наданих форматах.
База даних помилок RPC Telegram пов’язує
FRESH_CHANGE_ADMINS_FORBIDDEN зі зміною адміністраторів, FRESH_CHANGE_PHONE_FORBIDDEN
зі зміною номера телефону, а FRESH_RESET_AUTHORISATION_FORBIDDEN з
скасуванням інших сесій, зміною їхнього терміну дії або реєстрацією пароля-ключа.
SESSION_TOO_FRESH_* та PASSWORD_TOO_FRESH_* стосуються передачі права власності та
виведення доходів або подарунків. Це не операції збору даних; новий вхід у систему
не означає загальної 24-годинної заборони на читання. Експорт може окремо повертати
TAKEOUT_INIT_DELAY_*. TgWitness зберігає паузи, запрошені сервером, і не повторює
прийняття токенів автоматично, а також не скасовує сесії для обходу обмежень.
Більше інструментів → Обліковий запис → Безпека облікового запису → Сесії цього облікового запису → Завершити всі інші сесії викликає auth.resetAuthorizations
на запит оператора та записує account.all_other_sessions_terminated із
кількістю сесій до та після. Telegram приймає це від сесії, яка була увійшла протягом 24 годин.
Коли цей робочий простір входить за допомогою QR-коду з імпортованої сесії, сесія, яка її затвердила,
залишається увійденною: TgWitness по черзі завершує інші за допомогою account.resetAuthorization та
записує kept_approving_session. Якщо це єдина сесія, то програма зупиняється з цієї причини
і не змінює пароль.
Зробіть так, щоб ця сесія виконувала те саме для ключа, створеного під час входу з цього робочого простору, а потім увімкніть двоступеневий пароль, якщо обліковий запис його не має. Панель показує цей пароль один раз; TgWitness зберігає його у сховищі робочого простору лише до цього моменту. Журнал фіксує session.exclusive_from. Якщо Telegram пізніше відобразить іншу сесію, журнал фіксує session.exclusive_ended , а панель видає попередження. Верифікатор виводить обидва записи.
Зробіть цю сесію єдиною, коли Telegram дозволяє виконувати одну й ту саму дію за таймером. Ця
опція з’являється в розділі Сесії цього облікового запису для ключа, створеного в цьому робочому просторі, і
записується як session.exclusive_automatic. Під час спостереження колектор кожні п’ять
хвилин перевіряє, чи минуло 24 годин з моменту запису account.authorized для цього ключа —
до цього Telegram відповідає FRESH_RESET_AUTHORISATION_FORBIDDEN — а потім виконує ту саму
операцію один раз. Успіх записується як session.exclusive_from, як і при натисканні кнопки вручну.
Відмова реєструється один раз як session.exclusive_postponed із зазначенням причини Telegram, і
колектор повторює спробу із зростаючою затримкою до шести годин. Режим тільки для читання тут не діє:
завершення сеансів є дією, пов’язаною з безпекою облікового запису, а не дією у чаті.
Двоступеневий пароль, згенерований під час автоматичного запуску, зберігається у сховищі робочого простору, зашифрований ключем робочого простору, ще до того, як Telegram його встановлює. Панель один раз отримує його з POST /api/account/sessions/only/password, після чого він видаляється, і відображає його в тому самому діалоговому вікні, що й під час ручного запуску, коли ви відкриваєте Сесії цього облікового запису. На сторінці підключення зазначається, що пароль очікує на введення. Він ніколи не потрапляє до журналу і зберігається після перезапуску, доки не буде показаний.
Під час спостереження також повідомляється про нові сесії: коли до списку сесій Telegram додається новий запис,
запис account.sessions фіксує його під added, а панель видає сповіщення із зазначенням
пристрою, додатка та країни з цього знімка.
Зонд-свідок#
Більше інструментів → Обліковий запис → Безпека облікового запису → Свідок перевіряє, чи отримує інший клієнт оновлення цього облікового запису. Додайте другий робочий простір, увійдіть у нього з іншим обліковим записом Telegram та власним сесійним ключем, створіть приватну групу з обома обліковими записами, потім виберіть цю групу як Чат для перевірки та другий робочий простір як Робочий простір свідка і увімкніть перевірку. Для обох облікових записів потрібно вимкнути режим Тільки для читання, а робочий простір свідка повинен перебувати в режимі спостереження.
Під час спостереження цей робочий простір надсилає probe:<n>:<token> у групу кожні 60–120 секунд
та фіксує probe.sent. Свідок відповідає ack:<n>:<token> та фіксує probe.seen і
probe.ack_sent. Підтвердження (ack), яке надходить у цю сесію як оперативне оновлення протягом 20 секунд,
фіксується як probe.acked. В іншому випадку робочий простір зчитує останню історію групи. Підтвердження
, знайдене там, але не доставлене в режимі реального часу, записується як coverage.gap з причиною
probe_ack_missed_live: панель генерує сповіщення та позначає прийом події як невдалий, доки
пізніше не надійде підтвердження в режимі реального часу (connection.restored, причина probe_ack_live). Відсутність підтвердження записується як
probe.unanswered; переривання з’єднання під час очікування або нечитабельна історія — як
probe.inconclusive. Режим тільки для читання, обмеження Telegram та паузи FloodWait записуються один раз
як probe.skipped.
Телемарафон .session#
| Що це таке | База даних SQLite, яку створюють інструменти на базі Telethon, наприклад my_account.session |
| Визнано | Таблиці sessions (разом із dc_id, server_address, port, auth_key) та version = 7 або 8 |
| Вимоги | Рівно один рядок авторизованої сесії; закрита, повна база даних |
Спочатку закрийте програму, яка створила файл. Якщо поруч із ним є файл my_account.session-journal або
my_account.session-wal, це означає, що база даних не завершена: відкрийте та
повністю закрийте оригінальний клієнт. Видалення цих супутніх файлів може призвести до пошкодження копії.
Pyrogram .session#
| Що це таке | База даних SQLite, яку створюють інструменти на основі Pyrogram |
| Визнано | Таблиця sessions з dc_id, auth_key, test_mode, user_id, is_bot; version = 2 або 3 |
| Вимоги | Допускається лише одна авторизована сесія користувача в робочій мережі. Сесії ботів та тестових DC відхиляються. |
Під час входу збережений ідентифікатор користувача перевіряється у Telegram.
Пара «сесія + JSON»#
Дані часто розповсюджуються у вигляді двох файлів з однаковою назвою, наприклад
447700900123.session та 447700900123.json. Виберіть обидва одночасно.
- На основі JSON TgWitness використовує
app_id/api_idтаapp_hash/api_hash, тому вам зазвичай не потрібно вводити облікові дані API. - Профіль з’єднання використовує
device_model(псевдонімdevice),system_version(псевдонімsdk),app_version,lang_code,system_lang_code(псевдонімsystem_lang_pack),lang_packта опціональнийtz_offset(секунди від UTC, від -43200 до 50400). Вказані поля мають пріоритет над згенерованими значеннями за замовчуванням та мовою панелі/браузера . Суперечливі псевдоніми відхиляються. Визначений профіль зберігається у зашифрованих облікових даних робочої області та повторно використовується після перезапуску, включаючи версію додатка. phone, налаштування проксі та токени пристроїв ігноруються.twoFAдоступний лише для читання, коли Створити незалежну авторизацію обрано; прямий імпорт ігнорує його.- JSON-файл без підтримуваного поля авторизації є лише метаданими. Додайте файл сесії або продовжуйте вхід за допомогою телефону чи QR-коду. JSON-файл, що містить підтримувану сесію або авторизаційний ключ, може авторизуватися самостійно; див. Account JSON.
Telegram Desktop (TData)#
TData — це папка tdata у програмі Telegram Desktop (кросплатформовий
додаток з desktop.telegram.org).
| Система | Стандартне розташування tdata |
|---|---|
| Windows | %APPDATA%\Telegram Desktop\tdata (портативний Telegram: поруч із Telegram.exe) |
| Linux | ~/.local/share/TelegramDesktop/tdata |
| macOS | ~/Library/Application Support/Telegram Desktop/tdata |
Щоб імпортувати його:
Попередження про паралельну сесію. Прямий імпорт TData повторно використовує ключ авторизації Telegram Desktop. Не використовуйте цей ключ одночасно в Desktop та TgWitness. Telegram може анулювати авторизацію за допомогою
AUTH_KEY_DUPLICATED, що зробить обидві копії непридатними для використання до нового входу в систему.Повністю закрийте Desktop, включаючи його процес у системному лотку, і тримайте цю копію закритою, поки TgWitness використовує імпортовану сесію. Закрийте програму, не виходите з системи та не скасовуйте сесію: скасування також робить імпортовану копію недійсною. Якщо вам потрібно, щоб обидва клієнти працювали, виберіть Створити незалежну авторизацію і тримайте Desktop закритим, доки не відбудеться успішний новий вхід, або увійдіть у TgWitness за допомогою телефону чи QR-коду. Рекомендується використовувати окремий обліковий запис, але це не робить клоновані ключі безпечними для паралельного використання.
Це також стосується імпортованих
.sessionфайли, текст StringSession та HEX-код ключа авторизації. Інші клієнти з власними, незалежно створеними авторизаціями, можуть залишатися у системі. Дивіться документацію Telegram щодо AUTH_KEY_DUPLICATED.
- Повністю закрийте Telegram Desktop.
-
Створіть ZIP-архів, що містить лише ці два елементи з
tdata:key_datas- 16-символьний файл із розширенням «
s», що знаходиться поруч, зазвичай «D877F783D5D3EF8Cs»
Стиснення всієї папки разом із кешем мультимедіа зазвичай перевищує обмеження (512 записів, 32 МіБ у розпакованому вигляді). 3. Виберіть ZIP-файл у розділі «Файли». Якщо у Telegram Desktop встановлено локальний пароль, спочатку введіть його у полі «Пароль» або «Текст сеансу». Це не пароль 2FA.
Підтримується: один обліковий запис на архів, сучасне сховище key_datas/key_data0/key_data1,
локальний пароль. Не підтримується: папки з кількома обліковими записами, що ввійшли в систему, старі версії
десктопного додатка, ZIP-архіви, захищені паролем, та окремий нативний додаток для macOS «Telegram для macOS».
Telethon StringSession#
Один рядок тексту, який зазвичай починається з 1 і має довжину близько 350 символів. Завантажте
його як файл .txt або .tgwitness-session (максимум 4 Кбайт) або вставте його в поле
«Пароль» або «Текст сеансу». Приймаються лише рядки у форматі Telethon; рядки у форматах Pyrogram та TDLib
мають інші формати.
Ключ автентифікації та DC в одному рядку#
Списки облікових записів часто містять необроблені дані авторизації у форматі <512 hexadecimal characters>:<DC id>,
наприклад, a1b2…ef:5. Вставте цей рядок у поле Пароль або Текст сеансу, завантажте його як
текстовий файл або введіть у поле session JSON-файлу облікового запису. TgWitness
прив’язує DC 1–5 до тих самих виробничих адрес, що й при імпорті JSON-файлу auth_key + dc_id, та
повідомляє формат як Auth key HEX та DC. Будь-який інший номер DC або довжина ключа відхиляються.
JSON-файл облікового запису#
Один об’єкт JSON, розміром не більше 64 Кбайт, у файлі з розширенням .json.
| Поле (псевдоніми) | Значення |
|---|---|
api_id (app_id) |
Ідентифікатор додатка — додатне число |
api_hash (app_hash) |
Хеш додатка, 32 шестнадцяткові символи |
string_session (session_string, session_str; застарілий session) |
Текст Telethon StringSession або <512 hexadecimal characters>:<DC id>, а не ім’я файлу |
auth_key (auth_key_hex) + dc_id |
Повний ключ автентифікації довжиною 512 символів та DC 1–5 |
user_id (id) |
Необов’язково; перевіряється у Telegram перед збереженням авторизації |
device_model (device) |
Опис пристрою підключення |
system_version (sdk) |
Версія ОС, з якою встановлено з’єднання |
app_version |
Версія додатка, надіслана до Telegram |
lang_code, system_lang_code (system_lang_pack), lang_pack |
Мова клієнта, мова системи та мовний пакет клієнта; допускається порожнє значення lang_pack |
tz_offset |
Необов’язкове зміщення від UTC у секундах, що надсилається у полі initConnection.params; цілочисельний або десятковий цілочисельний рядок |
Якщо присутні як псевдонім, так і основна назва, вони повинні збігатися. Явні поля сесії Telethon
мають пріоритет над загальним блобом session в іншому форматі. Якщо
обидва містять впізнавані сесії Telethon, вони повинні описувати одну й ту саму авторизацію.
Без явного поля session має бути дійсною Telethon StringSession або ключем авторизації
та DC у форматі <512 hexadecimal characters>:<DC id>. Приклади:
{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }
{
"api_id": 1234567,
"api_hash": "0123456789abcdef0123456789abcdef",
"auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
"dc_id": 2,
"user_id": 123456789
}
У першому прикладі заповнюються лише облікові дані API; увійдіть за допомогою телефону або QR-коду, або додайте файл сеансу. Масові списки (масив JSON з обліковими записами) не приймаються.
Визначте, що у вас є#
| Ви бачите | Це | Використання |
|---|---|---|
*.session; при відкритті у текстовому редакторі у верхній частині відображається SQLite format 3 |
Telethon або Pyrogram SQLite | Файли (виявляються автоматично) |
Папка «tdata», що містить «key_datas» |
Telegram Desktop TData | Стиснути два файли у ZIP, потім «Файли» |
Один рядок тексту, що починається з 1, приблизно 350 символів |
Telethon StringSession | Файли |
Один рядок тексту 512 characters 0-9a-f, потім : та цифра 1–5 |
Ключ автентифікації та DC | Файли, код доступу до скриньки або текст сеансу |
*.json з app_id/app_hash |
Супровідні метадані | Файли разом із сесією |
*.json з auth_key або string_session |
JSON-файл облікового запису | Файли |
512 символів 0-9a-f |
Ключ автентифікації | Ключ автентифікації |
32 символи 0-9a-f |
Хеш API | Ідентифікатор API + хеш |
td.binlog або db.sqlite із додатка TDLib |
Хранилище TDLib | Не підтримується |
123456789:AA… |
Токен бота | Не підтримується |
Непідтримувані формати#
| Формат | Альтернатива |
|---|---|
Сховище TDLib (td.binlog) та експорт даних TDLib |
Увійдіть за допомогою телефону або QR-коду |
| Строки сеансів Pyrogram | Використовуйте файл Pyrogram .session або телефон/QR-код |
| TData з кількома обліковими записами, що ввійшли в систему | Вийдіть з інших облікових записів у Telegram Desktop або використовуйте власний файл сеансу кожного облікового запису |
| Токени ботів | Не підтримується: TgWitness здійснює спостереження як обліковий запис користувача |
| Списки багатьох акаунтів у форматі CSV/JSON | Імпортуйте підтримувані файли сесій через Облікові записи → Імпорт облікових записів або увійдіть за номером телефону / QR-кодом в окремих робочих просторах |
| Test-DC або сесії ботів | Використовуйте робочий обліковий запис користувача |
Кілька облікових записів#
Натисніть + поруч із селектором облікового запису або відкрийте Більше інструментів → Обліковий запис → Налаштування → Налаштування з’єднання → Робочі простори, введіть назву та увійдіть.
- Необмежена кількість робочих просторів, включаючи основний. Кожен має власну сесію, проксі- маршрут, джерела, політику збору даних, журнал, ключ підпису, контрольні точки та експортні файли.
- Перемикання між робочими просторами не призупиняє роботу інших.
- Журнал залишається прив’язаним до облікового запису, з якого його було створено. Для входу з іншого облікового запису потрібно створити інший робочий простір, а один обліковий запис не можна прив’язати до двох робочих просторів.
- Токен головної панелі керує всіма робочими просторами. Наданий доступ дозволяє обмежити доступ інших користувачів до вибраних акаунтів та чатів із окремими правами доступу та обмеженнями сеансів.
- Функція «Акаунти» перейменовує робочу область та видаляє додану робочу область разом із її сесією, журналом, джерелами та ключем підпису. Головну робочу область неможливо видалити з панелі.
Масовий імпорт і групи акаунтів#
Скористайтеся меню «Акаунти» → «Імпортувати акаунти», щоб додати кілька акаунтів, зіставити файли за базовим іменем та переглянути результати входу для кожного з них. Кожен акаунт отримує власний робочий простір.
Група об’єднує пов’язані акаунти, не об’єднуючи їхні сесії, ключі чи
докази. Натиснувши «Відкрити групу» у розділі «Акаунти», ви перейдете на її сторінку за адресою /groups/<id>:
- Облікові записи: маршрут підключення кожного учасника, спостереження та останнє повідомлення, з функціями «Запустити все» та «Призупинити все».
- Потребує уваги: акаунти, з яких вийшли, які недоступні або мають проблеми з підключенням, введенням даних, джерелом чи медіафайлами; кожне ім’я веде до відповідної картки.
- У чатах, які переглядають кілька облікових записів, відображаються: спільні джерела, облікові записи, що їх переглядають, та перерви в періоді спостереження за робочим простором (до семи днів). Експорт із N обліковими записами розподіляє експорт каналу або супергрупи між ними та підписує один архів.
- Експорт групи: один елемент ZIP, у якому міститься підписаний експорт кожного облікового запису під
accounts/таmanifest.jsonпереліком їхніх SHA-256 та відбитків ключів, підписаних головним робочим простором уmanifest.signature.json. Перевіряйте архів кожного облікового запису окремо за допомогоюpython -m tgwitness.verifyта перевіряйте його за допомогою надійного відбитка цього облікового запису.
Учасники використовують спільні налаштування групи; кожен обліковий запис може зберігати власні значення. Дивіться розділ «Спільні налаштування», посібник з імпорту та груп та панель управління пулом MTProxy.
Вийти#
Додаткові інструменти → Обліковий запис → Вийти з Telegram (з призупиненим спостереженням) надсилає Telegram запит на завершення сеансу, тому він також зникає з розділу Налаштування → Пристрої облікового запису та видаляє сеанс із сховища робочого простору. Журнал, джерела, налаштування та ключ підпису залишаються, а журнал фіксує вихід. Робоча область все ще належить своєму обліковому запису: лише цей обліковий запис може знову підключитися до неї. Якщо Telegram не відповідає, сесія все одно видаляється тут, і панель повідомляє про це; завершіть її в Telegram у розділі Налаштування → Пристрої.
Коли Telegram завершує сеанс#
Якщо Telegram заблокує, заморозить або вийде з облікового запису, або завершить сеанс з іншого пристрою, у
журналі фіксуються причина, помилка Telegram, маршрут та центр обробки даних. Стан облікового запису
відображається у звіті про втрату облікового запису: підписаний файл у форматі JSON із записами журналу
за 24 години до втрати, а саме: підключення, маршрути, сеанси, повідомлення облікового запису та прогалини
у покритті, кожне з яких має хеш журналу та підпис. Перевірте це за допомогою
python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP; експорт доказів
містить повний ланцюжок хеш-кодів. Заблокований обліковий запис також виявляється під час підключення та спостереження, а його
дії з відправлення та приєднання вимикаються.
Забезпечення безпеки файлів облікових записів#
- Ставтеся до кожного
.session, TData ZIP, StringSession, Auth Key та JSON-файлу облікового запису як до пароля. TgWitness зберігає імпортовані дані авторизації у своєму зашифрованому сховищі; ви можете пізніше видалити оригінальні файли. - Не використовуйте одну й ту саму авторизацію одночасно у двох програмах. Telegram може її скасувати
(
AUTH_KEY_DUPLICATED), і обидві копії перестануть працювати. - Сесія, термін дії якої закінчився або яка була скасована, не може бути відновлена шляхом конвертації. Увійдіть знову.
Усунення несправностей#
| Повідомлення або ознака | Що робити |
|---|---|
| Неможливо прочитати цю сесію. Закрийте оригінальний клієнт… | Файл SQLite відкритий або незавершений (додатковий файл -journal/-wal). Належним чином закрийте вихідну програму та скопіюйте файл ще раз. |
| Підтримувані схеми Telethon SQLite: 7 та 8 / Pyrogram … 2 та 3 | Файл було створено за допомогою дуже старої або невідомої версії бібліотеки. Замість цього увійдіть за допомогою телефону/QR-коду. |
| Підтримуються лише авторизовані сесії користувачів у виробничому середовищі | Файл Pyrogram належить боту або тестовій мережі. |
| Архів TData перевищує 512 записів або 32 МіБ | У ZIP-файлі мають бути лише файли key_datas та D877F783D5D3EF8Cs, а не вся папка. |
| Неможливо розшифрувати TData. Перевірте локальний пароль на робочому столі | Введіть локальний пароль Telegram Desktop у полі «Пароль» або «Текст сеансу». |
| Імпортуйте по одному обліковому запису TData за раз | У Telegram Desktop було кілька облікових записів; див. розділ «Непідтримувані формати». |
| Вибрані файли містять опис різних облікових записів або облікових даних API | Вибирайте файли лише з одного облікового запису. |
| JSON не містить жодних облікових даних або авторизаційних даних для підтримуваних API | Перевірте назви полів у JSON-файлі облікового запису. |
| Лише метадані API | У JSON немає сесії. Додайте файл .session або скористайтеся номером телефону/QR-кодом. |
| HEX-код авторизаційного ключа повинен містити всі 512 шістнадцяткових символів | Ключ є урізаним або містить …. |
| Ідентифікатор облікового запису не збігається з імпортованим обліковим записом | Ідентифікатор користувача у файлі відрізняється від того, що вказує Telegram; файл належить іншому обліковому запису. |
| Цей обліковий запис уже належить іншому робочому простору | Відкрийте цю робочу область замість того, щоб додавати обліковий запис двічі. |
| Підключено, але у списку чатів у розділі Додаткові інструменти → Джерела відсутня приватна група. | Перевірте членство. Вибірник перевіряє перші 1,000 діалогів; збільште обмеження в розділі Додаткові інструменти → Параметри. |
| Помилка підключення через проксі | Перевірте режим маршрутизації та IP. Автоматичний MTProxy пробує інший робочий запис. «Hide the address» очікує; «Direct» як крайній захід може встановити з’єднання безпосередньо після налаштованої затримки. Див. режими маршрутизації. |
Див. також: підключення та безпека проксі-серверів і шифрування, а також як відбувається збір даних після входу в систему.