批量下载 Telegram 聊天与频道中的视频、音频、照片、文档、语音和 GIF，支持机器人命令、Web 界面筛选与网盘自动上传 | TelegramMediaDownloader | v2.2.5

软件介绍

TelegramMediaDownloader 是一款基于 Python 的 Telegram 媒体批量下载工具，可将指定聊天、频道或收藏夹中的视频、音频、图片、文档等资源完整归档到本地，支持机器人命令与 Web 网页界面两种操作方式。它适合需要长期备份 Telegram 群组/频道资源、批量整理收藏内容的用户，也可通过 Docker 部署在服务器上常驻运行。 核心功能： - 两种运行模式：既可作机器人运行（在聊天中下发「下载」或「转发」命令），也可作为一次性批量下载工具使用 - Web 网页界面：运行后浏览器访问 localhost:5000 即可图形化查看下载进度，远程机器可配置 web_host 为 0.0.0.0 对外提供服务 - 全媒体类型支持：音频、文档、照片、视频、video_note、语音消息与 animation（GIF）均可下载 - 文件格式筛选：可按 audio/document/video 分别指定要下载的扩展名（如 pdf、epub、mp4，或填 all 表示全部格式） - 多频道并行：config.yaml 中可配置多个 chat_id，每个频道单独记录读取进度 - 下载过滤器：使用 download_filter 按消息日期等条件（如 message_date >= 2022-12-01）精确筛选要下载的消息 - 断点续传与失败重试：通过 last_read_message_id 记录已读进度，未完成的文件写入 ids_to_retry 自动重试 - 自定义命名与目录：支持 save_path 保存路径、file_path_prefix 目录前缀（chat_title/media_datetime）与 file_name_prefix 文件名前缀（message_id/file_name）及自定义分隔符 - 多线程下载：max_download_task 控制同时进行的下载任务数 - 自动上传网盘：可配置 upload_drive 将下载完成的文件上传至远程存储目录，支持上传前压缩、上传后删除本地文件 - 隐私保护：hide_file_name 可隐藏文件名 - 下载清单记录：enable_download_txt 可生成下载记录文本文件 - 多平台部署：支持 Windows 本地 pip 安装运行，也可通过 Docker / docker-compose 一键部署与升级 - 账号与权限控制：支持 web_login_secret 网页登录密钥与 allowed_user_ids 限定可使用机器人下载的用户 **中文支持**：提供完整中文说明文档（README_CN.md），配置项含义、API 密钥与 chat_id 获取步骤等教程均有中文说明。