Переглянути документацію
Посібники
Оновіть nightly-версію, зменште кількість одночасних запитів, перевірте Deno, а потім перевірте файли cookie й робочу вихідну IP-адресу.
На цій сторінці
Спробуйте це перш за все
- Оновлення вночі. Оновлення Python середовища, що використовується невдалим працівникам.
- Зниження навантаження. Перерва паралельних робочих місць на цьому IP; випробування одного відео і одного фрагменту одночасно.
- Перевірте Deno. Поверніть, що лог вербус виявляє час роботи.
- Вибирайте діючі файли 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 і формати=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-targetspython -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; використовуйте оновлену підтримувану версію.
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 середовищі. Якщо імперіація вводить невдачу на робочому шляху, порівнюйте ідентичний запит без прапора.
Після перевірки залежності, ретрон реального передачі засобів масової інформації. Якщо поточний нічний досі повідомляє про підписання-розв'язання невдачі для того ж гравця, зберегти ідентифікатор гравця і повідомлення розв'язання для відповідного виклику. Якщо вирішення вдається і засоби масової інформації отримують 403, продовжуйте до session/IP перевіряти.
5 Замінити відхилений IP-адрес
Те ж саме публічне відео, ті ж самі налаштування, інший результат IP: замінює недійсний вихід. FlashData бачить багато постійних 403s викликаних поганими або закріпленими прокси IP. Реабілітація yt-dlp не відновлює цей маршрут.
- Зберігайте джерело, нічний огляд, Дено, файли 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-виході | Зберігайте цей маршрут і його низькопотяжну базову лінію. Кварантин недійсного виходу, а не відкликання його для кожного відео. |
| Зміни в прокси-кредитації не мають ніякого впливу | Перевірте реальну політику IP і сесії; прокси може все ще використовувати той же вихід. |
| Гравець працює, медіа проваляються тільки через прокси | Перевірте доступ 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-адреси медіа з постійних робочих записів. При відновленні закінчених результатів витягу, запитуйте нові 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 -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Використовується 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 як поправку: вона виявляє формати, не забезпечуючи їх відсутній токен.
Живі, нещодавно закінчені і звичайні завантажені відео можуть виявляти різні манифести. Включити цей стан при пошуку 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», менш корисний, ніж короткий запис, в якому показується, що запит і контрольована зміна провалилися.