Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Посібники

Як виправити помилку 403 Forbidden у yt-dlp

Оновіть nightly-версію, зменште кількість одночасних запитів, перевірте Deno, а потім перевірте файли cookie й робочу вихідну IP-адресу.

На цій сторінці

Спробуйте це перш за все

  1. Оновлення вночі. Оновлення Python середовища, що використовується невдалим працівникам.
  2. Зниження навантаження. Перерва паралельних робочих місць на цьому IP; випробування одного відео і одного фрагменту одночасно.
  3. Перевірте Deno. Поверніть, що лог вербус виявляє час роботи.
  4. Вибирайте діючі файли cookie. Для невеликої роботи використовуйте сесію браузера, яка може грати в джерело.
  5. Замінити відхилений IP. Запустіть свіжу екстракцію через здоровий хостинг або прокси-вихід.
Оновлення, а потім перевірте потрібний робочий час
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
1 джерело, 1 низький зарядний перехід
python -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"
Використовуйте вашу невдалу URL, а потім короткий публічний відео як контроль. Цей аудіо-один-провідник уникне FFmpeg і зберігає нове ім'я файлу, що нагадується час, для кожного спробу.

Відправляйтеся на невдалого працівника. Перевірте вербозу Proxy map для його реальної маршруту. --ignore-config видаляє збережені варіанти, але зберігає встанові плагіни та прокси навколишнього середовища.

Успіх означає збережений файл. Після того, як аудіо працює, випробуйте відео з -f bv, а потім відновлюйте повні налаштування виходу. --simulate і -F не випробуйте передачу засобів масової інформації. Кап 2M є початковою точкою для діагностики.

1 Оновлення до ночі

Попередній робочий заповіт раптово провалиться: оновлення перш. зміни YouTube-плеєра можуть розривати старі екстрактори; останній нічний може вже містити поправки.

Оновлення робочої системи Python
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
yt-dlp -U тільки оновлення в поточному каналі. використовуйте --update-to нічно, щоб перейти з стабільного.

Відновлення та відновлення контейнера, якщо його зображення містить старий пакет; оновлення Python на хості не оновлює цей контейнер. Зберігайте точну перегляд в робочому записі і знову запускайте той же джерело, перш ніж змінювати інші налаштування.

Усунути старий player_client, player_js_version і формати=missing_pot перевершення для базової лінії. Робочий з старого інциденту тепер може вибрати непотрібного клієнта або виявити потоки, токен якого ще відсутній. Проблема #14680 є прикладом зміни гравця, що встановлюється в потоці; копіювання його тимчасового перевищення назавжди не є виправленням.

2) зменшення конкурентоспроможності

Завантажується робота, а потім не працює, коли обсяг збільшується: зменшує загальну навантаження на IP-виходу.У FlashData досвід, швидкі паралельні передачі можуть викликати відмову.

Джерело навантаженняПерша діагностична ситуація
Конкурентні робочі місцяОдин активний відео для цього IP-виходу; тимчасово зупинити решту хвоста.
Народительські фрагменти--concurrent-fragments 1.
aria2 або інший зовнішній завантажувачQuay lại --downloader native. Nếu dùng lại aria2 sau đó, hãy bắt đầu bằng -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 Перевірте дено

Перевірте обидві залежності від працівника: Дено виконує виклики; yt-dlp-ejs забезпечує скрипти розчинника; [default] додатковий встановлює скрипти.

Перевірте залежність працівників
deno --version
python -m pip show yt-dlp yt-dlp-ejs
python -m yt_dlp --list-impersonate-targets
Перевірка робочого часу і вирішення проблем
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"

Читайте лінію JS Runtime для Deno, і будь-які [jsc:deno] розв'язані повідомлення. Відсутній час запуску або попередження signature/n-challenge потрібно виправити перед іншим великим завантаженням. Deno 2.3+ є поточним мінімальним показником в документації EJS; використовуйте оновлену підтримувану версію.

Linux з Deno поза PATH
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Замінити /opt/deno/bin/deno реальним виконаним. на macOS або Windows, використовуйте цей безперервний Deno шлях працівника замість цього.

У цьому випадку curl-cffi додаток дозволяє --impersonate="". Він надає відбитки пальців, схожі на браузер; він не замінює Deno. Якщо цільовий браузер недоступний, встановіть додатковий в тому ж Python середовищі. Якщо імперіація вводить невдачу на робочому шляху, порівнюйте ідентичний запит без прапора.

