YTDLnis 中文文档 下载 App

yt-dlp 三种更新源 Stable Nightly Master 选哪个

为什么要关注 yt-dlp 版本

yt-dlp 是 YTDLnis 的心脏,而 yt-dlp 自己的维护节奏很快——目标网站(YouTube、B 站、TikTok 等)经常改版防爬策略,yt-dlp 要跟着改才能继续工作。如果你的 yt-dlp 版本太旧,下载时可能报:

这些场景第一件事就是更新 yt-dlp。

三种更新源

「更多 → 设置 → Updating → yt-dlp Source」里选:

源适合谁说明
Stable(默认)不太依赖的普通用户最稳定但更新最慢,重大修复可能落后几周
Nightly推荐,绝大多数用户日更版,平衡稳定性和时效性,包含 Stable 没有的大部分修复
Master高级用户 / 必须用最新修复的每次提交都构建,修复最快但也最容易引入新 Bug
Custom有特殊需求的填一个自定义的 yt-dlp 仓库 fork

推荐选 Nightly——Stable 太慢经常跟不上网站改版、Master 太激进偶尔出问题。Nightly 是官方也推荐的主力源。

自动更新

Updating 设置里还有:

一般开自动检查就够了,不用开启动时更新。

手动更新

两种方式:

  1. 终端命令:打开内置终端 → yt-dlp -U,等它跑完就行
  2. 设置页面:「更多 → 设置 → Updating → yt-dlp Source」旁边有「Check now」按钮

终端更新可以在里面看到更详细的日志输出,包括下载了什么版本、更新了哪些内容。

某些地区更新不了

如果在中国大陆或部分网络受限地区,从 GitHub 拉取 yt-dlp 可能会被墙导致更新失败。表现是通知了有新版但下载卡住、或者 Updating 页面显示网络错误。

解决方案:

  1. 切换到 Nightly 源试试(有时 Stable 和 Nightly 的分发节点不同)
  2. 用终端手动更新时配合代理(终端里 yt-dlp 会继承系统代理设置)
  3. 换一个网络环境更新一次后就不用再管了(更新源保持 Nightly,自动更新在下次可用网络时继续)