使用tdl监听下载tg消息到挂载的google硬盘

效果演示

打造专属 Telegram 下载机器人：tg-tdl 深度解析与部署指南 🚀

项目概述

你是否经常需要在 Telegram 上接收文件，但又觉得手动下载再上传到服务器很麻烦？或者担心大文件会占用过多设备空间？

tg-tdl 是一个开源的 Telegram 文件下载机器人，它能自动将接收到的文件下载到你指定的服务器位置。

核心功能

• 📥 自动下载：转发或发送文件即可触发下载

• 🔒 权限控制：仅限授权用户使用

• 🚦 下载队列管理：控制并发下载数量

• 📏 文件大小限制：可配置最大下载尺寸

• 💾 历史记录：完整记录所有下载操作

• ⚙️ 环境变量配置：安全便捷的配置方式

• 🖥️ 服务器部署：适合 VPS、NAS 等环境

技术实现解析

1. 环境配置

程序通过环境变量获取关键配置：

• BOT_TOKEN：Telegram 机器人令牌

• ALLOWED_USERS：授权用户 ID 列表

• DOWNLOAD_DIR：文件存储路径

• MAX_FILE_SIZE_MB：文件大小限制

• MAX_CONCURRENT_DOWNLOADS：最大并发数

2. 核心下载流程

1. 接收文件：机器人通过 message_handler 处理文件消息

2. 权限检查：

• 验证用户权限

• 检查文件大小

• 确认并发数未超限

3. 队列管理：将任务加入下载队列

4. 异步下载：使用独立线程执行下载操作

5. 结果处理：更新状态并通知用户

3. 辅助功能

• 历史记录：JSON 格式保存下载记录

• 管理命令：
  • /status：查看当前状态
  • /clearhistory：清除历史记录

• 错误处理：完善的异常捕获机制

详细部署指南

准备工作

1. 确保已安装 Python 3.8+

2. 准备 Telegram 机器人令牌

3. 获取授权用户 ID（可通过 @userinfobot 查询）

安装步骤

配置设置

推荐使用 .env 文件管理配置：

1. 安装环境变量支持包：

1. 创建 .env 文件：

1. 确保下载目录存在且有写入权限：

运行机器人

后台运行方案

1. nohup 方式：

1. screen/tmux 方式：

1. Systemd 服务（推荐生产环境使用）：

使用说明

1. 在 Telegram 中找到你的机器人

2. 发送 /start 开始使用

3. 直接发送或转发文件即可触发下载

4. 常用命令：

• /status：查看下载状态

• /clearhistory：清除历史记录

安全建议

1. 妥善保管 BOT_TOKEN，不要泄露

2. 严格控制 ALLOWED_USERS 列表

3. 根据服务器性能合理设置并发数

4. 定期检查下载目录使用情况

常见问题

Q：下载的文件存储在哪里？
A：在 .env 中配置的 DOWNLOAD_DIR 路径下。

Q：如何增加授权用户？
A：在 ALLOWED_USERS 中添加用户 ID，用逗号分隔。

Q：为什么我的下载速度很慢？
A：可能是服务器带宽限制或 Telegram 服务器限制，可尝试调整并发数。

希望本指南能帮助你成功部署这个实用的 Telegram 下载机器人！如有其他问题，欢迎留言讨论。

六 代码

GitHub – moran69/telegram-file-bot: 调用tdl转存tg telegram视频到google网盘或其他硬盘

调用tdl转存tg telegram视频到google网盘或其他硬盘. Contribute to moran69/telegram-file-bot development by creating an account on GitHub.

https://github.com/moran69/telegram-file-bot/tree/main