tdl 命令生成器 V5

Telegram Downloader · 可视化构建命令

全局参数

适用于所有命令;留空即不写入命令

更多全局参数
线程 / 并发是 tdl 的持久参数,只需在此设置一次;工具会把它们追加到命令末尾。

登录 Telegram

登录会写入全局命名空间对应的会话数据;已有数据会被覆盖。

tdl login

桌面端会话无需在服务器上交互,最适合远程登录。

留空时 tdl 会尝试自动查找常见安装路径。

密码会出现在生成的命令中,不会被本工具保存。

下载消息媒体

支持消息链接与官方客户端导出的 JSON 文件;可下载受保护聊天的内容。

tdl download
每行一条链接,自动去重并清理 ?single

相对于 tdl 工作目录;建议填写绝对路径。

下载选项
文件名模板

Go template 语法,留空使用 tdl 默认模板。

转发消息

从链接或导出 JSON 读取消息并转发到目标;direct 模式失败时会自动降级为 clone。

tdl forward
支持 Telegram 链接与导出 JSON,每行一个

支持 @用户名、数字 ID、公开链接,或 tdl 表达式引擎路由。

转发选项

上传文件

将服务器上的文件或目录上传到 Telegram;--chat 与 --to 互斥。

tdl upload

每行一个路径;目录会被递归处理。

留空则上传到「收藏夹」。

使用表达式引擎动态选择目标。

必须与 --chat 一起使用。

支持表达式;留空使用 tdl 默认的文件名 / MIME 说明。

上传选项

聊天工具

列出会话、导出消息或导出受保护频道成员。

tdl chat

备份与迁移

操作的是 tdl 的会话与数据存储,不包含下载的媒体文件。

backup / recover / migrate

备份文件包含登录会话,请妥善保管。

扩展与系统

管理 tdl 扩展或检查更新。扩展会在服务器上执行第三方代码。

extension / update

支持 GitHub 仓库(owner/repo)或本地路径。

已自动保存

表单内容、主题和服务器地址保存在本机浏览器;登录密码默认不保存。远程执行时命令会发送到你配置的 API。

后端与云同步

可保存多个后端并随时切换;收藏目标按后端分组。

密钥只发送到你填写的 API 地址。勾选「记住」才写入本机 localStorage,否则只留在当前标签页;开启云同步后密钥会在本机加密再上传。

确认执行

此操作会在远程服务器上运行命令。