工具简介
Session / TData 格式互转 帮助您在 StringSession 文本 与 tdata 压缩包 之间双向转换,无需登录 Telegram。
访问:tele.xiaohutou.top → 顶部 格式互转 Tab
工具能做什么
| 输入 | 输出 |
|---|---|
| Session 文本(文件或粘贴) | tdata ZIP(含 tdata/ 目录) |
| 含 tdata 的 ZIP | Session 文本文件 |
系统按文件内容自动识别类型,不看文件名(a.txt、data.zip 均可)。
关于 TData
TData 是 Telegram Desktop 客户端用来保存登录状态的本地数据目录,不是单个文件,而是一组密钥与配置文件的集合。互转工具处理的是「可导入 Telegram Desktop 的 tdata 目录」,而不是 Telegram 安装目录下的其他数据。
TData 目录里通常有什么
有效的 tdata 目录至少包含以下特征之一(服务端据此判断 ZIP 是否合法):
| 特征 | 说明 |
|---|---|
key_datas | 常见密钥数据文件,位于 tdata 目录内 |
D877F783D5… 开头文件 | Telegram Desktop 账号映射相关文件(前缀固定,后缀因账号而异) |
Session → tdata 成功后,下载的 ZIP 解压结构为:
converted_tdata.zip
└── tdata/
├── key_datas
├── D877F783D5D3EF8C… (示例,实际文件名因账号而异)
└── …可将解压后的 tdata 文件夹用于 Telegram Desktop 导入/替换本地 tdata(具体操作因客户端版本而异,请自行备份原数据)。
上传 tdata 时应如何打包 ZIP
上传 ZIP 压缩包 即可触发 tdata → Session,无需关心压缩包叫什么名字。以下打包方式均可识别:
| 打包方式 | ZIP 内路径示例 | 是否支持 |
|---|---|---|
| 只压缩 tdata 文件夹 | tdata/key_datas、tdata/D877… | 支持 |
| 压缩 Session 制作导出的账号目录 | 8613988881111/tdata/key_datas | 支持(会自动在解压目录中查找 tdata) |
| ZIP 内任意层级含 tdata | backup/xxx/tdata/… | 支持(递归查找名为 tdata 且内容合法的目录) |
仅有 key_datas 但不在 tdata 目录名下 | some_folder/key_datas | 支持(按 marker 定位目录) |
请勿上传
- 加密 ZIP(带密码的压缩包)
- 不含 tdata 或 key_datas 的普通 ZIP(如仅含 session.txt 的制作包需走「粘贴 Session」而非当 tdata 上传)
- 损坏、空 ZIP 或体积超过服务端上限(默认单文件 20MB)
与 Session 制作导出的 tdata 有何不同
| Session 制作下载的 ZIP | 格式互转 Session → tdata | |
|---|---|---|
| 内容 | session.txt + account.json + tdata/ | 仅 tdata/ 目录 |
| 用途 | 一次拿齐三种文件 | 只要 Desktop 可用的 tdata |
| 来源 | 在线登录 Telegram 后生成 | 从已有 StringSession 转换 |
若您已有制作工具导出的 ZIP,其中 tdata/ 子目录可直接再次打包上传,转为 Session 文本;或直接使用其中的 session.txt 粘贴互转,无需重复打包整个 ZIP。
TData 失效与转换失败
- Session 已失效(账号登出、会话被撤销)→ Session → tdata 会失败
- tdata 不完整或来自错误备份 → tdata → Session 提示「无效的 tdata」或「未找到有效的 tdata 目录」
- ZIP 中找不到 tdata 相关路径 → 校验阶段即拒绝,提示「ZIP 中未找到 tdata 相关文件」
互转不会替您重新登录 Telegram,也不会修复已失效的凭证。
适用场景
- 已有 StringSession,需要 Telegram Desktop 的 tdata
- 已有 tdata 备份,需要在 Telethon / Pyrogram 中使用 Session
- 在不同工具链之间迁移登录格式
注意
转换的是已有登录凭证,请勿上传他人文件。输出同样属于敏感信息。
核心特点
| 特点 | 说明 |
|---|---|
| 双向互转 | Session ↔ tdata |
| 无需 Telegram 登录 | 不上传手机号、不发验证码 |
| 自动识别 | 文本 → Session→tdata;ZIP 魔数 → tdata→Session |
| 共用授权码 | 与 Session 制作共用额度,见 授权码与额度 |
与 Session 制作的区别
| Session 制作 | 格式互转 | |
|---|---|---|
| Telegram 登录 | 需要 | 不需要 |
| 输入 | 本人账号登录 | 已有 Session / tdata 文件 |
| 输出 | 完整 ZIP(session + tdata + account.json) | 单一格式文件 |
使用流程概览
- 站点登录 — 输入授权码(与制作共用)
- 进入「格式互转」Tab
- 上传文件或粘贴 Session → 开始转换 → 下载结果
详见 使用方法。
安全提示
- 仅转换您合法持有的凭证
- 成功转换扣 1 次额度;校验/失败/超时不扣
- 文件大小与格式受服务端限制(默认单文件 20MB)