⚠️ 重要说明
TDL是命令行工具，无法在网页中直接使用。需要下载到本地电脑运行。
本页面提供详细的安装和使用指导。
🚀 快速开始
方法一：下载预编译版本（推荐）
1
访问TDL官方发布页面下载对应系统版本
# macOS/Linux用户
wget https://github.com/iyear/tdl/releases/latest/download/tdl_Darwin_x86_64.tar.gz
tar -xzf tdl_Darwin_x86_64.tar.gz
# Windows用户
# 下载 tdl_Windows_x86_64.zip 并解压
2
将tdl文件移动到系统PATH或当前目录
3
登录Telegram账号
./tdl login
4
开始下载媒体文件
# 下载频道最新10个文件
./tdl dl -u channelname -l 10
# 下载指定聊天的所有媒体
./tdl dl -c "ChatName"
方法二：从源码编译
1
确保已安装Go 1.19+
2
克隆并编译
git clone https://github.com/iyear/tdl.git
cd tdl
go build -o tdl .
🎯 主要功能
- 下载频道和聊天中的媒体文件
- 支持受保护的私有频道
- 批量下载和断点续传
- 消息导出为JSON格式
- 成员列表导出
- 文件上传到Telegram
- 消息转发和路由
📖 常用命令
登录账号：
tdl login
下载频道媒体：
# 下载最新20个文件
tdl dl -u channelname -l 20
# 下载指定时间范围
tdl dl -u channelname --from "2023-01-01" --to "2023-12-31"
下载私聊媒体：
tdl dl -c "用户名或聊天名" -l 50
导出聊天记录：
tdl chat export -c "聊天名" -o messages.json
上传文件：
tdl up -p "文件路径" -c "目标聊天"
❓ 常见问题
Q: 为什么不能在网页中使用？
A: TDL需要访问Telegram API和本地文件系统，出于安全考虑，浏览器不允许网页进行这些操作。
Q: 如何下载受保护的频道内容？
A: 首先需要加入该频道，然后使用TDL登录你的账号即可下载。
Q: 下载速度慢怎么办？
A: TDL的下载速度取决于你是否是Telegram Premium用户，Premium用户享有更快的下载速度。