基于 Ubuntu 的 tdl 容器，用于下载 Telegram 媒体，支持 amd64/arm64
465
基于 Ubuntu 24.04 的 tdl 运行环境，用于下载 Telegram 媒体（含受保护会话）。
容器常驻运行，通过 docker exec 执行登录、导出与下载；下载内容与登录会话经挂载目录持久化到宿主机。
本镜像已发布 多架构 Manifest，docker pull 时按机器自动选择：
| 架构 | 适用环境 |
|---|---|
linux/amd64 | 常见 x86_64 Linux 服务器 / PC |
linux/arm64 | Apple Silicon（M 系列 Mac）等 |
无需手动指定 --platform（除非你刻意要在 arm 机器上跑 amd64 模拟）。
docker pull wannayoung/ubuntu-tdl:latest
mkdir -p /path/to/downloads /path/to/config
docker run -d \
--name tdl \
--restart always \
-v /path/to/downloads:/downloads \
-v /path/to/config:/root/.tdl \
-it \
wannayoung/ubuntu-tdl:latest
或使用 Compose：
services:
tdl:
image: wannayoung/ubuntu-tdl:latest
container_name: tdl
volumes:
- /path/to/downloads:/downloads
- /path/to/config:/root/.tdl
restart: always
stdin_open: true
tty: true
docker compose up -d
docker exec tdl tdl version
| 项目 | 说明 |
|---|---|
| 基础镜像 | ubuntu:24.04 |
| 内置工具 | tdl（构建时安装当时最新 Release） |
| 语言 / 时区 | zh_CN.UTF-8 / Asia/Shanghai |
| 主进程 | sleep infinity（常驻，便于反复 exec） |
| 对外端口 | 无（纯 CLI，无 Web / nginx） |
| 工作目录 | /downloads |
| 容器路径 | 用途 |
|---|---|
/downloads | 下载文件、导出的 JSON |
/root/.tdl | 登录会话与 tdl 本地数据 |
绑定挂载不会清空宿主机已有文件；容器内写入可立即在宿主机看到。
容器内一般没有 Telegram Desktop，登录请用二维码或验证码。
# 进入 shell
docker exec -it tdl bash
# 或直接执行（登录务必加 -it）
docker exec -it tdl tdl login -T qr
# docker exec -it tdl tdl login -T code
# 列出对话
docker exec -it tdl tdl chat ls
# 导出媒体消息列表为 JSON
docker exec -it tdl tdl chat export -c CHANNEL_OR_CHAT -o /downloads/export.json
# 按 JSON 下载（请显式指定 -d /downloads）
docker exec -it tdl tdl dl -f /downloads/export.json -d /downloads
# 按消息链接下载
docker exec -it tdl tdl dl -u 'https://t.me/xxx/123' -d /downloads
更多用法见 tdl 官方文档。
若需通过本机代理访问 Telegram：
docker exec -it tdl tdl --proxy socks5://host.docker.internal:7890 login -T qr
或在 Compose 中使用 network_mode: host（适合代理监听在宿主机 localhost 的场景）。
tdl dl 默认相对目录是 downloads，在容器内请使用 -d /downloads，避免落到 /downloads/downloads/root/.tdl 对应的宿主机目录，重建容器通常无需重新登录--takeout 降低限流影响| 标签 | 说明 |
|---|---|
latest | 当前多架构最新构建 |
Content type
Image
Digest
sha256:510dcd53e…
Size
57.3 MB
Last updated
about 2 months ago
docker pull wannayoung/ubuntu-tdl