浏览文档
指南
依次更新到 nightly 版、降低并发、检查 Deno,再测试有效的 Cookie 与可用的出口 IP。
本页内容
先做这些检查
- 更新 nightly 版。 在发生故障的下载进程所用的 Python 环境中更新 yt-dlp。
- 降低负载。 暂停此 IP 上的并行任务,每次只测试一个视频、一个片段。
- 检查 Deno。 确认详细日志显示已检测到 JavaScript 运行时。
- 试用有效的 Cookie。 对于少量下载,使用能够播放源视频的浏览器会话。
- 更换被拒绝的出口 IP。 使用可用的主机或代理出口重新提取。
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --versionpython -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --downloader native \
--concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"在发生故障的下载进程上运行。 查看详细日志中的 Proxy map 以确认实际路由。--ignore-config 会忽略保存的选项,但仍使用已安装的插件与环境代理。
保存了文件才算传输成功。 音频下载成功后,使用 -f bv 测试视频,然后恢复完整的输出设置。--simulate 和 -F 不会验证媒体传输。2M 限速可作为排查的起点。
1、更新到夜间
以前工作命令突然失败: 更新首先。 YouTube 播放器的变化可能会破坏更老的提取器;最新夜间可能已经包含修复。
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
python -c "import sys, yt_dlp; print(sys.executable); print(yt_dlp.__file__)"yt-dlp --update-to nightly
yt-dlp --version如果图像包含较旧的包,重启和重新启动容器;在主机上更新 Python 不会更新该容器。
删除旧的 player_client, player_js_version 和 format=missing_pot 基线的过渡。一个从一个旧事件的下载进程现在可以选择一个不合适的客户端或暴露一个流,其标志仍然缺乏。問題 #14680 是玩家變更固定上流的例子;無限地複製其暫時過度並不是修正。
2. 减少竞争要求
下载工作,然后失败,因为量增加:减少出口 IP的总负载。 在FlashData的经验中,快速平行转移可以引发拒绝。
| 负载的来源 | 第一诊断设置 |
|---|---|
| 竞争视频工作 | 一个活跃的视频为此输出IP;暂时停止剩余的绳子。 |
| 原生部分请求 | --concurrent-fragments 1. |
| aria2 或其他外部下载器 | 改回 --downloader native。如果之后恢复使用 aria2,请从 -x 1 -s 1 -j 1 开始。 |
| 媒體帶幅 | 尝试 --limit-rate 2M 作为保守性测试,然后逐步增加。 |
| 抽出和新下载 | 使用 --sleep-requests 2 和 --sleep-interval 5 --max-sleep-interval 10. |
| 无奈退休 | 保持工作级和下载级退休计算有限;不要在下载进程中增加。 |
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--downloader native --concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
--sleep-interval 5 --max-sleep-interval 10 --retries 1 --fragment-retries 1 -f bv \
-o "diagnostics/%(id)s-%(epoch)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"如果低负载转移工作,保持该基线并同时增加一维,同时观察失败。如果它仍然在 nightly/runtime 检查后立即失败,不要继续无限地减少带宽:测试不同的输出 IP。YouTube 已标志的路线可能在引发的流量停止后仍然被拒绝。
3、检查Deno
检查下载进程的两种依赖: Deno 运行挑战; yt-dlp-ejs 提供解决方案编写; [default] 附加安装编写;单独安装 Deno。
deno --version
python -m pip show yt-dlp yt-dlp-ejs
python -m yt_dlp --list-impersonate-targetspython -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"阅读JS运行线的Deno,以及任何 [jsc:deno] 解决消息。缺失运行时间或 signature/n-challenge 警告需要在另一个大下载运行之前修复。Deno 2.3+ 是 EJS 文档中最少的现行;使用更新支持的版本。
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"curl-cffi 额外允许 --impersonate="”。它提供像浏览器一样的请求指纹;它不取代Deno。如果浏览器目标不可用,则在同一 Python 环境中安装额外。如果在工作路线上出现失败,则将同样的请求与没有旗帜相比较。
依赖性检查后,真实的媒体转移将恢复。如果当前的夜间仍然报告同一玩家签名解决失败,则保存玩家 ID 和解决器消息,以便匹配上流问题。如果解決成功,媒體獲得 403,繼續進行 session/IP 檢查。
5、取代被拒绝的输出IP
同一公开视频、相同设置、换 IP 后结果不同: 更换故障出口。FlashData 观察到许多持续出现的 403 与质量不佳或被标记的代理 IP 有关。重新安装 yt-dlp 无法修复该出口线路。
- 保持源、夜间修订、Deno、必要时Cookie和格式选项器相同。
- 测试一个替代输出IP与新鲜的提取和真实的媒体转移。
- 确认该代理实际上改变了其输出IP. 一个新的门户主机名称或认证仍然可以导致相同的输出。
- 保持在提取、代币生成和媒体转移期间的紧密的代理会议。
- 取消或冷却您的游泳池中失败的出口,转向另一个健康的出口,以获得新的工作或控制退休。
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --proxy "http://USER:PASSWORD@HOST:PORT" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --proxy "" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
--force-ipv4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"| 结果 | 下一步 |
|---|---|
| 同一源在新输出IP上成功 | 保持这条路线和其低负载基线,四分之一的失败的出口,而不是为每个视频退出。 |
| 改变proxy 信号没有效应 | 查看实际的进展IP和会议政策;代理人仍然可以使用相同的输出。 |
| 播放器工作,媒体只通过proxy失败 | 查看 googlevideo.com 访问,而媒体使用相同的 exit/session. |
| 每条测试路线上都有一个源头失败;控制工作 | 查找源、格式和现场状态,不要从一个视频中标记整个流动游泳池。 |
先进:在一个IP上保持提取和转移
一个常见的应用错误是在一个机器上提取 info['url'],将其存储在一个尾巴中,然后在其他地方下载。签名的媒体URL终止,可能依赖于原始IP和请求标题。一个旋转的代理可以在一个应用程序内创建相同的分裂。
查询 YouTube 视频 ID 和所需输出设置。让下载进程进行新鲜的提取和下载一起。如果下载进程使用一个代理,保持相同的进展通过玩家提取,代币生成和媒体请求。请求代理提供商进行紧密的会议,而不是旋转每个 HTTP 请求。
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget
options = {
"js_runtimes": {"deno": {}},
"impersonate": ImpersonateTarget(),
"format": "ba",
"outtmpl": "diagnostics/%(id)s-%(epoch)s.%(ext)s",
"noplaylist": True,
"verbose": True,
# If required, configure one sticky proxy for the entire job:
# "proxy": "http://USER:PASSWORD@HOST:PORT",
}
with YoutubeDL(options) as downloader:
downloader.download(["https://www.youtube.com/watch?v=jNQXAC9IVRw"])如果在 requests.get(saved_media_url) 或一个单独的 FFmpeg 过程失败时成功,请检查此失败: URL 年龄、提取器提供的标题、 Cookie 和实际的进展。保持媒体URL远离可持续工作记录。在退出已耗尽的提取结果时,请从原始视频 ID 要求新鲜的 URL。
先进:识别失败的请求
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F列出提取格式; --simulate停止,在保存媒体之前。它也不会证明所选择的流量会返回比特。如果日志达到 Downloading 1 format(s) 然后与媒体数据 403 失败,更改输出文件名或安装 FFmpeg 不会修复该 HTTP 请求。
YouTube 客户端配置文件如 mweb 和 web_safari 改变玩家响应请求 yt-dlp。有些答案需要签名或n参数转换;一些媒体请求也需要GVS证据的起源标志。对于玩家请求的 PO 标志不可与媒体交付或子标题的标志交换。
| 登录位置 | 解释 |
|---|---|
Unable to download API page / Unable to download webpage | 提取请求被拒绝 识别该主机之前将其视为媒体服务器故障。 |
unable to download video data: HTTP Error 403: Forbidden | 已被拒绝的媒体请求,请遵循下面的 solver/token/route 分支。 |
| 片段 Retry 消息 | 保持片段错误和协议;比较另一个可用的格式而不是无限地撤回相同的片段。 |
| FFmpeg 說 HTTP 403 在閱讀入口時 | FFmpeg 是接收远程媒体,例如,对于一个剪辑。 检查 URL 和网络转到 FFmpeg; 这不是一个地方编码器错误。 |
存储上传返回 AccessDenied | 文件到达了您的上传阶段。 修复上传的布克特访问和退出,而不是YouTube下载。 |
先进:安装 PO-token 提供商
使用此分支,当需要的格式被转换为一个失踪的 GVS 代币,或者您的配置代币被拒绝。图标连接到一个 client/request 背景,并可以连接到视频 ID。一个复制一个视频的代码不是一个全线的可重复使用的认证。使用提供商来创建当前请求的代币。
下列设置使用 bgutil 2.0.2。它有两个部分:一个由 yt-dlp 加载的 Python 插件和一个由 tokens 生成的 JavaScript 服务。保持其版本在升级时一致。下面的例子使用在港口4416的同一托管上可访问的服务。
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"要在 Docker 主机上运行 yt-dlp,只发布 loopback 端口。
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2需要 Git、Node 22+ 和 npm. 在单独的终端运行最后一个命令,然后让它运行。 如果文件夹已经存在,请使用现有匹配释放的支票。
git clone --depth 1 --branch 2.0.2 https://github.com/Brainicism/bgutil-ytdlp-pot-provider.git
cd bgutil-ytdlp-pot-provider/server
npm ci
npx tsc
node build/main.js --host 127.0.0.1 --port 4416python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
--extractor-args "youtube:player_client=mweb" \
--extractor-args "youtubepot-bgutilhttp:base_url=http://127.0.0.1:4416" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"PO Token Providers: bgutil:http-2.0.2 (external)
Generating a gvs PO Token for mweb client via bgutil HTTP server
[download] 100%| 观察结果 | 修复 |
|---|---|
PO Token Providers: none | 插件不加载。 安装它与同一个 Python 翻译器;删除 --no-plugin-dirs. 单独的二元,使用提供商的文档插件 ZIP 安装而不是将其带入一个不相关的环境。 |
Error reaching GET … /ping | 启动提供商或修正 base_url. 从下载程序检查,而不仅仅是您的笔记本电脑浏览器。 |
| 供应商列出,但没有一代发生 | 阅读之前的播放器错误。 LOGIN_REQUIRED 可以在标志阶段之前停止请求。 加载的插件不会证明它已被使用。 |
| 创建一个代币,然后 bot/sign-in 拒绝 | 转到 session/network 诊断。 创建一个标志不验证浏览器帐户。 |
| mweb 代币工作,旧强制客户端仍然失败 | 不要再使用 mweb 的代币为另一个客户端。 让供应商处理所选择的背景,或者返回工作客户端配置。 |
如果使用两个容器,下载进程内部的 127.0.0.1 指向自身。将两个服务放在同一个 Docker 网络中,并使用提供程序的服务名,例如 http://bgutil-provider:4416。避免将提供程序的端口向公网开放。
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
--extractor-args "youtube:player_client=mweb" \
--extractor-args "youtubepot-bgutilhttp:base_url=http://bgutil-provider:4416" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"问题 #17681 记录了通过转向供应商解决的手动标志故障。它还包含一个后续的重复:将工作修复视为证据证明该代币失败,而不是证据证明每一个后期403都有相同的原因。
先进:一个格式、剪辑或直播失败
列表格式与相同的Cookie,提供商和网络选项与失败下载。直接运行失败的格式。如果另一个可用的格式工作,您将失败缩小到 delivery/client 路径;您没有确定每个分辨率或编码器都被打破。
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-F "https://www.youtube.com/watch?v=jNQXAC9IVRw"python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
-f YOUR_FORMAT_ID -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"SABR警告涉及客户提供的格式。他们不像一个n-挑战失败。如果一个旧的 web 过渡器只产生 unavailable/unsupported 格式,请删除过渡器或使用文档 mweb/provider 路径。不要添加 formats=missing_pot 作为修复:它暴露格式,而不提供失去的标志。
直播、最近完成和常见上传的视频可以展示不同的示范。此状态在搜索上流时包含。如果最近完成的流量仍在处理,则现有替代格式或后续提取可能是下一个有用的测试;添加全球编码器的过度到每个下载进程是不可能的。
回复一名下载进程
首先,重复失败的源与原始要求的 video/audio 输出。然后,使用现有示范、档案和输出政策重新启动一个下载进程。如果所有工作都共享相同的失败会议或路线,休息该跳动而不是增加其失败。
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txt每一次尝试时返回的403需要退休前改变状态。不要设置无限的片段退出或将失败的ID移动到成功档案。如果媒体完成,仅存储交付失败,重新上传保存的文件。
未能成功?准备一个有用的错误报告
- 捕获实际失败的转换与 --verbose,而不仅仅是一个成功的 --simulate运行。
- 保持 yt-dlp 修订, runtime/EJS 版本,加载的供应商和选择的 format/protocol.
- 包括在错误之前的警告,是否被要求一个代币,以及是否在媒体选择之前或之后出现故障。
- 在 IPv4/direct/proxy 上记录相同来源的结果,仅适用于您实际进行的比较。
- 删除 Cookie 内容、proxy 认证、签署的 URL 和 tokens 之前共享日志。
使用具体的先前警告和您的发布搜索。如果匹配的回归仍然开放,请保持失败的项目,并在跟踪修复时使用确认的工作路径。一个清洁的日志,只说“403”不那么有用,而是一个短篇记录,显示了请求和控制的变更失败。