Після перевірки залежності, ретрон реального передачі засобів масової інформації. Якщо поточний нічний досі повідомляє про підписання-розв'язання невдачі для того ж гравця, зберегти ідентифікатор гравця і повідомлення розв'язання для відповідного виклику. Якщо вирішення вдається і засоби масової інформації отримують 403, продовжуйте до session/IP перевіряти.

4. спробуйте діючі файли cookie для невеликої роботи

Тестуйте відому робочу сесію. Поверніть, що браузер може грати точний джерело, а потім спробуйте його файли cookie з тим же командою і маршрутом.

Використовуйте робочу сесію Firefox
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies-from-browser firefox \
  "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" --cookies private/youtube-cookies.txt \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Використовуйте файли cookie у форматі Netscape. зберігайте файл приватним і письмовим для цієї роботи; для читання таємниці, зробіть копію на роботу.

Якщо файли cookie завантажуються, але YouTube стверджує, що вони більше не діють, замінити сесію, а не повторювати той же файл. Для декількох відео, збереження браузера входу може бути практичним. Для великої колекції публічних відео, пошук і оновлення багатьох браузерів сеансів не є залежним скальованою стратегією.

Для масової роботи, керуйте басейном використовуваних прокси-вихідних IP і ротації на робочих кордонах, з низьким бюджетом за запитом IP. Зберігати файли cookie облікового запису для джерел, які фактично вимагають доступу до облікового запису. Зміна IP не дозволяє отримати доступ до приватного або недоступного відео.

5 Замінити відхилений IP-адрес

Те ж саме публічне відео, ті ж самі налаштування, інший результат IP: замінює недійсний вихід. FlashData бачить багато постійних 403s викликаних поганими або закріпленими прокси IP. Реабілітація yt-dlp не відновлює цей маршрут.

  1. Зберігайте джерело, нічний огляд, Дено, файли cookie, якщо це необхідно, і формат вибірника однаковий.
  2. Тестуйте один замінений IP-вихід з свіжим видобутком і реальним передачею засобів масової інформації.
  3. Поверніть прокси, що фактично змінив свій вихідний IP. Нове ім'я хостингу або акредитація порталу все ще може призвести до того ж виходу.
  4. Зберігайте прикріплену сесію прокси протягом усього екстракції, генерації токенів та передачі засобів масової інформації.
  5. Видаляйте або охолоджуйте недійсний вихід у вашому басейні. перевертайтеся на інший здоровий вихід для нової роботи або контролюваного відходу.
Замінити сесію прокси
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"
Це перешкоджає environment/configured прокси для тестування. Скачати його, коли хостинг не може безпосередньо дістатися до YouTube.
Порівняйте маршрут IPv4 хостела
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"
Робочий IPv4 маршрут може відрізнятися від невдалого IPv6 маршруту. з прокси, -4 не обов'язково вибирає вихідну IP-семейство прокси.
ПоповненняПопередня дія
Те ж саме джерело вдається на новому IP-виходіЗберігайте цей маршрут і його низькопотяжну базову лінію. Кварантин недійсного виходу, а не відкликання його для кожного відео.
Зміни в прокси-кредитації не мають ніякого впливуПеревірте реальну політику IP і сесії; прокси може все ще використовувати той же вихід.
Гравець працює, медіа проваляються тільки через проксиПеревірте доступ googlevideo.com і що засоби масової інформації використовують той самий exit/session.
Один джерело провалиться на кожному випробуваному маршруті; контроль працюєВивчайте цей джерело, формат і стан життя. Не назначайте весь прокси-пойс, розбитий з одного відео.

Наступна: Зберігати екстракцію та передачу на одному IP

Поширеною помилкою в програмі є витяг info['url'] на одній машині, зберігання в ковбасі, а потім завантаження в іншому місці. Підписані URL-адреси медіа закінчуються і можуть залежати від оригінального IP і запиту заголовків. Ротаційний прокси може створювати один і той же розділ навіть в межах однієї програми.

Виберіть YouTube-відео-ID і бажані налаштування виходу. Залишайте працівника робити свіжу екстракцію і завантажуйте разом. Якщо працівник використовує прокси, тримайте той же егрес через гравця екстракції, генерації токенів і запитів засобів масової інформації. Запрошуйте провайдера проксі на стяжну сесію замість того, щоб обертати кожну запит HTTP.

Зберігати екстракцію і передачу в тій же роботі Python
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"])
Це прямий локальний завантаження; він не потребує ключа API. Додайте ваші перевірені cookie/provider варіанти тільки тоді, коли попередні тести вимагають їх.

Якщо це вдається під час requests.get(saved_media_url) або окремого FFmpeg процесу провалиться, перевірте цей провал: вік URL, адреси, надані екстрактором, файли cookie і реальний егрес. Зберігайте URL-адреси медіа з постійних робочих записів. При відновленні закінчених результатів витягу, запитуйте нові 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 для запиту гравця не може бути обмінений з одним для передачі засобів масової інформації або підзаголовків.

