工具介绍

iyear/tdl 是一个 Telegram下载工具，具有以下特性：

  • 单文件启动
  • 低资源占用
  • 吃满你的带宽
  • 比官方客户端更快
  • 支持从（受保护）的会话中下载文件
  • 使用自动回退和消息路由转发消息
  • 支持上传文件至 Telegram
  • 将消息/成员/订阅者导出为 JSON
我平时主要用来下载文件，一定程度上可以突破官方的限速，节省下载的时间，更重要的一点是它能下载（受保护）会话的内容，这也就意味着能下载到不支持保存、转发等操作的频道内容。

安装 Telegram 并登录

前往官网下载并安装桌面版 Telegram：

https://telegram.org

下载 TDL 工具

访问 TDL 的 GitHub Releases 页面，下载最新版本并解压：

https://github.com/iyear/tdl/releases

解压到 D:\tdl，根据你的路径修改以下命令

配置系统环境变量

在 PowerShell 中执行以下命令，将 TDL 路径添加到系统环境变量中：

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";D:\tdl", [EnvironmentVariableTarget]::Machine)

设置临时变量（可选）

如果你需要设置代理或命名空间，可以使用以下命令：

$env:TDL_NS = "Mxiaolu"
$env:TDL_PROXY = "socks5://127.0.0.1:10808"

说明：

  • TDL_NS：命名空间，用于多账号区分
  • TDL_PROXY：代理地址（根据你的代理工具调整）

登录 Telegram 账号

tdl login -d "D:\Telegram"

说明：

  • -d 参数用于指定 Telegram 客户端数据存储路径

文件下载方法

  1. 找到要下载的 Telegram 消息
  2. 右键消息 → 复制链接（格式如 https://t.me/zxc1314000/4115）
  3. 执行以下命令进行下载：
tdl dl -u https://t.me/zxc1314000/4115

可根据需要下载多个链接，重复添加 -u 参数即可

实测效果截图

正常频道下载速度测试：

普通频道下载速度

受保护频道下载演示：

受保护频道下载

常用命令参数速查表

# 下载命令
tdl dl -u [链接]              下载指定消息中的文件

# 上传命令
tdl up -p [文件或目录路径]    上传文件或文件夹
       -c [聊天链接]         上传到指定聊天，上传到收藏夹可不写

# 常用选项
-n [命名空间]                区分不同账号（建议每个账号一个）
-d [目录路径]                指定下载路径
-u [消息链接]                需下载的 Telegram 消息链接，可多次指定
-p [文件或目录路径]           上传路径（支持文件或目录）
-c [聊天链接]                上传目标（不填默认上传到收藏夹）
--skip-same                 跳过相同文件（根据文件名和大小判断）
--rm                        上传后自动删除原文件
--photo                     上传为图片类型（默认上传为文档）
--proxy [代理地址]           设置代理（如 socks5://127.0.0.1:10808）
-t [线程数]                  每个任务的线程数（默认 8）
-l [并发数]                  同时进行的任务数（默认 4）
--pool                      客户端连接池大小（默认 8）
--reconnect-timeout         重连超时时间（默认 2m）
--continue                  恢复中断的下载任务
-i [扩展名列表]               只下载/上传指定后缀（如 mp4,jpg）
-e [扩展名列表]               排除指定后缀不进行下载/上传（如 mp3,png）