Обзор документации
Руководства
Обновите 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 или другой внешний загрузчик | Вернитесь к --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 выполняет вызовы; 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 Line для 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 вызванных плохими или флагманскими прокси-IPs. Переустройство 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-изход | Удержите этот маршрут и его низкоточный базовый маршрут. Карантин неудачного выхода, а не отторжение его для каждого видео. |
| Изменение прокси-кредитаций не оказывает эффекта | Проверьте реальный IP и сеанс-политику эгресса; прокси может все же использовать тот же выход. |
| Игроки работают, медиа не работает только через прокси | Проверьте доступ googlevideo.com и что СМИ используют тот же exit/session. |
| Один источник проваливается на каждом испытанном маршруте; контроль работает | Исследуйте этот источник, формат и живый статус. Не назначайте весь прокси-поль, разбитый из одного видео. |
Напредная: поддержка экстракции и передачи на одном IP
Частый ошибка в приложении заключается в том, что info['url'] выводится на одном устройстве, хранится в ковчеге и позже загружается в другом месте. Подписанные URL-адреса медиа истекают и могут зависеть от оригинального IP и запросов. Ротационный прокси может создавать тот же раздел даже в одном приложении.
Проверьте видеоидентификатор YouTube и желаемые настройки выхода. Пусть работник совершает свежую экстракцию и загружает вместе. Если работник использует прокси, то сохраняйте тот же эгресс через игровую экстракцию, генерацию токенов и запросы СМИ. Попросите провайдера прокси на стяжной сессии вместо того, чтобы вращать каждую запрос 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 ветвям ниже. |
| Фрагмент Retry Messages | Поддерживайте фрагментную ошибку и протокол; сравнивайте другой доступный формат вместо того, чтобы отслеживать тот же фрагмент бесконечно. |
| FFmpeg говорит HTTP 403 в то время, как читает ввод | FFmpeg является удаленным медиа, например, для клипа. проверьте URL и сеть перенесен на FFmpeg; это не локальная ошибка кодек. |
Загрузка хранилища возвращается AccessDenied | Файл достиг стадии загрузки. поправить букет доступа и вывести, что загрузить, а не загрузить YouTube. |
Настройка: установка ПО-токен провайдера
Используйте эту ветку, когда необходимые формати пересекаются для отсутствующего токена GVS, или ваш конфигурированный токен отвергается. Токены связаны с контекстом client/request и могут быть связаны с видео-ID. Токен, копированный для одного видео, не является повторным акредитацией для всего ребра. Используйте поставщика, чтобы генерировать токен для текущего запроса.
В следующем приложении используется 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 | Плагин не загружен. установить его с тем же Пайтон-интерпретером; удалить --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.txt403 возвращенный на каждом попытке требует изменения состояния перед выходом на пенсию. Не устанавливайте бесконечное отклонение фрагментов или переместите неудачные ID в архив успеха. Если медиа закончились и только доставка хранения не удалась, перезагрузите сохранившийся файл.
До сих пор неудачно? Подготовить полезный отчет о ошибке
- Понимайте фактический неудачный перевод с --verbose, не только успешный --simulate проход.
- Удержите yt-dlp пересмотр, runtime/EJS версии, загруженный провайдер и выбранный format/protocol.
- Включите предупреждение перед ошибкой, спросили ли вы токен и произошло ли неудача до или после выбора медиа.
- Запишите результаты того же источника в IPv4/direct/proxy только для сравнений, которые вы фактически проводили.
- Удалите содержимое файлов cookie, прокси-кредитации, подписанные URL и токены перед тем, как поделиться записью.
Поиск upstream с помощью конкретного предшествующего предупреждения и вашего выхода. Если регрессия, которая соответствует, все еще открыта, сохраните неудачный элемент и используйте подтвержденный рабочий путь, при этом отслеживайте этот ремонт. Чистый дневник, который говорит только «403», менее полезен, чем короткий запис, показывающий, какие запросы и контролируемые изменения не удались.