password
comment
type
status
date
slug
summary
tags
category
icon
本教程介绍如何使用 Docker 部署 Telegram Media Downloader，实现自动下载 Telegram 频道或群组中的媒体文件。前提条件：系统已安装 Docker 和 Docker Compose。
📝 部署步骤
获取 Telegram API 密钥
- 访问 my.telegram.org/apps 并登录 Telegram 帐户
- 填写表格注册新应用程序
- 获取 api_id 和 api_hash
创建 Telegram 机器人（可选）
如需通过机器人创建下载任务：
- 在 Telegram 中搜索 @BotFather，发送
/newbot
- 按提示设置名称和用户名，保存返回的 bot_token
初始化项目
创建目录并下载配置文件：
配置参数
编辑
config.yaml：注意：最新版本的 config.yaml 默认不包含
bot_token 字段，如需使用机器人功能请手动添加。核心配置说明
配置项 | 说明 |
api_hash / api_id | Telegram API 认证密钥 |
bot_token | 机器人凭证（可选） |
chat | 频道/群组配置，支持多个。 chat_id 为目标 ID，last_read_message_id 首次设为 0 |
media_types | 下载的媒体类型： audio、photo、video、document、voice、video_note |
file_formats | 指定格式过滤，默认 all |
save_path | 文件保存根目录 |
file_path_prefix | 子目录结构，可组合： chat_title、media_datetime、media_type |
language | 界面语言： EN（默认）、ZH、RU、UA |
max_download_task | 最大并发下载数，默认 5 |
web_host / web_port | Web 管理界面地址和端口 |
web_login_secret | Web 界面登录密码，不配置则无需登录 |
allowed_user_ids | 允许使用机器人的用户 ID 列表 |
更多高级配置（下载过滤器、云盘上传等）请参考 项目 Wiki。
首次运行
首次需前台启动以完成 Telegram 认证：
输入手机号和验证码完成认证后，按
Ctrl + C 退出。后台运行
🔄 升级
配置文件和已下载的媒体文件会自动保留。
📎 参考资源
- 作者:Cheng
- 链接:https://tangly1024.com/article/telegram-media-downloader-docker-guide
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
