HOG-StarWatch的主页

Appearance

安装 ​

一键脚本 ​

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

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

安装最新版本 ​

powershell
iwr -useb https://docs.iyear.me/tdl/install.ps1 | iex
bash
curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash

通过 ghproxy.com 镜像安装 ​

powershell
$Script=iwr -useb https://docs.iyear.me/tdl/install.ps1;
$Block=[ScriptBlock]::Create($Script); Invoke-Command -ScriptBlock $Block -ArgumentList "", "$True"
bash
curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash -s -- --proxy

安装特定版本 ​

powershell
$Env:TDLVersion = "VERSION"
$Script=iwr -useb https://docs.iyear.me/tdl/install.ps1;
$Block=[ScriptBlock]::Create($Script); Invoke-Command -ScriptBlock $Block -ArgumentList "$Env:TDLVersion"
bash
curl -sSL https://docs.iyear.me/tdl/install.sh | sudo bash -s -- --version VERSION

包管理器 ​

bash
brew install telegram-downloader
powershell
scoop bucket add extras
scoop install telegram-downloader
bash
pkg install tdl
bash
yay -S tdl
bash
↓见下↓

Nix ​

bash
nix-env -iA nixos.tdl
nix
environment.systemPackages = [
    pkgs.tdl
];
bash
nix-shell -p tdl

Packaging status

Docker ​

可用镜像：

可用标签：

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

Docker CLI ​

以一次性命令运行 tdl：

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

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

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

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

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

在容器内运行 tdl：

bash
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 网络运行：

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

Docker Compose ​

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

docker-compose.yml

INFO

示例配置使用 Docker Compose v2 语法。

yaml
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：

bash
docker compose run --rm tdl <ARGUMENTS>

在容器内运行 tdl：

bash
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. 下载指定操作系统和架构的压缩包：

Windows ​

macOS ​

Linux ​

  1. 解压缩压缩包
  2. 将可执行文件移动到所需目录
  3. 将此目录添加到 PATH 环境变量
  4. 确保您对文件具有执行权限

源代码 ​

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

  1. 安装 Git
  2. 安装 Go 的 1.23 版本或更高版本
  3. 根据 Go 文档中的描述更新您的 PATH 环境变量

INFO

安装目录由 GOPATH 和 GOBIN 环境变量控制。如果设置了 GOBIN，则二进制文件将安装到该目录。如果设置了 GOPATH，则二进制文件将安装到 GOPATH 列表中第一个目录的 bin 子目录。否则，二进制文件将安装到默认的 GOPATH 的 bin 子目录（$HOME/go 或 %USERPROFILE%\go）。

然后构建：

bash
go install github.com/iyear/tdl@latest
tdl version

Copyright © 2024-present StarWatch