Перейти к содержимому
RU
Ключ 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
Один источник, один низкоточный перенос
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 или другой внешний загрузчикВернитесь к --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-targets
Проверка работы и решение проблем
python -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; используйте обновленную поддерживаемую версию.

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 используйте в этом месте абсолютную дорогу работника.

В этом случае 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"
Используйте файлы Netscape-форматы. сохраните файл частным и письменным для этой работы; для чтения-только секрета, сделайте копию на работу.

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

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

5 Замена отвергнутого IP-адреса

Те же публичные видео, те же настройки, разные результаты IP: замещает неудачный выход. FlashData видит много упорных 403s вызванных плохими или флагманскими прокси-IPs. Переустройство yt-dlp не исправит этот маршрут.

  1. Сохраняйте источник, ночной ревизию, Deno, файлы 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 и желаемые настройки выхода. Пусть работник совершает свежую экстракцию и загружает вместе. Если работник использует прокси, то сохраняйте тот же эгресс через игровую экстракцию, генерацию токенов и запросы СМИ. Попросите провайдера прокси на стяжной сессии вместо того, чтобы вращать каждую запрос 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 ветвям ниже.
Фрагмент Retry MessagesПоддерживайте фрагментную ошибку и протокол; сравнивайте другой доступный формат вместо того, чтобы отслеживать тот же фрагмент бесконечно.
FFmpeg говорит HTTP 403 в то время, как читает вводFFmpeg является удаленным медиа, например, для клипа. проверьте URL и сеть перенесен на FFmpeg; это не локальная ошибка кодек.
Загрузка хранилища возвращается AccessDeniedФайл достиг стадии загрузки. поправить букет доступа и вывести, что загрузить, а не загрузить YouTube.

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

Используйте эту ветку, когда необходимые формати пересекаются для отсутствующего токена GVS, или ваш конфигурированный токен отвергается. Токены связаны с контекстом client/request и могут быть связаны с видео-ID. Токен, копированный для одного видео, не является повторным акредитацией для всего ребра. Используйте поставщика, чтобы генерировать токен для текущего запроса.

В следующем приложении используется 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Плагин не загружен. установить его с тем же Пайтон-интерпретером; удалить --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. Для смешанного подбора, проверьте видео и аудио 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 возвращенный на каждом попытке требует изменения состояния перед выходом на пенсию. Не устанавливайте бесконечное отклонение фрагментов или переместите неудачные ID в архив успеха. Если медиа закончились и только доставка хранения не удалась, перезагрузите сохранившийся файл.

До сих пор неудачно? Подготовить полезный отчет о ошибке

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

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