安装

# 以管理员身份打开 PowerShell 执行
iwr -useb https://docs.iyear.me/tdl/install.ps1 | iex

登录

# 指定数据目录登录（避免与其他 Telegram 客户端冲突）
tdl login -d "D:\Telegram Desktop"

# 或使用默认目录
tdl login

下载

基础下载（多线程 + 代理）

# 从导出的 result.json 下载，8线程/任务，4并发，HTTP代理
tdl dl -f result.json -t 8 -l 4 --proxy http://127.0.0.1:7890

HTTP 服务器模式（配合 IDM/Aria2/wget 使用）

# 启动 HTTP 文件服务器，暴露所有文件供下载工具接管
tdl dl -f result.json --serve --port 8080 --proxy http://127.0.0.1:7890

# 浏览器打开 http://localhost:8080 查看文件列表
# 用 IDM 批量添加下载任务

其他下载参数

数据管理

备份账号数据

tdl backup

迁移存储引擎

# 从默认 bolt DB 迁移到 file 引擎（存为文本文件到指定目录）
tdl migrate --to driver=file,path=D:\tdl_backup

恢复数据

tdl recover

消息转发

基础转发

# 从 JSON 导出文件转发消息到另一个群/频道
tdl forward --from result.json --to https://t.me/目标频道 --proxy http://127.0.0.1:7890

Clone 模式（保留完整消息格式，不只是链接）

tdl forward --from result.json --to @目标群 --mode clone --proxy http://127.0.0.1:7890

其他转发参数

聊天工具

# 列出所有对话
tdl chat ls

# 导出某个频道的消息为 JSON（供后续 dl 使用）
tdl chat export -c https://t.me/某频道 -o output.json

# 导出频道成员列表
tdl chat users -c https://t.me/某频道 -o users.csv

上传文件

# 上传整个目录到频道/群组
tdl up --path D:\videos\ --chat https://t.me/我的频道 --proxy http://127.0.0.1:7890

# 只上传 mp4 文件
tdl up --path D:\videos\ --chat @mygroup -i mp4

# 上传后自动删除源文件
tdl up --path D:\downloads\ --chat @mygroup --rm

常用组合

场景：从群聊批量下载媒体 + HTTP 服务器供 IDM 接管

tdl dl -f result.json --serve --port 8080 --proxy http://127.0.0.1:7890

场景：消息搬家（整个频道迁移到新频道）

tdl forward --from result.json --to https://t.me/新频道 --mode clone -l 4 --proxy http://127.0.0.1:7890

场景：完整备份并迁移存储

tdl backup
tdl migrate --to driver=file,path=D:\tdl_backup