搜索文章 Ctrl K

【跑通版】yt-dlp完全版

周店瑟谷 45 阅读 AI 工具与智能体

项目地址：yt-dlp/yt-dlp: A feature-rich command-line audio/video downloader

yt-dlp --js-runtimes node --cookies cookies.txt --extractor-args "youtube:client=ios" -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" "https://www.youtube.com/watch?v=K0IRHe2zR10"

看到这个报错和 GitHub Issue 的长截图，真的是太真实了！你踩中了目前 Chromium 内核（包括最新的 Edge 和 Chrome）刚刚推出的一个终极防御机制：应用绑定加密 (App-Bound Encryption)。

从你截图里的 GitHub Issue 讨论中也能看出来，这是最近在 yt-dlp 社区引起哀鸿遍野的新问题。

简单来说，Edge 和 Chrome 最近更新了底层安全机制。以前，yt-dlp 可以直接去你的 Windows 硬盘里读取浏览器的 Cookie 数据库，并使用系统的 DPAPI 进行解密。但现在，微软和谷歌把门彻底焊死了：只有浏览器本身（那个主进程）才能解密这些 Cookie。外部的任何第三方脚本（包括 yt-dlp）只要强行去读，就会直接报 Failed to decrypt with DPAPI。

这也就意味着，--cookies-from-browser 这个曾经最好用的参数，在最新版的 Edge 上暂时算是“阵亡”了。既然外部强攻不行，我们只能从浏览器内部“智取”。

唯一且最稳妥的破局方案：使用浏览器扩展内部导出

既然只有浏览器自己能解密，我们就让浏览器内部的合法插件把解密好的、且刚刚通过风控的“热乎” Cookie 吐出来。

第一步：安装专用导出扩展

打开你的 Edge 浏览器，进入扩展商店，搜索并安装名为 Get cookies.txt LOCALLY 的插件。这个插件是开源的，也是 yt-dlp 官方推荐的配套工具，它导出的格式完全兼容。

第二步：提取“经过验证”的 Cookie

  1. 在 Edge 里打开你需要下载的那个 YouTube 视频页面。

  2. 确保视频能够正常播放几秒钟（这一步非常核心，是为了让浏览器跑完当前的 JS 风控挑战，拿到最新的有效 Token）。

  3. 点击浏览器右上角的 Get cookies.txt LOCALLY 插件图标，点击导出按钮。

第三步：替换工作目录中的文件

将刚刚下载好的文件重命名为 cookies.txt，直接拖到你的 D:\视频下载\ 目录下，覆盖掉你之前那个可能已经失效或被锁定的旧文件。

第四步：执行最终极简命令

现在你已经有了解密后的、新鲜的凭证。并且因为你后台开着 Clash 的 TUN 虚拟网卡模式，不需要额外配置代理端口。请直接在 PowerShell 运行：

PowerShell

yt-dlp --cookies cookies.txt -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" https://youtu.be/XAOulOejkbo（无效）


yt-dlp --js-runtimes node --cookies cookies.txt --extractor-args "youtube:client=ios" -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" "https://www.youtube.com/watch?v=K0IRHe2zR10"

通过这个逻辑链路：插件内部解密 -> 规避 DPAPI 报错 -> 绕过 JS 风控 -> 直接合并 4K，这是目前对抗 YouTube 频繁升级的反爬机制最高效、也是唯一能长期稳定的路径了。

yt-dlp --js-runtimes node --cookies cookies.txt --extractor-args "youtube:client=ios" -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" "https://www.youtube.com/watch?v=7hE9_7vAT3w"


太棒了！看截图你的下载速度跑到了稳稳的 18.31 MiB/s，而且完美绕过了 YouTube 的层层封锁。

你打出的这套参数组合，可以说是目前对抗 YouTube 反爬虫机制的“终极形态”。它不仅解决了 403 报错，还兼顾了最高画质和通用格式，非常值得作为以后下载 4K 视频的标准化模板。

我来帮你把这条长命令进行逐段拆解，让你清楚了解每个参数的战略意义：

核心参数拆解

1. 召唤程序

  • yt-dlp：命令行主程序。

2. 核心反爬虫阵列（破盾利器）

  • --js-runtimes node：动态签名破解。YouTube 会下发复杂的 JavaScript 挑战代码（也就是之前让你在 IDM 里疯狂报 403 的元凶之一）。这个参数让 yt-dlp 调用你电脑上的 Node.js 环境去真实“算”出正确答案，向服务器证明“我是一个有运算能力的真实设备”。

  • --cookies cookies.txt：身份与信誉担保。这是你这次使用的核心方案。携带真实浏览器的 Cookie 访问，不仅能下载年龄限制或会员专享视频，更重要的是给你的请求加上了“真实活跃用户”的信誉权重，极大降低了被拉黑 IP 的概率。

  • --extractor-args "youtube:client=ios"：伪装客户端通道。这是非常高阶的一手操作。YouTube 网页版（Web端）的风控目前是最严苛的，但移动端 API 往往相对宽松。这个参数强制 yt-dlp 伪装成苹果 iOS APP 去索要视频流，成功率极高且往往能拿到更纯净的节点流。

3. 画质与格式的极致追求

  • -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best"：自动无损封装。这是一个带有退路设定的格式筛选器，顺序如下：

  • 首选方案： bestvideo[ext=mp4]+bestaudio[ext=m4a]（索要最高画质的纯视频流 + 最高音质的纯音频流，下载后依赖 FFmpeg 自动合并为高质量 MP4 文件）。

  • 备用方案一： /best[ext=mp4]（如果拿不到分离的高规格流，就下载 YouTube 官方封装好的最高画质 MP4）。

  • 兜底方案： /best（如果连 MP4 都没有，有什么最高清的就下什么）。

4. 目标定位

  • "https://www.youtube.com/watch?v=7hE9_7vAT3w"：你要下载的金枪鱼视频原链接。

你的专属复用模板

为了以后折腾效率更高，你可以把这段代码存进备忘录。下次下视频，只需要无脑替换最后面双引号里的链接即可：

PowerShell

yt-dlp --js-runtimes node --cookies cookies.txt --extractor-args "youtube:client=ios" -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" "这里粘贴你的YouTube视频链接"

💡 长期复用的两个关键点：

  1. Cookie 的保质期： cookies.txt 文件里的登录状态是会过期的。如果你隔了几个月再次用这串命令发现又报错了，只需重新用浏览器插件导出一份最新的 cookies.txt 覆盖掉旧文件就行。

  2. 底层依赖： 这串命令能跑得这么顺，意味着你电脑的环境变量里已经成功配置了 Node.js（负责算防盗链）和 FFmpeg（负责合并音视频）。以后重装电脑时，记得也要把这两位“幕后英雄”装上。