ytdlp.online
首页 油猴脚本

如何下载与安装 yt-dlp

Windows、macOS 和 Linux 的分步设置指南。

yt-dlp 是一个功能强大的命令行媒体下载器（youtube-dl 的积极维护分支），可让您从数千个网站下载视频和音频。由于它在终端中运行，没有原生图形界面。

要下载高质量视频（1080p、4K 等）或提取 MP3 音频，您必须安装 FFmpeg。此外，强烈推荐安装 Deno 等 JavaScript 运行时以绕过 YouTube 的限速和机器人封锁。以下是在您的设备上设置这些工具的完整指南。

不想安装软件？您可以直接在我们的 在线控制台 无需任何配置。

方法一：WinGet（推荐且最简单）

Windows 10 (1809+) 和 Windows 11 默认包含 Windows 包管理器 (winget)。它会自动管理安装、路径和更新。

  1. 打开 PowerShell 或命令提示符（CMD）。
  2. 运行以下命令： 
    winget install yt-dlp
  3. 重新启动终端窗口以应用环境更改。

方法二：Scoop / Chocolatey

适用于在 Windows 上使用命令行包管理器的高级用户。

Scoop: 
scoop install yt-dlp
Chocolatey: 
choco install yt-dlp

方法三：直接下载（.exe）

直接下载独立的可执行二进制文件。

  1. 下载最新二进制文件：
    下载 yt-dlp.exe
  2. 为 yt-dlp 创建一个文件夹，例如： C:\yt-dlp\，并将下载的 yt-dlp.exe 移入其中。
  3. 将文件夹添加到系统 PATH 环境变量：
    1. 按 Win + S 搜索"环境变量"，然后点击"编辑系统环境变量"。
    2. 在系统属性窗口中，点击 "环境变量..." 按钮。
    3. 在"系统变量"（或"用户变量"）下，找到并选择名为 Path 的变量，然后点击"编辑..."。
    4. 点击 "新建" 并输入文件夹路径：C:\yt-dlp，然后在所有对话框中点击 确定。
  4. 关闭并重新打开终端（PowerShell 或 CMD）以使 PATH 更改生效。

方法一：Homebrew（推荐）

Homebrew 是 macOS 的标准包管理器。它会自动解析所有依赖项，包括 Python 和 FFmpeg。

  1. 打开终端应用。
  2. 运行以下命令安装 yt-dlp： 
    brew install yt-dlp

方法二：MacPorts

或者，您可以使用 MacPorts 包管理器安装 yt-dlp。

sudo port install yt-dlp

方法三：直接使用 Curl 安装

将编译好的二进制文件直接下载到本地执行路径。

sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp

方法一：pip（推荐获取最新版本）

使用 Python 的 pip 管理器可确保您直接获取视频提取器脚本的最新更新。

  1. 使用 Python 3 pip 安装或更新 yt-dlp： 
    python3 -m pip install -U yt-dlp

方法二：发行版包管理器

通过 Linux 发行版包管理器安装 yt-dlp。

Debian / Ubuntu: 
sudo apt update && sudo apt install yt-dlp
Arch Linux: 
sudo pacman -S yt-dlp
Fedora: 
sudo dnf install yt-dlp

方法三：直接下载

将独立的 Linux 二进制文件直接下载到本地可执行路径。

  1. 使用 wget/curl 下载并设置权限： 
    sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlp

如何安装 FFmpeg（高清和 MP3 必需）

FFmpeg 是一个开源媒体库，yt-dlp 在底层使用它来合并单独的高清视频轨道（1080p、4K）和音频轨道，或将音频提取为 MP3。没有 FFmpeg，yt-dlp 只能下载 720p 或更低质量的带内置音频的流。

Windows

使用 winget 一条命令安装 FFmpeg：

winget install Gyan.FFmpeg

或者，从 Gyan.dev 下载构建版本，解压，然后将 bin 目录添加到您的 PATH 环境变量中。

macOS

如果使用 Homebrew，它会自动安装。手动安装命令：

brew install ffmpeg
Linux

通过系统包管理器安装：

Debian / Ubuntu: 
sudo apt install ffmpeg
Arch Linux: 
sudo pacman -S ffmpeg

如何安装 Deno（推荐用于 YouTube）

Deno 是一个现代 JavaScript 运行时。yt-dlp 在底层使用 Deno 来执行 YouTube 基于 JavaScript 的签名解密算法。安装 Deno 有助于绕过 YouTube 的下载限速和 "n-challenge" 机器人检测封锁。

Windows

使用 winget 一条命令安装 Deno：

winget install DenoLand.Deno

或者使用 Scoop： scoop install deno

macOS

通过 Homebrew 安装 Deno：

brew install deno
Linux

使用官方 shell 脚本安装 Deno：

curl -fsSL https://deno.land/install.sh | sh

运行此脚本前请确保已安装 unzip 和 curl。

验证安装

安装完成后，打开终端（PowerShell、命令提示符或 Terminal.app）并运行版本检查命令验证一切正常。

1. 运行版本命令

在终端中执行版本查询命令：

yt-dlp --version
2. 预期输出

如果安装成功，它会打印一个发布日期版本号，例如：

2026.06.18

如果提示"命令未找到"，请确保重新启动终端或验证包含 yt-dlp 的文件夹已正确添加到系统环境 PATH。

常见错误排查

遇到问题？以下是 Windows、macOS 和 Linux 上最常见 yt-dlp 错误的修复方法。

这意味着 yt-dlp 不在系统 PATH 中。如果您通过 winget、Homebrew 或 pip 安装，只需关闭并重新打开终端——PATH 仅对新会话生效。

