全局参数 0
适用于所有命令;留空即不写入命令
更多全局参数
线程 / 并发是 tdl 的持久参数,只需在此设置一次;工具会把它们追加到命令末尾。
登录 Telegram
登录会写入全局命名空间对应的会话数据;已有数据会被覆盖。
tdl login
桌面端会话无需在服务器上交互,最适合远程登录。
留空时 tdl 会尝试自动查找常见安装路径。
密码会出现在生成的命令中,不会被本工具保存。
交互式登录:code / qr 模式需要在终端中接收验证码或扫码,远程执行会因为没有交互输入而超时。请复制命令到服务器终端运行。
下载消息媒体
支持消息链接与官方客户端导出的 JSON 文件;可下载受保护聊天的内容。
tdl download
相对于 tdl 工作目录;建议填写绝对路径。
仅在勾选 HTTP 服务模式时生效。
文件名模板
Go template 语法,留空使用 tdl 默认模板。
转发消息
从链接或导出 JSON 读取消息并转发到目标;direct 模式失败时会自动降级为 clone。
tdl forward
支持 @用户名、数字 ID、公开链接,或 tdl 表达式引擎路由。
上传文件
将服务器上的文件或目录上传到 Telegram;--chat 与 --to 互斥。
tdl upload
每行一个路径;目录会被递归处理。
留空则上传到「收藏夹」。
使用表达式引擎动态选择目标。
必须与 --chat 一起使用。
支持表达式;留空使用 tdl 默认的文件名 / MIME 说明。
--rm 会删除服务器上的源文件,且无法恢复。请确认路径与备份后再执行。
聊天工具
列出会话、导出消息或导出受保护频道成员。
tdl chat
time / id 使用「起,止」;last 使用单个数量。
备份与迁移
操作的是 tdl 的会话与数据存储,不包含下载的媒体文件。
backup / recover / migrate
备份文件包含登录会话,请妥善保管。
恢复会覆盖当前命名空间的数据。请先执行备份,再继续操作。
源存储在「全局参数 → 更多 → --storage」中指定。
迁移会移动当前数据。请确认源与目标存储参数,并提前备份。
扩展与系统
管理 tdl 扩展或检查更新。扩展会在服务器上执行第三方代码。
extension / update
支持 GitHub 仓库(owner/repo)或本地路径。
更新会替换服务器上的 tdl 可执行文件。执行前请确认当前没有正在运行的任务。
生成
tdl version 命令,用于在服务器上查看当前版本。
已自动保存
表单内容、主题和服务器地址保存在本机浏览器;登录密码默认不保存。远程执行时命令会发送到你配置的 API。