Сессия Telegram для Telethon: это ключ, а не приложение
Сессия Telegram для Telethon — это ключ авторизации (обычно файл .session формата SQLite или строка StringSession), а не окно приложения Telegram. Он позволяет вашему Python-клиенту обращаться к MTProto от имени пользователя. Если вы дважды кликаете по файлу в ожидании увидеть список чатов, вы заказали не тот формат. Если же вам нужно, чтобы get_me() вернул объект пользователя, то это именно тот продукт.
Это руководство предназначено для разработчиков и операторов, которые уже используют (или планируют использовать) Telethon, хотят получать сессии из готового инвентаря и нуждаются в четком методе проверки и правилах замены. Каталог находится здесь: аккаунты Telegram. Чтобы разобраться в терминах «готовый», «свежий» и «отлежавшийся», прочтите статью о готовых аккаунтах Telegram.
Ключевые моменты
- Сессия Telethon — это файл ключа авторизации или StringSession, а не окно десктопного приложения.
- Выбирайте Session (Telethon) на странице аккаунтов Telegram; инвентарь тот же, отличается только формат доставки.
- Проверка в реальном времени: подключитесь со своими
api_id/api_hash, затем вызовитеget_me().- После успешной проверки смените двухфакторную аутентификацию; рассматривайте каждую лишнюю копию ключа как уязвимость.
- Нерабочие ключи (
AuthKeyUnregistered, неверный телефон) — это повод для замены, а не для редактирования SQLite.
Что именно представляет собой сессия Telethon?
Сессия Telethon — это ключ авторизации, который ваш Python-клиент использует для взаимодействия с MTProto от имени пользователя. Telethon создает его, когда вы конструируете что-то вроде TelegramClient('anon') и завершаете вход. После этого файл сам по себе является логином.
Внутри типичного файла .session находятся простые, но критически важные данные: дата-центр для подключения, ключ авторизации, шифрующий трафик (чтобы Telegram считал процесс этим пользователем), и кеш сущностей, которые клиент уже видел. Кеш может делать файл больше, чем «крошечный ключ», но не превращает его в читаемый экспорт чатов. Не открывайте SQLite в поисках сообщений. Единственный надежный тест — это живое подключение.
StringSession — это тот же ключ, но закодированный в виде текста. Это удобно на машинах, которые удаляют свою файловую систему. Но его легче скомпрометировать. Любой, у кого есть эта строка, может войти в систему как этот пользователь. Храните строки в менеджере секретов, а не в репозитории. Один живой логин может превратиться в два ключа при экспорте; считайте копии.
Токен бота — это третий тип объекта: HTTP-секрет для Bot API. Это не сессия пользователя. Если для вашего теста нужно, чтобы пользователь нажал «Старт», вам нужна сессия пользователя. Если нужно, чтобы бот ответил, вам нужен токен.
Как купить доставку в формате Session / Telethon на TgFather?
На TgFather вы выбираете доставку в формате Session (Telethon) в том же каталоге аккаунтов, что и TData. Откройте аккаунты Telegram, выберите Session, затем страну и возраст. Доставка происходит мгновенно после списания средств с кошелька. Загрузки доступны по подписанным, истекающим ссылкам.
Вы покупаете формат доставки, а не другой вид аккаунта. Выбирайте Session, потому что ваш код написан на Telethon. Выбирайте TData, если за Telegram Desktop будет сидеть человек. Выбирайте код для входа, если хотите ввести его в клиенте, который контролируете вы. Неправильный формат, который «звучит серьезно», все равно остается неправильным для вашей задачи.
Если get_me() завершается ошибкой на полученной сессии, это случай для замены, а не для споров о структуре SQLite. Проведите собственный тест, прежде чем строить рабочие процессы на основе этого ключа.
Стоит ли выбирать формат Session до выбора страны?
Да: сначала определитесь с форматом доставки, а затем выбирайте страну и возраст. Откройте аккаунты Telegram, выберите Session (Telethon), укажите страну и возраст, и зарезервируйте слот, который сможете протестировать в тот же день.
Какой тест работоспособности следует провести?
Проведите реальное подключение с вызовом get_me(), используя ваши собственные api_id и api_hash, прежде чем доверять файлу. Не доверяйте файлу только потому, что у него расширение .session. Не доверяйте строке только потому, что она длинная.
Вам нужно получить:
- Успешное соединение.
- Возвращенный объект пользователя.
- ID пользователя и телефон, соответствующие аккаунту, который вы, как вы думали, купили.
Пользовательское имя (username) может меняться. ID — никогда. Несовпадение юзернейма — повод обратиться в поддержку. Несовпадение телефона — это другой аккаунт.
Возможные ошибки:
- Не удается подключиться: сессия неактивна.
- Подключается, но требует облачный пароль, который вам не предоставили: отсутствует вторая блокировка.
AuthKeyUnregistered: ключ в файле больше не зарегистрирован. Это сувенир. Запросите замену; не пытайтесь редактировать SQLite вручную.
Вызов get_me() доказывает, что ключ все еще может работать. Он не доказывает «отлежавшийся образ жизни». После успешной проверки установите или измените двухэтапную аутентификацию. Облачный пароль блокирует новые входы, но не удаляет уже существующие файлы сессий. Если облачный пароль был предоставлен вместе с сессией, смените его. Не используйте пароль от своего личного Telegram.
Telethon, StringSession, TData или токен бота: что выбрать?
Файлы сессий Telethon и StringSession — это ключи пользователя; TData — это для Telegram Desktop; токен бота — для Bot API. Подбирайте формат под свою задачу, прежде чем платить.
Telethon .session |
StringSession | TData | Токен бота | |
|---|---|---|---|---|
| Что это | Файл SQLite с ключом авторизации + кешем | Тот же ключ в виде текста | Рабочая директория Telegram Desktop | HTTP-секрет для бота |
| Чем открывается | Telethon | Telethon | Telegram Desktop | Bot API / любой HTTP-клиент |
| Выглядит как приложение? | Нет | Нет | Да, на десктопе | Нет |
| Тест работоспособности | Подключение + get_me() |
Подключение + get_me() |
Настройки показывают номер | getMe через Bot API |
| Относитесь как к | Паролю | Паролю, который легко скопировать | Паролю в папке | Паролю |
И Telethon, и Pyrogram работают с MTProto и оба создают «сессии». Но их файлы не взаимозаменяемы. Не пытайтесь использовать .session от Telethon в клиенте Pyrogram. Не вставляйте строку Pyrogram в StringSession. Если ваш проект на Pyrogram, покупайте или генерируйте сессию Pyrogram. Объявления, в которых указано просто «сессия» без упоминания библиотеки, — это пустая трата вашего времени.
Как безопасно хранить и использовать ключ?
Храните файл сессии или строку как пароль: никаких копипастов, коммитов в репозиторий и случайных копий. Любой, у кого есть ключ, залогинен как этот пользователь оттуда, где он запускает клиент.
Практические правила:
- Не вставляйте его в групповой чат «просто для проверки».
- Не коммитьте его в репозиторий.
- Две машины с двумя копиями — это два ключа.
- Если вы отзовете не ту строку в списке устройств Telegram, следующий вызов
get_me()завершится ошибкойAuthKeyUnregistered. - После первого успешного вызова
get_me()прекратите эксперименты. Поместите файл туда, где процесс сможет его прочитать. Рассматривайте каждую лишнюю копию как уязвимость.
Легитимные сценарии использования: тестовый стенд, где реальный пользователь общается с ботом, скрипт поддержки, который извлекает чат по запросу человека, или тестовый ящик для Mini App. Квитанция об оплате не дает права на несанкционированные массовые рассылки.
Нужен аккаунт для человека, работающего в Desktop? Сравните форматы в статье о готовых аккаунтах Telegram. Нужен хэндл бота, а не ключ пользователя? Смотрите статью про отлежавшихся ботов Telegram.
Где покупать и что покрывает замена?
Покупайте доставку в формате Session на аккаунтах TgFather; замена покрывает нерабочие ключи, а не ошибки с хранением секретов. Начните со страницы аккаунтов Telegram: выберите Session (Telethon), страну и возраст. Оплатите с кошелька. Загрузите по подписанной ссылке. Запустите get_me(). Смените облачный пароль. Приступайте к работе только после того, как ключ докажет свою работоспособность.
Нерабочий ключ (AuthKeyUnregistered, неверный телефон, отсутствующая 2FA, которую вам обещали) — это повод для замены в рамках купленного инвентаря, а не для спора о том, что «сессии такими и бывают». Используйте свои собственные api_id / api_hash и свой собственный менеджер секретов. Каталог предоставляет формат; ваш процесс отвечает за гигиену после доставки.
Сессия Telegram — это именно ключ авторизации. Telethon — это Python-библиотека, которая задает вопрос Telegram. Если вы искали доставку для Telethon, вы все равно купили файл (или строку), а не окно приложения.
Когда будете готовы: купить аккаунты Telegram с доставкой в формате Session.
Часто задаваемые вопросы
Что такое StringSession в Telethon?
StringSession — это ваш ключ авторизации, закодированный в одну текстовую строку, вместо хранения в файле .session. Он содержит ту же критически важную информацию, например, дата-центр и ключ авторизации. Этот формат удобен для сред, где файловая система является временной. Однако, поскольку это просто текст, его легче случайно скомпрометировать. Хранить StringSession следует в менеджере секретов, а не прямо в коде вашего репозитория.
Могу ли я прочитать историю чатов из файла .session?
Нет, вы не можете прочитать историю чатов непосредственно из файла .session. Файл представляет собой базу данных SQLite, которая содержит ваш ключ авторизации и кеш сущностей, которые видел ваш клиент, а не экспорт сообщений. Если вам нужен доступ к сообщениям, вы должны использовать сессию с работающим клиентом Telethon для подключения к серверам Telegram и их получения. Не пытайтесь открыть файл в поисках сообщений.
Нужен ли мне собственный API ID для купленной сессии?
Да, вы должны использовать свои собственные api_id и api_hash при подключении с купленной сессией Telethon. Сам файл сессии — это просто ключ авторизации пользователя, в то время как учетные данные API идентифицируют ваше конкретное приложение для Telegram. Тест для проверки новой сессии требует подключения с использованием ваших собственных данных API. Это доказывает, что ключ может работать от имени пользователя через ваш экземпляр приложения.
Стоит ли менять облачный пароль на новой сессии?
Да, вам следует сменить пароль двухэтапной аутентификации, также известный как облачный пароль, сразу после подтверждения работоспособности сессии. Облачный пароль блокирует новые попытки входа, добавляя уровень безопасности. Если пароль был предоставлен вместе с сессией, смените его на тот, который знаете только вы. Это поможет защитить аккаунт от всех, кто мог иметь доступ к исходным учетным данным или файлу сессии.