# 修复 yt-dlp 的「Sign in to confirm you’re not a bot」错误

使用 nightly 版、Deno、有效的浏览器会话与可用的出口 IP 排查「Sign in to confirm you’re not a bot」。

规范链接： https://flashdata.dev/zh/docs/guides/yt-dlp-sign-in-not-a-bot
FlashData 核查于 2026-11-13

- [新或过时的下载进程](https://flashdata.dev/zh/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#baseline) — 夜间检查，丹诺和清洁基地线
- [同样的IP仍然被阻止](https://flashdata.dev/zh/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#network) — 取代出口，控制其工作负载
- [小工作需要Cookies](https://flashdata.dev/zh/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#cookies) — 使用有效的浏览器会议
- [The provided YouTube account cookies are no longer valid](https://flashdata.dev/zh/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#renew-session) — 出口和测试新鲜会议

<a id="first-response"></a>

## 先做以下四项检查


1. **更新 nightly 版。** 更新发生故障的下载进程所用的 yt-dlp，再测试一个源视频。
2. **检查 Deno。** 确认详细日志显示该运行时。
3. **试用有效的会话。** 对于少量下载，浏览器 Cookie 可能有帮助。
4. **测试另一个出口 IP。** 如果同一公开视频在备用出口可用，就把任务移出被标记的线路。

> **被标记的 IP 可能连续数天遭到拒绝**
> FlashData 在批量下载中观察到过这种情况。如果控制条件相同的测试在另一出口成功，就停用故障线路。短暂等待不一定能解除限制。

- [HTTP 429 限流等待与请求间隔](https://flashdata.dev/zh/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [HTTP 403 错误恢复](https://flashdata.dev/zh/docs/guides/yt-dlp-403-forbidden/reference.md)

<a id="symptoms"></a>

## 遇到其他提示时如何排查


| 提示或表现 | 下一篇 去哪里 |
| --- | --- |
| `Sign in to confirm you’re not a bot` / `LOGIN_REQUIRED` | 夜间检查和 Deno,然后比较输出IP和有效的会议。 |
| `The provided YouTube account cookies are no longer valid` | 使用下面的更新程序取代出口会议。 |
| HTTP 429 | 停止受影响的输出和较低的请求频率；使用单独的429指南。 |
| `Could not copy Chrome cookie database` / `Failed to decrypt with DPAPI` | 修复本地 Cookie 加载故障；已确认的请求尚未发生。 |
| 選擇格式，然後媒體 HTTP 403 | 遵循 403 指南，以了解竞争、IP 和媒体请求的背景。 |

<a id="baseline"></a>

## 1、更新和测试一个来源


**测试访问前重新清理基线**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
```

使用 Deno 2.3+ 并在字母日志中确认其检测；由此工作流要求。此分類上一篇：與此相匹配的EJS溶液為一個官方獨立的二元，使用 yt-dlp --update-to 夜間，並取代 Python -m yt_dlp 與 yt-dlp。保持相同的来源和网络，下面的两个测试。

**A.清洁匿名提取**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

用错误的视图 URL 取代示例。 --ignore-config 删除默认的 cookie/client 设置；它不会删除环境预览或安装插件。

**B. 可以播放视频的 Firefox 个人资料**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --cookies-from-browser firefox --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

登录到 Firefox 的预定帐户并确认正确的视频播放在那里首先。 此阅读该浏览器会议；它不使用 Chrome 的会议。

| A / B 结果 | 需要调整的内容 |
| --- | --- |
| 一个工作;B失败 | 从您的公共视频工作中删除不必要的 Cookie 选项。 选择的会话或验证的客户端路径引入了故障。 仅更新它需要帐户访问的工作。 |
| 失败:B工作 | 保持工作会议源在工作中。 对于无头下载进程，用下面的程序出口会议，并在下载进程身上进行测试。 |
| B 不能 copy/decrypt cookie | 首先解决本地浏览器文件错误。 您尚未测试验证访问。 |
| 服务器上的两者都失败；同样的测试在本地工作 | 检查下载进程的运行时间/配置，然后比较其输出网络和总请求量。 |
| 两者都失败，一个源头失败；公共控制成功 | 检查准确的来源可用性和帐户访问。 不同的公共视频成功不会确定访问此。 |

保持老`player_client`超越这个基线。已验证和匿名默认客户端可能会有所不同。因此，提供Cookie是对会议背景和客户端选择的有意义的变化，而不是简单地添加一个普遍的解锁旗帜。

- [更新实际下载进程安装](https://flashdata.dev/zh/docs/guides/yt-dlp-403-forbidden/reference.md#versions)
- [修复工作时间 / EJS 警告](https://flashdata.dev/zh/docs/guides/yt-dlp-403-forbidden/reference.md#challenges)

<a id="network"></a>

## 2 取代持久标志的 IP


使用这个分支，当许多公共视频在一个下载进程失败，但同样的配置成功在其他地方。通过不同的主机或代理输出测试新源提取和媒体下载。改变源IP是实际恢复，当IP是YouTube继续拒绝的条件时。

**试一条替代的贴纸proxy路线**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --proxy "http://USER:PASSWORD@HOST:PORT" -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

使用一个会议，保持一个出发的IP整个工作。 只添加 --cookies 如果访问比较显示他们需要。

检查替换真的有不同的输出IP。代理服务可以保持相同的输出，在一个更改的门口或用户名后面。对于大型收藏，保持一套经过测试的出口，限制每出口的竞争，并将新工作从一个标志着的排行榜上移动。在新提取之前或失败后旋转，而不是玩家请求和媒体转让之间。

| 比较 | 操作 |
| --- | --- |
| 新出口工作；旧出口仍要求登录 | 保留正常线路，暂时停用或隔离旧出口。反复从旧出口重试无法恢复该 IP 的信誉。 |
| Cookies工作几个视频 | 使用这个会议为小工作，不要通过在许多忙碌的下载进程中分享它来扩展。 |
| 浏览器在家工作；下载进程仍然失败 | 家IP/session不是服务器IP/session.在下载进程的实际路线上重复相同的单视频测试。 |
| 每个路线上都会出现一个特定的视频 | 检查该来源的可用性和帐户要求，与公共视频控制单独。 |

浏览器 Cookie 工作室对有限下载有用，但大数据集不能依赖于不断找到和更新许多帐户会议。对于大规模的公共视频工作，投资出发IP质量、旋转和IP包装。保持 Cookie 用于需要帐户的访问；一个代理商不提供私人视频访问。

**比较IPv4在直接下载进程路线上**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --force-ipv4 -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

当配置一个代理时, -4 只能影响与代理的连接。

- [全 direct/proxy IP 比较](https://flashdata.dev/zh/docs/guides/yt-dlp-403-forbidden/reference.md#environment)

<a id="cookies"></a>

## 3、使用 Cookie 为小工作


浏览器的显示名称不是其个人资料目录名称。在 Chrome 中，请在 `chrome://version` 中阅读个人资料路径。在 Firefox 中，使用 `about:profiles` 来识别实际上正在运行 YouTube 会议的个人资料。作为另一个操作系统用户运行的背景服务不会自动继承它。

**Firefox**

如果有多个个人资料，请使用 Firefox 支持的 browser/profile 合成来输入所需的个人资料名称或路径。


**默认 Firefox 个人资料**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --cookies-from-browser firefox -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```


**Chrome 配置**

用实际目录名替换 Profile 1。如果 Windows 无法复制或解密 Chrome 数据库，请参阅下方的 Cookie 错误排查。


**选择一个特定的Chrome目录**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --cookies-from-browser "chrome:Profile 1" -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```


**出口文件**

使用 Netscape 格式的文件，而不是 JSON 或复制 Cookie 标题。该文件必须是可读和可写的本地工作，因为 yt-dlp 保存其 Cookie 存储器关闭。对于一个仅阅读的容器秘密，请使用下面的字符串复制。


**阅读私人Cookie文件**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --cookies private/youtube-cookies.txt -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```


> **充电不是接受**
> 一个“提取 Cookie”或“发现 YouTube 帐户 Cookie”线证明了当地数据被找到，它不证明 YouTube 仍然接受会议。

Cookie 文件验证浏览器会议。 将其保持在 Git 、支持附件和公共日志上。 在浏览器中测试帐户的真实访问; Cookie 出口不能添加访问私人、删除或会员限制的视频。

- [Browser/profile 合成和 Cookie 格式](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#how-do-i-pass-cookies-to-yt-dlp)

<a id="renew-session"></a>

## 4. 更新已结束的会议


**标签为这个分支**

```text
The provided YouTube account cookies are no longer valid
playability status: LOGIN_REQUIRED
```

缩短的标记在上流版本 #15527. 第一行本身不是有效的会议的证据。

对于保存的 Cookie 文件, upstream 建议出口一个专门的私人会议，然后让该会议关闭。

1. 打开一个新的 private/incognito 窗口，然后登录到可以访问源的帐户。
2. 在同一选项卡中，打开 https://www.youtube.com/robots.txt. 保持它是私人会议中的唯一选项卡。
3. 从此私人会议中提取YouTube.com Cookie 使用在上流 FAQ中链接的 Cookie-export 扩展，并启用到 private/incognito 窗口的访问。
4. 出口后关闭整个私人窗口。 不要继续使用该出口的浏览器中的会话。
5. 将出口保留在私人状态下，并将单源测试运行，并指向新文件的 --cookies。

将 `--cookies-from-browser` 与 `--cookies` 结合起来，将常见的浏览器配置文件提取出来；它不会捕获此私人会议。更改文件的终止列也不会更新一个服务器已关闭的会议。

**取代，不再播放包**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --cookies private/youtube-cookies.txt -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

如果不效的cookie警告留下，则下载进程确认收到新出口的文件，并且出口来自计划的私人会议。如果警告消失，但 `LOGIN_REQUIRED` 留下，转到 network/source 下面的比较。如果媒体选择成功，转账现在返回403,使用GVS标志和转账检查。

- [YouTube 精确出口程序](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies)
- [残疾人会议例子: #15527](https://github.com/yt-dlp/yt-dlp/issues/15527)
- [Cookie 旋转解释: #14872](https://github.com/yt-dlp/yt-dlp/issues/14872)

<a id="server"></a>

## Linux / Docker:复制一个仅阅读的 Cookie 秘密


`--cookies` 也是一个输出路径: yt-dlp 在例子关闭时，保存其 Cookie 栏。直接指向一个仅读的秘密可能会产生文件系统错误，即使在转移后。多名下载进程写同一份出口文件也可以重写对方的状态。

保持所提供的出口隐私，并将其复制到每个工作的临时目录中。 下面的 Python 示例使用 Deno 进行挑战，并下载一个音频流。

**此分類上一篇：將會議傳送到 yt-dlp**

```python
from pathlib import Path
from shutil import copyfile
from tempfile import TemporaryDirectory
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget

source_cookie_file = Path("/run/secrets/youtube-cookies.txt")

with TemporaryDirectory(prefix="yt-session-") as temporary:
    job_cookies = Path(temporary) / "cookies.txt"
    copyfile(source_cookie_file, job_cookies)
    options = {
        "cookiefile": str(job_cookies),
        "js_runtimes": {"deno": {}},
        "impersonate": ImpersonateTarget(),
        "noplaylist": True,
        "format": "ba",
        "outtmpl": "downloads/%(id)s.%(ext)s",
    }
    with YoutubeDL(options) as downloader:
        downloader.download(["https://www.youtube.com/watch?v=jNQXAC9IVRw"])
```

保持下载文档在临时导向文档内，以便当 yt-dlp 保存时,Cookie 文件仍然存在，这保护了提供的文件；它不会更新已结束的会话。

对于长期运行服务，通过您现有的秘密管理过程分发新出口，并开始新的工作，不要盲目分享一个可转换的cookie文件在当前工作中，保持任何会议更新与成功下载档案单独。

- [Cookie持久性在YouTubeDL](https://github.com/yt-dlp/yt-dlp/blob/2026.10.26/yt_dlp/YoutubeDL.py)

<a id="tokens"></a>

## 波托克纳供应商被加载，但仍然被封锁


检查供应商是否只是被发现或实际上产生了代币。对于GVS代币，抽出器通常需要一个可用的玩家结果首先。如果该客户端提前返回`LOGIN_REQUIRED`,则可能从未达到媒体标志请求。

| 记录证据 | 下一步 |
| --- | --- |
| `PO Token Providers` 列出了 bgutil，但日志中没有生成令牌的记录 | 阅读先前的玩家错误。 加载的插件不是成功的验证或代币生成的证据。 |
| `Error reaching GET … /ping` | 在下载进程容器中，当地主人是下载进程；在共享网络上使用供应商的服务名称。 |
| `Generating a gvs PO Token` 后出现 `LOGIN_REQUIRED` | 检查会议和下载进程路线 重新安装相同的供应商不会改变帐户或出发网络。 |
| 创建的代币，选择的格式，然后媒体 403 | 在 403 指南中查看所选客户端的标志背景和 extraction/transfer 路线。 |

供应商项目记录一个数据中心案例，在那里创建了一个标志，并持久了登录错误，这就是为什么成功检查必须包括玩家响应和真正的媒体转让，而不仅仅是供应商的初始线。

- [安装和验证供应商两部分](https://flashdata.dev/zh/docs/guides/yt-dlp-403-forbidden/reference.md#po-token)
- [供应商的登记事件: #37](https://github.com/Brainicism/bgutil-ytdlp-pot-provider/issues/37)

<a id="workload"></a>

## 以少数请求的回复


单独的消息 `This content isn't available, try again later` 被文档为上流作为一个 guest/account 请求率限制。停止使用该会议的下载进程，保留失败的身份证，并在退出单一来源之前让拒绝清晰。没有有用的理由重演完整的示范，而每个项目都得到相同的回应。

**使用工作配置和睡眠预设置的重复**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
  --fragment-retries 3 --batch-file urls.txt
```

保持相同的存档和输出政策。 配置必须包含您的工作时间和任何所需的 session/provider 设置。

| 控制 | 什么变化 |
| --- | --- |
| -t sleep | 在此过程中，应用 yt-dlp 的包装预定，检查对话配置，以确保有效的睡眠值。 |
| --sleep-requests | 关闭提取请求 相关的 metadata/player请求，包括从未下载媒体的工作流。 |
| --sleep-interval | 等待媒体下载之前，它不会推移单独的密集的转换器 - 仅要求。 |
| --limit-rate | 限制转移带宽；它不限制玩家请求频率。 |
| 控制竞争 | 限制在您的过程中进行的组合工作，十个包装下载进程仍然可以通过一个会议进行过渡。 |

将申请退款预算与 yt-dlp 的退款设置分开。十个工作退休，每一个推出另一个下载器与自己的退休，可以增加请求。将一个结束的会议视为更新任务和一个不持续的来源视为失败的项目，而不是立即重新复制两者。

- [专门 429 恢复和请求包装](https://flashdata.dev/zh/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [YouTube 要求率错误和包装](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#this-content-isnt-available-try-again-later)

<a id="cookie-errors"></a>

## Windows:Cookie复制和解密错误


| 失败 | 具体行动 | 下一篇 什么要检查 |
| --- | --- | --- |
| `Could not copy Chrome cookie database` / `Permission denied` | 关闭所有 Chrome 窗口及其剩余背景过程，然后作为同一操作系统用户重新启动。 | 记录应该先前复制数据库，如果下一个错误是解密，请使用下一个行。 |
| `Failed to decrypt with DPAPI` | 使用 Firefox 配置文件与预定登录，或将 YouTube cookies出口到 Netscape 格式并通过 --cookies. Windows Chrome 加密是一个已知的升级问题。 | 成功的 Cookie 加载跟随玩家回应。 作为管理员或更改视频格式运行不会解密会议。 |
| `Cookies file must be Netscape formatted, not JSON` | 重新出口为 cookies.txt/Netscape 格式。 浏览器 JSON 出口或原始 Cookie 请求标题不是该格式。 | 文件包装器接受出口，然后测试YouTube是否接受会议。 |
| `No such file or directory` | 查看路径在实际服务用户下。 下载进程容器无法阅读仅在笔记本电脑上存在的个人资料。 | 预期的文件在命令中的路径上存在，而不打印其内容。 |

这些失败发生在预定的验证请求之前。取代您的出发IP不能使不可读的数据库可读。相反，一旦Cookie正确加载，一个持续的Bot-Check答案需要一个会议或网络测试而不是另一个数据库复制工作。

- [Chrome 数据库锁定: #7271](https://github.com/yt-dlp/yt-dlp/issues/7271)
- [Chrome Windows 解密: #10927](https://github.com/yt-dlp/yt-dlp/issues/10927)

<a id="recovery"></a>

## 确保原始故障已解决


- Cookie 加载故障：在 YouTube 回复之前，确认 copying/parsing/decryption 成功。
- 无效的会话：检查无效的cookie警告消失，准确的来源产生可用的播放器响应。
- 供应商故障：检查发现、服务可用性和必要时进行代币事件。
- 下载故障：检查所需的 video/audio 流实际上达到输出文件；模拟本身不是完成。
- 收集故障：重新使用现有档案，并在恢复正常的尾巴之前检查失败的物品。

不要使用缓存删除、证书检查禁用或任意用户代理作为这些检查的替代品。他们不会更新由服务器拒绝的会话或解密浏览器数据库。保持工作变更和依赖版本的准确工作配置。

- [403 与供应商命令的修复](https://flashdata.dev/zh/docs/guides/yt-dlp-403-forbidden/reference.md)
- [可追溯的Python下载进程](https://flashdata.dev/zh/docs/guides/yt-dlp-python-api/reference.md)
- [管理的YouTube下载](https://flashdata.dev/zh/products/youtube-download)
