tangyoha/telegram_media_downloader 基于 Telethon/Pyrogram 类客户端，读取 .env 中的 api_id、api_hash 与 session，按频道 ID 或链接递归下载媒体文件。进程维持与 Telegram 的长连接，下载队列与断点状态写入本地目录，不适合 无状态多副本 Kubernetes Deployment——并发多实例可能触发 Telegram 限流或 session 冲突。与官方「导出聊天」相比自动化程度更高；应在单容器 --restart unless-stopped 下运行，session 文件与下载目录务必 volume 持久化。

快速启动

docker run -d --name tg-downloader \
  -v $(pwd)/data:/app/downloads \
  -v $(pwd)/.env:/app/.env \
  docker.io/tangyoha/telegram_media_downloader:latest

推荐实践

docker run -d --name tg-downloader \
  --restart unless-stopped \
  -v /data/tg/downloads:/app/downloads \
  -v /data/tg/session:/app/session \
  -v /data/tg/.env:/app/.env:ro \
  -e TZ=Asia/Shanghai \
  docker.io/tangyoha/telegram_media_downloader:2.0.0

核心参数说明

• -v .../downloads:/app/downloads — 媒体文件输出目录
• -v .../session:/app/session — Telegram 登录 session 持久化
• -v .../.env:/app/.env:ro — api_id、api_hash 与频道配置
• -e TZ — 文件名与日志时区
• --restart unless-stopped — 断网或限流后自动重连
• 单实例 — 同一 session 勿多容器并行