# @distube/yt-dlp 中文文档

规范地址：https://npmcn.com/package/%40distube/yt-dlp/

版本：2\.0\.1
npm 元数据更新时间：2024-06-07T09:02:43.517Z
中文译文更新时间：2026-11-12T12:19:33.610Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40distube/yt-dlp
原文对照：https://npmcn.com/package/%40distube/yt-dlp/?lang=original
项目主页：https://github.com/distubejs/extractor-plugins/tree/main/packages/yt-dlp#readme
源码仓库：https://github.com/distubejs/extractor-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：66.5 kB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：distube 5
- 首次发布：2022-01-27T14:06:09.277Z
- 最新版本发布：2024-06-07T09:02:41.412Z
- 近 30 天下载量：3956（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 0 个）

## 中文简介

一个使用yt-dlp的DisTube可播放取取器插件.

## 安装

```sh
npm install @distube/yt-dlp
```

也可以使用：`pnpm add @distube/yt-dlp`、`yarn add @distube/yt-dlp`、`bun add @distube/yt-dlp`

## README

[![](https://nodei.co/npm/@distube/yt-dlp.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/@distube/yt-dlp)

![npm peer dependency version](https://img.shields.io/npm/dependency-version/@distube/yt-dlp/peer/distube?style=flat-square) ![npm](https://img.shields.io/npm/dt/@distube/yt-dlp?logo=npm&style=flat-square) ![GitHub Repo stars](https://img.shields.io/github/stars/distubejs/extractor-plugins?logo=github&logoColor=white&style=flat-square) [![Discord](https://img.shields.io/discord/732254550689316914?logo=discord&logoColor=white&style=flat-square)](https://discord.gg/feaDd9h)

[![Buy Me a Coffee at ko-fi.com](https://storage.ko-fi.com/cdn/kofi3.png)](https://ko-fi.com/skick)

# @distube/yt-dlp (英语)

使用 DisTube 可播放提取器插件 [yt- dlp (日语)](https://github.com/yt-dlp/yt-dlp)

[_什么是可播放的提取器插件?_](https://github.com/skick1234/DisTube/wiki/Projects-Hub#plugins)

# 特性

-   支助 [900多个地点](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md) 使用 [yt- dlp (日语)](https://github.com/yt-dlp/yt-dlp)

# 所需经费

-   [蟒蛇](https://www.python.org/)

# 安装

```sh
npm install @distube/yt-dlp@latest
```

# 使用量

```ts
import { DisTube } from "distube";
import { YtDlpPlugin } from "@distube/yt-dlp";

const distube = new DisTube(client, {
  plugins: [new YtDlpPlugin({ update: true })],
});
```

# 文档

### 新 YtDlp Plugin( \[YtDlp Plugin 选项\])

创建 DisTube 的 `ExtractorPlugin` 举个例子.

-   `YtDlpPluginOptions.update` (单位:千美元)`boolean`: 默认为 `true`。当插件初始化时更新 yt-dlp 二进制.

> YtDlpPlugin 应该是其中最后一个插件 `plugins` 阵列.

## 环境变量

-   `YTDLP_DISABLE_DOWNLOAD`: 设定为禁用下载yt-dlp 二进制.
-   `YTDLP_URL`: Yt- dlp 二进制下载的URL.
-   `YTDLP_DIR`: 下载yt-dlp 二进制的目录.
-   `YTDLP_FILENAME`: yt-dlp 二进制的文件名.

## 解决问题

### 安装失败( 状态代码: 403)

您的 IP 已被 GitHub 限制速率, 插件无法获得 yt- dlp 二进制的最新链接 . 您可以使用环境变量更改下载链接 `YTDLP_URL`,或通过设置来禁用下载 `YTDLP_DISABLE_DOWNLOAD` 改为 `true`。 。 。 .

```sh
export YTDLP_URL=https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp
npm install @distube/yt-dlp@latest
```

```sh
export YTDLP_DISABLE_DOWNLOAD=true
npm install @distube/yt-dlp@latest
```

### 运行插件失败( 状态代码: 403)

插件无法在启动时下载 yt- dlp 二进制 。 与上案同为相. 您可以在启动时禁用下载 `new YtDlpPlugin({ update: false })` 或使用以上溶液.

```js
import { DisTube } from "distube";
const distube = new DisTube(client, {
  plugins: [new YtDlpPlugin({ update: false })],
});
```

## 常见问题

### @distube/yt-dlp 是什么？

一个使用yt-dlp的DisTube可播放取取器插件\.

### 如何安装 @distube/yt-dlp？

在项目目录运行 npm install @distube/yt-dlp，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：distube（5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @distube/yt-dlp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @distube/yt-dlp 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @distube/yt-dlp 可以商用吗？

@distube/yt-dlp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @distube/yt-dlp 的下载量有多少？

根据 npm 官方下载统计，@distube/yt-dlp 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,956 次，日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @distube/yt-dlp 还在维护吗？

最新版本 2\.0\.1 发布于 2024/06/07（2 年前）；至今共发布 12 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/01/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。