如果您手动下载了 yt-dlp.exe，需要将其所在文件夹添加到 PATH 环境变量。请参阅上方的详细 PATH 设置步骤。

或者完全跳过本地设置， 在我们的在线控制台运行 yt-dlp ——无需任何配置。

YouTube 会封锁来自被标记或数据中心 IP 地址的下载。要在本地修复此问题，请将浏览器 Cookie 传递给 yt-dlp： 
yt-dlp --cookies-from-browser chrome "URL"
这可以让 yt-dlp 使用您已认证的 YouTube 会话来绕过封锁。

在 ytdlp.online，我们的后端服务器会自动为高级会员轮换住宅代理 IP 以绕过此限制。

yt-dlp 需要 FFmpeg 来合并单独的视频和音频流（1080p+ 下载必需）或提取 MP3 音频。请参阅上方的 FFmpeg 安装部分了解所有平台的详细设置说明。

快速修复： 
winget install ffmpeg
在 ytdlp.online，FFmpeg 已预装——所有合并和音频提取都在我们的服务器上自动完成。

这通常在 YouTube 更新其流媒体算法时发生，导致旧版本的 yt-dlp 无法工作。通过更新到最新版本来修复： 
yt-dlp -U
如果您通过包管理器安装，请使用其更新命令（例如 winget upgrade yt-dlp 或 brew upgrade yt-dlp）。

在 ytdlp.online，我们每小时扫描上游更新并自动保持系统核心更新。

YouTube 会有意限制 yt-dlp 的下载速度。安装 Deno（JavaScript 运行时）可让 yt-dlp 自动绕过限速。请参阅上方的 Deno 安装部分。

此外，请确保您使用的是 最新版本的 yt-dlp（yt-dlp -U），因为限速绕过方法会频繁更新。

在 ytdlp.online，Deno 已预配置，下载在高带宽服务器上运行，速度最大化。

这是误报。独立的 yt-dlp.exe 使用 PyInstaller 构建，它将 Python 解释器打包成单个可执行文件。杀毒软件经常标记 PyInstaller 打包的程序，因为一些恶意软件也使用相同的打包技术——但 yt-dlp 本身是完全安全的。

yt-dlp 是一个 100% 开源项目，托管在 GitHub 上，拥有 100,000+ 星标和数百名贡献者。源代码可公开审计。

修复方法：在 Windows 安全中心为 yt-dlp 文件夹添加排除项，或通过 winget install yt-dlp 安装（微软验证的包不会被标记）。

不想运行本地二进制文件？使用我们的 基于云的在线控制台 ——您的设备上无需安装任何东西。

如何更新 yt-dlp

YouTube 和其他视频平台频繁更新其流媒体协议，这可能导致旧版本的 yt-dlp 停止工作。保持本地安装更新到最新版本，可自动解决提取错误。

方法 A：独立二进制文件更新

如果您直接下载了二进制文件或通过 pip 安装，请在终端中运行内置更新命令：

yt-dlp -U
方法 B：包管理器更新

Windows (winget): winget upgrade yt-dlp

macOS (Homebrew): brew upgrade yt-dlp

Python (pip): python3 -m pip install --upgrade yt-dlp

快速入门命令

在终端中使用这些基础命令开始：

目标 命令 操作
下载视频（最佳画质） yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0"
提取 MP3 音频 yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0"
专业提示： 需要更多用于字幕提取、格式筛选、批量下载或绕过机器人封锁的高级命令？ 查看我们的完整 yt-dlp 速查表 →
💖 喜欢这份安装指南吗？分享给你的朋友吧！ 💖

yt-dlp 在 2026 年安全吗？

是的，yt-dlp 是安全的。它是一个 100% 开源项目，采用 Unlicense 许可证，托管在 GitHub 上，拥有 100,000+ 星标和数百名活跃贡献者。每一行代码都可公开审计。

  • 无遥测、无广告、无捆绑软件。yt-dlp 是一个纯净的、专用的命令行工具。
  • Windows Defender 误报是由 PyInstaller 打包引起的，而非恶意代码。通过 winget 安装可避免此问题。
  • 合法使用：yt-dlp 是一款通用媒体下载器。请仅下载您有权下载的内容——您自己上传的内容、Creative Commons 材料或经过明确许可的内容。

如果您不想在本地运行可执行文件，我们的 在线控制台 在我们的服务器上运行 yt-dlp——您的设备上无需安装任何东西。

100K+ ⭐
在 GitHub 上开源

不想在设备上安装软件？

直接在我们的服务器上运行 yt-dlp 命令。使用我们的网页界面下载播放列表、录制直播和即时提取音频。

试试播放列表下载器 尝试频道下载器 试试直播录制器 尝试 Twitch 下载器 尝试 Reddit 视频下载器 尝试字幕下载器
yt-dlp 工具箱
播放列表下载器 一键保存完整的 YouTube 播放列表 YouTube 频道下载器 批量下载频道的所有视频 直播录制器 实时录制正在播出的直播流 Twitch 下载器 保存 Twitch 录像、剪辑片段和直播流 Reddit 视频下载器 下载带声音的 Reddit 视频 字幕下载器 提取字幕为 SRT、VTT 或 TXT
查看所有 yt-dlp 工具
yt-dlp 帮助与文档
下载与安装
安装 yt-dlp 可执行文件与依赖
yt-dlp 速查表
常用命令速查
命令生成器
交互式命令生成器
完整帮助参考
完整参数列表
API 文档
REST API 文档