Skip to content

工具简介

Session / TData 格式互转 帮助您在 StringSession 文本tdata 压缩包 之间双向转换,无需登录 Telegram

访问:tele.xiaohutou.top → 顶部 格式互转 Tab

工具能做什么

输入输出
Session 文本(文件或粘贴)tdata ZIP(含 tdata/ 目录)
含 tdata 的 ZIPSession 文本文件

系统按文件内容自动识别类型,不看文件名a.txtdata.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_datastdata/D877…支持
压缩 Session 制作导出的账号目录8613988881111/tdata/key_datas支持(会自动在解压目录中查找 tdata)
ZIP 内任意层级含 tdatabackup/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)单一格式文件

使用流程概览

  1. 站点登录 — 输入授权码(与制作共用)
  2. 进入「格式互转」Tab
  3. 上传文件或粘贴 Session → 开始转换 → 下载结果

详见 使用方法

安全提示

  • 仅转换您合法持有的凭证
  • 成功转换扣 1 次额度;校验/失败/超时不扣
  • 文件大小与格式受服务端限制(默认单文件 20MB)

相关文档