https://6e2a28aa.tdl-docs.pages.dev/zh/ Recent content in 介绍 on tdl Hugo -- gohugo.io zh https://6e2a28aa.tdl-docs.pages.dev/zh/getting-started/installation/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/getting-started/installation/ 安装 # 一键脚本 # Windows tdl 将被安装到 $Env:SystemDrive\tdl（将被添加到 PATH 中），该脚本还可用于升级 tdl。 安装最新版本 # iwr -useb https://docs.iyear.me/tdl/install.ps1 | iex 通过 ghproxy.com 镜像安装 # $Script=iwr -useb https://docs.iyear.me/tdl/install.ps1; $Block=[ScriptBlock]::Create($Script); Invoke-Command -ScriptBlock $Block -ArgumentList "", "$True" 安装特定版本 # $Env:TDLVersion = "VERSION" $Script=iwr -useb https://docs.iyear.me/tdl/install.ps1; $Block=[ScriptBlock]::Create($Script); Invoke-Command -ScriptBlock $Block -ArgumentList "$Env:TDLVersion" macOS 和 Linux tdl 将被安装到 /usr/local/bin/tdl，该脚本还可用于升级 tdl。 安装最新版本 # curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash 通过 ghproxy.com 镜像安装 # curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash -s -- --proxy https://6e2a28aa.tdl-docs.pages.dev/zh/guide/tools/list-chats/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/tools/list-chats/ 列出聊天 # 列出所有聊天 # tdl chat ls JSON 格式 # tdl chat ls -o json 过滤器 # 请参考 过滤器指南 以获取有关过滤器的基本知识。 列出所有可用的过滤字段： tdl chat ls -f - 列出名字包含 “Telegram” 的频道： tdl chat ls -f "Type contains 'channel' && VisibleName contains 'Telegram'" 列出具有主题的群组： tdl chat ls -f "len(Topics)>0" https://6e2a28aa.tdl-docs.pages.dev/zh/guide/global-config/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/global-config/ 全局配置 # 全局配置是可以在每个命令中设置的选项。 每次都设置全局配置！ 全局配置不代表配置会被持久化或者只需要在全局设置一次，它们只会在当前命令中生效。 你需要在每一个命令中设置它们。 -n/--ns # 每个命名空间代表一个 Telegram 帐号。默认值：default。 例如你想新增一个其他账户，为所有命令都添加 -n YOUR_ACCOUNT_NAME 选项即可： tdl -n iyear --proxy # 设置代理。默认值：""。 格式：protocol://username:password@host:port tdl --proxy socks5://localhost:1080 tdl --proxy http://localhost:8080 tdl --proxy https://localhost:8081 --storage # 设置存储。默认值：type=bolt,path=~/.tdl/data 格式: type=驱动,opt1=val1,opt2=val2,... 可用的驱动： 驱动名 选项 描述 bolt（默认） path=/path/to/data-directory 将数据存储在单独的数据库文件中，因此您可以在多个进程中使用（但必须是不同的命名空间）。 file path=/path/to/data.json 将数据存储在单个 JSON 文件中，通常用于调试。 legacy path=/path/to/data.kv 已弃用。 将数据存储在单个数据库文件中，因此你不能在多个进程中使用它。 - - 等待更多驱动… tdl --storage type=bolt,path=/path/to/data-dir --ntp # 设置 NTP 服务器。如果为空，将使用系统时间。默认值：""。 tdl --ntp pool.ntp.org --reconnect-timeout # 设置 Telegram 连接的重连超时。默认值：2m。 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/tools/export-members/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/tools/export-members/ 导出成员 # 导出聊天成员/订阅者、管理员、机器人等。 部分类型用户(被禁用户/被踢出用户/……)导出需要聊天管理员权限。 CHAT 示例 可用值： # @iyear （用户名） iyear （无前缀 @ 的用户名） 123456789（ID） https://t.me/iyear （公开链接） +1 123456789（电话号码） 如何在 Telegram 桌面端获取聊天 ID： # 设置 → 高级 → 实验性设置 → 在资料中显示对话 ID 默认 # 将所有用户导出为 tdl-users.json tdl chat users -c CHAT 自定义路径 # 指定文件路径进行导出 tdl chat users -c CHAT -o /path/to/export.json 原始数据 # 导出 Telegram MTProto 原始用户结构，用于调试。 tdl chat users -c CHAT --raw https://6e2a28aa.tdl-docs.pages.dev/zh/guide/login/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/login/ Login # https://6e2a28aa.tdl-docs.pages.dev/zh/more/env/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/more/env/ 环境变量 # 所有环境变量的值优先级低于命令行选项。 通过设置环境变量，避免在每次重复输入相同的命令行选项。 环境变量 对应选项 TDL_NS -n/--ns TDL_PROXY --proxy TDL_STORAGE --storage TDL_DEBUG --debug TDL_SIZE -s/--size TDL_THREADS -t/--threads TDL_LIMIT -l/--limit TDL_POOL --pool TDL_NTP --ntp TDL_RECONNECT_TIMEOUT --reconnect-timeout TDL_DISABLE_PROGRESS_PS --disable-progress-ps TDL_TEMPLATE dl --template TDL_STORAGE 环境变量的格式与命令行选项不同：{"type": "bolt", "path": "/path/to/data-dir"} (JSON 对象)。 https://6e2a28aa.tdl-docs.pages.dev/zh/getting-started/quick-start/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/getting-started/quick-start/ 快速开始 # 登录 # 我们不在这里指定命名空间，它将使用 default 命名空间。如果你想使用其他命名空间，可以使用 -n 标志指定命名空间。 使用桌面客户端登录 # 请确保从官方网站下载客户端（不要从 Microsoft Store 或 App Store 下载） 使用默认路径： tdl login 如果您设置了本地密码： tdl login -p YOUR_PASSCODE 或者指定自定义客户端路径： tdl login -d /path/to/TelegramDesktop 使用二维码登录 # tdl login -T qr 使用手机号码和验证码登录 # tdl login -T code 下载 # 我们从 Telegram 官方频道下载文件： tdl dl -u https://t.me/telegram/193 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/tools/export-messages/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/tools/export-messages/ 导出消息 # 以 JSON 格式导出聊天、频道、群组等中的媒体消息。 CHAT 示例 可用值： # @iyear （用户名） iyear （无前缀 @ 的用户名） 123456789（ID） https://t.me/iyear （公开链接） +1 123456789（电话号码） 如何在 Telegram 桌面端获取聊天 ID： # 设置 → 高级 → 实验性设置 → 在资料中显示对话 ID 空的 CHAT 表示“收藏夹” 所有消息 # 将包含媒体的所有消息导出到 tdl-export.json tdl chat export -c CHAT 从主题/回复中导出 # 从特定主题导出媒体消息： 获取主题 ID 的方式： 消息链接：https://t.me/c/1492447836/251011/269724（251011 是主题 ID） tdl chat ls 命令 tdl chat export -c CHAT --topic TOPIC_ID 从特定频道帖子的回复中导出媒体消息： tdl chat export -c CHAT --reply POST_ID https://6e2a28aa.tdl-docs.pages.dev/zh/more/data/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/more/data/ 数据 # 您的帐户信息将存储在 ~/.tdl 目录中。 日志文件将存储在 ~/.tdl/log 目录中。 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/download/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/download/ 下载 # 从链接下载： # 点击官方客户端的 “复制链接” 按钮获取消息链接。 消息链接示例 https://t.me/telegram/193 https://t.me/c/1697797156/151 https://t.me/iFreeKnow/45662/55005 https://t.me/c/1492447836/251015/251021 https://t.me/opencfdchannel/4434?comment=360409 https://t.me/myhostloc/1485524?thread=1485523 ...（如果发现新的链接格式，请提交新的 Issue） tdl dl -u https://t.me/tdl/1 -u https://t.me/tdl/2 从 JSON 下载： # 有两种导出 JSON 文件的方式： tdl 请参考 导出消息 桌面客户端 选择要导出的对话，点击右上角的三个点，然后点击 导出聊天历史。 取消选中所有选项（您现在不需要下载它们），将 大小限制 设置为最小值。 设置格式为 JSON 并选择您需要的时间段。 导出它！result.json 就是您需要的文件。 tdl dl -f result1.json -f result2.json 合并下载： # tdl dl \ -u https://t.me/tdl/1 -u https://t.me/tdl/2 \ -f result1.json -f result2.json 自定义目录： # 将文件下载到自定义目录 tdl dl -u https://t. https://6e2a28aa.tdl-docs.pages.dev/zh/getting-started/shell-completion/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/getting-started/shell-completion/ 自动补全 # 运行对应的命令以在所有会话中启用 Shell 自动补全： bash echo "source <(tdl completion bash)" >> ~/.bashrc zsh echo "source <(tdl completion zsh)" >> ~/.zshrc fish echo "tdl completion fish | source" >> ~/.config/fish/config.fish PowerShell Add-Content -Path $PROFILE -Value "tdl completion powershell | Out-String | Invoke-Expression" https://6e2a28aa.tdl-docs.pages.dev/zh/guide/forward/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/forward/ 转发 # 具有自动回退和消息路由的转发功能 一行命令将消息从 https://t.me/telegram/193 转发到 收藏夹： tdl forward --from https://t.me/telegram/193 自定义来源 # 消息链接示例 https://t.me/telegram/193 https://t.me/c/1697797156/151 https://t.me/iFreeKnow/45662/55005 https://t.me/c/1492447836/251015/251021 https://t.me/opencfdchannel/4434?comment=360409 https://t.me/myhostloc/1485524?thread=1485523 ...（如果发现新的链接格式，请提交新的 Issue） 您可以从链接和导出的JSON文件转发消息： tdl forward \ --from https://t.me/telegram/193 \ --from https://t.me/telegram/195 \ --from tdl-export.json \ --from tdl-export2.json 自定义目标 # CHAT 示例 可用值： # @iyear （用户名） iyear （无前缀 @ 的用户名） 123456789（ID） https://t.me/iyear （公开链接） +1 123456789（电话号码） 如何在 Telegram 桌面端获取聊天 ID： # 设置 → 高级 → 实验性设置 → 在资料中显示对话 ID 特定聊天 # 转发到特定的聊天： https://6e2a28aa.tdl-docs.pages.dev/zh/guide/upload/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/upload/ 上传 # 上传文件 # 上传指定的文件和目录到 保存的消息： tdl up -p /path/to/file -p /path/to/dir 自定义目标 # 上传到自定义聊天。 CHAT 示例 可用值： # @iyear （用户名） iyear （无前缀 @ 的用户名） 123456789（ID） https://t.me/iyear （公开链接） +1 123456789（电话号码） 如何在 Telegram 桌面端获取聊天 ID： # 设置 → 高级 → 实验性设置 → 在资料中显示对话 ID 指定聊天 # 上传到指定的聊天： tdl up -p /path/to/file -c CHAT 上传到论坛型聊天的指定主题： tdl up -p /path/to/file -c CHAT --topic TOPIC_ID 消息路由 # 通过基于表达式的消息路由，将文件上传到不同的聊天： --to 标志与 -c/--chat 和 --topic 标志冲突，只能使用其中一个。 列出所有可用字段： https://6e2a28aa.tdl-docs.pages.dev/zh/more/troubleshooting/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/more/troubleshooting/ 疑难解答 # 最佳实践 # 如何减小封号的风险？ 使用官方客户端会话登录。 尽可能使用默认的下载和上传选项。不要设置过大的 threads 和 size。 不要同时在多台设备上使用相同的帐户登录。 不要同时下载或上传太多文件。 成为 Telegram 大会员。😅 常见问题 # Q: 输入命令后为什么没有响应？日志中为什么出现 msg_id too high？ # A: 检查是否需要使用代理（使用 --proxy 选项）；检查您系统的本地时间是否正确（使用 --ntp 选项或校准系统时间） 如果仍然无法解决问题，请使用 --debug 标志重新运行。然后创建一个新的 ISSUE 并将日志粘贴到问题中。 Q: 使用 tdl 后，桌面客户端停止工作怎么办？ # A: 如果您的桌面客户端无法接收消息、加载聊天或发送消息，可能遇到了会话冲突。 您可以尝试使用 tdl login 重新登录，并选择 YES 以退出桌面客户端登录，这将删除客户端会话文件以分离会话。 Q: 如何将会话迁移到另一台设备？ # A: 您可以使用 tdl backup 和 tdl recover 命令导出和导入会话。详细信息请参见 迁移。 Q: 这算滥用吗？ # A: 不是。下载和上传速度受服务器端限制。由于官方客户端的速度通常不会达到帐户限制，因此开发了此工具，以尽可能高的速度下载文件。 Q: 这会导致封禁吗？ # A: 我不确定。所有操作都不涉及向其他人主动发送消息等高风险行为。 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/migration/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/migration/ 迁移 # 备份或恢复您的数据 备份 # 将您的数据备份到文件中。默认值：<date>.backup.tdl。 tdl backup 或者指定输出文件： tdl backup -d /path/to/custom.tdl 恢复 # 从备份文件中恢复您的数据。 tdl recover -f /path/to/custom.backup.tdl 迁移 # 将数据迁移到另一个存储中 查看存储以获取存储选项的详细信息。 迁移当前存储到文件类型存储： tdl migrate --to type=file,path=/path/to/data.json 迁移自定义存储到文件类型存储： tdl migrate --storage type=bolt,path=/path/to/data-directory --to type=file,path=/path/to/data.json https://6e2a28aa.tdl-docs.pages.dev/zh/guide/extensions/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/extensions/ 扩展 # 扩展是 tdl 的一项新功能，仍处于实验阶段，CLI 可能会在未来版本中发生变化。 如果你遇到任何问题或有任何建议，请在 GitHub 上创建 Issue。 概览 # tdl 扩展是与 tdl 核心无缝集成的独立工具。它们提供了一种扩展 tdl 核心的方法，但不需要将每个新功能添加到核心代码中。 tdl 扩展具有以下特点： 它们可以添加和删除，而不会影响 tdl 核心。 它们与 tdl 集成，并会显示在 tdl 命令和其他地方。 tdl 扩展位于 ~/.tdl/extensions，由 tdl extension 子命令控制。 使用以下命令快速体验 tdl 扩展： tdl extension install iyear/tdl-whoami tdl whoami 你可以看到 tdl-whoami 扩展的输出。详情请参阅 tdl-whoami。 You are XXXXX. ID: XXXXXXXX 查找扩展 # 你可以通过浏览带有 tdl-extension 主题的代码库来查找扩展。 安装扩展 # 要安装扩展，请使用 extension install 子命令。 扩展有两种类型： GitHub : 托管在 GitHub 代码库上的扩展。 https://6e2a28aa.tdl-docs.pages.dev/zh/snippets/chat/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/snippets/chat/ CHAT 示例 可用值： # @iyear （用户名） iyear （无前缀 @ 的用户名） 123456789（ID） https://t.me/iyear （公开链接） +1 123456789（电话号码） 如何在 Telegram 桌面端获取聊天 ID： # 设置 → 高级 → 实验性设置 → 在资料中显示对话 ID https://6e2a28aa.tdl-docs.pages.dev/zh/snippets/link/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/snippets/link/ 消息链接示例 https://t.me/telegram/193 https://t.me/c/1697797156/151 https://t.me/iFreeKnow/45662/55005 https://t.me/c/1492447836/251015/251021 https://t.me/opencfdchannel/4434?comment=360409 https://t.me/myhostloc/1485524?thread=1485523 ...（如果发现新的链接格式，请提交新的 Issue） https://6e2a28aa.tdl-docs.pages.dev/zh/reference/expr/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/reference/expr/ 表达式指南 # 表达式由 expr 引擎提供支持，它是一个简单、轻量但功能强大的表达式引擎。 表达式引擎文档：https://expr.medv.io/docs/Language-Definition 它功能强大，但对于新用户来说可能有些难以理解。如果您对表达式引擎有任何疑问，请随时提出 ISSUE。 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/template/ Mon, 01 Jan 0001 00:00:00 +0000 https://6e2a28aa.tdl-docs.pages.dev/zh/guide/template/ 模板指南 # 本指南将介绍可用于 tdl 模板中的变量和函数。 模板语法基于Go text/template。 下载 # 变量 (Beta) # 变量 描述 DialogID Telegram 对话ID MessageID Telegram 消息ID MessageDate Telegram 消息日期（时间戳） FileName Telegram 文件名 FileCaption Telegram 文件说明，也就是文本消息 FileSize 可读的文件大小，例如 1GB DownloadDate 下载日期（时间戳） 函数 (Beta) # 函数 描述 用法 示例 repeat 重复 STRING N 次 repeat STRING N {{ repeat "test" 3 }} replace 对 STRING 执行 PAIRS 替换 replace STRING PAIRS... {{ replace "Test" "t" "T" "e" "E" }} upper 将 STRING 转换为大写 upper STRING {{ upper "Test" }} lower 将 STRING 转换为小写 lower STRING {{ lower "Test" }} snakecase 将 STRING 转换为 snake_case snakecase STRING {{ snakecase "Test" }} camelcase 将 STRING 转换为 camelCase camelcase STRING {{ camelcase "Test" }} kebabcase 将 STRING 转换为 kebab-case kebabcase STRING {{ kebabcase "Test" }} rand 在范围 MIN 到 MAX 生成随机数 rand MIN MAX {{ rand 1 10 }} now 获取当前时间戳 now {{ now }} formatDate 格式化 TIMESTAMP 时间戳(默认格式: 20060102150405) formatDate TIMESTAMP formatDate TIMESTAMP "format" {{ formatDate 1600000000 }} {{ formatDate 1600000000 "2006-01-02-15-04-05"}} filenamify 尽可能将 STRING 转换为合法文件名，可选 MaxLength 限制字符串长度避免文件系统限制 filenamify STRING MaxLength {{ filenamify .