Telethon 的 Telegram Session 是密钥,不是应用程序
Telegram Telethon 会话是一个授权密钥(通常是 .session SQLite 文件或 StringSession 字符串),而不是一个 Telegram 应用程序窗口。它让你的 Python 客户端能以用户身份使用 MTProto。如果你双击文件时期望看到一个聊天列表,那么你订购了错误的格式。如果你需要 get_me() 返回一个用户对象,这才是你所需要的产品。
本指南面向已经(或将要)运行 Telethon 的开发者和运营者,他们希望从自有库存中获得 Session 交付,并需要清晰的实时测试和更换途径。产品目录是 Telegram 账号。关于现成号、新号和老号的更广泛说明,请阅读 购买 Telegram 现成账号。
核心要点
- Telethon 会话是授权密钥文件或 StringSession,不是一个桌面应用窗口。
- 在 Telegram 账号 页面选择 Session (Telethon);库存相同,交付格式不同。
- 实时测试:使用你的
api_id/api_hash连接,然后调用get_me()。- 测试通过后更改两步验证密码;将密钥的每一个额外副本都视为一个安全漏洞。
- 失效密钥 (
AuthKeyUnregistered,错误的手机号) 属于更换范畴,而不是让你自己去编辑 SQLite 文件。
究竟什么是 Telethon 会话?
Telethon 会话是你的 Python 客户端用来以用户身份与 MTProto 协议通信的授权密钥。当你构建类似 TelegramClient('anon') 的实例并完成登录后,Telethon 会创建它。之后,这个文件本身就代表了登录状态。
一个典型的 .session 文件内部包含了一些枯燥但至关重要的部分:要连接的数据中心、加密流量以便 Telegram 将该进程视为对应用户的授权密钥,以及客户端见过的实体的缓存。这个缓存可能会使文件比“一个微小的密钥”大,但并不会将其变成可读的聊天记录导出文件。不要试图打开 SQLite 文件寻找消息。实时测试是通过连接来验证的。
StringSession 是以文本形式编码的相同密钥。它在文件系统是临时的机器上很方便,但也更容易泄露。任何拥有该字符串的人都可以作为该用户登录。请将字符串保存在密钥存储中,而不是代码仓库里。一次实时登录在导出时可能变成两个密钥;请计算好副本数量。
机器人令牌 (bot token) 是第三种东西:一个用于 Bot API 的 HTTP 密钥。它不是用户会话。如果你的测试需要一个用户点击“开始”按钮,你需要的是用户会话。如果你的测试需要机器人做出回应,你需要的是机器人令牌。
如何在 TgFather 上购买 Session / Telethon 交付格式?
在 TgFather 上,你可以在与 TData 相同的自有账号目录中选择 Session (Telethon) 交付格式。打开 Telegram 账号,选择 Session,然后选择国家和年份范围。当钱包扣款后,交付是即时的。下载链接是通过签名的、会过期的链接提供的。
你购买的是一种交付格式,而不是一种不同类型的账号。如果你的代码使用 Telethon,就选择 Session。如果需要人工操作 Telegram Desktop,就选择 TData。如果你想在自己控制的客户端中输入验证码登录,就选择接收实时登录验证码。选择一个听起来“很专业”但对你的使用场景来说是错误的格式,仍然是错误的选择。
如果交付的会话在 get_me() 测试中失败,这是一个需要更换的情况,而不是关于 SQLite 布局的争论。在你将密钥用于生产任务之前,请务必运行你自己的测试。
是否应该在选择国家之前先选择 Session 格式?
是的:先确定交付格式,然后再选择国家和年份范围。打开 Telegram 账号,选择 Session (Telethon),选择国家和年份范围,然后预订一个你可以在当天进行测试的位置。
你应该运行什么样的实时测试?
在你信任文件之前,请使用你自己的 api_id 和 api_hash 运行一次真实的连接和 get_me() 测试。不要因为文件扩展名是 .session 就信任它。不要因为一个字符串很长就信任它。
你期望的结果是:
- 连接成功。
- 返回一个用户对象。
- 用户 ID 和手机号与你认为购买的账号相匹配。
个性化的用户名可以更改,但用户 ID 不会。用户名不匹配是一个需要联系客服的问题。手机号不匹配则意味着是另一个人。
失败模式:
- 无法连接:不是一个有效的会话。
- 连接成功,但要求输入你没有收到的云端密码:缺少第二把锁。
AuthKeyUnregistered:文件中的密钥已不再被注册。这是一个纪念品。请要求更换,不要手动编辑 SQLite 文件。
get_me() 证明密钥仍然可以通信,但它并不能证明账号的“年份和活跃度”。测试通过后,设置或更改两步验证密码。云端密码可以锁定新的登录,但它无法清除已经泄露出去的会话文件。如果会话附带了云端密码,请更改它。不要重复使用你个人 Telegram 账号的密码。
Telethon、StringSession、TData 和机器人令牌的对比
Telethon 会话文件和 StringSession 是用户密钥;TData 是桌面版;机器人令牌是用于 Bot API 的。在付款前,请确保格式与你的使用场景相匹配。
Telethon .session |
StringSession | TData | 机器人令牌 (Bot token) | |
|---|---|---|---|---|
| 它是什么 | 包含授权密钥和缓存的 SQLite 文件 | 与密钥相同的文本格式 | Telegram Desktop 工作目录 | 用于机器人的 HTTP 密钥 |
| 如何打开它 | Telethon | Telethon | Telegram Desktop | Bot API / 任何 HTTP 客户端 |
| 看起来像应用吗? | 否 | 否 | 是,在桌面上 | 否 |
| 实时测试 | 连接 + get_me() |
连接 + get_me() |
在设置中显示手机号 | 在 Bot API 上调用 getMe |
| 如何看待它 | 一个密码 | 一个易于粘贴的密码 | 一个文件夹形式的密码 | 一个密码 |
Telethon 和 Pyrogram 都使用 MTProto 协议,并且都会生成“会话”。但它们的文件并不兼容。不要将 Telethon 的 .session 文件提供给 Pyrogram 客户端。不要将 Pyrogram 的字符串粘贴到 StringSession 中。如果你的项目使用 Pyrogram,请购买或生成 Pyrogram 会话。那些只说“会话”而没有指明库的列表会浪费你的时间。
你应该如何安全地存储和使用密钥?
像存储密码一样存储会话文件或字符串:不要粘贴、不要提交到代码库、不要随意复制。任何拥有密钥的人,无论在哪里运行客户端,都以该用户的身份登录了。
实用规则:
- 不要为了“检查一下”就把它粘贴到群组里。
- 不要将它提交到代码库。
- 两台机器上有两个副本就等于两个密钥。
- 如果你在 Telegram 的设备列表中撤销了错误的行,下一次
get_me()将会因AuthKeyUnregistered而失败。 - 第一次成功运行
get_me()后,就不要再乱动了。将文件放在进程可以读取的地方。将每一个额外的副本都视为一个安全漏洞。
合法的应用场景包括:需要真实用户与机器人对话的测试工具、根据用户请求提取聊天记录的支持脚本、用于 Mini App 的临时收件箱。购买凭证并不意味着你可以免于因发送未经请求的批量消息而受到的处罚。
需要一个面向人工操作的桌面端席位?请在 购买 Telegram 现成账号 中比较不同格式。需要一个机器人身份而不是用户密钥?请参阅 Telegram 老机器人。
在哪里购买,更换政策涵盖哪些内容?
在 TgFather 购买 Session 交付的账号;更换政策涵盖失效的密钥,但不包括因密钥存储不当造成的问题。从 Telegram 账号 开始:选择 Session (Telethon)、国家和年份范围。从钱包支付。从签名链接下载。运行 get_me()。更改云端密码。只有在密钥被证明有效后才开始构建你的项目。
一个失效的密钥(AuthKeyUnregistered、错误的手机号、承诺提供但缺失的两步验证密码)在我们自有库存上属于更换范畴,而不是一个“会话就是这样”的争论。请使用你自己的 api_id / api_hash 和你自己的密钥存储方案。我们的目录负责交付格式;交付后的安全卫生由你的流程负责。
一个 Telegram 会话 就是那个授权密钥。Telethon 是向 Telegram 发出请求的 Python 库。如果你搜索的是 Telethon 交付,你购买的仍然是一个文件(或字符串),而不是一个应用程序窗口。
当你准备好时:购买带 Session 交付的 Telegram 账号。
常见问题
Telethon 中的 stringsession 是什么?
StringSession 是将你的授权密钥编码为单行文本,而不是存储在 .session 文件中。它包含相同关键信息,如数据中心和授权密钥。这种格式对于文件系统是临时的环境很方便。然而,因为它只是文本,所以更容易被意外泄露。你应该将 StringSession 存储在密钥管理器中,而不是直接放在你的代码仓库里。
我可以从 .session 文件中读取聊天记录吗?
不可以,你不能直接从 .session 文件中读取你的聊天记录。该文件是一个 SQLite 数据库,其中包含你的授权密钥和客户端见过的实体的缓存,而不是消息导出文件。如果你需要访问消息,你必须使用该会话通过一个有效的 Telethon 客户端连接到 Telegram 的服务器来获取它们。不要尝试打开文件寻找消息。
我购买的会话需要使用自己的 api id 吗?
是的,当你使用购买的 Telethon 会话连接时,必须使用你自己的 api_id 和 api_hash。会话文件本身只是用户授权密钥,而 API 凭证则向 Telegram 标识你的特定应用程序。验证新会话的实时测试要求你使用自己的 API 详细信息进行连接。这证明了密钥可以通过你的应用程序实例代表用户进行通信。
我应该在新会话上更改云端密码吗?
是的,在确认会话有效后,你应该立即更改两步验证密码(也称为云端密码)。云端密码可以锁定新的登录尝试,增加一层安全性。如果会话附带了密码,请将其更改为一个只有你自己知道的密码。这有助于保护账号,防止任何其他可能接触过原始凭证或会话文件的人访问。