🧠 TDL 命令行工具安装与使用教程（Windows 11 版）｜可下载 Telegram 限制资源

本教程将教你如何在 Windows 11 系统中安装并使用 TDL (Telegram Download CLI)，它可以下载 Telegram 群组、频道、甚至“受限可见”的资源（例如私密视频、加密频道内容等）。整个过程无需安装任何编程环境，只需下载解压即可直接使用。

📦 一、下载 TDL 程序

打开 GitHub 官方发布页：👉 https://github.com/iyear/tdl/releases/tag/v0.19.2
根据系统版本选择正确的文件下载：💻 64 位系统用户 → 下载 tdl_Windows_64bit.zip； 💾 32 位系统用户 → 下载 tdl_Windows_32bit.zip。📌 不确定系统类型？右键点击“此电脑”→“属性”→ 查看“系统类型”。

📂 二、解压并配置环境变量

1️⃣ 解压文件

下载完成后，将压缩包解压到任意文件夹，推荐路径如下：

C:\Users\<你的用户名>\Documents\tdl

解压后文件夹应包含：

tdl.exe<br>LICENSE<br>README.md

2️⃣ 添加到系统环境变量

为了能在任意路径下使用 tdl 命令，需要将解压目录添加到系统环境变量：右键点击 此电脑 → 属性 → 高级系统设置 → 环境变量 → 找到并双击 Path → 点击 新建，添加以下路径：

C:\Users\<你的用户名>\Documents\tdl

保存并关闭所有窗口。

3️⃣ 验证安装是否成功

打开 PowerShell 或 CMD，输入：

tdl --version

若输出：

TDL 0.19.2

说明 TDL 已正确安装并可以使用 ✅

📖 三、查阅官方文档

TDL 的详细功能及参数请参考官方文档：👉 https://docs.iyear.me/tdl/zh/

🚀 四、快速入门示例

1️⃣ 登录 Telegram 账户

首次使用前需要登录 Telegram：

tdl login

输入手机号（含国家区号，如 +1 或 +86），再输入 Telegram 发送的验证码。登录后会话将自动保存。

2️⃣ 下载单条 Telegram 消息文件

示例链接：

https://t.me/tdl/1

执行命令：

tdl dl -u "https://t.me/tdl/1"

程序会自动在当前目录下创建 downloads 文件夹，并下载该文件。

3️⃣ 批量下载多个消息

tdl dl -u "https://t.me/tdl/1" -u "https://t.me/tdl/2" -u "https://t.me/tdl/3"

4️⃣ 使用 JSON 文件批量下载频道资源

如果你已经导出频道文件（如 bearcave10.json），可以使用以下命令批量下载：

tdl dl -f "bearcave10.json" --group --skip-same

TDL 会自动识别相册、组合消息等内容，并跳过重复文件。

5️⃣ 启动 HTTP 文件服务器（可选）

tdl dl -f "bearcave10.json" --serve --port 8081

打开浏览器访问：

http://localhost:8081

即可直接下载文件。

📤 五、导出 Telegram 频道或群组为 JSON 文件

TDL 支持将频道或群组导出为 JSON 文件，方便批量下载或备份。

1️⃣ 导出单个频道

tdl export -u "https://t.me/bearcave10" -f "bearcave10.json"

2️⃣ 使用 Takeout 模式导出（推荐）

tdl export -u "https://t.me/bearcave10" --takeout -f "bearcave10.json"

Takeout 模式使用 Telegram 官方接口，导出速度更快、更稳定。

3️⃣ 合并多个导出文件

tdl dl -f "bear1.json" -f "bear2.json" --group --skip-same

🪟 六、右键文件夹运行（推荐方式）

如果你的下载文件夹中已有 JSON 文件，可直接在该文件夹中运行命令：打开下载文件夹 → 在空白处按下 Shift + 右键 → 选择“在此处打开命令窗口 (CMD)”或“在终端中打开” → 输入命令并回车：

tdl dl -f "bearcave10.json" --group --skip-same

⚙️ 七、常用参数说明

参数	功能说明
-t	设置下载线程数（如 -t 8）
-l	设置并发任务数（如 -l 4）
--group	自动检测相册或组合消息
--desc	倒序下载（从最新开始）
--skip-same	跳过重复文件
--rewrite-ext	修正文件扩展名
--continue	断点续传
--restart	重新下载所有文件
--takeout	启用 Telegram 官方导出接口

📚 八、更多高级功能

完整文档：👉 https://docs.iyear.me/tdl/zh/
推荐阅读：文件命名模板语法、自定义命名、下载过滤（白名单与黑名单）、Takeout 模式详解、HTTP 文件服务器使用技巧。

✅ 九、总结

通过本教程，你已经学会：在 Windows 11 上安装并配置 TDL；登录 Telegram 账户；导出频道或群组为 JSON；批量下载公开与受限资源；使用右键文件夹方式快速运行命令。