安装

安装 #

一键脚本 #

tdl 将被安装到 $Env:SystemDrive\tdl（将被添加到 PATH 中），该脚本还可用于升级 tdl。

安装最新版本 #

iwr -useb https://docs.iyear.me/tdl/install.ps1 | iex

通过 ghproxy.com 镜像安装 #

$Script=iwr -useb https://docs.iyear.me/tdl/install.ps1;
$Block=[ScriptBlock]::Create($Script); Invoke-Command -ScriptBlock $Block -ArgumentList "", "$True"

安装特定版本 #

$Env:TDLVersion = "VERSION"
$Script=iwr -useb https://docs.iyear.me/tdl/install.ps1;
$Block=[ScriptBlock]::Create($Script); Invoke-Command -ScriptBlock $Block -ArgumentList "$Env:TDLVersion"

tdl 将被安装到 /usr/local/bin/tdl，该脚本还可用于升级 tdl。

安装最新版本 #

curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash

通过 ghproxy.com 镜像安装 #

curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash -s -- --proxy

安装特定版本 #

curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash -s -- --version VERSION

包管理器 #

brew install telegram-downloader
scoop bucket add extras
scoop install telegram-downloader
pkg install tdl
yay -S tdl

nix-env #

nix-env -iA nixos.tdl

NixOS-Configuration #

environment.systemPackages = [
    pkgs.tdl
];

nix-shell #

nix-shell -p tdl

Packaging status

Docker #

可用镜像：

可用标签：

  • latest（默认）：最新的稳定版本
  • X.Y.Z：tdl的特定版本

以一次性命令运行 tdl：

docker run --rm -it iyear/tdl <ARGUMENTS>

进一步，挂载配置目录以保持持久化：

docker run --rm -it \
  -v $HOME/.tdl:/root/.tdl \
  iyear/tdl <ARGUMENTS>

为了方便获取下载的文件，可以挂载下载目录和其他需要的目录：

docker run --rm -it \
  -v $HOME/.tdl:/root/.tdl \
  -v $HOME/Downloads:/downloads \
  iyear/tdl <ARGUMENTS>

在容器内运行 tdl：

docker run --rm -it <FLAGS> --entrypoint sh iyear/tdl
预览输出
/ # tdl version
Version: 0.17.7
Commit: ace2402
Date: 2024-11-01T14:40:56+08:00

go1.21.13 linux/amd64
/ #

如果希望使用 localhost 地址的代理，使用 host 网络运行：

docker run --rm -it <FLAGS> --network host iyear/tdl <ARGUMENTS>

使用 Docker Compose 运行 tdl，避免每次输入 docker run 选项。

docker-compose.yml
示例配置使用 Docker Compose v2 语法。
services:
  tdl:
    image: iyear/tdl # 或指定特定版本的 X.Y.Z 版本标签
    volumes:
      - $HOME/.tdl:/root/.tdl # 保持配置持久化
      - $HOME/Downloads:/downloads # 可选
      # - /path/to/your/need:/path/in/container
    stdin_open: true
    tty: true
    # 如果需要使用 localhost 地址的代理，使用 host 网络
    network_mode: host

使用 Docker Compose 运行 tdl：

docker compose run --rm tdl <ARGUMENTS>

在容器内运行 tdl：

docker compose run --rm --entrypoint sh tdl
预览输出
/ # tdl version
Version: 0.17.7
Commit: ace2402
Date: 2024-11-01T14:40:56+08:00

go1.21.13 linux/amd64
/ #

预编译二进制 #

  1. 下载指定操作系统和架构的压缩包：
x86_64/amd64 x86 arm64 armv5 armv6 armv7
Intel M1/M2
x86_64/amd64 x86 arm64 armv5 armv6 armv7
  1. 解压缩压缩包
  2. 将可执行文件移动到所需目录
  3. 将此目录添加到 PATH 环境变量
  4. 确保您对文件具有执行权限

源代码 #

要从源代码构建 tdl 的扩展版本，您必须：

  1. 安装 Git
  2. 安装 Go 的 1.23 版本或更高版本
  3. 根据 Go 文档中的描述更新您的 PATH 环境变量
安装目录由 GOPATH 和 GOBIN 环境变量控制。如果设置了 GOBIN，则二进制文件将安装到该目录。如果设置了 GOPATH，则二进制文件将安装到 GOPATH 列表中第一个目录的 bin 子目录。否则，二进制文件将安装到默认的 GOPATH 的 bin 子目录（$HOME/go 或 %USERPROFILE%\go）。

然后构建：

go install github.com/iyear/tdl@latest
tdl version
Calendar 2025/06/08
Edit 编辑本页