Локація Logінтерпретація
Unable to download API page / Unable to download webpageВизначте цей хостинг, перш ніж розглядати його як провал медіа-сервера.
unable to download video data: HTTP Error 403: ForbiddenЗаявка на вибір засобів масової інформації була відхилена.Слідуйте solver/token/route галузям нижче.
Фрагмент відхилення повідомленьЗберігайте фрагментну помилку і протокол; порівнюйте інший доступний формат замість того, щоб відрізати той же фрагмент назавжди.
FFmpeg говорить HTTP 403 під час читання входуFFmpeg є збирання віддалених засобів масової інформації, наприклад, для кліпу. перевірте URL і мережу, що перейшли на FFmpeg; це не місцева помилка кодек.
Завантаження зберігання повертається AccessDeniedФайл досяг вашого етапу завантаження. Виправити букетний доступ і відкликати, що завантажується, а не YouTube завантаження.

Наступна: Налаштування ПО-токен провайдера

Використовуйте цю галузь, коли необхідні формати перерваються для відсутнього токену GVS, або ваш конфігурований токен відкидається. Токенти пов'язані з контекстом client/request і можуть бути пов'язані з відео-ІД. Токен, копійований для одного відео, не є повторним акредитацією для цілого ребра. Використовуйте провайдера для створення токену для поточного запиту.

У наступному розділі використовується bgutil 2.0.2. Вона має дві частини: плагіна Python, завантажена yt-dlp і сервіс JavaScript, який генерує токенів. Зберігайте версії в поєднанні під час оновлення. Приклади нижче використовують сервіс, доступний на тому ж хості в порту 4416.

Налаштування підключення в Python середовище yt-dlp
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"

Для yt-dlp за допомогою хостингу Docker. видати тільки порт loopback.

Почніть провайдер
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2
Перевірте сервіс з середовища завантажувача
python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"
Очікуйте HTTP 200. Виконайте це в контейнері працівника, якщо це там, де yt-dlp працює.
Запит mweb ЗМІ з постачальником
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. Не публікуйте порт провайдера.

Використовуйте провайдера в мережі Docker працівника
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"
Замінити YOUR_FORMAT_ID. для поєднаного вибору, перевіряйте відео і аудіо-ІД окремо. для кліпу, спочатку перевіряйте нерозривний потік.

Укази SABR стосуються форматів, які пропонує клієнт. Вони не такі ж, як і невдача n-виклику. Якщо старий web переверх виробляє тільки unavailable/unsupported формати, видаліть переверх або використовуйте документальний mweb/provider шлях. Не додайте formats=missing_pot як поправку: вона виявляє формати, не забезпечуючи їх відсутній токен.

Живі, нещодавно закінчені і звичайні завантажені відео можуть виявляти різні манифести. Включити цей стан при пошуку upstream. Якщо нещодавно закінчений потік все ще обробляється, альтернативний формат або пізній екстракція може бути корисним наступним тестом; додавання глобального кодек-перевізника до кожного працівника не є.

Отримайте одного працівника

Перш за все, повторюйте невдалий джерело з оригінальним необхідним вихідним 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 повернувся на кожну спробу потребує зміненого стану перед відставкою. Не встановіть безмежні фрагменти відходів або перемістіть невдалих ідентифікаторів в архіву успіху. Якщо засоби масової інформації закінчилися і лише доставка зберігання не вдалося, відновлюйте завантаження збереженого файлу.

Чи не вдасться? – Використовуйте корисний звіт про помилку

  • Знайдіть реальний невдалий перехід з --verbose, не тільки успішним --simulate роком.
  • Зберігайте yt-dlp перегляд, runtime/EJS версії, завантажений провайдер і вибраний format/protocol.
  • Включити попередження перед помилкою, чи був затребуваний токен, і чи сталася невдача до або після вибору засобів масової інформації.
  • Згадай результати того ж джерела за IPv4/direct/proxy тільки для порівнянь, які ви фактично пройшли.
  • Видаляти вміст файлів cookie, прокси-кредитації, підписані URL-адреси та токенів перед поділом запису.

Пошук за допомогою конкретного попередження і випуску. Якщо відповідний регресія все ще відкрита, зберігайте недійсний пункт і використовуйте підтверджений робочий шлях, відстежуючи цей ремонт. Чистий запис, який говорить тільки «403», менш корисний, ніж короткий запис, в якому показується, що запит і контрольована зміна провалилися.