OpenSource-Hub
Y

yt-dlp

SHA-256
162.0k stars·影音下载·已提供 SHA-256 校验码,下载后可自行核对文件完整性

功能丰富的命令行音视频下载器,支持数千网站。youtube-dl 的活跃分支,更快更稳。

智能下载

下载 Download 版本

v2026.03.17 · 21.5 MB

百万用户信赖的万能视频下载神器,支持上千网站,命令行一键搞定。

核心功能

  • 支持 YouTube、B站、Twitter、Instagram 等上千个网站
  • 可下载视频、音频、字幕、缩略图,支持格式与质量选择
  • 支持播放列表/频道/用户全部内容批量下载
  • 集成 SponsorBlock 自动跳过广告段落
  • 支持自定义输出文件名模板(日期、标题等)

避坑指南

  • 部分网站(如 Netflix、HBO)受 DRM 保护无法下载;2. 命令行工具,需熟悉基本终端操作;3. 频繁下载可能触发网站限流,建议合理间隔;4. 更新频繁,建议定期升级以保持兼容性。

适用场景

  • 收藏 YouTube 视频 / 音乐离线播放
  • 下载 B站、微博、抖音等平台视频用于剪辑或存档
  • 批量备份整个频道或播放列表
  • 配合脚本实现定时下载或者自动化工作流

详细介绍

yt-dlp 是一个功能强大的命令行音视频下载工具,支持 YouTube 及上千个其他网站。作为知名 youtube-dl 的活跃分支,它新增了许多功能、修复了漏洞,并保持快速更新。支持格式选择、字幕、播放列表、元数据嵌入、SponsorBlock 集成,以及通过配置文件和插件实现高度定制。提供 Windows、macOS、Linux 独立二进制文件及 pip 安装。适用于自动化下载、内容归档和离线观看。

常见问题与排障 (2)

故障排除
如何修复 yt-dlp 中的 'nsig extraction failed' 和 'Sign in to confirm you’re not a bot' 错误?

1. 将 yt-dlp 更新到最新的 nightly 版本:yt-dlp -Upip install -U yt-dlp
2. 如果仍然遇到“请登录以确认您不是机器人”的错误,请传递浏览器 cookies 以绕过 YouTube 的机器人检测。使用 --cookies-from-browser BROWSER(例如 --cookies-from-browser chrome)或通过 --cookies COOKIES_FILE 导出 cookies 文件。详细步骤请参见:https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies
3. “nsig extraction failed”警告通常在更新后消失;如果没有,这是一个已知的临时问题——请关注链接的 GitHub issues 以获取更新。

来源 Issue #16833
故障排除
为什么 yt-dlp 不显示 YouTube premium 视频格式(如增强比特率、格式 ID 356 或 721)?

你必须将YouTube Premium账户的cookies传递给yt-dlp。使用--cookies-from-browser BROWSER(例如chrome)或--cookies cookies.txt。如果格式仍未出现,将yt-dlp更新到最新的nightly版本(yt-dlp --update-to nightly),因为YouTube经常修改格式逻辑。某些Premium格式还需要po_token,你可以从浏览器的YouTube页面提取,并通过--extractor-args youtube:po_token=TOKEN传递。最后,确认该视频在你所在区域确实提供这些格式;Premium格式可能受地区限制。

来源 Issue #16851

标签

video-downloaderyoutube-dlcliaudiovideoopen-source

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

访问 GitHub Releases 下载对应系统的二进制文件(如 Windows 选 yt-dlp.exe)

4

打开终端/命令提示符,运行 yt-dlp "视频链接"

5

等待下载完成,文件保存在当前目录

安装指引
  1. 访问 GitHub Releases 下载对应系统的二进制文件(如 Windows 选 yt-dlp.exe)
  2. 打开终端/命令提示符,运行 yt-dlp "视频链接"
  3. 等待下载完成,文件保存在当前目录
文件完整性

已提供 SHA-256 校验码,下载后可自行核对文件完整性

该校验码提取自 GitHub 官方 Release 页面

SHA256 校验码

6cfba1af5147da0196d8c015961b1422bdd47fc2f9bb6df8cb4d1dc029939c51

该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

直接删除下载的二进制文件即可。若通过 pip 安装,执行 pip uninstall yt-dlp。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议Unlicense
最后更新2026-06-26 21:35:51
GitHub 仓库

遇到问题?查看下方 FAQ

2 FAQs

相似推荐